@brandlab-digital/conformance 0.1.0-alpha.9 → 1.0.0-rc.1

package/dist/vitest.js

@@ -12,6 +12,7 @@ const DEFAULT_EXTENSIONS = new Set([
 const DEFAULT_IGNORED_DIRS = new Set([
     "node_modules",
     ".next",
+    ".vercel",
     "dist",
     "coverage",
 ]);
@@ -49,6 +50,19 @@ const DEFAULT_TOPOLOGY_ALLOWED_LIB_DIRS = [
 ];
 const DEFAULT_TOPOLOGY_ALLOWED_TYPE_FILES = [];
 const STANDARD_PACKAGE_MANAGER = "npm@11.14.1";
+const STANDARD_NEXT_BASELINE = {
+    baseline: "2026-07",
+    nextVersion: "16.2.9",
+    reactVersion: "19.2.7",
+    reactDomVersion: "19.2.7",
+    node: "24.x",
+    minimumNode: "20.9.0",
+    router: "app",
+    bundler: "turbopack",
+    cacheComponents: false,
+    analyzeBundleScript: "next experimental-analyze",
+    imageQualities: [75, 90],
+};
 const STANDARD_TYPESCRIPT_TARGET = "ES2022";
 const CONTENT_ARRAY_NAMES = [
     "faqs",
@@ -430,11 +444,44 @@ const STANDARD_CONTACT_MODULE_FILES = new Set([
     "useContactAttachments.ts",
     "useFormDraftPersistence.ts",
 ]);
+const CONTACT_EMAIL_CONTRACT_REQUIREMENTS = [
+    {
+        code: "brandlab-architecture-contact-email-submission-id",
+        pattern: /\bsubmissionId\b/,
+        detail: "src/lib/contact/ContactFormEmail.tsx must include the shared submissionId field.",
+    },
+    {
+        code: "brandlab-architecture-contact-email-page-path",
+        pattern: /\bpagePath\b/,
+        detail: "src/lib/contact/ContactFormEmail.tsx must include the submitted pagePath field.",
+    },
+    {
+        code: "brandlab-architecture-contact-email-page-url",
+        pattern: /\bpageUrl\b/,
+        detail: "src/lib/contact/ContactFormEmail.tsx must include the submitted pageUrl field.",
+    },
+    {
+        code: "brandlab-architecture-contact-email-traffic-source",
+        pattern: /\btrafficSource\b/,
+        detail: "src/lib/contact/ContactFormEmail.tsx must include the trafficSource field.",
+    },
+    {
+        code: "brandlab-architecture-contact-email-ad-click-rows",
+        pattern: /\b(adClickIds|getAdClickIdRows|formatAdClickIdsForEmailText)\b/,
+        detail: "src/lib/contact/ContactFormEmail.tsx must include ad-click ID rows.",
+    },
+    {
+        code: "brandlab-architecture-contact-email-attachments",
+        pattern: /\b(attachmentCount|attachments|formatContactFormEmailAttachmentSummary|getContactFormEmailContextRows)\b/,
+        detail: "src/lib/contact/ContactFormEmail.tsx must include an attachment summary.",
+    },
+];
 const ALLOWED_RICH_DATA_CONTENT_PATTERNS = [
     /^src\/data\/site\/legal\/[^/]+\.(?:ts|tsx)$/,
 ];
 const LEGACY_ENV_ARTIFACT_PATTERNS = [
     /\bNEXT_PUBLIC_RECAPTCHA_SITE_KEY\b/,
+    /\bNEXT_PUBLIC_GOOGLE_MAPS(?:_PLATFORM)?_API_KEY\b/,
     /\bRECAPTCHA_SECRET_KEY\b/,
     /\bOUTLOOK_EMAIL\b/,
     /\bOUTLOOK_PASSWORD\b/,
@@ -459,6 +506,10 @@ export const BRANDLAB_FORBIDDEN_SOURCE_PATTERNS = [
         name: "sitemap filesystem freshness",
         pattern: /\bfs\.statSync\b|\.mtime\b|\bmtime\b/,
     },
+    {
+        name: "public Google Maps API key",
+        pattern: /\bNEXT_PUBLIC_GOOGLE_MAPS(?:_PLATFORM)?_API_KEY\b/,
+    },
 ];
 function fileExtension(path) {
     const match = path.match(/\.[^.]+$/);
@@ -502,6 +553,36 @@ function appFamilyForPage(path) {
         return "home";
     return withoutPrefix.split("/")[0] ?? "unknown";
 }
+function appRouteFileIsDynamic(path) {
+    return /\/\[[^\]]+\]\//.test(path) || /\[[^\]]+\]/.test(path);
+}
+function routeTemplateImportMatches(source) {
+    return [
+        ...source.matchAll(/^\s*import\s+([^'"\n]+?)\s+from\s+['"](@\/components\/templates\/[^'"]+)['"]/gm),
+    ].flatMap((match) => {
+        const importClause = match[1].trim();
+        const modulePath = match[2];
+        const names = [];
+        const defaultName = importClause
+            .replace(/\{[\s\S]*?\}/g, "")
+            .split(",")[0]
+            ?.trim();
+        if (defaultName)
+            names.push(defaultName);
+        const namedClause = importClause.match(/\{([\s\S]*?)\}/)?.[1];
+        if (namedClause) {
+            for (const part of namedClause.split(",")) {
+                const name = part.trim().split(/\s+as\s+/).pop()?.trim();
+                if (name)
+                    names.push(name);
+            }
+        }
+        return names.map((name) => ({
+            localName: name,
+            modulePath,
+        }));
+    });
+}
 function extractQuotedStrings(line) {
     const strings = [];
     let quote = null;
@@ -721,6 +802,65 @@ function getPackageVersion(packageJson, packageName) {
         packageJson.devDependencies?.[packageName] ??
         null);
 }
+function isExactVersionSpec(version) {
+    return typeof version === "string" && !/^[~^*]|latest|workspace:|file:|link:/.test(version);
+}
+function extractDelimitedProperty(source, propertyName, openChar, closeChar) {
+    const propertyMatch = source.match(new RegExp(`${propertyName}\\s*:`));
+    if (!propertyMatch || propertyMatch.index === undefined)
+        return null;
+    const start = source.indexOf(openChar, propertyMatch.index + propertyMatch[0].length);
+    if (start === -1)
+        return null;
+    let depth = 0;
+    let quote = null;
+    let escaped = false;
+    for (let index = start; index < source.length; index += 1) {
+        const char = source[index];
+        if (quote) {
+            if (escaped)
+                escaped = false;
+            else if (char === "\\")
+                escaped = true;
+            else if (char === quote)
+                quote = null;
+            continue;
+        }
+        if (char === '"' || char === "'" || char === "`")
+            quote = char;
+        else if (char === openChar)
+            depth += 1;
+        else if (char === closeChar) {
+            depth -= 1;
+            if (depth === 0)
+                return source.slice(start + 1, index);
+        }
+    }
+    return null;
+}
+function extractStringProperty(source, propertyName) {
+    return source.match(new RegExp(`${propertyName}\\s*:\\s*['"\`]([^'"\`]+)['"\`]`, "m"))?.[1] ?? null;
+}
+function parseBrandlabNextContract(source) {
+    const nextSource = extractDelimitedProperty(source, "next", "{", "}");
+    if (!nextSource)
+        return null;
+    return {
+        baseline: extractStringProperty(nextSource, "baseline"),
+        nextVersion: extractStringProperty(nextSource, "nextVersion"),
+        reactVersion: extractStringProperty(nextSource, "reactVersion"),
+        reactDomVersion: extractStringProperty(nextSource, "reactDomVersion"),
+        node: extractStringProperty(nextSource, "node"),
+        minimumNode: extractStringProperty(nextSource, "minimumNode"),
+        router: extractStringProperty(nextSource, "router"),
+        bundler: extractStringProperty(nextSource, "bundler"),
+        cacheComponents: /cacheComponents\s*:\s*true/m.test(nextSource)
+            ? true
+            : /cacheComponents\s*:\s*false/m.test(nextSource)
+                ? false
+                : null,
+    };
+}
 export function evaluateSharedPackageVersionSpecs(options) {
     const issues = [];
     for (const packageName of options.packageNames) {
@@ -1180,6 +1320,7 @@ export function evaluateBrandlabArchitecture(options) {
                     severity: "error",
                     code: "brandlab-architecture-component-page-module",
                     detail: `${relativePath} is a route-owned page module inside components. Standard projects keep route files in src/app, page data in src/data, and reusable templates directly under src/components/templates.`,
+                    fix: "Move page-specific content and SEO records into src/data/site/pages, compose one-off static pages directly in the matching src/app route, and keep src/components/templates for dynamic route families or templates shared by multiple routes.",
                     path: relativePath,
                 });
             }
@@ -1188,6 +1329,7 @@ export function evaluateBrandlabArchitecture(options) {
                     severity: "error",
                     code: "brandlab-architecture-component-static-page",
                     detail: `${relativePath} keeps a static page module inside components. Standard projects keep route ownership in src/app and page models in src/data.`,
+                    fix: "Move static page model data into src/data/site/pages and compose the one-off static page directly in the matching src/app route. Keep src/components/templates for dynamic route families or templates shared by multiple routes.",
                     path: relativePath,
                 });
             }
@@ -1319,7 +1461,7 @@ export function evaluateBrandlabArchitecture(options) {
             const directComponentImports = [
                 ...source.matchAll(/from\s+['"](@\/components\/(?:sections|contact|ui)\/[^'"]+)['"]/g),
             ].map((match) => match[1]);
-            if (directComponentImports.length > 0) {
+            if (appRouteFileIsDynamic(relativePath) && directComponentImports.length > 0) {
                 issues.push({
                     severity: "error",
                     code: "brandlab-architecture-route-direct-component-composition",
@@ -1476,6 +1618,15 @@ export function evaluateBrandlabArchitecture(options) {
                     path: relativePath,
                 });
             }
+            if (/\baggregateRating\b|\bAggregateRating\b|['"]Review['"]|\breviewRating\b|\breview\s*:/.test(source)) {
+                issues.push({
+                    severity: "error",
+                    code: "brandlab-architecture-self-serving-review-schema",
+                    detail: `${relativePath} emits Review or AggregateRating schema from a local service-business site. Google treats business-controlled LocalBusiness/Organization review markup as self-serving and ineligible for review snippets.`,
+                    fix: "Keep customer testimonials/reviews as visible page content only. Do not emit Review or AggregateRating JSON-LD for the client's own local business or services.",
+                    path: relativePath,
+                });
+            }
             if (!/export\s+function\s+createSchema(?:Graph)?\b/.test(source))
                 continue;
             if (source.includes("@brandlab-digital/site-core/schema"))
@@ -1803,6 +1954,16 @@ export function evaluateBrandlabArchitecture(options) {
                 path: "src/lib/contact/ContactFormEmail.tsx",
             });
         }
+        for (const requirement of CONTACT_EMAIL_CONTRACT_REQUIREMENTS) {
+            if (contactEmailSource && !requirement.pattern.test(contactEmailSource)) {
+                issues.push({
+                    severity: "error",
+                    code: requirement.code,
+                    detail: requirement.detail,
+                    path: "src/lib/contact/ContactFormEmail.tsx",
+                });
+            }
+        }
         if (/message\s*:\s*error\s+instanceof\s+Error\s*&&\s*error\.message/.test(actionsSource)) {
             issues.push({
                 severity: "error",
@@ -1923,6 +2084,49 @@ export function evaluateBrandlabArchitecture(options) {
                     path: "package.json",
                 });
             }
+            for (const [packageName, expectedVersion] of [
+                ["next", STANDARD_NEXT_BASELINE.nextVersion],
+                ["react", STANDARD_NEXT_BASELINE.reactVersion],
+                ["react-dom", STANDARD_NEXT_BASELINE.reactDomVersion],
+            ]) {
+                const installedVersion = getPackageVersion(packageJson, packageName);
+                if (installedVersion === expectedVersion && isExactVersionSpec(installedVersion))
+                    continue;
+                issues.push({
+                    severity: "error",
+                    code: "brandlab-architecture-next-package-version",
+                    detail: `package.json installs ${packageName} as "${installedVersion ?? "missing"}"; expected exact "${expectedVersion}".`,
+                    path: "package.json",
+                });
+            }
+            if (packageJson.engines?.node !== STANDARD_NEXT_BASELINE.node) {
+                issues.push({
+                    severity: "error",
+                    code: "brandlab-architecture-next-node-engine",
+                    detail: `package.json engines.node is "${packageJson.engines?.node ?? "missing"}"; expected "${STANDARD_NEXT_BASELINE.node}".`,
+                    path: "package.json",
+                });
+            }
+            const webpackScripts = Object.entries(packageJson.scripts ?? {})
+                .filter(([, script]) => typeof script === "string" && /--webpack/.test(script))
+                .map(([scriptName]) => scriptName);
+            if (webpackScripts.length > 0) {
+                issues.push({
+                    severity: "error",
+                    code: "brandlab-architecture-next-webpack-script",
+                    detail: `package.json contains webpack fallback scripts: ${webpackScripts.join(", ")}.`,
+                    path: "package.json",
+                });
+            }
+            if (packageJson.scripts?.["analyze:bundle"] &&
+                packageJson.scripts["analyze:bundle"] !== STANDARD_NEXT_BASELINE.analyzeBundleScript) {
+                issues.push({
+                    severity: "error",
+                    code: "brandlab-architecture-next-bundle-analysis-script",
+                    detail: `package.json analyze:bundle is "${packageJson.scripts["analyze:bundle"]}"; expected "${STANDARD_NEXT_BASELINE.analyzeBundleScript}".`,
+                    path: "package.json",
+                });
+            }
         }
         const tsconfigPath = join(options.root, "tsconfig.json");
         if (existsSync(tsconfigPath)) {
@@ -2133,6 +2337,48 @@ export function evaluateBrandlabArchitecture(options) {
         const brandlabConfigSource = existsSync(brandlabConfigPath)
             ? readFileSync(brandlabConfigPath, "utf8")
             : "";
+        const brandlabNextContract = parseBrandlabNextContract(brandlabConfigSource);
+        if (!brandlabNextContract) {
+            issues.push({
+                severity: "error",
+                code: "brandlab-architecture-next-contract",
+                detail: "brandlab.config.ts does not declare the Brandlab Next Baseline 2026-07 next contract.",
+                path: "brandlab.config.ts",
+            });
+        }
+        else {
+            for (const [fieldName, expectedValue] of [
+                ["baseline", STANDARD_NEXT_BASELINE.baseline],
+                ["nextVersion", STANDARD_NEXT_BASELINE.nextVersion],
+                ["reactVersion", STANDARD_NEXT_BASELINE.reactVersion],
+                ["reactDomVersion", STANDARD_NEXT_BASELINE.reactDomVersion],
+                ["node", STANDARD_NEXT_BASELINE.node],
+                ["minimumNode", STANDARD_NEXT_BASELINE.minimumNode],
+                ["router", STANDARD_NEXT_BASELINE.router],
+                ["bundler", STANDARD_NEXT_BASELINE.bundler],
+            ]) {
+                if (brandlabNextContract[fieldName] === expectedValue)
+                    continue;
+                issues.push({
+                    severity: "error",
+                    code: "brandlab-architecture-next-contract",
+                    detail: `brandlab.config.ts next.${fieldName} is "${brandlabNextContract[fieldName] ?? "missing"}"; expected "${expectedValue}".`,
+                    path: "brandlab.config.ts",
+                });
+            }
+            if (brandlabNextContract.cacheComponents !== STANDARD_NEXT_BASELINE.cacheComponents) {
+                issues.push({
+                    severity: "error",
+                    code: "brandlab-architecture-next-cache-components",
+                    detail: "brandlab.config.ts enables cacheComponents outside the approved Brandlab pilot track.",
+                    path: "brandlab.config.ts",
+                });
+            }
+        }
+        const contactAttachmentsPath = join(options.root, "src/lib/contact/attachments.ts");
+        const contactAttachmentsSource = existsSync(contactAttachmentsPath)
+            ? readFileSync(contactAttachmentsPath, "utf8")
+            : "";
         if (brandlabConfigSource.includes("contactAttachments") &&
             !/serverActions\s*:\s*\{[\s\S]*bodySizeLimit\s*:\s*['"]20mb['"]/.test(nextConfigSource)) {
             issues.push({
@@ -2142,6 +2388,67 @@ export function evaluateBrandlabArchitecture(options) {
                 path: "next.config.ts",
             });
         }
+        if (brandlabConfigSource.includes("contactAttachments") &&
+            !/filenamePrefix\s*:\s*['"`][a-z0-9][a-z0-9-]{2,48}['"`]/.test(contactConstantsSource)) {
+            issues.push({
+                severity: "error",
+                code: "brandlab-architecture-contact-attachment-prefix",
+                detail: "Contact attachment policy does not define an explicit project-specific filenamePrefix.",
+                path: "src/lib/contact/constants.ts",
+            });
+        }
+        if (existsSync(join(options.root, "pages")) || existsSync(join(options.root, "src/pages"))) {
+            issues.push({
+                severity: "error",
+                code: "brandlab-architecture-pages-router-directory",
+                detail: "Project contains pages/ or src/pages/. Brandlab Next Baseline is App Router only.",
+            });
+        }
+        for (const filePath of walkAllFiles(options.root)) {
+            if (!/\.(?:ts|tsx|js|jsx)$/.test(filePath))
+                continue;
+            const relativePath = relative(options.root, filePath).split(/[/\\]/).join("/");
+            if (relativePath.startsWith("node_modules/") ||
+                relativePath.startsWith(".next/") ||
+                relativePath.startsWith("dist/")) {
+                continue;
+            }
+            const source = readFileSync(filePath, "utf8");
+            const pagesRouterApiPatterns = [
+                ["next/head", /\bfrom\s+['"]next\/head['"]/],
+                ["getStaticProps", /\bgetStaticProps\b/],
+                ["getServerSideProps", /\bgetServerSideProps\b/],
+            ];
+            const pagesRouterApis = pagesRouterApiPatterns.filter(([, pattern]) => pattern.test(source));
+            if (pagesRouterApis.length > 0) {
+                issues.push({
+                    severity: "error",
+                    code: "brandlab-architecture-pages-router-api",
+                    detail: `${relativePath} references Pages Router APIs: ${pagesRouterApis.map(([label]) => label).join(", ")}.`,
+                    path: relativePath,
+                });
+            }
+            const invalidQualities = [...new Set([...source.matchAll(/\bquality\s*=\s*\{?\s*(\d+)\s*\}?/g)]
+                    .map((match) => Number(match[1]))
+                    .filter((quality) => !STANDARD_NEXT_BASELINE.imageQualities.includes(quality)))].sort((a, b) => a - b);
+            if (invalidQualities.length > 0) {
+                issues.push({
+                    severity: "error",
+                    code: "brandlab-architecture-next-image-quality",
+                    detail: `${relativePath} uses unsupported next/image quality values: ${invalidQualities.join(", ")}.`,
+                    path: relativePath,
+                });
+            }
+        }
+        if (/createContactAttachmentFilename\s*\(/.test(contactAttachmentsSource) &&
+            !/(prefix\s*:\s*contactAttachmentPolicy\.filenamePrefix|policy\s*:\s*contactAttachmentPolicy)/.test(contactAttachmentsSource)) {
+            issues.push({
+                severity: "error",
+                code: "brandlab-architecture-contact-attachment-filename",
+                detail: "Contact attachment filename generation does not use the project-specific attachment filename prefix.",
+                path: "src/lib/contact/attachments.ts",
+            });
+        }
         if (/const\s+staticLegacyMappings\s*[:=]/.test(nextConfigSource)) {
             issues.push({
                 severity: "error",
@@ -2150,6 +2457,50 @@ export function evaluateBrandlabArchitecture(options) {
                 path: "next.config.ts",
             });
         }
+        if (/cacheComponents\s*:\s*true/.test(nextConfigSource)) {
+            issues.push({
+                severity: "error",
+                code: "brandlab-architecture-next-cache-components",
+                detail: "next.config.ts enables cacheComponents outside the approved Brandlab pilot track.",
+                path: "next.config.ts",
+            });
+        }
+        if (!/images\s*:\s*\{/.test(nextConfigSource)) {
+            issues.push({
+                severity: "error",
+                code: "brandlab-architecture-next-image-config",
+                detail: "next.config.ts must define an explicit images config.",
+                path: "next.config.ts",
+            });
+        }
+        else {
+            for (const [code, detail, pattern] of [
+                [
+                    "brandlab-architecture-next-image-qualities",
+                    "next.config.ts images.qualities must be [75, 90].",
+                    /qualities\s*:\s*\[\s*75\s*,\s*90\s*\]/,
+                ],
+                [
+                    "brandlab-architecture-next-image-cache-ttl",
+                    "next.config.ts images.minimumCacheTTL is missing.",
+                    /minimumCacheTTL\s*:/,
+                ],
+                [
+                    "brandlab-architecture-next-image-remote-patterns",
+                    "next.config.ts images.remotePatterns is missing.",
+                    /remotePatterns\s*:\s*\[/,
+                ],
+            ]) {
+                if (pattern.test(nextConfigSource))
+                    continue;
+                issues.push({
+                    severity: "error",
+                    code,
+                    detail,
+                    path: "next.config.ts",
+                });
+            }
+        }
         const envExamplePath = join(options.root, ".env.example");
         if (existsSync(envExamplePath) &&
             LEGACY_ENV_ARTIFACT_PATTERNS.some((pattern) => pattern.test(readFileSync(envExamplePath, "utf8")))) {
@@ -2194,6 +2545,7 @@ export function evaluateBrandlabArchitecture(options) {
         }
     }
     const familyCounts = new Map();
+    const templateImportRouteCounts = new Map();
     for (const filePath of pageFiles) {
         const family = appFamilyForPage(filePath);
         const current = familyCounts.get(family) ?? {
@@ -2208,7 +2560,16 @@ export function evaluateBrandlabArchitecture(options) {
         const source = readFileSync(join(options.root, filePath), "utf8");
         const lineCount = source.split(/\r?\n/).length;
         const routeOwnedContentChars = countRouteOwnedContentChars(source);
-        if (lineCount > largeRouteFileLineLimit) {
+        for (const templateImport of routeTemplateImportMatches(source)) {
+            const key = `${templateImport.modulePath}::${templateImport.localName}`;
+            const currentImport = templateImportRouteCounts.get(key) ?? {
+                modulePath: templateImport.modulePath,
+                routes: new Set(),
+            };
+            currentImport.routes.add(filePath);
+            templateImportRouteCounts.set(key, currentImport);
+        }
+        if (appRouteFileIsDynamic(filePath) && lineCount > largeRouteFileLineLimit) {
             issues.push({
                 severity: "error",
                 code: "large-route-file",
@@ -2216,15 +2577,15 @@ export function evaluateBrandlabArchitecture(options) {
                 path: filePath,
             });
         }
-        if (routeOwnedContentChars > routeFileContentCharLimit) {
+        if (appRouteFileIsDynamic(filePath) && routeOwnedContentChars > routeFileContentCharLimit) {
             issues.push({
                 severity: "error",
                 code: "route-owned-page-copy",
-                detail: `Route file contains about ${routeOwnedContentChars} characters of customer-facing copy. Standard route files should orchestrate data and components, not own page copy.`,
+                detail: `Dynamic route file contains about ${routeOwnedContentChars} characters of customer-facing copy. Standard dynamic route families should orchestrate data and components, not own repeated page copy.`,
                 path: filePath,
             });
         }
-        if (CONTENT_ARRAY_PATTERN.test(source)) {
+        if (appRouteFileIsDynamic(filePath) && CONTENT_ARRAY_PATTERN.test(source)) {
             issues.push({
                 severity: "error",
                 code: "embedded-route-content-array",
@@ -2240,7 +2601,9 @@ export function evaluateBrandlabArchitecture(options) {
                 path: filePath,
             });
         }
-        const copyMatches = routeOwnedCopyPropertyMatches(source);
+        const copyMatches = appRouteFileIsDynamic(filePath)
+            ? routeOwnedCopyPropertyMatches(source)
+            : [];
         if (copyMatches.length > 0) {
             const propertyNames = [
                 ...new Set(copyMatches.map((match) => match.propertyName)),
@@ -2277,6 +2640,19 @@ export function evaluateBrandlabArchitecture(options) {
             });
         }
     }
+    for (const { modulePath, routes } of templateImportRouteCounts.values()) {
+        if (routes.size !== 1)
+            continue;
+        const [routePath] = [...routes];
+        if (appRouteFileIsDynamic(routePath))
+            continue;
+        issues.push({
+            severity: "error",
+            code: "brandlab-architecture-single-use-page-template",
+            detail: `${routePath} imports ${modulePath}, but that template is only used by one static route. Static one-off pages should compose page sections directly in src/app; keep src/components/templates for reusable dynamic route families or templates shared by multiple routes.`,
+            path: routePath,
+        });
+    }
     const staticRouteFileLimit = architecture?.staticRouteFileLimit ?? DEFAULT_STATIC_ROUTE_FILE_LIMIT;
     for (const [family, counts] of familyCounts.entries()) {
         if (counts.staticCount > staticRouteFileLimit &&