polen 0.8.0-next.9 → 0.8.1-next.1

package/build/lib/debug/debug.js

@@ -1,8 +1,36 @@
+import { Arr, Str } from '@wollybeard/kit';
 import { colorize } from 'consola/utils';
-import { snakeCase } from 'es-toolkit';
 import { inspect } from 'node:util';
-import { calcIsEnabledFromEnv } from './environment-variable.js';
-export const create = (namespace, initialState) => {
+import { calcIsEnabledFromEnv } from "./environment-variable.js";
+// todo:
+// const Option = {
+//   else:
+//     <alternative>(alternative: alternative) => <value>(value: value): value extends undefined ? alternative : value => {
+//       if (value === undefined || value === null) {
+//         return alternative as any
+//       }
+//       return value as any
+//     },
+// }
+// const namespaceToString = (namespace: string[] = []): string => {
+//   return formatNamespaceSegment(namespace.join(`_`))
+//   // todo:
+//   // const x = Option.else([] as string[])
+//   // const y = x(namespace)
+//   // const z = Fn.pipe(
+//   //   namespace,
+//   //   x,
+//   //   // Option.else([]),
+//   //   // (_) => Array.is(_) ? _ : [],
+//   //   // Str.joinWith(`_`),
+//   //   // Str.Case.upper,
+//   // )
+// }
+const formatNamespaceSegment = (segment) => {
+    return Str.Case.snake(segment).toUpperCase();
+};
+export const create = (namespaceInput, initialState) => {
+    const namespace = Arr.sure(namespaceInput ?? []);
     const isDebugEnabledFromEnv = calcIsEnabledFromEnv(process.env, namespace);
     const state = initialState ?? {
         isEnabled: isDebugEnabledFromEnv,
@@ -25,10 +53,11 @@ export const create = (namespace, initialState) => {
                     maxStringLength: 1000,
                 })
                 : ``;
-            const namespaceRendered = namespace
-                ? colorize(`bold`, colorize(`bgYellowBright`, ` ` + snakeCase(namespace).toUpperCase() + ` `))
-                : ``;
-            const eventRendered = colorize(`bold`, colorize(`bgMagentaBright`, ` ` + snakeCase(event).toUpperCase() + ` `));
+            const formatNamespaceSegmentAnsi = (segment) => {
+                return colorize(`bold`, colorize(`bgYellowBright`, ` ` + formatNamespaceSegment(segment) + ` `));
+            };
+            const namespaceRendered = namespace.map(formatNamespaceSegmentAnsi).join(` `);
+            const eventRendered = colorize(`bold`, colorize(`bgMagentaBright`, ` ` + formatNamespaceSegment(event) + ` `));
             const prefixRendered = `${namespaceRendered} ${eventRendered}`;
             console.debug(prefixRendered, payloadRendered);
         }
@@ -37,9 +66,9 @@ export const create = (namespace, initialState) => {
         state.isEnabled = isEnabled;
     };
     debug.sub = (subNamespace) => {
+        const s = Arr.sure(subNamespace);
         const stateCopy = structuredClone(state);
-        const fullNamespace = namespace ? `${namespace}:${subNamespace}` : subNamespace;
-        return create(fullNamespace, stateCopy);
+        return create([...namespace, ...s], stateCopy);
     };
     return debug;
 };
@@ -53,5 +82,5 @@ const parseNumberOr = (str, defaultValue) => {
     return parsed;
 };
 // initialize root debug
-export const debug = create();
+export const debugGlobal = create();
 //# sourceMappingURL=debug.js.map

package/build/lib/debug/debug.js.map

