@monimesl/dot-service 1.0.0-beta.3 → 1.0.0-beta.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"page-DBnKjef6.d.ts","names":[],"sources":["../src/page.ts"],"mappings":";;;QAyBQ;YAEI;;KAKA,gBAAgB,uCAExB,cAAc;UAGD;WACN;WACA;WACA,SAAS;;UAGH;EACf,KAAK,MAAM,QAAQ,UAAU;EAE7B,QAAQ,MAAM,QAAQ,UAAU;EAEhC,MAAM,MAAM,QAAQ,UAAU;EAE9B,KAAK;EAIL,cAAc,kBACZ,MAAM,QACN,UAAU,oBACT,QAAQ;EAGX,eAAe;;KAGL,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;WAEb,MAAM;EAEf,SAAS,QAAQ,YAAY;EAG7B,iBAAiB,SAAS;EAG1B,UAAU,SAAS;EAInB,UAAU,QAAQ;WAET,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;EAGd,UAAU;EAGV,QAAQ;EACR,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,UAAU;WACV,QAAQ;WACR,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;EAG1B,SAAS,MAAM;WAGN,aAAa;EAEtB,SAAS,MAAM,MAAM,YAAY;EAGjC,cAAc,MAAM,MAAM,YAAY,iBAAiB;EAEvD,eAAe,MAAM,MAAM;WAElB;;UAIM,aAAa;WACnB,OAAO,MAAM;WACb,YAAY;;KAGlB,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;WACtD,MAAM;EAWb,YAAA,oBACA,YACA,YAAY,eAAe,IAC3B,MAAM,UACN,WAAW,aAAa;MAsCtB,SAAS,MAAM;MAKf;MAIA,QAAQ;MAIR,cAAc;EAIlB,iBAAiB,SAAS;EAM1B,UAAU,SAAS;EAMnB,UAAU,QAAQ;EAclB,SAAS,QAAQ,YAAY;EA+B7B,OAAO,cAAc,QAAQ;EAQvB,IAAI,cAAc,QAAQ,WAAW;EAS3C,SAAS,cAAc,OAAO,WAAW;EAanC,UAAU,gBAAgB,WAC9B,UAAU,MACP,MAAM,WAAW,UAAU,MAC7B;EASH"}
1
+ {"version":3,"file":"page-DBnKjef6.d.ts","names":[],"sources":["../src/page.ts"],"mappings":";;;QAyBQ;YAEI;;KAKA,gBAAgB,uCAExB,cAAc;UAGD;WACN;WACA;WACA,SAAS;;UAGH;EACf,KAAK,MAAM,QAAQ,UAAU;EAE7B,QAAQ,MAAM,QAAQ,UAAU;EAEhC,MAAM,MAAM,QAAQ,UAAU;EAE9B,KAAK;EAIL,cAAc,kBACZ,MAAM,QACN,UAAU,oBACT,QAAQ;EAIX,eAAe;;KAGL,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;WAEb,MAAM;EAEf,SAAS,QAAQ,YAAY;EAG7B,iBAAiB,SAAS;EAG1B,UAAU,SAAS;EAKnB,UAAU,QAAQ;WAET,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;EAEd,UAAU;EAGV,QAAQ;EACR,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,UAAU;WACV,QAAQ;WACR,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;EAG1B,SAAS,MAAM;WAGN,aAAa;EAEtB,SAAS,MAAM,MAAM,YAAY;EAGjC,cAAc,MAAM,MAAM,YAAY,iBAAiB;EAEvD,eAAe,MAAM,MAAM;WAElB;;UAIM,aAAa;WACnB,OAAO,MAAM;WACb,YAAY;;KAGlB,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;WACtD,MAAM;EAWb,YAAA,oBACA,YACA,YAAY,eAAe,IAC3B,MAAM,UACN,WAAW,aAAa;MAsCtB,SAAS,MAAM;MAKf;MAIA,QAAQ;MAIR,cAAc;EAIlB,iBAAiB,SAAS;EAM1B,UAAU,SAAS;EAMnB,UAAU,QAAQ;EAclB,SAAS,QAAQ,YAAY;EA+B7B,OAAO,cAAc,QAAQ;EAQvB,IAAI,cAAc,QAAQ,WAAW;EAS3C,SAAS,cAAc,OAAO,WAAW;EAanC,UAAU,gBAAgB,WAC9B,UAAU,MACP,MAAM,WAAW,UAAU,MAC7B;EASH"}
@@ -1 +1 @@
1
- {"version":3,"file":"service-DlPGSrNU.js","names":[],"sources":["../src/bar-title.ts","../src/contrast.ts","../src/host-errors.ts","../src/host-calls.ts","../src/page.ts","../src/service.ts"],"sourcesContent":["import { isRefusedBarTitle, MAX_BAR_TITLE_LENGTH } from '@monimesl/dot-core';\n\nconst warnedTitles = new Set<string>();\n\n// In development: warns once when Dash won't show a page's title as written.\nexport function warnOnBarTitle(pageId: string, title: string | undefined): void {\n if (title === undefined || warnedTitles.has(title)) {\n return;\n }\n let problem: string | undefined;\n if (isRefusedBarTitle(title)) {\n problem =\n \"names Dash or Monime, so Dash shows the dot's name instead. Pick a title of your own\";\n } else if (title.length > MAX_BAR_TITLE_LENGTH) {\n problem = `is longer than ${MAX_BAR_TITLE_LENGTH} characters, so Dash cuts it. Pick a shorter one`;\n }\n if (problem === undefined) {\n return;\n }\n warnedTitles.add(title);\n console.warn(`[dot] Page \"${pageId}\": the navigation bar's title \"${title}\" ${problem}.`);\n}\n","import type { ColorScheme, NavigationBarOptions } from '@monimesl/dot-core';\nimport { contrast, READABLE_CONTRAST } from '@monimesl/dot-core';\n\n// Each warning shows once, so a page that changes its bars often doesn't fill the console.\nconst shownWarnings = new Set<string>();\n\n// In development: warns when text colours the dot picks are hard to read on their backgrounds.\n// Colours Dash picks itself always read well. `textColor` is the page's or the theme's, if set.\nexport function warnOnPoorContrast(\n pageId: string,\n navigationBar: NavigationBarOptions,\n scheme: ColorScheme,\n textColor: string | undefined,\n background: string,\n): void {\n const { backgroundColor: barBackground, textColor: barText } = navigationBar;\n if (barBackground && barText) {\n warnIfHardToRead(\n `Page \"${pageId}\": the navigation bar's textColor ${barText} on its backgroundColor ${barBackground}`,\n barText,\n barBackground,\n 'leave textColor out so Dash picks one',\n );\n }\n if (textColor) {\n warnIfHardToRead(\n `Page \"${pageId}\": the ${scheme} text ${textColor} on the page's background ${background}`,\n textColor,\n background,\n 'leave the text color out so Dash picks one',\n );\n }\n}\n\nfunction warnIfHardToRead(\n subject: string,\n textColor: string,\n background: string,\n advice: string,\n): void {\n const ratio = contrast(textColor, background);\n if (ratio >= READABLE_CONTRAST || shownWarnings.has(subject)) {\n return;\n }\n shownWarnings.add(subject);\n console.warn(\n `[dot] ${subject} is hard to read. Its contrast is ${ratio.toFixed(1)}, and text needs at least ${READABLE_CONTRAST}. Pick colours further apart, or ${advice}.`,\n );\n}\n","import { HostError } from '@monimesl/dot-core';\n\nexport function cancelledError(method: string): HostError {\n return new HostError('cancelled', `\"${method}\" was cancelled`);\n}\n","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';\nimport { cancelledError } from './host-errors';\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(cancelledError(call.method));\n }\n\n #settle(result: HostResult): void {\n const call = this.#waiting.get(result.id);\n // A cancelled call may still get a late answer from the host. Ignore it.\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 NavigationBarOptions,\n PageBars,\n PageConfigs,\n PageShare,\n PageHooks,\n PageLaunchOptions,\n PageState,\n PageColors,\n TabBarOptions,\n} from '@monimesl/dot-core';\nimport {\n applyChanges,\n checkColors,\n checkConfigs,\n checkNavigationBar,\n checkTabBar,\n mergeColors,\n mergeConfigs,\n} from '@monimesl/dot-core';\nimport type { Dash, DashRequest } from '@monimesl/dot-dash';\nimport { dash, tracked } from '@monimesl/dot-dash';\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 make TypeScript test the\n// ids as a whole, not one by one.\nexport type PageId = [keyof DotPageIds] extends [never]\n ? string\n : Extract<keyof DotPageIds, string>;\n\n// The navigation pushForResult asks for: a page on top.\nexport interface PushNavigation {\n readonly action: 'push';\n readonly page: string;\n readonly options: PageLaunchOptions;\n}\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 // Opens `page` on top, and resolves with what it gives back with backWithResult, or undefined if\n // it closes without one, such as when the person goes back.\n pushForResult<Result = unknown>(\n page: PageId,\n options?: PageLaunchOptions,\n ): Promise<Result | undefined>;\n\n // Closes this page, and gives `result` to the page below if it opened this one with pushForResult.\n backWithResult(result: unknown): 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 because TypeScript checks method parameters loosely. That lets a handler\n// narrow its event, such as `(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`, which another handler passes when it calls it.\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 // Dash's features. Calls still running when the page closes are cancelled.\n readonly dash: Dash;\n\n setState(update: StateUpdate<S>): void;\n\n // Changes Dash's navigation bar on this page, on top of what definePage set.\n setNavigationBar(options: NavigationBarOptions): void;\n\n // Hides or shows Dash's tab bar while this page shows.\n setTabBar(options: TabBarOptions): void;\n\n // Changes this page's colours, on top of what definePage set, such as\n // { background: { light: \"#FFF3E0\" } }. A scheme set to undefined puts the theme's colour back.\n setColors(colors: PageColors): 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 // Dash's bars and the page's colours, on top of defineDot's configs. `setNavigationBar`,\n // `setTabBar` and `setColors` change them while the page runs.\n configs?: PageConfigs;\n // Lets Dash's Share open this page, with these of its options. Without it, Share opens the dot's\n // first page. Write it out in place, as the build reads it without running the code.\n share?: PageShare;\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 configs?: PageConfigs;\n readonly share?: PageShare;\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 // The page's bars changed.\n showBars(page: Page): void;\n\n // defineDot's configs. The page's own configs override them.\n readonly dotConfigs?: PageConfigs | undefined;\n\n navigate(page: Page, navigation: Navigation): void;\n\n // Opens a page on top of `page`, which waits for what that page gives back.\n pushForResult(page: Page, navigation: PushNavigation): Promise<unknown>;\n\n backWithResult(page: Page, result: unknown): void;\n\n readonly strict?: boolean;\n}\n\n// What a page keeps from the copy it replaces, such as after a hot reload.\nexport interface RestoredPage<S> {\n readonly state: State<S>;\n readonly barChanges: PageBars;\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 dash: Dash = tracked(dash, (request) => this.#track(request));\n readonly #definition: PageDefinition<S>;\n readonly #host: PageHost;\n #state: State<S>;\n #closed = false;\n readonly #dashRequests = new Set<DashRequest<unknown>>();\n #previousHook: Promise<unknown> = Promise.resolve();\n // Bar changes the page made while running, on top of its configs.\n #barChanges: PageBars;\n\n constructor(\n instanceId: number,\n id: string,\n definition: PageDefinition<S>,\n host: PageHost,\n restored?: RestoredPage<S>,\n ) {\n this.id = id;\n this.instanceId = instanceId;\n this.#definition = definition;\n this.#host = host;\n if (restored) {\n this.#state = this.#freeze(restored.state);\n this.#barChanges = restored.barChanges;\n } else {\n const copy = JSON.parse(JSON.stringify(definition.initialState)) as State<S>;\n this.#state = this.#freeze(copy);\n this.#barChanges = { navigationBar: {}, tabBar: {}, colors: {} };\n }\n checkConfigs(definition.configs ?? {});\n\n const { mutations = {}, actions = {} } = definition;\n const sharedName = Object.keys(mutations).find((name) => name in actions);\n if (sharedName) {\n throw new Error(\n `Page \"${id}\" uses \"${sharedName}\" as both a mutation and an action. Rename one of them`,\n );\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 // Whether the person can pull the page down to refresh it.\n get refreshable(): boolean {\n return this.#definition.hooks?.onRefresh !== undefined;\n }\n\n get bars(): PageBars {\n return mergeConfigs(this.#host.dotConfigs, this.#definition.configs, this.#barChanges);\n }\n\n get barChanges(): PageBars {\n return this.#barChanges;\n }\n\n setNavigationBar(options: NavigationBarOptions): void {\n checkNavigationBar(options);\n const navigationBar = { ...this.#barChanges.navigationBar, ...options };\n this.#changeBars({ ...this.#barChanges, navigationBar });\n }\n\n setTabBar(options: TabBarOptions): void {\n checkTabBar(options);\n const tabBar = { ...this.#barChanges.tabBar, ...options };\n this.#changeBars({ ...this.#barChanges, tabBar });\n }\n\n setColors(colors: PageColors): void {\n checkColors(colors);\n const mergedColors = mergeColors(this.#barChanges.colors, colors);\n this.#changeBars({ ...this.#barChanges, colors: mergedColors });\n }\n\n #changeBars(barChanges: PageBars): void {\n if (this.#closed) {\n return;\n }\n this.#barChanges = barChanges;\n this.#host.showBars(this as Page);\n }\n\n setState(update: StateUpdate<S>): void {\n if (this.#closed) {\n return;\n }\n let changes: StateChanges<S> | undefined;\n if (typeof update === 'function') {\n changes = update(this.#state);\n } else {\n changes = update;\n }\n if (changes === undefined) {\n return;\n }\n const next = applyChanges(this.#state, changes);\n const patch = this.#changedKeys(next);\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 #changedKeys(next: State<S>): PageState {\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 return patch;\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 doesn't 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 for (const request of this.#dashRequests) {\n request.cancel();\n }\n this.#dashRequests.clear();\n }\n\n #track(request: DashRequest<unknown>): void {\n // An action still running after the page closed mustn't reach the person, so its calls stop.\n if (this.#closed) {\n request.cancel();\n return;\n }\n this.#dashRequests.add(request);\n const forget = () => this.#dashRequests.delete(request);\n void request.then(forget, forget);\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 pushForResult: <Result>(page: PageId, options: PageLaunchOptions = {}) => {\n if (this.#closed) {\n return Promise.resolve(undefined);\n }\n const result = this.#host.pushForResult(this as Page, { action: 'push', page, options });\n return result as Promise<Result | undefined>;\n },\n backWithResult: (result) => {\n if (!this.#closed) {\n this.#host.backWithResult(this as Page, result);\n }\n },\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 if (this.#host.strict) {\n return deepFreeze(state);\n }\n return 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 dash: Dash;\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.dash = page.dash;\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 readonly setNavigationBar = (options: NavigationBarOptions): void => {\n this.#page.setNavigationBar(options);\n };\n\n readonly setTabBar = (options: TabBarOptions): void => {\n this.#page.setTabBar(options);\n };\n\n readonly setColors = (colors: PageColors): void => {\n this.#page.setColors(colors);\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 for (const child of Object.values(value)) {\n deepFreeze(child);\n }\n }\n return value;\n}\n","import type {\n DotHooks,\n DotEvent,\n Envelope,\n HostCaller,\n HostLayerMessages,\n LogicLayerMessages,\n Navigation,\n PageConfigs,\n PageLaunchOptions,\n PageState,\n SystemContext,\n Theme,\n Transport,\n UILayerMessages,\n} from '@monimesl/dot-core';\nimport {\n DEFAULT_SYSTEM_CONTEXT,\n checkConfigs,\n connectHost,\n EventEmitter,\n MAX_STACK_DEPTH,\n MessageChannel,\n pageBackground,\n themeScheme,\n withSystemDefaults,\n} from '@monimesl/dot-core';\nimport { useHostDashApiVersions, warnAboveDashApiVersion } from '@monimesl/dot-dash';\n\nimport { warnOnBarTitle } from './bar-title';\nimport { warnOnPoorContrast } from './contrast';\nimport { HostCalls } from './host-calls';\nimport type { PageDefinition, PushNavigation, RestoredPage } 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 go to the view layer.\n setState(page: Page, patch: PageState): void;\n\n // `instanceId` is set when the error came from a 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 // Dash's bars and the colours of every page. A page's own configs override them.\n readonly configs?: PageConfigs;\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 // While developing, the dot's minApiVersion from dot.json, so Dash calls newer than it are pointed out.\n dashMinApiVersion?: string | undefined;\n}\n\n// The logic layer. It owns every page's state, runs handlers, and sends state changes to the\n// view layer.\nexport class Service implements DotContext {\n readonly channel: ServiceChannel;\n readonly hooks = new EventEmitter<ServiceHooks>();\n #definitions: Record<string, PageDefinition>;\n readonly #pages = new Map<number, Page>();\n readonly #dot: Partial<DotDefinition>;\n readonly #strict: boolean;\n readonly #development: boolean;\n #theme: Theme;\n #systemContext: SystemContext = DEFAULT_SYSTEM_CONTEXT;\n #stack: HostLayerMessages['syncStack'] = { pages: [], limit: MAX_STACK_DEPTH };\n // How each page waiting for a result from a page it opened with pushForResult gets it.\n readonly #awaitingResults = new Map<number, (result: unknown) => void>();\n // Results given with backWithResult, kept for the page below until it shows again.\n readonly #results = new Map<number, unknown>();\n readonly #hostCalls: HostCalls;\n\n constructor({ transport, pages, dot = {}, strict = false, dashMinApiVersion }: 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 // Only development builds pass the Dash API version, so only they warn about it.\n this.#development = dashMinApiVersion !== undefined;\n if (dashMinApiVersion !== undefined) {\n warnAboveDashApiVersion(dashMinApiVersion);\n }\n this.#theme = dot.theme ?? {};\n checkConfigs(dot.configs ?? {});\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 const previousScheme = this.#systemContext.scheme;\n this.#systemContext = withSystemDefaults(context);\n useHostDashApiVersions(this.#systemContext.dashApiVersions);\n if (this.#systemContext.scheme !== previousScheme) {\n this.#resendBars();\n }\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 // The page it opened has closed, with or without a result.\n this.#settleResult(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('refresh', ({ instanceId }) => {\n const page = this.getPage(instanceId);\n const refresh = page.lifecycle('onRefresh').finally(() => {\n this.channel.send('refreshed', { instanceId });\n });\n this.reportError(refresh, 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 const stopWatchingUncaught = this.#watchUncaughtErrors();\n connectHost(this.callHost);\n this.hooks.emit('launch');\n this.reportError(this.#runLaunchHook());\n return () => {\n stopListening();\n stopWatchingUncaught();\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 this.#resendBars();\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 // Runs a host call, such as `dash.ui.alert`, through this service's channel.\n readonly callHost: HostCaller = (method, params, options) =>\n this.#hostCalls.call(method, params, options);\n\n loadPage(instanceId: number, id: string, options: PageLaunchOptions = {}): Page {\n const page = this.#createPage(instanceId, id);\n this.#sendInitialState(page);\n this.#sendBars(page);\n this.hooks.emit('pageLoad', page);\n this.reportError(page.lifecycle('onLoad', options), instanceId);\n return page;\n }\n\n // Swaps in a newer build's pages on a hot reload. A page restarts only if its initialState\n // changed.\n replacePages(definitions: Record<string, PageDefinition>): void {\n const previousDefinitions = this.#definitions;\n this.#definitions = definitions;\n for (const [instanceId, page] of this.#pages) {\n const definition = definitions[page.id];\n // A page the new build no longer has keeps its old code until it closes.\n if (!definition) {\n continue;\n }\n page.close();\n const previousInitialState = previousDefinitions[page.id]?.initialState;\n if (JSON.stringify(previousInitialState) !== JSON.stringify(definition.initialState)) {\n this.loadPage(instanceId, page.id, this.#launchOptions(instanceId));\n } else {\n this.#keepPage(page);\n }\n }\n }\n\n #keepPage(page: Page): void {\n const kept = this.#createPage(page.instanceId, page.id, {\n state: page.state,\n barChanges: page.barChanges,\n });\n // The new definePage may set other configs, or add or drop onRefresh.\n this.#sendBars(kept);\n if (kept.refreshable !== page.refreshable) {\n this.#sendInitialState(kept);\n }\n }\n\n #sendInitialState(page: Page): void {\n this.channel.send('initPageState', {\n instanceId: page.instanceId,\n state: page.state,\n refreshable: page.refreshable,\n });\n }\n\n // The options the page was opened with, so its onLoad can run again with them.\n #launchOptions(instanceId: number): PageLaunchOptions | undefined {\n const entry = this.#stack.pages.find((stackEntry) => stackEntry.instanceId === instanceId);\n return entry?.options;\n }\n\n #createPage(instanceId: number, id: string, restored?: RestoredPage<PageState>): Page {\n const page = new Page(\n instanceId,\n id,\n this.#definition(id),\n {\n commit: (page, patch) => {\n this.hooks.emit('setState', page, patch);\n this.channel.send('setPageState', { instanceId: page.instanceId, patchState: patch });\n },\n showBars: (page) => this.#sendBars(page),\n dotConfigs: this.#dot.configs,\n navigate: (page, navigation) => this.#navigate(page, navigation),\n pushForResult: (page, navigation) => this.#pushForResult(page, navigation),\n backWithResult: (page, result) => this.#backWithResult(page, result),\n strict: this.#strict,\n },\n restored,\n );\n this.#pages.set(instanceId, page);\n return page;\n }\n\n #navigate(page: Page, navigation: Navigation): void {\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 `Can't open \"${navigation.page}\", as ${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\n #pushForResult(page: Page, navigation: PushNavigation): Promise<unknown> {\n // A result it was still waiting for can't come now.\n this.#settleResult(page.instanceId);\n // When the page can't open, the promise rejects with the reason.\n return new Promise((resolve) => {\n this.#navigate(page, navigation);\n this.#awaitingResults.set(page.instanceId, resolve);\n });\n }\n\n #backWithResult(page: Page, result: unknown): void {\n const { pages } = this.#stack;\n const index = pages.findIndex((entry) => entry.instanceId === page.instanceId);\n if (index > 0) {\n const below = pages[index - 1]!;\n this.#results.set(below.instanceId, result);\n }\n this.#navigate(page, { action: 'back', delta: 1 });\n }\n\n // Ends the page's wait for a result: with the one kept for it, or undefined without one.\n #settleResult(instanceId: number): void {\n const result = this.#results.get(instanceId);\n this.#results.delete(instanceId);\n const resolve = this.#awaitingResults.get(instanceId);\n this.#awaitingResults.delete(instanceId);\n resolve?.(result);\n }\n\n // The host gets the background as the dot shows it now; the webview gets the page's colours.\n #sendBars(page: Page): void {\n const { navigationBar, tabBar, colors } = page.bars;\n const deviceScheme = this.#systemContext.scheme;\n const background = pageBackground(colors.background, this.#theme, deviceScheme);\n this.channel.send('pageBars', {\n instanceId: page.instanceId,\n navigationBar,\n tabBar,\n background,\n });\n this.channel.send('pageColors', { instanceId: page.instanceId, colors });\n if (this.#development) {\n const scheme = themeScheme(this.#theme, deviceScheme);\n const textColor = colors.text?.[scheme] ?? this.#theme.colors?.text?.[scheme];\n warnOnPoorContrast(page.id, navigationBar, scheme, textColor, background);\n warnOnBarTitle(page.id, navigationBar.title);\n }\n }\n\n // A new theme or scheme can change the background every open page shows.\n #resendBars(): void {\n for (const page of this.#pages.values()) {\n this.#sendBars(page);\n }\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.#settleResult(instanceId);\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(`There's no page \"${id}\". Check the name, and that dot.ts lists it in pages`);\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, uncaught = false): 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 if (reason.stack !== undefined) {\n report.stack = reason.stack;\n }\n if (uncaught) {\n report.uncaught = true;\n }\n this.channel.send('error', report);\n }\n\n // Only some engines have global error events, such as a browser's Web Worker. Elsewhere the native\n // host catches what it can itself.\n #watchUncaughtErrors(): () => void {\n const scope = globalThis as ErrorEventScope;\n const addListener = scope.addEventListener;\n const removeListener = scope.removeEventListener;\n if (addListener === undefined || removeListener === undefined) {\n return () => {};\n }\n const onError = (event: UncaughtErrorEvent) => {\n this.#reportError(event.error ?? event.message, undefined, true);\n };\n const onRejection = (event: UncaughtErrorEvent) => {\n this.#reportError(event.reason, undefined, true);\n };\n addListener.call(scope, 'error', onError);\n addListener.call(scope, 'unhandledrejection', onRejection);\n return () => {\n removeListener.call(scope, 'error', onError);\n removeListener.call(scope, 'unhandledrejection', onRejection);\n };\n }\n}\n\n// What the service reads of a global scope's error events, as dots type-check without the DOM.\ninterface ErrorEventScope {\n addEventListener?: (type: string, listener: (event: UncaughtErrorEvent) => void) => void;\n removeEventListener?: (type: string, listener: (event: UncaughtErrorEvent) => void) => void;\n}\n\n// An `error` event has `error` and `message`; an `unhandledrejection` event has `reason`.\ninterface UncaughtErrorEvent {\n error?: unknown;\n message?: string;\n reason?: unknown;\n}\n\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":"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"}
1
+ {"version":3,"file":"service-DlPGSrNU.js","names":[],"sources":["../src/bar-title.ts","../src/contrast.ts","../src/host-errors.ts","../src/host-calls.ts","../src/page.ts","../src/service.ts"],"sourcesContent":["import { isRefusedBarTitle, MAX_BAR_TITLE_LENGTH } from '@monimesl/dot-core';\n\nconst warnedTitles = new Set<string>();\n\n// In development: warns once when Dash won't show a page's title as written.\nexport function warnOnBarTitle(pageId: string, title: string | undefined): void {\n if (title === undefined || warnedTitles.has(title)) {\n return;\n }\n let problem: string | undefined;\n if (isRefusedBarTitle(title)) {\n problem =\n \"names Dash or Monime, so Dash shows the dot's name instead. Pick a title of your own\";\n } else if (title.length > MAX_BAR_TITLE_LENGTH) {\n problem = `is longer than ${MAX_BAR_TITLE_LENGTH} characters, so Dash cuts it. Pick a shorter one`;\n }\n if (problem === undefined) {\n return;\n }\n warnedTitles.add(title);\n console.warn(`[dot] Page \"${pageId}\": the navigation bar's title \"${title}\" ${problem}.`);\n}\n","import type { ColorScheme, NavigationBarOptions } from '@monimesl/dot-core';\nimport { contrast, READABLE_CONTRAST } from '@monimesl/dot-core';\n\n// Each warning shows once, so a page that changes its bars often doesn't fill the console.\nconst shownWarnings = new Set<string>();\n\n// In development: warns when text colours the dot picks are hard to read on their backgrounds.\n// Colours Dash picks itself always read well. `textColor` is the page's or the theme's, if set.\nexport function warnOnPoorContrast(\n pageId: string,\n navigationBar: NavigationBarOptions,\n scheme: ColorScheme,\n textColor: string | undefined,\n background: string,\n): void {\n const { backgroundColor: barBackground, textColor: barText } = navigationBar;\n if (barBackground && barText) {\n warnIfHardToRead(\n `Page \"${pageId}\": the navigation bar's textColor ${barText} on its backgroundColor ${barBackground}`,\n barText,\n barBackground,\n 'leave textColor out so Dash picks one',\n );\n }\n if (textColor) {\n warnIfHardToRead(\n `Page \"${pageId}\": the ${scheme} text ${textColor} on the page's background ${background}`,\n textColor,\n background,\n 'leave the text color out so Dash picks one',\n );\n }\n}\n\nfunction warnIfHardToRead(\n subject: string,\n textColor: string,\n background: string,\n advice: string,\n): void {\n const ratio = contrast(textColor, background);\n if (ratio >= READABLE_CONTRAST || shownWarnings.has(subject)) {\n return;\n }\n shownWarnings.add(subject);\n console.warn(\n `[dot] ${subject} is hard to read. Its contrast is ${ratio.toFixed(1)}, and text needs at least ${READABLE_CONTRAST}. Pick colours further apart, or ${advice}.`,\n );\n}\n","import { HostError } from '@monimesl/dot-core';\n\nexport function cancelledError(method: string): HostError {\n return new HostError('cancelled', `\"${method}\" was cancelled`);\n}\n","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';\nimport { cancelledError } from './host-errors';\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(cancelledError(call.method));\n }\n\n #settle(result: HostResult): void {\n const call = this.#waiting.get(result.id);\n // A cancelled call may still get a late answer from the host. Ignore it.\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 NavigationBarOptions,\n PageBars,\n PageConfigs,\n PageShare,\n PageHooks,\n PageLaunchOptions,\n PageState,\n PageColors,\n TabBarOptions,\n} from '@monimesl/dot-core';\nimport {\n applyChanges,\n checkColors,\n checkConfigs,\n checkNavigationBar,\n checkTabBar,\n mergeColors,\n mergeConfigs,\n} from '@monimesl/dot-core';\nimport type { Dash, DashRequest } from '@monimesl/dot-dash';\nimport { dash, tracked } from '@monimesl/dot-dash';\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 make TypeScript test the\n// ids as a whole, not one by one.\nexport type PageId = [keyof DotPageIds] extends [never]\n ? string\n : Extract<keyof DotPageIds, string>;\n\n// The navigation pushForResult asks for: a page on top.\nexport interface PushNavigation {\n readonly action: 'push';\n readonly page: string;\n readonly options: PageLaunchOptions;\n}\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 // Opens `page` on top, and resolves with what it gives back with `backWithResult`, or undefined\n // if it closes without one, as when the person goes back.\n pushForResult<Result = unknown>(\n page: PageId,\n options?: PageLaunchOptions,\n ): Promise<Result | undefined>;\n\n // Closes this page, and gives `result` to the page below if it opened this one with\n // `pushForResult`.\n backWithResult(result: unknown): 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 because TypeScript checks method parameters loosely. That lets a handler\n// narrow its event, such as `(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`, which another handler passes when it calls it.\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 // Dash's features. Calls still running when the page closes are cancelled.\n readonly dash: Dash;\n\n setState(update: StateUpdate<S>): void;\n\n // Changes Dash's navigation bar on this page, on top of what definePage set.\n setNavigationBar(options: NavigationBarOptions): void;\n\n // Hides or shows Dash's tab bar while this page shows.\n setTabBar(options: TabBarOptions): void;\n\n // Changes this page's colours, on top of what definePage set, such as\n // { background: { light: \"#FFF3E0\" } }. Set `light` or `dark` to undefined to use the theme's\n // colour again.\n setColors(colors: PageColors): 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 // Dash's bars and the page's colours, on top of `defineDot`'s `configs`. See `PageConfigs`.\n configs?: PageConfigs;\n // Lets Dash's Share open this page, with these of its options. Without it, Share opens the dot's\n // first page. Write it out in place, as the build reads it without running the code.\n share?: PageShare;\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 configs?: PageConfigs;\n readonly share?: PageShare;\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 // The page's bars changed.\n showBars(page: Page): void;\n\n // defineDot's configs. The page's own configs override them.\n readonly dotConfigs?: PageConfigs | undefined;\n\n navigate(page: Page, navigation: Navigation): void;\n\n // Opens a page on top of `page`, which waits for what that page gives back.\n pushForResult(page: Page, navigation: PushNavigation): Promise<unknown>;\n\n backWithResult(page: Page, result: unknown): void;\n\n readonly strict?: boolean;\n}\n\n// What a page keeps from the copy it replaces, such as after a hot reload.\nexport interface RestoredPage<S> {\n readonly state: State<S>;\n readonly barChanges: PageBars;\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 dash: Dash = tracked(dash, (request) => this.#track(request));\n readonly #definition: PageDefinition<S>;\n readonly #host: PageHost;\n #state: State<S>;\n #closed = false;\n readonly #dashRequests = new Set<DashRequest<unknown>>();\n #previousHook: Promise<unknown> = Promise.resolve();\n // Bar changes the page made while running, on top of its configs.\n #barChanges: PageBars;\n\n constructor(\n instanceId: number,\n id: string,\n definition: PageDefinition<S>,\n host: PageHost,\n restored?: RestoredPage<S>,\n ) {\n this.id = id;\n this.instanceId = instanceId;\n this.#definition = definition;\n this.#host = host;\n if (restored) {\n this.#state = this.#freeze(restored.state);\n this.#barChanges = restored.barChanges;\n } else {\n const copy = JSON.parse(JSON.stringify(definition.initialState)) as State<S>;\n this.#state = this.#freeze(copy);\n this.#barChanges = { navigationBar: {}, tabBar: {}, colors: {} };\n }\n checkConfigs(definition.configs ?? {});\n\n const { mutations = {}, actions = {} } = definition;\n const sharedName = Object.keys(mutations).find((name) => name in actions);\n if (sharedName) {\n throw new Error(\n `Page \"${id}\" uses \"${sharedName}\" as both a mutation and an action. Rename one of them`,\n );\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 // Whether the person can pull the page down to refresh it.\n get refreshable(): boolean {\n return this.#definition.hooks?.onRefresh !== undefined;\n }\n\n get bars(): PageBars {\n return mergeConfigs(this.#host.dotConfigs, this.#definition.configs, this.#barChanges);\n }\n\n get barChanges(): PageBars {\n return this.#barChanges;\n }\n\n setNavigationBar(options: NavigationBarOptions): void {\n checkNavigationBar(options);\n const navigationBar = { ...this.#barChanges.navigationBar, ...options };\n this.#changeBars({ ...this.#barChanges, navigationBar });\n }\n\n setTabBar(options: TabBarOptions): void {\n checkTabBar(options);\n const tabBar = { ...this.#barChanges.tabBar, ...options };\n this.#changeBars({ ...this.#barChanges, tabBar });\n }\n\n setColors(colors: PageColors): void {\n checkColors(colors);\n const mergedColors = mergeColors(this.#barChanges.colors, colors);\n this.#changeBars({ ...this.#barChanges, colors: mergedColors });\n }\n\n #changeBars(barChanges: PageBars): void {\n if (this.#closed) {\n return;\n }\n this.#barChanges = barChanges;\n this.#host.showBars(this as Page);\n }\n\n setState(update: StateUpdate<S>): void {\n if (this.#closed) {\n return;\n }\n let changes: StateChanges<S> | undefined;\n if (typeof update === 'function') {\n changes = update(this.#state);\n } else {\n changes = update;\n }\n if (changes === undefined) {\n return;\n }\n const next = applyChanges(this.#state, changes);\n const patch = this.#changedKeys(next);\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 #changedKeys(next: State<S>): PageState {\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 return patch;\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 doesn't 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 for (const request of this.#dashRequests) {\n request.cancel();\n }\n this.#dashRequests.clear();\n }\n\n #track(request: DashRequest<unknown>): void {\n // An action still running after the page closed mustn't reach the person, so its calls stop.\n if (this.#closed) {\n request.cancel();\n return;\n }\n this.#dashRequests.add(request);\n const forget = () => this.#dashRequests.delete(request);\n void request.then(forget, forget);\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 pushForResult: <Result>(page: PageId, options: PageLaunchOptions = {}) => {\n if (this.#closed) {\n return Promise.resolve(undefined);\n }\n const result = this.#host.pushForResult(this as Page, { action: 'push', page, options });\n return result as Promise<Result | undefined>;\n },\n backWithResult: (result) => {\n if (!this.#closed) {\n this.#host.backWithResult(this as Page, result);\n }\n },\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 if (this.#host.strict) {\n return deepFreeze(state);\n }\n return 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 dash: Dash;\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.dash = page.dash;\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 readonly setNavigationBar = (options: NavigationBarOptions): void => {\n this.#page.setNavigationBar(options);\n };\n\n readonly setTabBar = (options: TabBarOptions): void => {\n this.#page.setTabBar(options);\n };\n\n readonly setColors = (colors: PageColors): void => {\n this.#page.setColors(colors);\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 for (const child of Object.values(value)) {\n deepFreeze(child);\n }\n }\n return value;\n}\n","import type {\n DotHooks,\n DotEvent,\n Envelope,\n HostCaller,\n HostLayerMessages,\n LogicLayerMessages,\n Navigation,\n PageConfigs,\n PageLaunchOptions,\n PageState,\n SystemContext,\n Theme,\n Transport,\n UILayerMessages,\n} from '@monimesl/dot-core';\nimport {\n DEFAULT_SYSTEM_CONTEXT,\n checkConfigs,\n connectHost,\n EventEmitter,\n MAX_STACK_DEPTH,\n MessageChannel,\n pageBackground,\n themeScheme,\n withSystemDefaults,\n} from '@monimesl/dot-core';\nimport { useHostDashApiVersions, warnAboveDashApiVersion } from '@monimesl/dot-dash';\n\nimport { warnOnBarTitle } from './bar-title';\nimport { warnOnPoorContrast } from './contrast';\nimport { HostCalls } from './host-calls';\nimport type { PageDefinition, PushNavigation, RestoredPage } 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 go to the view layer.\n setState(page: Page, patch: PageState): void;\n\n // `instanceId` is set when the error came from a 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 // Dash's bars and the colours of every page. A page's own configs override them.\n readonly configs?: PageConfigs;\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 // While developing, the dot's minApiVersion from dot.json, so Dash calls newer than it are pointed out.\n dashMinApiVersion?: string | undefined;\n}\n\n// The logic layer. It owns every page's state, runs handlers, and sends state changes to the\n// view layer.\nexport class Service implements DotContext {\n readonly channel: ServiceChannel;\n readonly hooks = new EventEmitter<ServiceHooks>();\n #definitions: Record<string, PageDefinition>;\n readonly #pages = new Map<number, Page>();\n readonly #dot: Partial<DotDefinition>;\n readonly #strict: boolean;\n readonly #development: boolean;\n #theme: Theme;\n #systemContext: SystemContext = DEFAULT_SYSTEM_CONTEXT;\n #stack: HostLayerMessages['syncStack'] = { pages: [], limit: MAX_STACK_DEPTH };\n // How each page waiting for a result from a page it opened with pushForResult gets it.\n readonly #awaitingResults = new Map<number, (result: unknown) => void>();\n // Results given with backWithResult, kept for the page below until it shows again.\n readonly #results = new Map<number, unknown>();\n readonly #hostCalls: HostCalls;\n\n constructor({ transport, pages, dot = {}, strict = false, dashMinApiVersion }: 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 // Only development builds pass the Dash API version, so only they warn about it.\n this.#development = dashMinApiVersion !== undefined;\n if (dashMinApiVersion !== undefined) {\n warnAboveDashApiVersion(dashMinApiVersion);\n }\n this.#theme = dot.theme ?? {};\n checkConfigs(dot.configs ?? {});\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 const previousScheme = this.#systemContext.scheme;\n this.#systemContext = withSystemDefaults(context);\n useHostDashApiVersions(this.#systemContext.dashApiVersions);\n if (this.#systemContext.scheme !== previousScheme) {\n this.#resendBars();\n }\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 // The page it opened has closed, with or without a result.\n this.#settleResult(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('refresh', ({ instanceId }) => {\n const page = this.getPage(instanceId);\n const refresh = page.lifecycle('onRefresh').finally(() => {\n this.channel.send('refreshed', { instanceId });\n });\n this.reportError(refresh, 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 const stopWatchingUncaught = this.#watchUncaughtErrors();\n connectHost(this.callHost);\n this.hooks.emit('launch');\n this.reportError(this.#runLaunchHook());\n return () => {\n stopListening();\n stopWatchingUncaught();\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 this.#resendBars();\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 // Runs a host call, such as `dash.ui.alert`, through this service's channel.\n readonly callHost: HostCaller = (method, params, options) =>\n this.#hostCalls.call(method, params, options);\n\n loadPage(instanceId: number, id: string, options: PageLaunchOptions = {}): Page {\n const page = this.#createPage(instanceId, id);\n this.#sendInitialState(page);\n this.#sendBars(page);\n this.hooks.emit('pageLoad', page);\n this.reportError(page.lifecycle('onLoad', options), instanceId);\n return page;\n }\n\n // Swaps in a newer build's pages on a hot reload. A page restarts only if its initialState\n // changed.\n replacePages(definitions: Record<string, PageDefinition>): void {\n const previousDefinitions = this.#definitions;\n this.#definitions = definitions;\n for (const [instanceId, page] of this.#pages) {\n const definition = definitions[page.id];\n // A page the new build no longer has keeps its old code until it closes.\n if (!definition) {\n continue;\n }\n page.close();\n const previousInitialState = previousDefinitions[page.id]?.initialState;\n if (JSON.stringify(previousInitialState) !== JSON.stringify(definition.initialState)) {\n this.loadPage(instanceId, page.id, this.#launchOptions(instanceId));\n } else {\n this.#keepPage(page);\n }\n }\n }\n\n #keepPage(page: Page): void {\n const kept = this.#createPage(page.instanceId, page.id, {\n state: page.state,\n barChanges: page.barChanges,\n });\n // The new definePage may set other configs, or add or drop onRefresh.\n this.#sendBars(kept);\n if (kept.refreshable !== page.refreshable) {\n this.#sendInitialState(kept);\n }\n }\n\n #sendInitialState(page: Page): void {\n this.channel.send('initPageState', {\n instanceId: page.instanceId,\n state: page.state,\n refreshable: page.refreshable,\n });\n }\n\n // The options the page was opened with, so its onLoad can run again with them.\n #launchOptions(instanceId: number): PageLaunchOptions | undefined {\n const entry = this.#stack.pages.find((stackEntry) => stackEntry.instanceId === instanceId);\n return entry?.options;\n }\n\n #createPage(instanceId: number, id: string, restored?: RestoredPage<PageState>): Page {\n const page = new Page(\n instanceId,\n id,\n this.#definition(id),\n {\n commit: (page, patch) => {\n this.hooks.emit('setState', page, patch);\n this.channel.send('setPageState', { instanceId: page.instanceId, patchState: patch });\n },\n showBars: (page) => this.#sendBars(page),\n dotConfigs: this.#dot.configs,\n navigate: (page, navigation) => this.#navigate(page, navigation),\n pushForResult: (page, navigation) => this.#pushForResult(page, navigation),\n backWithResult: (page, result) => this.#backWithResult(page, result),\n strict: this.#strict,\n },\n restored,\n );\n this.#pages.set(instanceId, page);\n return page;\n }\n\n #navigate(page: Page, navigation: Navigation): void {\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 `Can't open \"${navigation.page}\", as ${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\n #pushForResult(page: Page, navigation: PushNavigation): Promise<unknown> {\n // A result it was still waiting for can't come now.\n this.#settleResult(page.instanceId);\n // When the page can't open, the promise rejects with the reason.\n return new Promise((resolve) => {\n this.#navigate(page, navigation);\n this.#awaitingResults.set(page.instanceId, resolve);\n });\n }\n\n #backWithResult(page: Page, result: unknown): void {\n const { pages } = this.#stack;\n const index = pages.findIndex((entry) => entry.instanceId === page.instanceId);\n if (index > 0) {\n const below = pages[index - 1]!;\n this.#results.set(below.instanceId, result);\n }\n this.#navigate(page, { action: 'back', delta: 1 });\n }\n\n // Ends the page's wait for a result: with the one kept for it, or undefined without one.\n #settleResult(instanceId: number): void {\n const result = this.#results.get(instanceId);\n this.#results.delete(instanceId);\n const resolve = this.#awaitingResults.get(instanceId);\n this.#awaitingResults.delete(instanceId);\n resolve?.(result);\n }\n\n // The host gets the background as the dot shows it now; the webview gets the page's colours.\n #sendBars(page: Page): void {\n const { navigationBar, tabBar, colors } = page.bars;\n const deviceScheme = this.#systemContext.scheme;\n const background = pageBackground(colors.background, this.#theme, deviceScheme);\n this.channel.send('pageBars', {\n instanceId: page.instanceId,\n navigationBar,\n tabBar,\n background,\n });\n this.channel.send('pageColors', { instanceId: page.instanceId, colors });\n if (this.#development) {\n const scheme = themeScheme(this.#theme, deviceScheme);\n const textColor = colors.text?.[scheme] ?? this.#theme.colors?.text?.[scheme];\n warnOnPoorContrast(page.id, navigationBar, scheme, textColor, background);\n warnOnBarTitle(page.id, navigationBar.title);\n }\n }\n\n // A new theme or scheme can change the background every open page shows.\n #resendBars(): void {\n for (const page of this.#pages.values()) {\n this.#sendBars(page);\n }\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.#settleResult(instanceId);\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(`There's no page \"${id}\". Check the name, and that dot.ts lists it in pages`);\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, uncaught = false): 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 if (reason.stack !== undefined) {\n report.stack = reason.stack;\n }\n if (uncaught) {\n report.uncaught = true;\n }\n this.channel.send('error', report);\n }\n\n // Only some engines have global error events, such as a browser's Web Worker. Elsewhere the native\n // host catches what it can itself.\n #watchUncaughtErrors(): () => void {\n const scope = globalThis as ErrorEventScope;\n const addListener = scope.addEventListener;\n const removeListener = scope.removeEventListener;\n if (addListener === undefined || removeListener === undefined) {\n return () => {};\n }\n const onError = (event: UncaughtErrorEvent) => {\n this.#reportError(event.error ?? event.message, undefined, true);\n };\n const onRejection = (event: UncaughtErrorEvent) => {\n this.#reportError(event.reason, undefined, true);\n };\n addListener.call(scope, 'error', onError);\n addListener.call(scope, 'unhandledrejection', onRejection);\n return () => {\n removeListener.call(scope, 'error', onError);\n removeListener.call(scope, 'unhandledrejection', onRejection);\n };\n }\n}\n\n// What the service reads of a global scope's error events, as dots type-check without the DOM.\ninterface ErrorEventScope {\n addEventListener?: (type: string, listener: (event: UncaughtErrorEvent) => void) => void;\n removeEventListener?: (type: string, listener: (event: UncaughtErrorEvent) => void) => void;\n}\n\n// An `error` event has `error` and `message`; an `unhandledrejection` event has `reason`.\ninterface UncaughtErrorEvent {\n error?: unknown;\n message?: string;\n reason?: unknown;\n}\n\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":";;;AAEA,MAAM,+BAAe,IAAI,IAAY;AAGrC,SAAgB,eAAe,QAAgB,OAAiC;CAC9E,IAAI,UAAU,KAAA,KAAa,aAAa,IAAI,KAAK,GAC/C;CAEF,IAAI;CACJ,IAAI,kBAAkB,KAAK,GACzB,UACE;MACG,IAAI,MAAM,SAAS,sBACxB,UAAU,kBAAkB,qBAAqB;CAEnD,IAAI,YAAY,KAAA,GACd;CAEF,aAAa,IAAI,KAAK;CACtB,QAAQ,KAAK,eAAe,OAAO,iCAAiC,MAAM,IAAI,QAAQ,EAAE;AAC1F;;;ACjBA,MAAM,gCAAgB,IAAI,IAAY;AAItC,SAAgB,mBACd,QACA,eACA,QACA,WACA,YACM;CACN,MAAM,EAAE,iBAAiB,eAAe,WAAW,YAAY;CAC/D,IAAI,iBAAiB,SACnB,iBACE,SAAS,OAAO,oCAAoC,QAAQ,0BAA0B,iBACtF,SACA,eACA,uCACF;CAEF,IAAI,WACF,iBACE,SAAS,OAAO,SAAS,OAAO,QAAQ,UAAU,4BAA4B,cAC9E,WACA,YACA,4CACF;AAEJ;AAEA,SAAS,iBACP,SACA,WACA,YACA,QACM;CACN,MAAM,QAAQ,SAAS,WAAW,UAAU;CAC5C,IAAI,SAAS,qBAAqB,cAAc,IAAI,OAAO,GACzD;CAEF,cAAc,IAAI,OAAO;CACzB,QAAQ,KACN,SAAS,QAAQ,oCAAoC,MAAM,QAAQ,CAAC,EAAE,4BAA4B,kBAAkB,mCAAmC,OAAO,EAChK;AACF;;;AC9CA,SAAgB,eAAe,QAA2B;CACxD,OAAO,IAAI,UAAU,aAAa,IAAI,OAAO,gBAAgB;AAC/D;;;ACcA,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,eAAe,KAAK,MAAM,CAAC;CACzC;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;;;AC4EA,SAAgB,WAId,SAAoD;CACpD,OAAO;AACT;AAgCA,IAAa,OAAb,MAAmD;CACjD;CACA;CACA;CACA;CACA,OAAsB,QAAQ,OAAO,YAAY,KAAK,OAAO,OAAO,CAAC;CACrE;CACA;CACA;CACA,UAAU;CACV,gCAAyB,IAAI,IAA0B;CACvD,gBAAkC,QAAQ,QAAQ;CAElD;CAEA,YACE,YACA,IACA,YACA,MACA,UACA;EACA,KAAK,KAAK;EACV,KAAK,aAAa;EAClB,KAAK,cAAc;EACnB,KAAK,QAAQ;EACb,IAAI,UAAU;GACZ,KAAK,SAAS,KAAK,QAAQ,SAAS,KAAK;GACzC,KAAK,cAAc,SAAS;EAC9B,OAAO;GACL,MAAM,OAAO,KAAK,MAAM,KAAK,UAAU,WAAW,YAAY,CAAC;GAC/D,KAAK,SAAS,KAAK,QAAQ,IAAI;GAC/B,KAAK,cAAc;IAAE,eAAe,CAAC;IAAG,QAAQ,CAAC;IAAG,QAAQ,CAAC;GAAE;EACjE;EACA,aAAa,WAAW,WAAW,CAAC,CAAC;EAErC,MAAM,EAAE,YAAY,CAAC,GAAG,UAAU,CAAC,MAAM;EACzC,MAAM,aAAa,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM,SAAS,QAAQ,OAAO;EACxE,IAAI,YACF,MAAM,IAAI,MACR,SAAS,GAAG,UAAU,WAAW,uDACnC;EAGF,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;CAGA,IAAI,cAAuB;EACzB,OAAO,KAAK,YAAY,OAAO,cAAc,KAAA;CAC/C;CAEA,IAAI,OAAiB;EACnB,OAAO,aAAa,KAAK,MAAM,YAAY,KAAK,YAAY,SAAS,KAAK,WAAW;CACvF;CAEA,IAAI,aAAuB;EACzB,OAAO,KAAK;CACd;CAEA,iBAAiB,SAAqC;EACpD,mBAAmB,OAAO;EAC1B,MAAM,gBAAgB;GAAE,GAAG,KAAK,YAAY;GAAe,GAAG;EAAQ;EACtE,KAAK,YAAY;GAAE,GAAG,KAAK;GAAa;EAAc,CAAC;CACzD;CAEA,UAAU,SAA8B;EACtC,YAAY,OAAO;EACnB,MAAM,SAAS;GAAE,GAAG,KAAK,YAAY;GAAQ,GAAG;EAAQ;EACxD,KAAK,YAAY;GAAE,GAAG,KAAK;GAAa;EAAO,CAAC;CAClD;CAEA,UAAU,QAA0B;EAClC,YAAY,MAAM;EAClB,MAAM,eAAe,YAAY,KAAK,YAAY,QAAQ,MAAM;EAChE,KAAK,YAAY;GAAE,GAAG,KAAK;GAAa,QAAQ;EAAa,CAAC;CAChE;CAEA,YAAY,YAA4B;EACtC,IAAI,KAAK,SACP;EAEF,KAAK,cAAc;EACnB,KAAK,MAAM,SAAS,IAAY;CAClC;CAEA,SAAS,QAA8B;EACrC,IAAI,KAAK,SACP;EAEF,IAAI;EACJ,IAAI,OAAO,WAAW,YACpB,UAAU,OAAO,KAAK,MAAM;OAE5B,UAAU;EAEZ,IAAI,YAAY,KAAA,GACd;EAEF,MAAM,OAAO,aAAa,KAAK,QAAQ,OAAO;EAC9C,MAAM,QAAQ,KAAK,aAAa,IAAI;EACpC,KAAK,SAAS,KAAK,QAAQ,IAAI;EAC/B,IAAI,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GAC9B,KAAK,MAAM,OAAO,MAAc,KAAK;CAEzC;CAEA,aAAa,MAA2B;EACtC,MAAM,QAAmB,CAAC;EAC1B,KAAK,MAAM,OAAO,OAAO,KAAK,IAAI,GAChC,IAAI,KAAK,SAAS,KAAK,OAAO,MAC5B,MAAM,OAAO,KAAK;EAGtB,OAAO;CACT;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;EACf,KAAK,MAAM,WAAW,KAAK,eACzB,QAAQ,OAAO;EAEjB,KAAK,cAAc,MAAM;CAC3B;CAEA,OAAO,SAAqC;EAE1C,IAAI,KAAK,SAAS;GAChB,QAAQ,OAAO;GACf;EACF;EACA,KAAK,cAAc,IAAI,OAAO;EAC9B,MAAM,eAAe,KAAK,cAAc,OAAO,OAAO;EACtD,QAAa,KAAK,QAAQ,MAAM;CAClC;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;GAC7D,gBAAwB,MAAc,UAA6B,CAAC,MAAM;IACxE,IAAI,KAAK,SACP,OAAO,QAAQ,QAAQ,KAAA,CAAS;IAGlC,OADe,KAAK,MAAM,cAAc,MAAc;KAAE,QAAQ;KAAQ;KAAM;IAAQ,CAC1E;GACd;GACA,iBAAiB,WAAW;IAC1B,IAAI,CAAC,KAAK,SACR,KAAK,MAAM,eAAe,MAAc,MAAM;GAElD;EACF;CACF;CAEA,UAAU,YAA8B;EACtC,IAAI,CAAC,KAAK,SACR,KAAK,MAAM,SAAS,MAAc,UAAU;CAEhD;CAEA,QAAQ,OAA2B;EACjC,IAAI,KAAK,MAAM,QACb,OAAO,WAAW,KAAK;EAEzB,OAAO;CACT;AACF;AAGA,IAAM,cAAN,MAA2F;CACzF;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,MAAe,WAA6B,SAAyB;EAC/E,KAAK,KAAK,KAAK;EACf,KAAK,aAAa,KAAK;EACvB,KAAK,OAAO,KAAK;EACjB,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;CAEA,oBAA6B,YAAwC;EACnE,KAAK,MAAM,iBAAiB,OAAO;CACrC;CAEA,aAAsB,YAAiC;EACrD,KAAK,MAAM,UAAU,OAAO;CAC9B;CAEA,aAAsB,WAA6B;EACjD,KAAK,MAAM,UAAU,MAAM;CAC7B;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,KAAK,MAAM,SAAS,OAAO,OAAO,KAAK,GACrC,WAAW,KAAK;CAEpB;CACA,OAAO;AACT;;;ACjZA,SAAgB,UAAU,KAAmC;CAC3D,OAAO;AACT;AAaA,IAAa,UAAb,MAA2C;CACzC;CACA,QAAiB,IAAI,aAA2B;CAChD;CACA,yBAAkB,IAAI,IAAkB;CACxC;CACA;CACA;CACA;CACA,iBAAgC;CAChC,SAAyC;EAAE,OAAO,CAAC;EAAG,OAAO;CAAgB;CAE7E,mCAA4B,IAAI,IAAuC;CAEvE,2BAAoB,IAAI,IAAqB;CAC7C;CAEA,YAAY,EAAE,WAAW,OAAO,MAAM,CAAC,GAAG,SAAS,OAAO,qBAAqC;EAC7F,KAAK,UAAU,IAAI,eAAe,SAAS;EAC3C,KAAK,aAAa,IAAI,UAAU,KAAK,OAAO;EAC5C,KAAK,eAAe;EACpB,KAAK,OAAO;EACZ,KAAK,UAAU;EAEf,KAAK,eAAe,sBAAsB,KAAA;EAC1C,IAAI,sBAAsB,KAAA,GACxB,wBAAwB,iBAAiB;EAE3C,KAAK,SAAS,IAAI,SAAS,CAAC;EAC5B,aAAa,IAAI,WAAW,CAAC,CAAC;EAE9B,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,MAAM,iBAAiB,KAAK,eAAe;GAC3C,KAAK,iBAAiB,mBAAmB,OAAO;GAChD,uBAAuB,KAAK,eAAe,eAAe;GAC1D,IAAI,KAAK,eAAe,WAAW,gBACjC,KAAK,YAAY;EAErB,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;GAEpC,KAAK,cAAc,UAAU;GAC7B,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,YAAY,EAAE,iBAAiB;GAEjD,MAAM,UADO,KAAK,QAAQ,UACP,CAAC,CAAC,UAAU,WAAW,CAAC,CAAC,cAAc;IACxD,KAAK,QAAQ,KAAK,aAAa,EAAE,WAAW,CAAC;GAC/C,CAAC;GACD,KAAK,YAAY,SAAS,UAAU;EACtC,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;EACD,MAAM,uBAAuB,KAAK,qBAAqB;EACvD,YAAY,KAAK,QAAQ;EACzB,KAAK,MAAM,KAAK,QAAQ;EACxB,KAAK,YAAY,KAAK,eAAe,CAAC;EACtC,aAAa;GACX,cAAc;GACd,qBAAqB;GACrB,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;EACvC,KAAK,YAAY;CACnB;CAEA,QAAQ,YAA0B;EAChC,MAAM,OAAO,KAAK,OAAO,IAAI,UAAU;EACvC,IAAI,CAAC,MACH,MAAM,IAAI,MAAM,iBAAiB,WAAW,eAAe;EAE7D,OAAO;CACT;CAGA,YAAiC,QAAQ,QAAQ,YAC/C,KAAK,WAAW,KAAK,QAAQ,QAAQ,OAAO;CAE9C,SAAS,YAAoB,IAAY,UAA6B,CAAC,GAAS;EAC9E,MAAM,OAAO,KAAK,YAAY,YAAY,EAAE;EAC5C,KAAK,kBAAkB,IAAI;EAC3B,KAAK,UAAU,IAAI;EACnB,KAAK,MAAM,KAAK,YAAY,IAAI;EAChC,KAAK,YAAY,KAAK,UAAU,UAAU,OAAO,GAAG,UAAU;EAC9D,OAAO;CACT;CAIA,aAAa,aAAmD;EAC9D,MAAM,sBAAsB,KAAK;EACjC,KAAK,eAAe;EACpB,KAAK,MAAM,CAAC,YAAY,SAAS,KAAK,QAAQ;GAC5C,MAAM,aAAa,YAAY,KAAK;GAEpC,IAAI,CAAC,YACH;GAEF,KAAK,MAAM;GACX,MAAM,uBAAuB,oBAAoB,KAAK,GAAG,EAAE;GAC3D,IAAI,KAAK,UAAU,oBAAoB,MAAM,KAAK,UAAU,WAAW,YAAY,GACjF,KAAK,SAAS,YAAY,KAAK,IAAI,KAAK,eAAe,UAAU,CAAC;QAElE,KAAK,UAAU,IAAI;EAEvB;CACF;CAEA,UAAU,MAAkB;EAC1B,MAAM,OAAO,KAAK,YAAY,KAAK,YAAY,KAAK,IAAI;GACtD,OAAO,KAAK;GACZ,YAAY,KAAK;EACnB,CAAC;EAED,KAAK,UAAU,IAAI;EACnB,IAAI,KAAK,gBAAgB,KAAK,aAC5B,KAAK,kBAAkB,IAAI;CAE/B;CAEA,kBAAkB,MAAkB;EAClC,KAAK,QAAQ,KAAK,iBAAiB;GACjC,YAAY,KAAK;GACjB,OAAO,KAAK;GACZ,aAAa,KAAK;EACpB,CAAC;CACH;CAGA,eAAe,YAAmD;EAEhE,OADc,KAAK,OAAO,MAAM,MAAM,eAAe,WAAW,eAAe,UACpE,CAAC,EAAE;CAChB;CAEA,YAAY,YAAoB,IAAY,UAA0C;EACpF,MAAM,OAAO,IAAI,KACf,YACA,IACA,KAAK,YAAY,EAAE,GACnB;GACE,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,SAAS,KAAK,UAAU,IAAI;GACvC,YAAY,KAAK,KAAK;GACtB,WAAW,MAAM,eAAe,KAAK,UAAU,MAAM,UAAU;GAC/D,gBAAgB,MAAM,eAAe,KAAK,eAAe,MAAM,UAAU;GACzE,iBAAiB,MAAM,WAAW,KAAK,gBAAgB,MAAM,MAAM;GACnE,QAAQ,KAAK;EACf,GACA,QACF;EACA,KAAK,OAAO,IAAI,YAAY,IAAI;EAChC,OAAO;CACT;CAEA,UAAU,MAAY,YAA8B;EAClD,IAAI,WAAW,WAAW,QACxB,KAAK,YAAY,WAAW,IAAI;EAElC,MAAM,EAAE,OAAO,UAAU,KAAK;EAC9B,IAAI,WAAW,WAAW,UAAU,MAAM,UAAU,OAClD,MAAM,IAAI,MACR,eAAe,WAAW,KAAK,QAAQ,MAAM,8CAC/C;EAEF,KAAK,MAAM,KAAK,YAAY,MAAM,UAAU;EAC5C,KAAK,QAAQ,KAAK,YAAY;GAAE,GAAG;GAAY,MAAM,KAAK;EAAW,CAAC;CACxE;CAEA,eAAe,MAAY,YAA8C;EAEvE,KAAK,cAAc,KAAK,UAAU;EAElC,OAAO,IAAI,SAAS,YAAY;GAC9B,KAAK,UAAU,MAAM,UAAU;GAC/B,KAAK,iBAAiB,IAAI,KAAK,YAAY,OAAO;EACpD,CAAC;CACH;CAEA,gBAAgB,MAAY,QAAuB;EACjD,MAAM,EAAE,UAAU,KAAK;EACvB,MAAM,QAAQ,MAAM,WAAW,UAAU,MAAM,eAAe,KAAK,UAAU;EAC7E,IAAI,QAAQ,GAAG;GACb,MAAM,QAAQ,MAAM,QAAQ;GAC5B,KAAK,SAAS,IAAI,MAAM,YAAY,MAAM;EAC5C;EACA,KAAK,UAAU,MAAM;GAAE,QAAQ;GAAQ,OAAO;EAAE,CAAC;CACnD;CAGA,cAAc,YAA0B;EACtC,MAAM,SAAS,KAAK,SAAS,IAAI,UAAU;EAC3C,KAAK,SAAS,OAAO,UAAU;EAC/B,MAAM,UAAU,KAAK,iBAAiB,IAAI,UAAU;EACpD,KAAK,iBAAiB,OAAO,UAAU;EACvC,UAAU,MAAM;CAClB;CAGA,UAAU,MAAkB;EAC1B,MAAM,EAAE,eAAe,QAAQ,WAAW,KAAK;EAC/C,MAAM,eAAe,KAAK,eAAe;EACzC,MAAM,aAAa,eAAe,OAAO,YAAY,KAAK,QAAQ,YAAY;EAC9E,KAAK,QAAQ,KAAK,YAAY;GAC5B,YAAY,KAAK;GACjB;GACA;GACA;EACF,CAAC;EACD,KAAK,QAAQ,KAAK,cAAc;GAAE,YAAY,KAAK;GAAY;EAAO,CAAC;EACvE,IAAI,KAAK,cAAc;GACrB,MAAM,SAAS,YAAY,KAAK,QAAQ,YAAY;GACpD,MAAM,YAAY,OAAO,OAAO,WAAW,KAAK,OAAO,QAAQ,OAAO;GACtE,mBAAmB,KAAK,IAAI,eAAe,QAAQ,WAAW,UAAU;GACxE,eAAe,KAAK,IAAI,cAAc,KAAK;EAC7C;CACF;CAGA,cAAoB;EAClB,KAAK,MAAM,QAAQ,KAAK,OAAO,OAAO,GACpC,KAAK,UAAU,IAAI;CAEvB;CAEA,WAAW,YAA0B;EACnC,MAAM,OAAO,KAAK,OAAO,IAAI,UAAU;EACvC,IAAI,CAAC,MACH;EAEF,KAAK,OAAO,OAAO,UAAU;EAC7B,KAAK,MAAM;EACX,KAAK,cAAc,UAAU;EAC7B,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,oBAAoB,GAAG,qDAAqD;EAE9F,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,YAAgC,WAAW,OAAa;EACnF,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,IAAI,OAAO,UAAU,KAAA,GACnB,OAAO,QAAQ,OAAO;EAExB,IAAI,UACF,OAAO,WAAW;EAEpB,KAAK,QAAQ,KAAK,SAAS,MAAM;CACnC;CAIA,uBAAmC;EACjC,MAAM,QAAQ;EACd,MAAM,cAAc,MAAM;EAC1B,MAAM,iBAAiB,MAAM;EAC7B,IAAI,gBAAgB,KAAA,KAAa,mBAAmB,KAAA,GAClD,aAAa,CAAC;EAEhB,MAAM,WAAW,UAA8B;GAC7C,KAAK,aAAa,MAAM,SAAS,MAAM,SAAS,KAAA,GAAW,IAAI;EACjE;EACA,MAAM,eAAe,UAA8B;GACjD,KAAK,aAAa,MAAM,QAAQ,KAAA,GAAW,IAAI;EACjD;EACA,YAAY,KAAK,OAAO,SAAS,OAAO;EACxC,YAAY,KAAK,OAAO,sBAAsB,WAAW;EACzD,aAAa;GACX,eAAe,KAAK,OAAO,SAAS,OAAO;GAC3C,eAAe,KAAK,OAAO,sBAAsB,WAAW;EAC9D;CACF;AACF;AAeA,SAAS,aAAa,SAAuC;CAC3D,MAAM,UAAU,QAAQ;CACxB,IAAI,OAAO,SAAS,eAAe,UACjC,OAAO,QAAQ;AAGnB"}
@@ -1 +1 @@
1
- {"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import type {\n DotEvent,\n HostCaller,\n Navigation,\n PageBars,\n PageLaunchOptions,\n PageState,\n} 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';\nimport { cancelledError } from './host-errors';\n\n// A dot's code uses these without imports, and the compiler adds the imports when it bundles.\n// Tests load that code directly, so this module sets them up. Import it first.\nconst globals = globalThis as unknown as Record<string, unknown>;\nglobals.definePage = definePage;\nglobals.defineDot = defineDot;\nglobals.createEvent = 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 // Host methods the page may call. Any other call rejects with `unsupported`.\n host?: TestHost;\n // What each page the test page opens with pushForResult gives back, by its id. A page not listed\n // gives undefined, as if the person went back.\n results?: Readonly<Record<string, unknown>>;\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 // What Dash's bars show over the page now.\n readonly bars: PageBars;\n // What the page gave back with backWithResult, or undefined.\n readonly result: unknown;\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 // Runs the page's onRefresh, as when the person pulls it down.\n refresh(): Promise<void>;\n}\n\nexport async function testPage<S extends PageState>(\n definition: PageDefinition<S>,\n { id = 'test', options = {}, host = {}, results = {} }: TestPageOptions = {},\n): Promise<PageTest<S>> {\n const patches: PageState[] = [];\n const navigations: Navigation[] = [];\n const hostCalls: HostCallRecord[] = [];\n let result: unknown;\n connectHost(fakeHostCaller(host, hostCalls));\n const page = new Page<S>(1, id, definition, {\n commit: (_page, patch) => patches.push(patch),\n showBars: () => {},\n navigate: (_page, navigation) => navigations.push(navigation),\n pushForResult: (_page, navigation) => {\n navigations.push(navigation);\n return Promise.resolve(results[navigation.page]);\n },\n backWithResult: (_page, given) => {\n result = given;\n navigations.push({ action: 'back', delta: 1 });\n },\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 get bars() {\n return page.bars;\n },\n get result() {\n return result;\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 refresh: () => page.lifecycle('onRefresh'),\n };\n}\n\n// Answers each call with the test's fake for that method.\nfunction fakeHostCaller(host: TestHost, hostCalls: HostCallRecord[]): HostCaller {\n return (method, params) => {\n hostCalls.push({ method, params });\n const handler = host[method];\n if (!handler) {\n const error = new HostError(\n 'unsupported',\n `The test has no host method \"${method}\". Add it to testPage's \\`host\\` option`,\n );\n return createHostRequest(Promise.reject(error));\n }\n // Cancelling rejects the call, as it does in a running dot.\n let cancel = () => {};\n const answer = new Promise<unknown>((resolve, reject) => {\n cancel = () => reject(cancelledError(method));\n Promise.resolve()\n .then(() => handler(params as never))\n .then(resolve, reject);\n });\n return createHostRequest(answer, () => cancel());\n };\n}\n"],"mappings":";;;AAiBA,MAAM,UAAU;AAChB,QAAQ,aAAa;AACrB,QAAQ,YAAY;AACpB,QAAQ,cAAc;AA4CtB,eAAsB,SACpB,YACA,EAAE,KAAK,QAAQ,UAAU,CAAC,GAAG,OAAO,CAAC,GAAG,UAAU,CAAC,MAAuB,CAAC,GACrD;CACtB,MAAM,UAAuB,CAAC;CAC9B,MAAM,cAA4B,CAAC;CACnC,MAAM,YAA8B,CAAC;CACrC,IAAI;CACJ,YAAY,eAAe,MAAM,SAAS,CAAC;CAC3C,MAAM,OAAO,IAAI,KAAQ,GAAG,IAAI,YAAY;EAC1C,SAAS,OAAO,UAAU,QAAQ,KAAK,KAAK;EAC5C,gBAAgB,CAAC;EACjB,WAAW,OAAO,eAAe,YAAY,KAAK,UAAU;EAC5D,gBAAgB,OAAO,eAAe;GACpC,YAAY,KAAK,UAAU;GAC3B,OAAO,QAAQ,QAAQ,QAAQ,WAAW,KAAK;EACjD;EACA,iBAAiB,OAAO,UAAU;GAChC,SAAS;GACT,YAAY,KAAK;IAAE,QAAQ;IAAQ,OAAO;GAAE,CAAC;EAC/C;EACA,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,IAAI,OAAO;GACT,OAAO,KAAK;EACd;EACA,IAAI,SAAS;GACX,OAAO;EACT;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;EACA,eAAe,KAAK,UAAU,WAAW;CAC3C;AACF;AAGA,SAAS,eAAe,MAAgB,WAAyC;CAC/E,QAAQ,QAAQ,WAAW;EACzB,UAAU,KAAK;GAAE;GAAQ;EAAO,CAAC;EACjC,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS;GACZ,MAAM,QAAQ,IAAI,UAChB,eACA,gCAAgC,OAAO,wCACzC;GACA,OAAO,kBAAkB,QAAQ,OAAO,KAAK,CAAC;EAChD;EAEA,IAAI,eAAe,CAAC;EACpB,MAAM,SAAS,IAAI,SAAkB,SAAS,WAAW;GACvD,eAAe,OAAO,eAAe,MAAM,CAAC;GAC5C,QAAQ,QAAQ,CAAC,CACd,WAAW,QAAQ,MAAe,CAAC,CAAC,CACpC,KAAK,SAAS,MAAM;EACzB,CAAC;EACD,OAAO,kBAAkB,cAAc,OAAO,CAAC;CACjD;AACF"}
1
+ {"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import type {\n DotEvent,\n HostCaller,\n Navigation,\n PageBars,\n PageLaunchOptions,\n PageState,\n} 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';\nimport { cancelledError } from './host-errors';\n\n// A dot's code uses these without imports, and the compiler adds the imports when it bundles.\n// Tests load that code directly, so this module sets them up. Import it first.\nconst globals = globalThis as unknown as Record<string, unknown>;\nglobals.definePage = definePage;\nglobals.defineDot = defineDot;\nglobals.createEvent = 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 // Host methods the page may call. Any other call rejects with `unsupported`.\n host?: TestHost;\n // What each page the test page opens with `pushForResult` gives back, by its id. A page not listed\n // gives undefined, as if the person went back.\n results?: Readonly<Record<string, unknown>>;\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 // What Dash's bars show over the page now.\n readonly bars: PageBars;\n // What the page gave back with `backWithResult`, or undefined.\n readonly result: unknown;\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 // Runs the page's `onRefresh`, as when the person pulls it down.\n refresh(): Promise<void>;\n}\n\nexport async function testPage<S extends PageState>(\n definition: PageDefinition<S>,\n { id = 'test', options = {}, host = {}, results = {} }: TestPageOptions = {},\n): Promise<PageTest<S>> {\n const patches: PageState[] = [];\n const navigations: Navigation[] = [];\n const hostCalls: HostCallRecord[] = [];\n let result: unknown;\n connectHost(fakeHostCaller(host, hostCalls));\n const page = new Page<S>(1, id, definition, {\n commit: (_page, patch) => patches.push(patch),\n showBars: () => {},\n navigate: (_page, navigation) => navigations.push(navigation),\n pushForResult: (_page, navigation) => {\n navigations.push(navigation);\n return Promise.resolve(results[navigation.page]);\n },\n backWithResult: (_page, given) => {\n result = given;\n navigations.push({ action: 'back', delta: 1 });\n },\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 get bars() {\n return page.bars;\n },\n get result() {\n return result;\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 refresh: () => page.lifecycle('onRefresh'),\n };\n}\n\n// Answers each call with the test's fake for that method.\nfunction fakeHostCaller(host: TestHost, hostCalls: HostCallRecord[]): HostCaller {\n return (method, params) => {\n hostCalls.push({ method, params });\n const handler = host[method];\n if (!handler) {\n const error = new HostError(\n 'unsupported',\n `The test has no host method \"${method}\". Add it to testPage's \\`host\\` option`,\n );\n return createHostRequest(Promise.reject(error));\n }\n // Cancelling rejects the call, as it does in a running dot.\n let cancel = () => {};\n const answer = new Promise<unknown>((resolve, reject) => {\n cancel = () => reject(cancelledError(method));\n Promise.resolve()\n .then(() => handler(params as never))\n .then(resolve, reject);\n });\n return createHostRequest(answer, () => cancel());\n };\n}\n"],"mappings":";;;AAiBA,MAAM,UAAU;AAChB,QAAQ,aAAa;AACrB,QAAQ,YAAY;AACpB,QAAQ,cAAc;AA4CtB,eAAsB,SACpB,YACA,EAAE,KAAK,QAAQ,UAAU,CAAC,GAAG,OAAO,CAAC,GAAG,UAAU,CAAC,MAAuB,CAAC,GACrD;CACtB,MAAM,UAAuB,CAAC;CAC9B,MAAM,cAA4B,CAAC;CACnC,MAAM,YAA8B,CAAC;CACrC,IAAI;CACJ,YAAY,eAAe,MAAM,SAAS,CAAC;CAC3C,MAAM,OAAO,IAAI,KAAQ,GAAG,IAAI,YAAY;EAC1C,SAAS,OAAO,UAAU,QAAQ,KAAK,KAAK;EAC5C,gBAAgB,CAAC;EACjB,WAAW,OAAO,eAAe,YAAY,KAAK,UAAU;EAC5D,gBAAgB,OAAO,eAAe;GACpC,YAAY,KAAK,UAAU;GAC3B,OAAO,QAAQ,QAAQ,QAAQ,WAAW,KAAK;EACjD;EACA,iBAAiB,OAAO,UAAU;GAChC,SAAS;GACT,YAAY,KAAK;IAAE,QAAQ;IAAQ,OAAO;GAAE,CAAC;EAC/C;EACA,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,IAAI,OAAO;GACT,OAAO,KAAK;EACd;EACA,IAAI,SAAS;GACX,OAAO;EACT;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;EACA,eAAe,KAAK,UAAU,WAAW;CAC3C;AACF;AAGA,SAAS,eAAe,MAAgB,WAAyC;CAC/E,QAAQ,QAAQ,WAAW;EACzB,UAAU,KAAK;GAAE;GAAQ;EAAO,CAAC;EACjC,MAAM,UAAU,KAAK;EACrB,IAAI,CAAC,SAAS;GACZ,MAAM,QAAQ,IAAI,UAChB,eACA,gCAAgC,OAAO,wCACzC;GACA,OAAO,kBAAkB,QAAQ,OAAO,KAAK,CAAC;EAChD;EAEA,IAAI,eAAe,CAAC;EACpB,MAAM,SAAS,IAAI,SAAkB,SAAS,WAAW;GACvD,eAAe,OAAO,eAAe,MAAM,CAAC;GAC5C,QAAQ,QAAQ,CAAC,CACd,WAAW,QAAQ,MAAe,CAAC,CAAC,CACpC,KAAK,SAAS,MAAM;EACzB,CAAC;EACD,OAAO,kBAAkB,cAAc,OAAO,CAAC;CACjD;AACF"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@monimesl/dot-service",
3
- "version": "1.0.0-beta.3",
3
+ "version": "1.0.0-beta.5",
4
4
  "description": "Dot logic layer: pages, state and plugins",
5
5
  "type": "module",
6
6
  "repository": {
@@ -30,8 +30,8 @@
30
30
  "main": "./dist/index.js",
31
31
  "types": "./dist/index.d.ts",
32
32
  "dependencies": {
33
- "@monimesl/dot-core": "1.0.0-beta.3",
34
- "@monimesl/dot-dash": "1.0.0-beta.3"
33
+ "@monimesl/dot-core": "1.0.0-beta.5",
34
+ "@monimesl/dot-dash": "1.0.0-beta.5"
35
35
  },
36
36
  "devDependencies": {
37
37
  "publint": "^0.3.24",