@mokup/shared 1.1.3 → 2.0.0

package/dist/define-config.mjs

@@ -1,166 +1,151 @@
-import { isPromise, middlewareSymbol } from './config-core.mjs';
-
+import { isPromise, middlewareSymbol } from "./config-core.mjs";
+//#region src/define-config.ts
 function normalizeHookError(policy) {
-  if (policy === "throw" || policy === "silent") {
-    return policy;
-  }
-  return "warn";
+	if (policy === "throw" || policy === "silent") return policy;
+	return "warn";
 }
 function createDefineConfig(options) {
-  const contextStack = [];
-  function getActiveContext() {
-    const context = contextStack[contextStack.length - 1];
-    if (!context) {
-      throw new Error("onBeforeAll/onAfterAll must be called inside defineConfig()");
-    }
-    return context;
-  }
-  function runWithContext(context, fn) {
-    contextStack.push(context);
-    try {
-      const result = fn();
-      if (isPromise(result)) {
-        return result.finally(() => {
-          contextStack.pop();
-        });
-      }
-      contextStack.pop();
-      return result;
-    } catch (error) {
-      contextStack.pop();
-      throw error;
-    }
-  }
-  function reportHookError(error, policy) {
-    if (policy === "silent") {
-      return;
-    }
-    if (policy === "warn") {
-      console.warn(`${options.logPrefix} defineConfig hook failed:`, error);
-    }
-  }
-  function runHookSequence(stage, hooks, policy, setStage) {
-    if (hooks.length === 0) {
-      return;
-    }
-    setStage(stage);
-    let chain = null;
-    const runHook = (hook) => {
-      try {
-        const result = hook();
-        if (isPromise(result)) {
-          return result.catch((error) => {
-            if (policy === "throw") {
-              throw error;
-            }
-            reportHookError(error, policy);
-          });
-        }
-        return void 0;
-      } catch (error) {
-        if (policy === "throw") {
-          throw error;
-        }
-        reportHookError(error, policy);
-        return void 0;
-      }
-    };
-    for (const hook of hooks) {
-      if (chain) {
-        chain = chain.then(() => runHook(hook));
-        continue;
-      }
-      const result = runHook(hook);
-      if (isPromise(result)) {
-        chain = result;
-      }
-    }
-    if (!chain) {
-      setStage("normal");
-      return;
-    }
-    return chain.finally(() => {
-      setStage("normal");
-    });
-  }
-  function attachMetadata(config, meta) {
-    Object.defineProperty(config, middlewareSymbol, {
-      value: meta,
-      enumerable: false
-    });
-    return config;
-  }
-  function normalizeConfig(value) {
-    return value && typeof value === "object" ? value : {};
-  }
-  function onBeforeAll(handler) {
-    if (typeof handler !== "function") {
-      throw new TypeError("onBeforeAll expects a function");
-    }
-    const context = getActiveContext();
-    context.hooks.pre.push(handler);
-  }
-  function onAfterAll(handler) {
-    if (typeof handler !== "function") {
-      throw new TypeError("onAfterAll expects a function");
-    }
-    const context = getActiveContext();
-    context.hooks.post.push(handler);
-  }
-  function defineConfig(input) {
-    if (typeof input === "function") {
-      const pre = [];
-      const normal = [];
-      const post = [];
-      let stage = "normal";
-      const app = {
-        use: (...handlers) => {
-          if (stage === "pre") {
-            pre.push(...handlers);
-            return;
-          }
-          if (stage === "post") {
-            post.push(...handlers);
-            return;
-          }
-          normal.push(...handlers);
-        }
-      };
-      const context = {
-        app,
-        hooks: { pre: [], post: [] },
-        setStage: (next) => {
-          stage = next;
-        }
-      };
-      const result = runWithContext(context, () => input({ app }));
-      const finalize = (value) => {
-        const config2 = normalizeConfig(value);
-        const policy = normalizeHookError(config2.hookError);
-        const preResult = runHookSequence("pre", context.hooks.pre, policy, context.setStage);
-        const runPost = () => runHookSequence("post", context.hooks.post, policy, context.setStage);
-        if (isPromise(preResult)) {
-          return preResult.then(runPost).then(() => attachMetadata(config2, { pre, normal, post }));
-        }
-        const postResult = runPost();
-        if (isPromise(postResult)) {
-          return postResult.then(() => attachMetadata(config2, { pre, normal, post }));
-        }
-        return attachMetadata(config2, { pre, normal, post });
-      };
-      if (isPromise(result)) {
-        return result.then(finalize);
-      }
-      return finalize(result);
-    }
-    const config = normalizeConfig(input);
-    return attachMetadata(config, { pre: [], normal: [], post: [] });
-  }
-  return {
-    defineConfig,
-    onBeforeAll,
-    onAfterAll
-  };
+	const contextStack = [];
+	function getActiveContext() {
+		const context = contextStack.at(-1);
+		if (!context) throw new Error("onBeforeAll/onAfterAll must be called inside defineConfig()");
+		return context;
+	}
+	function runWithContext(context, fn) {
+		contextStack.push(context);
+		try {
+			const result = fn();
+			if (isPromise(result)) return result.finally(() => {
+				contextStack.pop();
+			});
+			contextStack.pop();
+			return result;
+		} catch (error) {
+			contextStack.pop();
+			throw error;
+		}
+	}
+	function reportHookError(error, policy) {
+		if (policy === "silent") return;
+		if (policy === "warn") console.warn(`${options.logPrefix} defineConfig hook failed:`, error);
+	}
+	function runHookSequence(stage, hooks, policy, setStage) {
+		if (hooks.length === 0) return;
+		setStage(stage);
+		let chain = null;
+		const runHook = (hook) => {
+			try {
+				const result = hook();
+				if (isPromise(result)) return result.catch((error) => {
+					if (policy === "throw") throw error;
+					reportHookError(error, policy);
+				});
+				return;
+			} catch (error) {
+				if (policy === "throw") throw error;
+				reportHookError(error, policy);
+				return;
+			}
+		};
+		for (const hook of hooks) {
+			if (chain) {
+				chain = chain.then(() => runHook(hook));
+				continue;
+			}
+			const result = runHook(hook);
+			if (isPromise(result)) chain = result;
+		}
+		if (!chain) {
+			setStage("normal");
+			return;
+		}
+		return chain.finally(() => {
+			setStage("normal");
+		});
+	}
+	function attachMetadata(config, meta) {
+		Object.defineProperty(config, middlewareSymbol, {
+			value: meta,
+			enumerable: false
+		});
+		return config;
+	}
+	function normalizeConfig(value) {
+		return value && typeof value === "object" ? value : {};
+	}
+	function onBeforeAll(handler) {
+		if (typeof handler !== "function") throw new TypeError("onBeforeAll expects a function");
+		getActiveContext().hooks.pre.push(handler);
+	}
+	function onAfterAll(handler) {
+		if (typeof handler !== "function") throw new TypeError("onAfterAll expects a function");
+		getActiveContext().hooks.post.push(handler);
+	}
+	function defineConfig(input) {
+		if (typeof input === "function") {
+			const pre = [];
+			const normal = [];
+			const post = [];
+			let stage = "normal";
+			const app = { use: (...handlers) => {
+				if (stage === "pre") {
+					pre.push(...handlers);
+					return;
+				}
+				if (stage === "post") {
+					post.push(...handlers);
+					return;
+				}
+				normal.push(...handlers);
+			} };
+			const context = {
+				app,
+				hooks: {
+					pre: [],
+					post: []
+				},
+				setStage: (next) => {
+					stage = next;
+				}
+			};
+			const result = runWithContext(context, () => input({ app }));
+			const finalize = (value) => {
+				const config = normalizeConfig(value);
+				const policy = normalizeHookError(config.hookError);
+				const preResult = runHookSequence("pre", context.hooks.pre, policy, context.setStage);
+				const runPost = () => runHookSequence("post", context.hooks.post, policy, context.setStage);
+				if (isPromise(preResult)) return preResult.then(runPost).then(() => attachMetadata(config, {
+					pre,
+					normal,
+					post
+				}));
+				const postResult = runPost();
+				if (isPromise(postResult)) return postResult.then(() => attachMetadata(config, {
+					pre,
+					normal,
+					post
+				}));
+				return attachMetadata(config, {
+					pre,
+					normal,
+					post
+				});
+			};
+			const isConfigPromise = (value) => isPromise(value);
+			if (isConfigPromise(result)) return result.then(finalize);
+			return finalize(result);
+		}
+		return attachMetadata(normalizeConfig(input), {
+			pre: [],
+			normal: [],
+			post: []
+		});
+	}
+	return {
+		defineConfig,
+		onBeforeAll,
+		onAfterAll
+	};
 }
