@markless/bundler 0.1.1 → 0.2.0

package/dist/dev-error.d.ts

@@ -0,0 +1,57 @@
+import { CompilerDiagnostic, SourceSpan } from "@markless/compiler";
+
+//#region src/dev-error/index.d.ts
+declare const MARKLESS_DEV_ERROR_EVENT = "markless:dev-error";
+declare const MARKLESS_DEV_ERROR_CLEAR_EVENT = "markless:dev-error-clear";
+declare const MARKLESS_DEV_ERROR_CLIENT_ID = "virtual:markless:dev-error-client";
+interface MarklessDevDiagnostic {
+  readonly code: string;
+  readonly message: string;
+  readonly filename?: string;
+  readonly line?: number;
+  readonly column?: number;
+  readonly why?: string;
+  readonly suggestion?: string;
+  readonly docsUrl?: string;
+  readonly frame?: string;
+}
+interface MarklessDevErrorPayload {
+  readonly version: 1;
+  readonly id: string;
+  readonly kind: 'compile' | 'runtime';
+  readonly diagnostics: readonly MarklessDevDiagnostic[];
+  readonly details: string;
+  readonly stack?: string;
+}
+interface MarklessErrorLocation {
+  readonly file?: string;
+  readonly line: number;
+  readonly column: number;
+}
+declare class MarklessCompileError extends Error {
+  readonly payload: MarklessDevErrorPayload;
+  readonly id: string;
+  readonly loc?: MarklessErrorLocation;
+  readonly frame?: string;
+  readonly plugin = "markless";
+  readonly pluginCode: string;
+  constructor(payload: MarklessDevErrorPayload);
+}
+declare function createCompileErrorPayload(input: {
+  readonly filename: string;
+  readonly source: string;
+  readonly diagnostics: readonly CompilerDiagnostic[];
+  readonly details: string;
+  readonly stack?: string;
+}): MarklessDevErrorPayload;
+declare function normalizeMarklessDevError(error: unknown, options?: {
+  readonly id?: string;
+}): MarklessDevErrorPayload;
+declare function serializeMarklessDevError(payload: MarklessDevErrorPayload): string;
+declare function formatMarklessSourceFrame(source: string, span: SourceSpan): string;
+declare function renderMarklessDevErrorDocument(payload: MarklessDevErrorPayload, options?: {
+  readonly base?: string;
+}): string;
+declare function renderMarklessDevErrorPlainText(payload: MarklessDevErrorPayload): string;
+//#endregion
+export { MARKLESS_DEV_ERROR_CLEAR_EVENT, MARKLESS_DEV_ERROR_CLIENT_ID, MARKLESS_DEV_ERROR_EVENT, MarklessCompileError, MarklessDevDiagnostic, MarklessDevErrorPayload, MarklessErrorLocation, createCompileErrorPayload, formatMarklessSourceFrame, normalizeMarklessDevError, renderMarklessDevErrorDocument, renderMarklessDevErrorPlainText, serializeMarklessDevError };

package/dist/dev-error.js

