veryfront 0.1.49 → 0.1.51

package/esm/src/transforms/mdx/esm-module-loader/module-writer.js

@@ -9,6 +9,7 @@
  */
 import { join } from "../../../platform/compat/path/index.js";
 import { rendererLogger as logger } from "../../../utils/index.js";
+import { BUILD_FAILED, BUNDLE_ERROR, CACHE_ERROR, IMPORT_RESOLUTION_ERROR, INVALID_ARGUMENT, } from "../../../errors/index.js";
 import { getErrorCollector } from "../../../observability/error-collector.js";
 import { withSpan } from "../../../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../../../observability/tracing/span-names.js";
@@ -41,7 +42,7 @@ const mdxWriteFlight = new Singleflight();
  * Note: We always cache HTTP imports for consistency between compiled and
  * non-compiled modes, allowing them to share the same cache.
  */
-export async function cacheHttpImports(code, importMap) {
+async function cacheHttpImports(code, importMap) {
     const result = await cacheHttpImportsToLocal(code, {
         cacheDir: getHttpBundleCacheDir(),
         importMap,
@@ -89,7 +90,9 @@ export async function doLoadModuleESM(compiledProgramCode, context) {
         rewritten = await transformReactToLocalPaths(rewritten);
         logger.debug(`${LOG_PREFIX_MDX_LOADER} Step: transformReactToLocalPaths DONE`, { projectSlug });
         if (!context.projectId) {
-            throw new Error(`Missing projectId for MDX module cache (projectSlug: ${context.projectSlug})`);
+            throw INVALID_ARGUMENT.create({
+                detail: `Missing projectId for MDX module cache (projectSlug: ${context.projectSlug})`,
+            });
         }
         let codeHash = hashString(rewritten);
         const namespaceKey = encodeURIComponent(context.projectId);
@@ -107,7 +110,7 @@ export async function doLoadModuleESM(compiledProgramCode, context) {
             const unresolvedPaths = unresolvedMatches.map((m) => m[1]).slice(0, 5);
             const errorMsg = `MDX has ${unresolvedMatches.length} unresolved module imports: ${unresolvedPaths.join(", ")}`;
             logger.error(`${LOG_PREFIX_MDX_RENDERER} ${errorMsg}`);
-            throw new Error(errorMsg);
+            throw IMPORT_RESOLUTION_ERROR.create({ detail: errorMsg });
         }
         const nsDir = join(esmCacheDir, namespaceKey);
         const localFs = getLocalFs();
@@ -125,7 +128,7 @@ export async function doLoadModuleESM(compiledProgramCode, context) {
             logger.debug(`${LOG_PREFIX_MDX_LOADER} Writing module file`, { projectSlug, filePath });
             const written = await writeCacheFile(localFs, filePath, rewritten, "MDX-ESM-LOADER");
             if (!written) {
-                throw new Error(`Failed to write MDX module cache file: ${filePath}`);
+                throw BUILD_FAILED.create({ detail: `Failed to write MDX module cache file: ${filePath}` });
             }
         });
         logger.debug(`${LOG_PREFIX_MDX_LOADER} Step: mdxWriteFlight DONE`, { projectSlug, filePath });
@@ -171,7 +174,9 @@ export async function doLoadModuleESM(compiledProgramCode, context) {
                     await mdxWriteFlight.do(refreshedPath, async () => {
                         const written = await writeCacheFile(getLocalFs(), refreshedPath, rewritten, "MDX-ESM-LOADER");
                         if (!written) {
-                            throw new Error(`Failed to write refreshed MDX module cache file: ${refreshedPath}`);
+                            throw BUILD_FAILED.create({
+                                detail: `Failed to write refreshed MDX module cache file: ${refreshedPath}`,
+                            });
                         }
                     });
                     filePath = refreshedPath;
@@ -186,7 +191,9 @@ export async function doLoadModuleESM(compiledProgramCode, context) {
                     if (refreshedBundles.length > 0) {
                         const stillFailed = await ensureHttpBundlesExist(refreshedBundles, cacheDir);
                         if (stillFailed.length > 0) {
-                            throw new Error(`Failed to recover ${stillFailed.length} HTTP bundle(s) after re-fetch: ${stillFailed.join(", ")}`);
+                            throw BUNDLE_ERROR.create({
+                                detail: `Failed to recover ${stillFailed.length} HTTP bundle(s) after re-fetch: ${stillFailed.join(", ")}`,
+                            });
                         }
                     }
                 }
@@ -224,7 +231,9 @@ export async function doLoadModuleESM(compiledProgramCode, context) {
                 await mdxWriteFlight.do(refreshedPath, async () => {
                     const written = await writeCacheFile(getLocalFs(), refreshedPath, rewritten, "MDX-ESM-LOADER");
                     if (!written) {
-                        throw new Error(`Failed to write regenerated MDX module cache file: ${refreshedPath}`);
+                        throw BUILD_FAILED.create({
+                            detail: `Failed to write regenerated MDX module cache file: ${refreshedPath}`,
+                        });
                     }
                 });
                 filePath = refreshedPath;
@@ -237,7 +246,9 @@ export async function doLoadModuleESM(compiledProgramCode, context) {
                 // Verify bundles now exist
                 const stillMissing = await findMissingFrameworkBundles(extractFrameworkBundlePaths(rewritten));
                 if (stillMissing.length > 0) {
-                    throw new Error(`Failed to regenerate ${stillMissing.length} framework bundle(s): ${stillMissing[0]}`);
+                    throw BUNDLE_ERROR.create({
+                        detail: `Failed to regenerate ${stillMissing.length} framework bundle(s): ${stillMissing[0]}`,
+                    });
                 }
                 logger.debug(`${LOG_PREFIX_MDX_LOADER} Framework bundles regenerated successfully`, {
                     projectSlug,
@@ -248,7 +259,9 @@ export async function doLoadModuleESM(compiledProgramCode, context) {
         // Verify the cache file exists before attempting dynamic import
         const fileExists = await verifyCacheFileExists(localFs, filePath, "MDX-ESM-LOADER");
         if (!fileExists) {
-            throw new Error(`MDX module cache file missing before import: ${filePath}`);
+            throw CACHE_ERROR.create({
+                detail: `MDX module cache file missing before import: ${filePath}`,
+            });
         }
         const mod = await withSpan(SpanNames.MDX_DYNAMIC_IMPORT, () => import(`file://${filePath}?v=${codeHash}`), { "mdx.file_path": filePath.split("/").pop() || filePath });
         logger.debug(`${LOG_PREFIX_MDX_LOADER} Step: dynamic import DONE`, {

package/esm/src/transforms/mdx/esm-module-loader/resolution/file-finder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-finder.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/resolution/file-finder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAsC5E,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAyBD,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkHtC;AAED,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GACjD,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAqB9E"}
+{"version":3,"file":"file-finder.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/resolution/file-finder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAsC5E,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AA0BD,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkHtC;AAED,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GACjD,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAqB9E"}

package/esm/src/transforms/mdx/esm-module-loader/resolution/file-finder.js

@@ -34,7 +34,8 @@ async function tryReadFile(path, readFile) {
         const content = await readFile(path);
         return { sourceCode: decodeContent(content), actualFilePath: path };
     }
-    catch {
+    catch (_) {
+        /* expected: file may not exist at this path */
         return null;
     }
 }
@@ -137,8 +138,8 @@ export async function resolveModuleFile(normalizedPath, adapter, projectDir) {
                 });
                 return { sourceCode: content, actualFilePath: frameworkPath };
             }
-            catch {
-                // Continue trying other extensions/directories
+            catch (_) {
+                /* expected: file may not exist with this extension/directory combination */
             }
         }
     }

package/esm/src/transforms/mdx/esm-module-loader/types.d.ts

@@ -29,15 +29,6 @@ export interface FSAdapter {
     } | null>;
     makeTempDir(prefix: string): Promise<string>;
 }
-export interface ImportMatch {
-    original: string;
-    path: string;
-}
-export interface ModuleFetchResult {
-    original: string;
-    filePath: string | null;
-    path: string;
-}
 export interface NestedImportResult {
     original: string;
     nestedFilePath: string | null;
@@ -73,8 +64,4 @@ export interface ModuleFetcherContext {
      */
     transformDeadline?: number;
 }
-export interface JSXTransform {
-    original: string;
-    transformed: string;
-}
 //# sourceMappingURL=types.d.ts.map

package/esm/src/transforms/mdx/esm-module-loader/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACzD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACtD,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACzD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAaD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACtD,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/esm/src/transforms/mdx/esm-module-loader/utils/stub-module.js

@@ -68,8 +68,8 @@ export async function createStubModule(modulePath, code, importStatement, esmCac
                 importStatement,
             });
         }
-        catch {
-            // Error collector may not be initialized in all contexts
+        catch (_) {
+            /* expected: error collector may not be initialized in all contexts */
         }
         logger.error(`${LOG_PREFIX_MDX_LOADER} Missing module: ${modulePath}`, {
             namedImports,

package/esm/src/transforms/pipeline/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAEhB,eAAe,EAChB,MAAM,YAAY,CAAC;AA4IpB,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAoI1B;AAoBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CASjB;AAkCD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,GACb,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAEhB,eAAe,EAChB,MAAM,YAAY,CAAC;AA4IpB,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAoI1B;AAoBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CASjB;AAmCD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,GACb,MAAM,cAAc,CAAC"}

package/esm/src/transforms/pipeline/index.js

@@ -246,9 +246,10 @@ export async function transformToESM(source, filePath, projectDir, adapter, opti
 /** Extract readFile from adapter if available, for dependency hash computation. */
 function extractReadFile(adapter) {
     const a = adapter;
-    if (typeof a?.fs?.readFile !== "function")
+    const readFile = a?.fs?.readFile;
+    if (typeof readFile !== "function")
         return undefined;
-    return (path) => a.fs.readFile(path);
+    return (path) => readFile.call(a.fs, path);
 }
 /**
  * Build a readFile helper that avoids routing local framework paths

package/esm/src/transforms/pipeline/stages/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/pipeline/stages/compile.ts"],"names":[],"mappings":"AAIA,OAAO,EAAyB,KAAK,eAAe,EAAkB,MAAM,aAAa,CAAC;AAI1F,eAAO,MAAM,aAAa,EAAE,eAyD3B,CAAC"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/pipeline/stages/compile.ts"],"names":[],"mappings":"AAKA,OAAO,EAAyB,KAAK,eAAe,EAAkB,MAAM,aAAa,CAAC;AAI1F,eAAO,MAAM,aAAa,EAAE,eA4D3B,CAAC"}

package/esm/src/transforms/pipeline/stages/compile.js

@@ -1,5 +1,6 @@
 import { getEsbuild } from "../../../platform/compat/esbuild.js";
 import { rendererLogger } from "../../../utils/index.js";
+import { COMPILATION_ERROR } from "../../../errors/index.js";
 import { getErrorCollector } from "../../../observability/error-collector.js";
 import { getLoaderFromPath } from "../../esm/transform-utils.js";
 import { TransformStage } from "../types.js";
@@ -48,7 +49,10 @@ export const compilePlugin = {
             });
             logger.error("Source preview (first 10 lines):\n" + sourcePreview);
             getErrorCollector().addCompileError(errorMsg, ctx.filePath);
-            throw new Error(`ESM transform failed for ${ctx.filePath} (loader: ${loader}): ${errorMsg}`);
+            throw COMPILATION_ERROR.create({
+                detail: `ESM transform failed for ${ctx.filePath} (loader: ${loader}): ${errorMsg}`,
+                cause: err,
+            });
         }
     },
 };

package/esm/src/transforms/pipeline/stages/ssr-vf-modules/path-resolver.js

@@ -22,8 +22,8 @@ export async function tryReadWithExtensions(fs, basePath) {
                 return { sourcePath, content };
             }
         }
-        catch {
-            // Continue trying other extensions
+        catch (_) {
+            /* expected: file may not exist at this extension */
         }
     }
     return null;
@@ -114,16 +114,16 @@ export async function resolveVeryfrontSourcePath(specifier) {
                 if (await exists(srcPath))
                     return srcPath;
             }
-            catch {
-                // Continue
+            catch (_) {
+                /* expected: file may not exist at this path */
             }
             // Try exact path
             try {
                 if (await exists(basePath))
                     return basePath;
             }
-            catch {
-                // Continue
+            catch (_) {
+                /* expected: file may not exist at this path */
             }
             continue;
         }
@@ -139,8 +139,8 @@ export async function resolveVeryfrontSourcePath(specifier) {
                 if (await exists(pathWithExt))
                     return pathWithExt;
             }
-            catch {
-                // Continue
+            catch (_) {
+                /* expected: file may not exist at this path */
             }
         }
         // Try index file
@@ -150,8 +150,8 @@ export async function resolveVeryfrontSourcePath(specifier) {
                 if (await exists(indexPath))
                     return indexPath;
             }
-            catch {
-                // Continue
+            catch (_) {
+                /* expected: file may not exist at this path */
             }
         }
     }
@@ -187,8 +187,8 @@ export async function resolveRelativeFrameworkImport(specifier, fromSourcePath,
             if (await exists(basePath))
                 return basePath;
         }
-        catch {
-            // Continue
+        catch (_) {
+            /* expected: file may not exist at this path */
         }
         // Try with .src suffix for embedded sources
         try {
@@ -196,8 +196,8 @@ export async function resolveRelativeFrameworkImport(specifier, fromSourcePath,
             if (await exists(srcPath))
                 return srcPath;
         }
-        catch {
-            // Continue
+        catch (_) {
+            /* expected: file may not exist at this path */
         }
         // Not found with explicit extension
         return null;
@@ -213,8 +213,8 @@ export async function resolveRelativeFrameworkImport(specifier, fromSourcePath,
             if (await exists(pathWithExt))
                 return pathWithExt;
         }
-        catch {
-            // Continue
+        catch (_) {
+            /* expected: file may not exist at this path */
         }
     }
     // Try index file
@@ -224,8 +224,8 @@ export async function resolveRelativeFrameworkImport(specifier, fromSourcePath,
             if (await exists(indexPath))
                 return indexPath;
         }
-        catch {
-            // Continue
+        catch (_) {
+            /* expected: file may not exist at this path */
         }
     }
     return null;

package/esm/src/transforms/pipeline/stages/ssr-vf-modules/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/transform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAYrE,OAAO,EAOL,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,EACrB,oBAAoB,UAAQ,EAC5B,KAAK,SAAI,GACR,OAAO,CAAC,MAAM,CAAC,CAoPjB;AAED;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4CxB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAEjB"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/transform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAarE,OAAO,EAOL,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,EACrB,oBAAoB,UAAQ,EAC5B,KAAK,SAAI,GACR,OAAO,CAAC,MAAM,CAAC,CAsPjB;AAED;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4CxB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/esm/src/transforms/pipeline/stages/ssr-vf-modules/transform.js

@@ -6,6 +6,7 @@
  */
 import { join } from "../../../../platform/compat/path/index.js";
 import { rendererLogger as logger } from "../../../../utils/index.js";
+import { IMPORT_RESOLUTION_ERROR } from "../../../../errors/index.js";
 import { replaceSpecifiers } from "../../../esm/lexer.js";
 import { hashCodeHex } from "../../../../utils/hash-utils.js";
 import { getHttpBundleCacheDir, getMdxEsmCacheDir } from "../../../../utils/cache-dir.js";
@@ -146,9 +147,11 @@ export async function transformFrameworkCode(content, sourcePath, ctx, throwOnMi
                 veryfrontReplacements.set(specifier, resolved);
             }
             else if (throwOnMissingImport) {
-                throw new Error(`${LOG_PREFIX} Could not resolve framework import "${specifier}" in ${sourcePath}. ` +
-                    `Expected to find ${join(FRAMEWORK_ROOT, "src", specifier.slice("#veryfront/".length))}.{ts,tsx,js,jsx} ` +
-                    `or an index file at that path.`);
+                throw IMPORT_RESOLUTION_ERROR.create({
+                    detail: `${LOG_PREFIX} Could not resolve framework import "${specifier}" in ${sourcePath}. ` +
+                        `Expected to find ${join(FRAMEWORK_ROOT, "src", specifier.slice("#veryfront/".length))}.{ts,tsx,js,jsx} ` +
+                        `or an index file at that path.`,
+                });
             }
         }
         // Collect and transform relative imports (./foo, ../bar) at any depth.
@@ -173,7 +176,9 @@ export async function transformFrameworkCode(content, sourcePath, ctx, throwOnMi
                 const resolvedPath = await resolveRelativeFrameworkImport(specifier, sourcePath, ctx.fs);
                 if (!resolvedPath) {
                     if (throwOnMissingImport) {
-                        throw new Error(`${LOG_PREFIX} Could not resolve relative import "${specifier}" in ${sourcePath}`);
+                        throw IMPORT_RESOLUTION_ERROR.create({
+                            detail: `${LOG_PREFIX} Could not resolve relative import "${specifier}" in ${sourcePath}`,
+                        });
                     }
                     logger.warn(`${LOG_PREFIX} Could not resolve relative import "${specifier}" in ${sourcePath}`);
                     continue;

package/esm/src/transforms/plugins/babel-node-positions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"babel-node-positions.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/plugins/babel-node-positions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2EH,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAqDrF"}
+{"version":3,"file":"babel-node-positions.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/plugins/babel-node-positions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0EH,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAsDrF"}

package/esm/src/transforms/plugins/babel-node-positions.js

@@ -122,7 +122,8 @@ export function injectNodePositions(source, options) {
             compact: false,
         }).code;
     }
-    catch {
+    catch (_) {
+        /* expected: source may not be parseable TSX/JSX */
         return source;
     }
 }

package/esm/src/transforms/plugins/plugin-loader.d.ts

@@ -1,7 +1,4 @@
-import type { Root as HastRoot } from "@types/hast";
-import type { Root as MdastRoot } from "@types/mdast";
 import type { Pluggable } from "unified";
-export type PluginFunction = (tree: MdastRoot | HastRoot, file?: unknown) => void | Promise<void> | ((tree: MdastRoot | HastRoot, file?: unknown) => void);
 export declare function getRemarkPlugins(): Pluggable[];
 export declare function getRehypePlugins(): Pluggable[];
 //# sourceMappingURL=plugin-loader.d.ts.map

package/esm/src/transforms/plugins/plugin-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/plugins/plugin-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQzC,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,SAAS,GAAG,QAAQ,EAC1B,IAAI,CAAC,EAAE,OAAO,KAEZ,IAAI,GACJ,OAAO,CAAC,IAAI,CAAC,GACb,CAAC,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC;AAE3D,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAQ9C;AAED,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAE9C"}
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/plugins/plugin-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAgBzC,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAQ9C;AAED,wBAAgB,gBAAgB,IAAI,SAAS,EAAE,CAE9C"}

package/esm/src/transforms/plugins/rehype-node-positions.d.ts

@@ -12,8 +12,9 @@
  *   data-node-column — source column number (0-based)
  */
 import type { Root } from "@types/hast";
-export interface RehypeNodePositionsOptions {
+interface RehypeNodePositionsOptions {
     filePath?: string;
 }
 export declare function rehypeNodePositions(options?: RehypeNodePositionsOptions): (tree: Root) => void;
+export {};
 //# sourceMappingURL=rehype-node-positions.d.ts.map

package/esm/src/transforms/plugins/rehype-node-positions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rehype-node-positions.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/plugins/rehype-node-positions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAoCtB"}
+{"version":3,"file":"rehype-node-positions.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/plugins/rehype-node-positions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,aAAa,CAAC;AAGjD,UAAU,0BAA0B;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAoCtB"}

package/esm/src/transforms/shared/cross-project-import.d.ts

@@ -1,8 +1,9 @@
-export interface ParsedCrossProjectImport {
+interface ParsedCrossProjectImport {
     projectSlug: string;
     version: string;
     path: string;
 }
 export declare function isCrossProjectImport(specifier: string): boolean;
 export declare function parseCrossProjectImport(specifier: string): ParsedCrossProjectImport | null;
+export {};
 //# sourceMappingURL=cross-project-import.d.ts.map

package/esm/src/transforms/shared/cross-project-import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cross-project-import.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/shared/cross-project-import.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI,CAU1F"}
+{"version":3,"file":"cross-project-import.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/shared/cross-project-import.ts"],"names":[],"mappings":"AAAA,UAAU,wBAAwB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI,CAU1F"}

package/esm/src/transforms/veryfront-module-urls.d.ts

@@ -1,3 +1,2 @@
 export declare function resolveVeryfrontModuleUrl(specifier: string): string | null;
-export declare function getVeryfrontModuleUrlMap(): Record<string, string>;
 //# sourceMappingURL=veryfront-module-urls.d.ts.map

package/esm/src/transforms/veryfront-module-urls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"veryfront-module-urls.d.ts","sourceRoot":"","sources":["../../../src/src/transforms/veryfront-module-urls.ts"],"names":[],"mappings":"AAmDA,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEjE"}
+{"version":3,"file":"veryfront-module-urls.d.ts","sourceRoot":"","sources":["../../../src/src/transforms/veryfront-module-urls.ts"],"names":[],"mappings":"AAmDA,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1E"}

package/esm/src/transforms/veryfront-module-urls.js

@@ -39,6 +39,3 @@ for (const [key, target] of Object.entries(config.exports ?? {})) {
 export function resolveVeryfrontModuleUrl(specifier) {
     return veryfrontModuleUrlMap.get(specifier) ?? null;
 }
-export function getVeryfrontModuleUrlMap() {
-    return Object.fromEntries(veryfrontModuleUrlMap);
-}

package/esm/src/types/entities/getEntityInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getEntityInfo.d.ts","sourceRoot":"","sources":["../../../../src/src/types/entities/getEntityInfo.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAU,UAAU,EAAe,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAWtE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAyI5B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6L5B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAyE5B"}
+{"version":3,"file":"getEntityInfo.d.ts","sourceRoot":"","sources":["../../../../src/src/types/entities/getEntityInfo.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAU,UAAU,EAAe,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAWtE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6I5B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA+L5B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAyE5B"}

package/esm/src/types/entities/getEntityInfo.js

@@ -69,8 +69,8 @@ export async function getEntityInfo(filePath, adapter) {
                     frontmatter = extracted.attrs;
                     body = extracted.body;
                 }
-                catch {
-                    // Malformed YAML frontmatter - continue with empty frontmatter
+                catch (_) {
+                    /* expected: malformed YAML frontmatter */
                 }
             }
             const fileName = filePath.split("/").pop() ?? "";
@@ -81,8 +81,10 @@ export async function getEntityInfo(filePath, adapter) {
                     const adapterFs = adapter.fs;
                     if (isExtendedFSAdapter(adapterFs) && adapterFs.isVeryfrontAdapter()) {
                         const underlyingAdapter = adapterFs.getUnderlyingAdapter();
-                        const getEntityIdForPath = underlyingAdapter?.getEntityIdForPath;
-                        if (getEntityIdForPath) {
+                        if (underlyingAdapter &&
+                            "getEntityIdForPath" in underlyingAdapter &&
+                            typeof underlyingAdapter.getEntityIdForPath === "function") {
+                            const getEntityIdForPath = underlyingAdapter.getEntityIdForPath;
                             const relativePath = filePath
                                 .replace(/^.*?\/pages\//, "pages/")
                                 .replace(/^.*?\/components\//, "components/");
@@ -90,8 +92,8 @@ export async function getEntityInfo(filePath, adapter) {
                         }
                     }
                 }
-                catch {
-                    // Ignore errors, fall back to file path
+                catch (_) {
+                    /* expected: entity ID extraction may fail, fall back to file path */
                 }
             }
             const entity = {
@@ -168,7 +170,8 @@ export async function getEntityBySlug(projectDir, slug, adapter) {
                         const stat = await withFallback(() => adapter.fs.stat(pagesDir), () => fs.stat(pagesDir), { operationName: "stat:getEntityBySlug", logError: false });
                         dirExists = stat.isDirectory;
                     }
-                    catch {
+                    catch (_) {
+                        /* expected: stat may fail for non-existent directories */
                         dirExists = false;
                     }
                     if (!dirExists)
@@ -187,8 +190,8 @@ export async function getEntityBySlug(projectDir, slug, adapter) {
                             return info;
                     }
                 }
-                catch {
-                    // Directory doesn't exist or error reading it, continue to next depth
+                catch (_) {
+                    /* expected: directory may not exist or readDir may fail */
                 }
             }
             logger.debug("No page found via resolveFile branch", { slug });
@@ -232,7 +235,8 @@ export async function getEntityBySlug(projectDir, slug, adapter) {
                         const stat = await withFallback(() => adapter.fs.stat(pagesDir), () => fs.stat(pagesDir), { operationName: "stat:getEntityBySlug", logError: false });
                         dirExists = stat.isDirectory;
                     }
-                    catch {
+                    catch (_) {
+                        /* expected: stat may fail for non-existent directories */
                         dirExists = false;
                     }
                 }
@@ -258,8 +262,8 @@ export async function getEntityBySlug(projectDir, slug, adapter) {
                         return info;
                 }
             }
-            catch {
-                // Directory doesn't exist or error reading it, continue to next depth
+            catch (_) {
+                /* expected: directory may not exist or readDir may fail */
             }
         }
         return null;

package/esm/src/types/entities.d.ts

@@ -1,4 +1,3 @@
-import { z } from "zod";
 export interface Frontmatter {
     title?: string;
     description?: string;
@@ -48,9 +47,5 @@ export interface EntityTypeInfo {
     isComponent: boolean;
     isPage: boolean;
 }
-export declare const FrontmatterSchema: z.ZodType<Frontmatter>;
-export declare const EntitySchema: z.ZodType<Entity>;
-export declare function validateEntity(entity: unknown): Entity;
-export declare function safeValidateEntity(entity: unknown): Entity | null;
 export declare function detectEntityType(fileName: string, frontmatter?: Frontmatter): EntityTypeInfo;
 //# sourceMappingURL=entities.d.ts.map

package/esm/src/types/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/src/types/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACjE;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAYD,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAGpD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAiBzC,CAAC;AAEH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGjE;AAiBD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,WAAgB,GAC5B,cAAc,CAyBhB"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/src/types/entities.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACjE;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAiBD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,WAAgB,GAC5B,cAAc,CAyBhB"}

package/esm/src/types/entities.js

@@ -1,35 +1,3 @@
-import { z } from "zod";
-const FILE_PATH_REGEX = /\.(mdx?|tsx?|jsx?)$/;
-const FrontmatterValueSchema = z.union([
-    z.string(),
-    z.number(),
-    z.boolean(),
-    z.array(z.string()),
-    z.undefined(),
-]);
-export const FrontmatterSchema = z.record(z.string(), FrontmatterValueSchema);
-export const EntitySchema = z.object({
-    id: z.string().uuid("Entity id must be a valid UUID"),
-    path: z
-        .string()
-        .min(1, "Entity path cannot be empty")
-        .regex(FILE_PATH_REGEX, "Entity path must end with a valid file extension (.md, .mdx, .ts, .tsx, .js, .jsx)"),
-    slug: z.string().min(1, "Entity slug cannot be empty"),
-    type: z.enum(["page", "layout", "component"]),
-    content: z.string(),
-    frontmatter: FrontmatterSchema,
-    kind: z.enum(["mdx", "tsx"]).optional(),
-    isLayout: z.boolean().optional(),
-    isComponent: z.boolean().optional(),
-    isPage: z.boolean().optional(),
-});
-export function validateEntity(entity) {
-    return EntitySchema.parse(entity);
-}
-export function safeValidateEntity(entity) {
-    const result = EntitySchema.safeParse(entity);
-    return result.success ? result.data : null;
-}
 function detectFileKind(ext) {
     if (ext === "mdx")
         return "mdx";

package/esm/src/utils/box.js

@@ -4,7 +4,7 @@
  * Creates polished bordered boxes with various styles.
  * Inspired by Lip Gloss (charmbracelet).
  */
-// deno-lint-ignore no-control-regex
+// deno-lint-ignore no-control-regex -- intentional: matches ANSI escape sequences for terminal color stripping
 const ANSI_REGEX = /\x1b\[[0-9;]*m/g;
 const RESET = `\x1b[0m`;
 export function stripAnsi(text) {

package/esm/src/utils/bundle-manifest-init.d.ts

@@ -11,9 +11,7 @@ interface BundleManifestConfig {
         };
     };
 }
-import { type BundleManifestStore } from "./bundle-manifest.js";
 export declare function initializeBundleManifest(config: BundleManifestConfig, mode: "development" | "production", adapter?: RuntimeAdapter): Promise<void>;
 export declare function getBundleManifestTTL(config: BundleManifestConfig, mode: "development" | "production"): number | undefined;
-export declare function warmupBundleManifest(store: BundleManifestStore, keys: string[]): Promise<void>;
 export {};
 //# sourceMappingURL=bundle-manifest-init.d.ts.map

package/esm/src/utils/bundle-manifest-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle-manifest-init.d.ts","sourceRoot":"","sources":["../../../src/src/utils/bundle-manifest-init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,oEAAoE;AACpE,UAAU,oBAAoB;IAC5B,KAAK,CAAC,EAAE;QACN,cAAc,CAAC,EAAE;YACf,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,GAAG,CAAC,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AACD,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,sBAAsB,CAAC;AAK9B,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,aAAa,GAAG,YAAY,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAkDD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,aAAa,GAAG,YAAY,GACjC,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAoBf"}
+{"version":3,"file":"bundle-manifest-init.d.ts","sourceRoot":"","sources":["../../../src/src/utils/bundle-manifest-init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,oEAAoE;AACpE,UAAU,oBAAoB;IAC5B,KAAK,CAAC,EAAE;QACN,cAAc,CAAC,EAAE;YACf,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,GAAG,CAAC,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;CACH;AAUD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,aAAa,GAAG,YAAY,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAkDD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,aAAa,GAAG,YAAY,GACjC,MAAM,GAAG,SAAS,CAMpB"}