-
+//#endregion
 export { createDefineConfig };

package/dist/diagnostic-types-DqAzUbgn.d.mts

@@ -0,0 +1,39 @@
+//#region src/diagnostic-types.d.ts
+/**
+ * Shared diagnostic categories emitted during mokup route scanning.
+ *
+ * @example
+ * import type { DiagnosticCategory } from '@mokup/shared'
+ *
+ * const category: DiagnosticCategory = 'invalid-route'
+ */
+type DiagnosticCategory = 'invalid-route' | 'unsupported-fields' | 'missing-handler' | 'duplicate-route' | 'sw-conflict';
+/**
+ * Ordered list of all supported diagnostic categories.
+ *
+ * @example
+ * import { diagnosticCategories } from '@mokup/shared'
+ *
+ * diagnosticCategories.includes('invalid-route')
+ */
+declare const diagnosticCategories: readonly ["invalid-route", "unsupported-fields", "missing-handler", "duplicate-route", "sw-conflict"];
+/**
+ * Runtime guard for supported diagnostic categories.
+ *
+ * @example
+ * import { isDiagnosticCategory } from '@mokup/shared'
+ *
+ * isDiagnosticCategory('invalid-route')
+ */
+declare function isDiagnosticCategory(value: string): value is DiagnosticCategory;
+/**
+ * Controls which diagnostics should fail instead of warn.
+ *
+ * @example
+ * import type { DiagnosticErrorMode } from '@mokup/shared'
+ *
+ * const errorOn: DiagnosticErrorMode = ['invalid-route']
+ */
+type DiagnosticErrorMode = 'all' | DiagnosticCategory[];
+//#endregion
+export { isDiagnosticCategory as i, DiagnosticErrorMode as n, diagnosticCategories as r, DiagnosticCategory as t };