@@ -0,0 +1,174 @@
+import { joinURL } from "ufo";
+//#region src/dev-error/index.ts
+const MARKLESS_DEV_ERROR_EVENT = "markless:dev-error";
+const MARKLESS_DEV_ERROR_CLEAR_EVENT = "markless:dev-error-clear";
+const MARKLESS_DEV_ERROR_CLIENT_ID = "virtual:markless:dev-error-client";
+const PLUGIN_CODE_KIND = "markless-dev-error";
+const PLUGIN_CODE_VERSION = 1;
+var MarklessCompileError = class extends Error {
+	payload;
+	id;
+	loc;
+	frame;
+	plugin = "markless";
+	pluginCode;
+	constructor(payload) {
+		super(payload.details);
+		this.name = "MarklessCompileError";
+		this.payload = payload.stack || !this.stack ? payload : {
+			...payload,
+			stack: this.stack
+		};
+		this.id = this.payload.id;
+		const primary = this.payload.diagnostics[0];
+		this.loc = primary?.line !== void 0 && primary.column !== void 0 ? {
+			file: primary.filename,
+			line: primary.line,
+			column: primary.column
+		} : void 0;
+		this.frame = primary?.frame;
+		this.pluginCode = serializeMarklessDevError(this.payload);
+	}
+};
+function createCompileErrorPayload(input) {
+	return {
+		version: 1,
+		id: input.filename,
+		kind: "compile",
+		diagnostics: input.diagnostics.map((diagnostic) => compilerDiagnostic(input.source, diagnostic)),
+		details: input.details,
+		...input.stack ? { stack: input.stack } : {}
+	};
+}
+function normalizeMarklessDevError(error, options = {}) {
+	if (error instanceof MarklessCompileError) return error.payload;
+	if (isObject(error) && isPayload(error.payload)) return error.payload;
+	if (isObject(error) && typeof error.pluginCode === "string") {
+		const payload = parseMarklessPluginCode(error.pluginCode);
+		if (payload) return payload;
+	}
+	const details = error instanceof Error ? error.message : String(error);
+	const code = isObject(error) && typeof error.code === "string" ? error.code : "MARKLESS_DEV_RUNTIME_ERROR";
+	return {
+		version: 1,
+		id: options.id ?? "navigation:unknown",
+		kind: "runtime",
+		diagnostics: [{
+			code,
+			message: details
+		}],
+		details,
+		...error instanceof Error && error.stack ? { stack: error.stack } : {}
+	};
+}
+function serializeMarklessDevError(payload) {
+	return JSON.stringify({
+		kind: PLUGIN_CODE_KIND,
+		version: PLUGIN_CODE_VERSION,
+		payload
+	});
+}
+function formatMarklessSourceFrame(source, span) {
+	const lines = source.split("\n");
+	const start = sourcePosition(source, span.start);
+	const end = sourcePosition(source, Math.max(span.start, span.end));
+	const firstLine = Math.max(1, start.line - 2);
+	const lastLine = Math.min(lines.length, start.line + 2);
+	const width = String(lastLine).length;
+	const frame = [];
+	for (let line = firstLine; line <= lastLine; line += 1) {
+		const active = line === start.line;
+		const text = lines[line - 1] ?? "";
+		frame.push(`${active ? ">" : " "} ${String(line).padStart(width)} | ${text}`);
+		if (active) {
+			const firstLineEnd = start.line === end.line ? end.column : text.length + 1;
+			const caretLength = Math.max(1, firstLineEnd - start.column);
+			frame.push(`  ${" ".repeat(width)} | ${" ".repeat(start.column - 1)}${"^".repeat(caretLength)}`);
+		}
+	}
+	return frame.join("\n");
+}
+function renderMarklessDevErrorDocument(payload, options = {}) {
+	const primary = payload.diagnostics[0] ?? {
+		code: "MARKLESS_DEV_RUNTIME_ERROR",
+		message: payload.details
+	};
+	const diagnostics = payload.diagnostics.slice(1).map((diagnostic) => {
+		return `<details><summary>${escapeHtml(`${diagnostic.code} — ${diagnostic.message}`)}</summary>${renderDiagnosticBody(diagnostic, options.base ?? "/")}</details>`;
+	});
+	const technical = [payload.details, payload.stack].filter(Boolean).join("\n\n");
+	const serialized = JSON.stringify(payload).replaceAll("<", "\\u003c");
+	return `<!doctype html>
+<html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${escapeHtml(primary.code)} — Markless development error</title><style>${documentStyles}</style></head>
+<body><main class="panel"><header><span class="badge">${escapeHtml(primary.code)}</span><h1>${escapeHtml(primary.message)}</h1></header>
+${renderDiagnosticBody(primary, options.base ?? "/")}
+${diagnostics.join("\n")}
+<details><summary>Technical details</summary><pre>${escapeHtml(technical)}</pre></details>
+<p class="recovery">Fix the error and reload to continue.</p></main>
+<script>window.__MARKLESS_DEV_ERROR__ = ${serialized};<\/script></body></html>`;
+}
+function renderMarklessDevErrorPlainText(payload) {
+	return [payload.details, payload.stack].filter(Boolean).join("\n\n");
+}
+function compilerDiagnostic(source, diagnostic) {
+	const position = diagnostic.primarySpan ? sourcePosition(source, diagnostic.primarySpan.start) : void 0;
+	return {
+		code: diagnostic.code,
+		message: diagnostic.message,
+		...diagnostic.primarySpan ? { filename: diagnostic.primarySpan.filename } : {},
+		...position ? {
+			line: position.line,
+			column: position.column
+		} : {},
+		...diagnostic.why ? { why: diagnostic.why } : {},
+		...diagnostic.suggestions[0]?.message ? { suggestion: diagnostic.suggestions[0].message } : {},
+		...diagnostic.docsUrl ? { docsUrl: diagnostic.docsUrl } : {},
+		...diagnostic.primarySpan ? { frame: formatMarklessSourceFrame(source, diagnostic.primarySpan) } : {}
+	};
+}
+function sourcePosition(source, offset) {
+	const before = source.slice(0, Math.max(0, Math.min(offset, source.length)));
+	const lastLineBreak = before.lastIndexOf("\n");
+	return {
+		line: before.split("\n").length,
+		column: before.length - lastLineBreak
+	};
+}
+function parseMarklessPluginCode(value) {
+	try {
+		const envelope = JSON.parse(value);
+		if (isObject(envelope) && envelope.kind === PLUGIN_CODE_KIND && envelope.version === PLUGIN_CODE_VERSION && isPayload(envelope.payload)) return envelope.payload;
+	} catch {}
+}
+function isPayload(value) {
+	return isObject(value) && value.version === 1 && typeof value.id === "string" && (value.kind === "compile" || value.kind === "runtime") && Array.isArray(value.diagnostics) && typeof value.details === "string";
+}
+function isObject(value) {
+	return typeof value === "object" && value !== null;
+}
+function renderDiagnosticBody(diagnostic, base) {
+	const editorLocation = diagnostic.filename && diagnostic.line !== void 0 && diagnostic.column !== void 0 ? `${diagnostic.filename}:${diagnostic.line}:${diagnostic.column}` : void 0;
+	return `${editorLocation ? `<a class="location" href="${escapeAttribute(joinURL(base, `/__open-in-editor?file=${encodeURIComponent(editorLocation)}`))}">${escapeHtml(editorLocation)}</a>` : ""}${diagnostic.why ? `<section><h2>Why</h2><p>${escapeHtml(diagnostic.why)}</p></section>` : ""}${diagnostic.suggestion ? `<section><h2>Suggested fix</h2><p>${escapeHtml(diagnostic.suggestion)}</p></section>` : ""}${diagnostic.frame ? `<pre class="frame">${escapeHtml(diagnostic.frame)}</pre>` : ""}${diagnostic.docsUrl && isHttpUrl(diagnostic.docsUrl) ? `<p><a href="${escapeAttribute(diagnostic.docsUrl)}">Read ${escapeHtml(diagnostic.code)} documentation</a></p>` : ""}`;
+}
+function isHttpUrl(value) {
+	try {
+		const url = new URL(value);
+		return url.protocol === "http:" || url.protocol === "https:";
+	} catch {
+		return false;
+	}
+}
+function escapeHtml(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
+}
+function escapeAttribute(value) {
+	return escapeHtml(value);
+}
+const documentStyles = `
+:root{color-scheme:light dark;font-family:system-ui,sans-serif;background:Canvas;color:CanvasText}
+*{box-sizing:border-box}body{margin:0;min-height:100vh;display:grid;place-items:center;padding:clamp(1rem,4vw,3rem);background:color-mix(in srgb,Canvas 94%,#b42318 6%)}
+.panel{width:min(60rem,100%);padding:clamp(1.25rem,3vw,2.5rem);border:1px solid color-mix(in srgb,CanvasText 20%,transparent);border-top:4px solid #c9362b;border-radius:.5rem;background:Canvas;box-shadow:0 1rem 3rem #0002}
+header{display:flex;flex-direction:column;gap:.6rem;margin-bottom:1rem}.badge{align-self:flex-start;padding:.15rem .45rem;border-radius:.25rem;background:color-mix(in srgb,#c9362b 14%,Canvas);color:#c9362b;font:600 .75rem ui-monospace,monospace}h1{margin:0;font-size:clamp(1.4rem,3vw,2rem);line-height:1.2}h2{margin:1rem 0 .25rem;font-size:.8rem;text-transform:uppercase;letter-spacing:.06em;color:color-mix(in srgb,CanvasText 65%,transparent)}p{margin:.3rem 0 1rem;line-height:1.55}a{color:LinkText}.location{display:inline-block;margin-bottom:.5rem;font:500 .9rem ui-monospace,monospace}.frame,details pre{overflow:auto;padding:1rem;border-radius:.35rem;background:color-mix(in srgb,CanvasText 7%,Canvas);font: .85rem/1.55 ui-monospace,monospace;white-space:pre}details{margin-top:1rem;border-top:1px solid color-mix(in srgb,CanvasText 15%,transparent);padding-top:1rem}summary{cursor:pointer;font-weight:600}.recovery{margin:1.5rem 0 0;color:color-mix(in srgb,CanvasText 65%,transparent);font-size:.9rem}`;
+//#endregion
+export { MARKLESS_DEV_ERROR_CLEAR_EVENT, MARKLESS_DEV_ERROR_CLIENT_ID, MARKLESS_DEV_ERROR_EVENT, MarklessCompileError, createCompileErrorPayload, formatMarklessSourceFrame, normalizeMarklessDevError, renderMarklessDevErrorDocument, renderMarklessDevErrorPlainText, serializeMarklessDevError };

package/dist/preload.d.ts

@@ -1,4 +1,4 @@
-import { o as MarklessBundleGraph } from "./types-D6KerlYq.js";
+import { o as MarklessBundleGraph } from "./types-CzXV_ABj.js";
 import { r as symbolVirtualModuleSourceFile } from "./source-module-BRb5P7wL.js";
 
 //#region src/build/preload-plan.d.ts

package/dist/preload.js

@@ -1,4 +1,4 @@
-import { S as planModulePreloads, l as symbolVirtualModuleSourceFile, x as planModulePreloadUrls } from "./source-module-CSRzW4Ny.js";
+import { C as planModulePreloads, S as planModulePreloadUrls, u as symbolVirtualModuleSourceFile } from "./source-module-C8W2THUI.js";
 //#region src/build/module-preload-dom.ts
 const PRIORITY_RANK = {
 	high: 2,