Method show

src/lib/FancyError.ts:142–196

* Show an error by registered ID with context, or with explicit title/message/props. * * Usage with registered error ID: * FancyError.show('action:jump:label_not_found', { label: 'my_label', step: 5 }); * * Usage with explicit parameters (legacy): * FancyError.show('Error Title', 'Er

(idOrTitle: string, contextOrMessage?: ErrorContext | string, propsArg?: FancyErrorProps)

	 *   FancyError.show('Error Title', 'Error message', { prop: 'value' });
	 */
	static show (idOrTitle: string, contextOrMessage?: ErrorContext | string, propsArg?: FancyErrorProps): void {
		if (typeof MonogatariDebug === 'object' && Debug.currentLevel > 0) {
			let title: string;
			let message: string;
			let props: FancyErrorProps;

			// Check if this is a registered error ID
			const template = FancyError.registry.get(idOrTitle);

			if (template && typeof contextOrMessage !== 'string') {
				// ID-based call: FancyError.show('error:id', { context })
				const context = (contextOrMessage || {}) as ErrorContext;
				title = FancyError.interpolate(template.title, context);
				message = FancyError.interpolate(template.message, context);
				props = FancyError.interpolateProps(template.props, context);

				// Merge any additional context properties that look like display props
				// (keys starting with capital letter or containing spaces) into the final props
				for (const key of Object.keys(context)) {
					if (/^[A-Z]/.test(key) || key.includes(' ')) {
						props[key] = context[key];
					}
				}
			} else {
				// Legacy call: FancyError.show('title', 'message', { props })
				title = idOrTitle || 'Error';
				message = (contextOrMessage as string) || 'An error has occurred! Please check the console so you get more insight.';
				props = propsArg || {};
			}

			const id = Util.uuid();

			const error: QueuedError = {
				id,
				title,
				message,
				props
			};

			if ($_('[data-error]').isVisible()) {
				FancyError.queue.unshift(error);
			} else {
				const showError = (): void => {
					$_('body').prepend(FancyError.generateModalHtml(error));
					FancyError.attachDismissHandler(id);
				};

				if ($_('body').length > 0) {
					showError();
				} else {
					$_ready(showError);
				}
			}
		}
	}

	static render (props: FancyErrorProps = {}): string {
		let html = '<div class="error-section">';