package/dist/diagnostic-types-DqAzUbgn.d.ts

@@ -0,0 +1,39 @@
+//#region src/diagnostic-types.d.ts
+/**
+ * Shared diagnostic categories emitted during mokup route scanning.
+ *
+ * @example
+ * import type { DiagnosticCategory } from '@mokup/shared'
+ *
+ * const category: DiagnosticCategory = 'invalid-route'
+ */
+type DiagnosticCategory = 'invalid-route' | 'unsupported-fields' | 'missing-handler' | 'duplicate-route' | 'sw-conflict';
+/**
+ * Ordered list of all supported diagnostic categories.
+ *
+ * @example
+ * import { diagnosticCategories } from '@mokup/shared'
+ *
+ * diagnosticCategories.includes('invalid-route')
+ */
+declare const diagnosticCategories: readonly ["invalid-route", "unsupported-fields", "missing-handler", "duplicate-route", "sw-conflict"];
+/**
+ * Runtime guard for supported diagnostic categories.
+ *
+ * @example
+ * import { isDiagnosticCategory } from '@mokup/shared'
+ *
+ * isDiagnosticCategory('invalid-route')
+ */
+declare function isDiagnosticCategory(value: string): value is DiagnosticCategory;
+/**
+ * Controls which diagnostics should fail instead of warn.
+ *
+ * @example
+ * import type { DiagnosticErrorMode } from '@mokup/shared'
+ *
+ * const errorOn: DiagnosticErrorMode = ['invalid-route']
+ */
+type DiagnosticErrorMode = 'all' | DiagnosticCategory[];
+//#endregion
+export { isDiagnosticCategory as i, DiagnosticErrorMode as n, diagnosticCategories as r, DiagnosticCategory as t };