@@ -1 +1 @@
-{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../src/lib/debug/debug.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../src/lib/debug/debug.ts"],"names":[],"mappings":"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"}

package/build/lib/debug/environment-variable.d.ts

@@ -1,4 +1,5 @@
 export declare const enVarName = "DEBUG";
+export declare const wildcard = "*";
 export declare const enVarEnabledValuesStatic: string[];
-export declare const calcIsEnabledFromEnv: (enVars: Record<string, unknown>, namespace?: string) => boolean;
+export declare const calcIsEnabledFromEnv: (enVars: Record<string, unknown>, namespace?: string[]) => boolean;
 //# sourceMappingURL=environment-variable.d.ts.map

package/build/lib/debug/environment-variable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment-variable.d.ts","sourceRoot":"","sources":["../../../src/lib/debug/environment-variable.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,UAAU,CAAA;AAEhC,eAAO,MAAM,wBAAwB,UAAqB,CAAA;AAE1D,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,MAAM,KACjB,OAUF,CAAA"}
+{"version":3,"file":"environment-variable.d.ts","sourceRoot":"","sources":["../../../src/lib/debug/environment-variable.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,UAAU,CAAA;AAEhC,eAAO,MAAM,QAAQ,MAAM,CAAA;AAC3B,eAAO,MAAM,wBAAwB,UAA0B,CAAA;AAE/D,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,MAAM,EAAE,KACnB,OA4BF,CAAA"}

package/build/lib/debug/environment-variable.js

@@ -1,13 +1,33 @@
+import { Arr, Language } from '@wollybeard/kit';
 export const enVarName = `DEBUG`;
-export const enVarEnabledValuesStatic = [`true`, `*`, `1`];
+export const wildcard = `*`;
+export const enVarEnabledValuesStatic = [`true`, wildcard, `1`];
 export const calcIsEnabledFromEnv = (enVars, namespace) => {
-    const enVar = typeof enVars[enVarName] === `string` ? enVars[enVarName].trim() : undefined;
-    if (!enVar)
+    const namespace_ = namespace?.map(_ => _.toLowerCase());
+    const pattern = typeof enVars[enVarName] === `string`
+        ? enVars[enVarName]
+            .trim()
+            .toLowerCase()
+            .split(`:`)
+            .map(_ => _.trim())
+        : undefined;
+    if (!pattern)
         return false;
-    if (enVarEnabledValuesStatic.includes(enVar))
+    if (pattern.length === 1 && enVarEnabledValuesStatic.includes(pattern[0]))
         return true;
-    if (namespace)
-        return enVar.startsWith(namespace);
-    return false;
+    if (!namespace_)
+        return false;
+    if (Arr.getLast(pattern) !== wildcard) {
+        return pattern.join() === namespace_.join();
+    }
+    let i = 0;
+    for (const segment of pattern) {
+        if (segment === wildcard)
+            return true;
+        if (segment !== namespace_[i])
+            return false;
+        i++;
+    }
+    Language.never();
 };
 //# sourceMappingURL=environment-variable.js.map

package/build/lib/debug/environment-variable.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment-variable.js","sourceRoot":"","sources":["../../../src/lib/debug/environment-variable.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAA;AAEhC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAA+B,EAC/B,SAAkB,EACT,EAAE;IACX,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IAE1F,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAExB,IAAI,wBAAwB,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEzD,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAEjD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}
+{"version":3,"file":"environment-variable.js","sourceRoot":"","sources":["../../../src/lib/debug/environment-variable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAA;AAEhC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAA;AAC3B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAA;AAE/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAA+B,EAC/B,SAAoB,EACX,EAAE;IACX,MAAM,UAAU,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;IACvD,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ;QACnD,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;aAChB,IAAI,EAAE;aACN,WAAW,EAAE;aACb,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC,CAAC,SAAS,CAAA;IAEb,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IAE1B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,wBAAwB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC;QAAE,OAAO,IAAI,CAAA;IAEvF,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAA;IAE7B,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,UAAU,CAAC,IAAI,EAAE,CAAA;IAC7C,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,OAAO,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QACrC,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAA;QAC3C,CAAC,EAAE,CAAA;IACL,CAAC;IAED,QAAQ,CAAC,KAAK,EAAE,CAAA;AAClB,CAAC,CAAA"}

package/build/lib/debug/index.d.ts

@@ -1,2 +1,2 @@
-export * as Debug from './debug.js';
+export * as Debug from './debug.ts';
 //# sourceMappingURL=index.d.ts.map

package/build/lib/debug/index.js

@@ -1,2 +1,2 @@
-export * as Debug from './debug.js';
+export * as Debug from "./debug.js";
 //# sourceMappingURL=index.js.map

package/build/lib/errors/ContextualAggregateError.d.ts

@@ -1,4 +1,4 @@
-import { ContextualError } from './ContextualError.js';
+import { ContextualError } from './ContextualError.ts';
 /**
  * Aggregation Error enhanced with a context object and types members.
  *

package/build/lib/errors/ContextualAggregateError.js

@@ -1,5 +1,5 @@
 import { Arr } from '@wollybeard/kit';
-import { ContextualError } from './ContextualError.js';
+import { ContextualError } from "./ContextualError.js";
 /**
  * Aggregation Error enhanced with a context object and types members.
  *

package/build/lib/errors/ContextualError.d.ts

@@ -1,4 +1,4 @@
-import type { Cause, Context } from './types.js';
+import type { Cause, Context } from './types.ts';
 /**
  * Error enhanced with a context object.
  *

package/build/lib/errors/ErrorInternal.d.ts

@@ -1,5 +1,5 @@
-import { ContextualError } from './ContextualError.js';
-import type { Cause, Context } from './types.js';
+import { ContextualError } from './ContextualError.ts';
+import type { Cause, Context } from './types.ts';
 export declare class ErrorInternal<$Name extends string = `ErrorInternal`, $Context extends Context = Context, $Cause extends Cause | undefined = undefined> extends ContextualError<$Name, $Context, $Cause> {
     name: $Name;
     constructor(message?: string, context?: $Context, cause?: $Cause);

package/build/lib/errors/ErrorInternal.js

@@ -1,4 +1,4 @@
-import { ContextualError } from './ContextualError.js';
+import { ContextualError } from "./ContextualError.js";
 export class ErrorInternal extends ContextualError {
     name = `ErrorInternal`;
     constructor(message = `Something went wrong.`, context = {}, cause = undefined) {

package/build/lib/errors/errors.d.ts

@@ -1,5 +1,5 @@
-export * from './ContextualAggregateError.js';
-export * from './ContextualError.js';
-export * from './ErrorInternal.js';
-export * from './types.js';
+export * from './ContextualAggregateError.ts';
+export * from './ContextualError.ts';
+export * from './ErrorInternal.ts';
+export * from './types.ts';
 //# sourceMappingURL=errors.d.ts.map

package/build/lib/errors/errors.js

@@ -1,5 +1,5 @@
-export * from './ContextualAggregateError.js';
-export * from './ContextualError.js';
-export * from './ErrorInternal.js';
-export * from './types.js';
+export * from "./ContextualAggregateError.js";
+export * from "./ContextualError.js";
+export * from "./ErrorInternal.js";
+export * from "./types.js";
 //# sourceMappingURL=errors.js.map

package/build/lib/errors/index.d.ts

@@ -1,2 +1,2 @@
-export * as Errors from './errors.js';
+export * as Errors from './errors.ts';
 //# sourceMappingURL=index.d.ts.map

package/build/lib/errors/index.js

@@ -1,2 +1,2 @@
-export * as Errors from './errors.js';
+export * as Errors from "./errors.js";
 //# sourceMappingURL=index.js.map

package/build/lib/errors/types.d.ts

@@ -1,4 +1,4 @@
-import type { ContextualError } from './ContextualError.js';
+import type { ContextualError } from './ContextualError.ts';
 export type Cause = Error | ContextualError;
 export type Context = object;
 //# sourceMappingURL=types.d.ts.map

package/build/lib/favicon/index.d.ts

@@ -1,2 +1,2 @@
-export * as Favicon from './favicon.js';
+export * as Favicon from './favicon.ts';
 //# sourceMappingURL=index.d.ts.map

package/build/lib/favicon/index.js

@@ -1,2 +1,2 @@
-export * as Favicon from './favicon.js';
+export * as Favicon from "./favicon.js";
 //# sourceMappingURL=index.js.map

package/build/lib/file-router/diagnostic-reporter.d.ts

@@ -0,0 +1,3 @@
+import type { Diagnostic } from './linter.ts';
+export declare const reportDiagnostics: (diagnostics: Diagnostic[]) => void;
+//# sourceMappingURL=diagnostic-reporter.d.ts.map

package/build/lib/file-router/diagnostic-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-reporter.d.ts","sourceRoot":"","sources":["../../../src/lib/file-router/diagnostic-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,eAAO,MAAM,iBAAiB,GAAI,aAAa,UAAU,EAAE,SAmB1D,CAAA"}

package/build/lib/file-router/diagnostic-reporter.js

@@ -0,0 +1,18 @@
+export const reportDiagnostics = (diagnostics) => {
+    if (diagnostics.length === 0)
+        return;
+    const errors = diagnostics.filter(d => d.severity === 'error');
+    const warnings = diagnostics.filter(d => d.severity === 'warning');
+    const infos = diagnostics.filter(d => d.severity === 'info');
+    const summary = [
+        errors.length > 0 && `${errors.length} error${errors.length === 1 ? '' : 's'}`,
+        warnings.length > 0 && `${warnings.length} warning${warnings.length === 1 ? '' : 's'}`,
+        infos.length > 0 && `${infos.length} info${infos.length === 1 ? '' : 's'}`,
+    ].filter(Boolean).join(', ');
+    console.warn(`\n🔍 Polen found ${summary}:\n`);
+    diagnostics.forEach((diagnostic, index) => {
+        const icon = diagnostic.severity === 'error' ? '❌' : diagnostic.severity === 'warning' ? '⚠️ ' : 'ℹ️ ';
+        console.warn(`${icon} ${index + 1}. ${diagnostic.message}\n`);
+    });
+};
+//# sourceMappingURL=diagnostic-reporter.js.map

package/build/lib/file-router/diagnostic-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-reporter.js","sourceRoot":"","sources":["../../../src/lib/file-router/diagnostic-reporter.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAyB,EAAE,EAAE;IAC7D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAEpC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAA;IAC9D,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAA;IAClE,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAA;IAE5D,MAAM,OAAO,GAAG;QACd,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;QAC9E,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;QACtF,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;KAC3E,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE5B,OAAO,CAAC,IAAI,CAAC,oBAAoB,OAAO,KAAK,CAAC,CAAA;IAE9C,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;QACtG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,KAAK,UAAU,CAAC,OAAO,IAAI,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/build/lib/file-router/file-router.d.ts

@@ -1,4 +1,6 @@
-export * from './linter.js';
-export * from './route.js';
-export * from './scan.js';
+export * from './linter.ts';
+export * from './route.ts';
+export * from './scan-tree.ts';
+export * from './scan.ts';
+export * from './sidebar/index.ts';
 //# sourceMappingURL=file-router.d.ts.map

package/build/lib/file-router/file-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../../src/lib/file-router/file-router.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}
+{"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../../src/lib/file-router/file-router.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA"}

package/build/lib/file-router/file-router.js

@@ -1,4 +1,6 @@
-export * from './linter.js';
-export * from './route.js';
-export * from './scan.js';
+export * from "./linter.js";
+export * from "./route.js";
+export * from "./scan-tree.js";
+export * from "./scan.js";
+export * from "./sidebar/index.js";
 //# sourceMappingURL=file-router.js.map

package/build/lib/file-router/file-router.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-router.js","sourceRoot":"","sources":["../../../src/lib/file-router/file-router.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}
+{"version":3,"file":"file-router.js","sourceRoot":"","sources":["../../../src/lib/file-router/file-router.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA"}

package/build/lib/file-router/index.d.ts

@@ -1,2 +1,2 @@
-export * as FileRouter from './file-router.js';
+export * as FileRouter from './file-router.ts';
 //# sourceMappingURL=index.d.ts.map

package/build/lib/file-router/index.js

@@ -1,2 +1,2 @@
-export * as FileRouter from './file-router.js';
+export * as FileRouter from "./file-router.js";
 //# sourceMappingURL=index.js.map

package/build/lib/file-router/linter.d.ts

@@ -1,6 +1,9 @@
-import { type Route, type RouteFile } from './route.js';
-export type Diagnostic = DiagnosticIndexConflict;
+import { type Route, type RouteFile } from './route.ts';
+export type DiagnosticSeverity = 'error' | 'warning' | 'info';
+export type Diagnostic = DiagnosticIndexConflict | DiagnosticNumberedPrefixConflict | DiagnosticNumberedPrefixOnIndex;
 export interface DiagnosticIndexConflict {
+    type: 'index-conflict';
+    severity: DiagnosticSeverity;
     message: string;
     literal: {
         file: RouteFile;
@@ -9,6 +12,26 @@ export interface DiagnosticIndexConflict {
         file: RouteFile;
     };
 }
+export interface DiagnosticNumberedPrefixConflict {
+    type: 'numbered-prefix-conflict';
+    severity: DiagnosticSeverity;
+    message: string;
+    kept: {
+        file: RouteFile;
+        order: number;
+    };
+    dropped: {
+        file: RouteFile;
+        order: number;
+    };
+}
+export interface DiagnosticNumberedPrefixOnIndex {
+    type: 'numbered-prefix-on-index';
+    severity: DiagnosticSeverity;
+    message: string;
+    file: RouteFile;
+    order: number;
+}
 export interface LintResult {
     diagnostics: Diagnostic[];
     routes: Route[];

package/build/lib/file-router/linter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../../src/lib/file-router/linter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAA+C,MAAM,YAAY,CAAA;AAEpG,MAAM,MAAM,UAAU,GAAG,uBAAuB,CAAA;AAEhD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE;QACP,IAAI,EAAE,SAAS,CAAA;KAChB,CAAA;IACD,KAAK,EAAE;QACL,IAAI,EAAE,SAAS,CAAA;KAChB,CAAA;CACF;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,MAAM,EAAE,KAAK,EAAE,CAAA;CAChB;AAED,eAAO,MAAM,IAAI,GAAI,QAAQ,KAAK,EAAE,KAAG,UA0CtC,CAAA"}
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../../src/lib/file-router/linter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAA+C,MAAM,YAAY,CAAA;AAEpG,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAE7D,MAAM,MAAM,UAAU,GAAG,uBAAuB,GAAG,gCAAgC,GAAG,+BAA+B,CAAA;AAErH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,gBAAgB,CAAA;IACtB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE;QACP,IAAI,EAAE,SAAS,CAAA;KAChB,CAAA;IACD,KAAK,EAAE;QACL,IAAI,EAAE,SAAS,CAAA;KAChB,CAAA;CACF;AAED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,0BAA0B,CAAA;IAChC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS,CAAA;QACf,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS,CAAA;QACf,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,0BAA0B,CAAA;IAChC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,MAAM,EAAE,KAAK,EAAE,CAAA;CAChB;AAED,eAAO,MAAM,IAAI,GAAI,QAAQ,KAAK,EAAE,KAAG,UA0FtC,CAAA"}

package/build/lib/file-router/linter.js

@@ -1,14 +1,53 @@
 import { Idx, Path } from '@wollybeard/kit';
-import { routeIsFromIndexFile, routeToPathExpression } from './route.js';
+import { routeIsFromIndexFile, routeToPathExpression } from "./route.js";
 export const lint = (routes) => {
     const diagnostics = [];
     const seen = Idx.create({ key: routeToPathExpression });
-    // ━ Check for conflict between index and literal.
-    //   Note: There is no other way for paths to conflict so we safely assuming the cause is index+literal.
+    // ━ Check for numbered prefix on index files
+    for (const route of routes) {
+        if (routeIsFromIndexFile(route) && route.logical.order !== undefined) {
+            const diagnostic = {
+                type: 'numbered-prefix-on-index',
+                severity: 'warning',
+                message: `Numbered prefix on index file has no effect. The file:\n  ${Path.format(route.file.path.relative)}\n\nhas a numbered prefix (${route.logical.order}_) which doesn't affect ordering since index files represent their parent directory.`,
+                file: route.file,
+                order: route.logical.order,
+            };
+            diagnostics.push(diagnostic);
+        }
+    }
+    // ━ Check for conflicts
     for (const route of routes) {
         // Detect
         const seenRoute = seen.get(route);
         if (seenRoute) {
+            // Check if it's a numbered prefix conflict
+            if (seenRoute.logical.order !== undefined && route.logical.order !== undefined) {
+                // Handle numbered prefix conflict - keep the one with higher order
+                const [kept, dropped] = seenRoute.logical.order > route.logical.order ? [seenRoute, route] : [route, seenRoute];
+                if (dropped === seenRoute) {
+                    seen.set(kept);
+                }
+                const orderMessage = kept.logical.order === dropped.logical.order
+                    ? `Both files have the same order number (${kept.logical.order}). The file processed later is being kept based on processing order.`
+                    : `The file with lower order number (${dropped.logical.order}) is being dropped in favor of the one with higher order (${kept.logical.order}).`;
+                const diagnostic = {
+                    type: 'numbered-prefix-conflict',
+                    severity: 'error',
+                    // dprint-ignore
+                    message: `Your files represent conflicting routes due to numbered prefixes. This file:\n  ${Path.format(kept.file.path.relative)}\n\nconflicts with this file:\n\n  ${Path.format(dropped.file.path.relative)}.\n\n${orderMessage}`,
+                    kept: {
+                        file: kept.file,
+                        order: kept.logical.order,
+                    },
+                    dropped: {
+                        file: dropped.file,
+                        order: dropped.logical.order,
+                    },
+                };
+                diagnostics.push(diagnostic);
+                continue;
+            }
             // Fix - ignore the index
             const [index, literal] = routeIsFromIndexFile(route) ? [route, seenRoute] : [seenRoute, route];
             if (seenRoute === index) {
@@ -16,6 +55,8 @@ export const lint = (routes) => {
             }
             // Report
             const diagnostic = {
+                type: 'index-conflict',
+                severity: 'error',
                 // dprint-ignore
                 message: `Your files represent conflicting routes. This index file route:\n  ${Path.format(index.file.path.relative)}\n\nconflicts with this literal file route:\n\n  ${Path.format(literal.file.path.relative)}.\n\nYour index route is being ignored.`,
                 literal: {

package/build/lib/file-router/linter.js.map

@@ -1 +1 @@
-{"version":3,"file":"linter.js","sourceRoot":"","sources":["../../../src/lib/file-router/linter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAA8B,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAmBpG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAe,EAAc,EAAE;IAClD,MAAM,WAAW,GAAiB,EAAE,CAAA;IAEpC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,CAAC,CAAA;IAEvD,kDAAkD;IAClD,wGAAwG;IACxG,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,SAAS;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAEjC,IAAI,SAAS,EAAE,CAAC;YACd,yBAAyB;YACzB,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;YAC9F,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;gBACxB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACjB,CAAC;YAED,SAAS;YACT,MAAM,UAAU,GAA4B;gBAC1C,gBAAgB;gBAChB,OAAO,EAAE,sEAAsE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,oDAAoD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,yCAAyC;gBACxP,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO,CAAC,IAAI;iBACnB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB;aACF,CAAA;YACD,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAE5B,SAAQ;QACV,CAAC;QAED,WAAW;QACX,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACjB,CAAC;IAED,OAAO;QACL,WAAW;QACX,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;KACvB,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"linter.js","sourceRoot":"","sources":["../../../src/lib/file-router/linter.ts"],"names":[],"mappings":"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"}

package/build/lib/file-router/route.d.ts

@@ -12,6 +12,7 @@ export interface Route {
 }
 export interface RouteLogical {
     path: Path;
+    order?: number;
 }
 export interface RouteFile {
     path: {

package/build/lib/file-router/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/lib/file-router/route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAU3C,MAAM,MAAM,IAAI,GAAG,WAAW,EAAE,CAAA;AAEhC,MAAM,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEzB,MAAM,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,CAAA;AAEnC,MAAM,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAAC,CAAA;AAElE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,eAAO,MAAM,GAAG,MAAM,CAAA;AAEtB,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,WAE1C,CAAA;AAUD,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,YAAY,CAAA;IACrB,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAA;CACX;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE;QACJ,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAA;QACrB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAA;KACtB,CAAA;CACF;AAUD,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,OAAO,EAAE,oBAAoB,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,KAAG,KAAK,IAAI,aAEvD,CAAA;AAcD,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,KAAG,KAAK,IAAI,aAEvD,CAAA;AAcD;;;;EAIE;AACF,eAAO,MAAM,gBAAgB,GAAI,OAAO,KAAK,KAAG,KAAK,IAAI,aAIxD,CAAA;AASD,eAAO,MAAM,oBAAoB,GAAI,OAAO,KAAK,KAAG,OAEnD,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,uBAAuB,WAAW,EAAE,KAAG,OAQjF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,EAAE,qBAAqB,WAAW,EAAE,KAAG,KAUrF,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,OAAO,KAAK,WAEjD,CAAA"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/lib/file-router/route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAU3C,MAAM,MAAM,IAAI,GAAG,WAAW,EAAE,CAAA;AAEhC,MAAM,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEzB,MAAM,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,CAAA;AAEnC,MAAM,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAAC,CAAA;AAElE,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC,eAAO,MAAM,GAAG,MAAM,CAAA;AAEtB,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,WAE1C,CAAA;AAUD,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,YAAY,CAAA;IACrB,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE;QACJ,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAA;QACrB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAA;KACtB,CAAA;CACF;AAUD,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,OAAO,EAAE,oBAAoB,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,KAAG,KAAK,IAAI,aAEvD,CAAA;AAcD,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,KAAG,KAAK,IAAI,aAEvD,CAAA;AAcD;;;;EAIE;AACF,eAAO,MAAM,gBAAgB,GAAI,OAAO,KAAK,KAAG,KAAK,IAAI,aAIxD,CAAA;AASD,eAAO,MAAM,oBAAoB,GAAI,OAAO,KAAK,KAAG,OAEnD,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,uBAAuB,WAAW,EAAE,KAAG,OAQjF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,EAAE,qBAAqB,WAAW,EAAE,KAAG,KAUrF,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,OAAO,KAAK,WAEjD,CAAA"}

package/build/lib/file-router/route.js

@@ -1,4 +1,4 @@
-import { arrayEquals } from '#lib/kit-temp.js';
+import { arrayEquals } from '#lib/kit-temp';
 import {} from '@wollybeard/kit';
 export const sep = `/`;
 export const pathToExpression = (path) => {

package/build/lib/file-router/route.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../src/lib/file-router/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAa,MAAM,iBAAiB,CAAA;AAoB3C,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAA;AAEtB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAU,EAAE,EAAE;IAC7C,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC7B,CAAC,CAAA;AA0CD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAY,EAA0B,EAAE;IACtE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAA;AACxC,CAAC,CAAA;AAsBD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAY,EAA0B,EAAE;IACtE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;AACtC,CAAC,CAAA;AAED,EAAE;AACF,gBAAgB;AAChB,EAAE;AAEF,EAAE;AACF,EAAE;AACF,EAAE;AACF,EAAE;AACF,gEAAgE;AAChE,EAAE;AACF,EAAE;AAEF;;;;EAIE;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAY,EAA0B,EAAE;IACvE,oCAAoC;IACpC,8CAA8C;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAA;AACxC,CAAC,CAAA;AAED,EAAE;AACF,EAAE;AACF,EAAE;AACF,mCAAmC;AACnC,EAAE;AACF,EAAE;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAY,EAAW,EAAE;IAC5D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,IAAI,CAAA;AACjE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAY,EAAE,qBAAoC,EAAW,EAAE;IAC1F,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,qBAAqB,CAAC,MAAM,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,WAAW,CAChB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACzD,qBAAqB,CACtB,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAY,EAAE,mBAAkC,EAAS,EAAE;IAC5F,2FAA2F;IAC3F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACpE,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE;YACP,GAAG,KAAK,CAAC,OAAO;YAChB,IAAI,EAAE,OAAO;SACd;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAY,EAAE,EAAE;IACpD,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAC7C,CAAC,CAAA;AAED,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;KACd;CACF,CAAA"}
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../src/lib/file-router/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAa,MAAM,iBAAiB,CAAA;AAoB3C,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAA;AAEtB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAU,EAAE,EAAE;IAC7C,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC7B,CAAC,CAAA;AA2CD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAY,EAA0B,EAAE;IACtE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAA;AACxC,CAAC,CAAA;AAsBD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAY,EAA0B,EAAE;IACtE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;AACtC,CAAC,CAAA;AAED,EAAE;AACF,gBAAgB;AAChB,EAAE;AAEF,EAAE;AACF,EAAE;AACF,EAAE;AACF,EAAE;AACF,gEAAgE;AAChE,EAAE;AACF,EAAE;AAEF;;;;EAIE;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAY,EAA0B,EAAE;IACvE,oCAAoC;IACpC,8CAA8C;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAA;AACxC,CAAC,CAAA;AAED,EAAE;AACF,EAAE;AACF,EAAE;AACF,mCAAmC;AACnC,EAAE;AACF,EAAE;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAY,EAAW,EAAE;IAC5D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,IAAI,CAAA;AACjE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAY,EAAE,qBAAoC,EAAW,EAAE;IAC1F,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,qBAAqB,CAAC,MAAM,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,WAAW,CAChB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACzD,qBAAqB,CACtB,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAY,EAAE,mBAAkC,EAAS,EAAE;IAC5F,2FAA2F;IAC3F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACpE,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE;YACP,GAAG,KAAK,CAAC,OAAO;YAChB,IAAI,EAAE,OAAO;SACd;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAY,EAAE,EAAE;IACpD,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAC7C,CAAC,CAAA;AAED,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;KACd;CACF,CAAA"}

package/build/lib/file-router/scan-tree.d.ts

@@ -0,0 +1,20 @@
+import { type TreeNode } from '#lib/tree/index';
+import type { Diagnostic } from './linter.ts';
+import type { Route } from './route.ts';
+export type RouteTreeNodeType = 'directory' | 'file';
+export interface RouteTreeNodeValue {
+    name: string;
+    order?: number;
+    type: RouteTreeNodeType;
+    route?: Route;
+}
+export type RouteTreeNode = TreeNode<RouteTreeNodeValue>;
+export interface ScanTreeResult {
+    routeTree: RouteTreeNode;
+    diagnostics: Diagnostic[];
+}
+export declare const scanTree: (parameters: {
+    dir: string;
+    glob?: string;
+}) => Promise<ScanTreeResult>;
+//# sourceMappingURL=scan-tree.d.ts.map

package/build/lib/file-router/scan-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-tree.d.ts","sourceRoot":"","sources":["../../../src/lib/file-router/scan-tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAa,MAAM,YAAY,CAAA;AAMlD,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,MAAM,CAAA;AAEpD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAAA;AAExD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,aAAa,CAAA;IACxB,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAkID,eAAO,MAAM,QAAQ,GAAU,YAAY;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,KAAG,OAAO,CAAC,cAAc,CAoBzB,CAAA"}