package/dist/diagnostic-types.d.mts

@@ -0,0 +1,2 @@
+import { i as isDiagnosticCategory, n as DiagnosticErrorMode, r as diagnosticCategories, t as DiagnosticCategory } from "./diagnostic-types-DqAzUbgn.mjs";
+export { DiagnosticCategory, DiagnosticErrorMode, diagnosticCategories, isDiagnosticCategory };

package/dist/diagnostic-types.d.ts

@@ -0,0 +1,2 @@
+import { i as isDiagnosticCategory, n as DiagnosticErrorMode, r as diagnosticCategories, t as DiagnosticCategory } from "./diagnostic-types-DqAzUbgn.mjs";
+export { DiagnosticCategory, DiagnosticErrorMode, diagnosticCategories, isDiagnosticCategory };

package/dist/diagnostic-types.mjs

@@ -0,0 +1,29 @@
+//#region src/diagnostic-types.ts
+/**
+* Ordered list of all supported diagnostic categories.
+*
+* @example
+* import { diagnosticCategories } from '@mokup/shared'
+*
+* diagnosticCategories.includes('invalid-route')
+*/
+const diagnosticCategories = [
+	"invalid-route",
+	"unsupported-fields",
+	"missing-handler",
+	"duplicate-route",
+	"sw-conflict"
+];
+/**
+* Runtime guard for supported diagnostic categories.
+*
+* @example
+* import { isDiagnosticCategory } from '@mokup/shared'
+*
+* isDiagnosticCategory('invalid-route')
+*/
+function isDiagnosticCategory(value) {
+	return diagnosticCategories.includes(value);
+}
+//#endregion
+export { diagnosticCategories, isDiagnosticCategory };

package/dist/diagnostics-C3QaEtqE.d.mts

@@ -0,0 +1,101 @@
+//#region src/diagnostics.d.ts
+interface DiagnosticSummarySection<TCategory extends string = string> {
+  category?: TCategory;
+  label: string;
+  items?: string[];
+  count?: number;
+  advice?: string;
+}
+declare const routeDiagnosticCatalog: {
+  readonly invalidRoute: {
+    readonly category: "invalid-route";
+    readonly label: "invalid route files ignored";
+    readonly advice: "Add a method suffix like .get.ts and avoid unsupported route group segments.";
+  };
+  readonly unsupportedFields: {
+    readonly category: "unsupported-fields";
+    readonly label: "routes skipped for unsupported rule fields";
+    readonly advice: "Use handler, headers, status, and delay in route rules; do not use legacy response, url, or method fields.";
+  };
+  readonly missingHandler: {
+    readonly category: "missing-handler";
+    readonly label: "routes skipped without handler";
+    readonly advice: "Export a handler value or function for every enabled rule.";
+  };
+  readonly duplicateRoute: {
+    readonly category: "duplicate-route";
+    readonly label: "duplicate route definitions";
+    readonly advice: "Keep each method + route path unique across scanned files.";
+  };
+};
+declare const swConflictDiagnostic: {
+  readonly category: "sw-conflict";
+  readonly label: "service worker config conflicts";
+  readonly advice: "Align sw.path, sw.scope, sw.register, and sw.unregister across entries that use SW mode.";
+};
+declare function collectSwConflictDiagnosticWarning(params: {
+  message: string;
+  onConflict?: (value: string) => void;
+}): boolean;
+declare function collectRouteDiagnosticWarning(params: {
+  message: string;
+  onUnsupportedFields?: (value: string) => void;
+  onMissingHandler?: (value: string) => void;
+  onDuplicateRoute?: (value: string) => void;
+}): void;
+declare function createRouteDiagnosticSections(params: {
+  invalidRoutes?: string[];
+  unsupportedFields?: string[];
+  missingHandlers?: string[];
+  duplicateRoutes?: string[];
+}): ({
+  items: string[];
+  category: "invalid-route";
+  label: "invalid route files ignored";
+  advice: "Add a method suffix like .get.ts and avoid unsupported route group segments.";
+} | {
+  items: string[];
+  category: "unsupported-fields";
+  label: "routes skipped for unsupported rule fields";
+  advice: "Use handler, headers, status, and delay in route rules; do not use legacy response, url, or method fields.";
+} | {
+  items: string[];
+  category: "missing-handler";
+  label: "routes skipped without handler";
+  advice: "Export a handler value or function for every enabled rule.";
+} | {
+  items: string[];
+  category: "duplicate-route";
+  label: "duplicate route definitions";
+  advice: "Keep each method + route path unique across scanned files.";
+})[];
+declare function createSwConflictDiagnosticSections(messages?: string[]): {
+  items: string[];
+  category: "sw-conflict";
+  label: "service worker config conflicts";
+  advice: "Align sw.path, sw.scope, sw.register, and sw.unregister across entries that use SW mode.";
+}[];
+declare function buildDiagnosticSummaryLines<TCategory extends string>(params: {
+  title?: string;
+  sections: DiagnosticSummarySection<TCategory>[];
+  maxItems?: number;
+}): string[];
+declare function createDiagnosticError<TCategory extends string>(params: {
+  errorOn?: 'all' | TCategory[];
+  sections: DiagnosticSummarySection<TCategory>[];
+  title?: string;
+  maxItems?: number;
+}): Error | null;
+declare function reportDiagnostics<TCategory extends string>(params: {
+  errorOn?: 'all' | TCategory[];
+  sections: DiagnosticSummarySection<TCategory>[];
+  title?: string;
+  errorTitle?: string;
+  maxItems?: number;
+  warn?: (message: string) => void;
+}): {
+  summaryLines: string[];
+  error: Error | null;
+};
+//#endregion
+export { createDiagnosticError as a, reportDiagnostics as c, collectSwConflictDiagnosticWarning as i, routeDiagnosticCatalog as l, buildDiagnosticSummaryLines as n, createRouteDiagnosticSections as o, collectRouteDiagnosticWarning as r, createSwConflictDiagnosticSections as s, DiagnosticSummarySection as t, swConflictDiagnostic as u };

package/dist/diagnostics-C3QaEtqE.d.ts

@@ -0,0 +1,101 @@
+//#region src/diagnostics.d.ts
+interface DiagnosticSummarySection<TCategory extends string = string> {
+  category?: TCategory;
+  label: string;
+  items?: string[];
+  count?: number;
+  advice?: string;
+}
+declare const routeDiagnosticCatalog: {
+  readonly invalidRoute: {
+    readonly category: "invalid-route";
+    readonly label: "invalid route files ignored";
+    readonly advice: "Add a method suffix like .get.ts and avoid unsupported route group segments.";
+  };
+  readonly unsupportedFields: {
+    readonly category: "unsupported-fields";
+    readonly label: "routes skipped for unsupported rule fields";
+    readonly advice: "Use handler, headers, status, and delay in route rules; do not use legacy response, url, or method fields.";
+  };
+  readonly missingHandler: {
+    readonly category: "missing-handler";
+    readonly label: "routes skipped without handler";
+    readonly advice: "Export a handler value or function for every enabled rule.";
+  };
+  readonly duplicateRoute: {
+    readonly category: "duplicate-route";
+    readonly label: "duplicate route definitions";
+    readonly advice: "Keep each method + route path unique across scanned files.";
+  };
+};
+declare const swConflictDiagnostic: {
+  readonly category: "sw-conflict";
+  readonly label: "service worker config conflicts";
+  readonly advice: "Align sw.path, sw.scope, sw.register, and sw.unregister across entries that use SW mode.";
+};
+declare function collectSwConflictDiagnosticWarning(params: {
+  message: string;
+  onConflict?: (value: string) => void;
+}): boolean;
+declare function collectRouteDiagnosticWarning(params: {
+  message: string;
+  onUnsupportedFields?: (value: string) => void;
+  onMissingHandler?: (value: string) => void;
+  onDuplicateRoute?: (value: string) => void;
+}): void;
+declare function createRouteDiagnosticSections(params: {
+  invalidRoutes?: string[];
+  unsupportedFields?: string[];
+  missingHandlers?: string[];
+  duplicateRoutes?: string[];
+}): ({
+  items: string[];
+  category: "invalid-route";
+  label: "invalid route files ignored";
+  advice: "Add a method suffix like .get.ts and avoid unsupported route group segments.";
+} | {
+  items: string[];
+  category: "unsupported-fields";
+  label: "routes skipped for unsupported rule fields";
+  advice: "Use handler, headers, status, and delay in route rules; do not use legacy response, url, or method fields.";
+} | {
+  items: string[];
+  category: "missing-handler";
+  label: "routes skipped without handler";
+  advice: "Export a handler value or function for every enabled rule.";
+} | {
+  items: string[];
+  category: "duplicate-route";
+  label: "duplicate route definitions";
+  advice: "Keep each method + route path unique across scanned files.";
+})[];
+declare function createSwConflictDiagnosticSections(messages?: string[]): {
+  items: string[];
+  category: "sw-conflict";
+  label: "service worker config conflicts";
+  advice: "Align sw.path, sw.scope, sw.register, and sw.unregister across entries that use SW mode.";
+}[];
+declare function buildDiagnosticSummaryLines<TCategory extends string>(params: {
+  title?: string;
+  sections: DiagnosticSummarySection<TCategory>[];
+  maxItems?: number;
+}): string[];
+declare function createDiagnosticError<TCategory extends string>(params: {
+  errorOn?: 'all' | TCategory[];
+  sections: DiagnosticSummarySection<TCategory>[];
+  title?: string;
+  maxItems?: number;
+}): Error | null;
+declare function reportDiagnostics<TCategory extends string>(params: {
+  errorOn?: 'all' | TCategory[];
+  sections: DiagnosticSummarySection<TCategory>[];
+  title?: string;
+  errorTitle?: string;
+  maxItems?: number;
+  warn?: (message: string) => void;
+}): {
+  summaryLines: string[];
+  error: Error | null;
+};
+//#endregion
+export { createDiagnosticError as a, reportDiagnostics as c, collectSwConflictDiagnosticWarning as i, routeDiagnosticCatalog as l, buildDiagnosticSummaryLines as n, createRouteDiagnosticSections as o, collectRouteDiagnosticWarning as r, createSwConflictDiagnosticSections as s, DiagnosticSummarySection as t, swConflictDiagnostic as u };

package/dist/diagnostics.d.mts

@@ -0,0 +1,2 @@
+import { a as createDiagnosticError, c as reportDiagnostics, i as collectSwConflictDiagnosticWarning, l as routeDiagnosticCatalog, n as buildDiagnosticSummaryLines, o as createRouteDiagnosticSections, r as collectRouteDiagnosticWarning, s as createSwConflictDiagnosticSections, t as DiagnosticSummarySection, u as swConflictDiagnostic } from "./diagnostics-C3QaEtqE.mjs";
+export { DiagnosticSummarySection, buildDiagnosticSummaryLines, collectRouteDiagnosticWarning, collectSwConflictDiagnosticWarning, createDiagnosticError, createRouteDiagnosticSections, createSwConflictDiagnosticSections, reportDiagnostics, routeDiagnosticCatalog, swConflictDiagnostic };

package/dist/diagnostics.d.ts

@@ -0,0 +1,2 @@
+import { a as createDiagnosticError, c as reportDiagnostics, i as collectSwConflictDiagnosticWarning, l as routeDiagnosticCatalog, n as buildDiagnosticSummaryLines, o as createRouteDiagnosticSections, r as collectRouteDiagnosticWarning, s as createSwConflictDiagnosticSections, t as DiagnosticSummarySection, u as swConflictDiagnostic } from "./diagnostics-C3QaEtqE.mjs";
+export { DiagnosticSummarySection, buildDiagnosticSummaryLines, collectRouteDiagnosticWarning, collectSwConflictDiagnosticWarning, createDiagnosticError, createRouteDiagnosticSections, createSwConflictDiagnosticSections, reportDiagnostics, routeDiagnosticCatalog, swConflictDiagnostic };