@brandlab-digital/conformance 2.1.0 → 3.1.0

package/dist/source-files.js

@@ -0,0 +1,323 @@
+import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
+import { join, posix } from "node:path";
+import ts from "typescript";
+/** Directory roots that can hold project-owned application source. */
+export const BRANDLAB_SOURCE_ROOT_DIRECTORIES = [
+    "src",
+    "app",
+    "components",
+    "lib",
+    "config",
+    "hooks",
+    "context",
+    "utils",
+    "data",
+];
+const SOURCE_FILE_PATTERN = /\.[cm]?[jt]sx?$/;
+const TEST_FILE_PATTERN = /\.(?:test|spec)\.[cm]?[jt]sx?$/;
+const ROOT_SOURCE_FILE_PATTERN = /^(?:instrumentation[\w.-]*|proxy|middleware|next\.config|mdx-components)\.[cm]?[jt]sx?$/;
+const RESOLUTION_EXTENSIONS = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
+/** Collect every non-test source file under the recognised project roots. */
+export function collectBrandlabSource(root) {
+    if (!isDirectory(root)) {
+        return { root, directoryRoots: [], rootFiles: [], files: [], byPath: new Map() };
+    }
+    const directoryRoots = BRANDLAB_SOURCE_ROOT_DIRECTORIES.filter((name) => isDirectory(join(root, name)));
+    const rootFiles = readdirSync(root, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && ROOT_SOURCE_FILE_PATTERN.test(entry.name))
+        .map((entry) => entry.name)
+        .sort();
+    const paths = [
+        ...directoryRoots.flatMap((name) => walkSourceFiles(root, name)),
+        ...rootFiles,
+    ].sort();
+    const files = paths.map((path) => {
+        const text = readFileSync(join(root, path), "utf8");
+        return { path, text, executable: stripCommentsPreservingLayout(text) };
+    });
+    return {
+        root,
+        directoryRoots: [...directoryRoots],
+        rootFiles,
+        files,
+        byPath: new Map(files.map((file) => [file.path, file])),
+    };
+}
+/** List every file below a project-relative directory, skipping dependencies and dot entries. */
+export function walkProjectFiles(root, directory) {
+    const absolute = join(root, directory);
+    if (!isDirectory(absolute))
+        return [];
+    const files = [];
+    for (const entry of readdirSync(absolute, { withFileTypes: true })) {
+        if (entry.name.startsWith(".") || entry.name === "node_modules" || entry.isSymbolicLink())
+            continue;
+        const path = posix.join(directory, entry.name);
+        if (entry.isDirectory())
+            files.push(...walkProjectFiles(root, path));
+        else if (entry.isFile())
+            files.push(path);
+    }
+    return files.sort();
+}
+function walkSourceFiles(root, directory) {
+    return walkProjectFiles(root, directory).filter((path) => {
+        const name = posix.basename(path);
+        return SOURCE_FILE_PATTERN.test(name) && !TEST_FILE_PATTERN.test(name);
+    });
+}
+const parsedFiles = new WeakMap();
+export function parseBrandlabSourceFile(file) {
+    const cached = parsedFiles.get(file);
+    if (cached)
+        return cached;
+    const parsed = ts.createSourceFile(file.path, file.text, ts.ScriptTarget.Latest, true, scriptKind(file.path));
+    parsedFiles.set(file, parsed);
+    return parsed;
+}
+function scriptKind(path) {
+    if (path.endsWith(".tsx"))
+        return ts.ScriptKind.TSX;
+    if (path.endsWith(".jsx"))
+        return ts.ScriptKind.JSX;
+    if (/\.[cm]?js$/.test(path))
+        return ts.ScriptKind.JS;
+    return ts.ScriptKind.TS;
+}
+/** Static imports, re-exports and literal dynamic imports declared by one file. */
+export function listModuleReferences(file) {
+    const source = parseBrandlabSourceFile(file);
+    const references = [];
+    const lineOf = (node) => source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1;
+    for (const statement of source.statements) {
+        if (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) {
+            const clause = statement.importClause;
+            const bindings = [];
+            if (clause?.name)
+                bindings.push({ imported: "default", local: clause.name.text });
+            const named = clause?.namedBindings;
+            if (named && ts.isNamespaceImport(named))
+                bindings.push({ imported: "*", local: named.name.text });
+            if (named && ts.isNamedImports(named)) {
+                for (const element of named.elements) {
+                    bindings.push({ imported: (element.propertyName ?? element.name).text, local: element.name.text });
+                }
+            }
+            references.push({
+                specifier: statement.moduleSpecifier.text,
+                kind: "import",
+                typeOnly: Boolean(clause?.isTypeOnly),
+                bindings,
+                line: lineOf(statement),
+            });
+        }
+        else if (ts.isExportDeclaration(statement) &&
+            statement.moduleSpecifier &&
+            ts.isStringLiteral(statement.moduleSpecifier)) {
+            const clause = statement.exportClause;
+            const bindings = clause && ts.isNamedExports(clause)
+                ? clause.elements.map((element) => ({
+                    imported: (element.propertyName ?? element.name).text,
+                    local: element.name.text,
+                }))
+                : [{ imported: "*", local: "*" }];
+            references.push({
+                specifier: statement.moduleSpecifier.text,
+                kind: "export",
+                typeOnly: statement.isTypeOnly,
+                bindings,
+                line: lineOf(statement),
+            });
+        }
+    }
+    const visit = (node) => {
+        if (ts.isCallExpression(node) &&
+            node.expression.kind === ts.SyntaxKind.ImportKeyword &&
+            node.arguments[0] &&
+            ts.isStringLiteralLike(node.arguments[0])) {
+            references.push({
+                specifier: node.arguments[0].text,
+                kind: "dynamic",
+                typeOnly: false,
+                bindings: [],
+                line: lineOf(node),
+            });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    return references;
+}
+/** Local names bound to an export of a package module, for example BrandlabGoogleTag. */
+export function importedLocalNames(file, modulePattern, importedName) {
+    return listModuleReferences(file)
+        .filter((reference) => reference.kind === "import" && modulePattern.test(reference.specifier))
+        .flatMap((reference) => reference.bindings)
+        .filter((binding) => binding.imported === importedName)
+        .map((binding) => binding.local);
+}
+/** Calls to a named export of a package module, following local import aliases. */
+export function findImportedCalls(file, modulePattern, importedName) {
+    const locals = new Set(importedLocalNames(file, modulePattern, importedName));
+    if (locals.size === 0)
+        return [];
+    const calls = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && locals.has(node.expression.text)) {
+            calls.push(node);
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(parseBrandlabSourceFile(file));
+    return calls;
+}
+export function lineOfNode(file, node) {
+    const source = parseBrandlabSourceFile(file);
+    return source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1;
+}
+/** The value of a named property in an object literal, or undefined. */
+export function objectPropertyValue(node, name) {
+    if (!node || !ts.isObjectLiteralExpression(node))
+        return undefined;
+    for (const property of node.properties) {
+        if (!ts.isPropertyAssignment(property))
+            continue;
+        const key = property.name;
+        const keyText = ts.isIdentifier(key) || ts.isStringLiteralLike(key) ? key.text : null;
+        if (keyText === name)
+            return property.initializer;
+    }
+    return undefined;
+}
+export function stringLiteralValue(node) {
+    return node && ts.isStringLiteralLike(node) ? node.text : null;
+}
+/** Resolve project-local specifiers (relative and tsconfig path aliases) to indexed files. */
+export function createBrandlabModuleResolver(root, knownPaths) {
+    const aliases = readPathAliases(root);
+    const candidates = (base) => [
+        base,
+        ...RESOLUTION_EXTENSIONS.map((extension) => `${base}${extension}`),
+        ...RESOLUTION_EXTENSIONS.map((extension) => posix.join(base, `index${extension}`)),
+        ...(base.endsWith(".js") ? RESOLUTION_EXTENSIONS.map((extension) => base.replace(/\.js$/, extension)) : []),
+    ];
+    const find = (base) => {
+        const normalised = posix.normalize(base).replace(/^\.\//, "");
+        return candidates(normalised).find((candidate) => knownPaths.has(candidate)) ?? null;
+    };
+    return (fromPath, specifier) => {
+        if (specifier.startsWith("."))
+            return find(posix.join(posix.dirname(fromPath), specifier));
+        for (const alias of aliases) {
+            if (alias.exact ? specifier !== alias.prefix : !specifier.startsWith(alias.prefix))
+                continue;
+            const rest = alias.exact ? "" : specifier.slice(alias.prefix.length);
+            for (const target of alias.targets) {
+                const resolved = find(target.replace("*", rest));
+                if (resolved)
+                    return resolved;
+            }
+        }
+        return null;
+    };
+}
+function readPathAliases(root) {
+    const fallback = [{ prefix: "@/", exact: false, targets: ["src/*"] }];
+    const configPath = join(root, "tsconfig.json");
+    if (!existsSync(configPath))
+        return fallback;
+    const parsed = ts.readConfigFile(configPath, (path) => readFileSync(path, "utf8"));
+    const options = parsed.config?.compilerOptions;
+    if (!options?.paths)
+        return fallback;
+    const baseUrl = posix.normalize((options.baseUrl ?? ".").replaceAll("\\", "/"));
+    return Object.entries(options.paths)
+        .filter(([, targets]) => Array.isArray(targets))
+        .map(([pattern, targets]) => ({
+        prefix: pattern.replace(/\*$/, ""),
+        exact: !pattern.endsWith("*"),
+        targets: targets.map((target) => posix.normalize(posix.join(baseUrl, target.replaceAll("\\", "/")))),
+    }));
+}
+/** Blank comments while preserving string contents, offsets and line breaks. */
+export function stripCommentsPreservingLayout(source) {
+    const output = [...source];
+    let state = "code";
+    let escaped = false;
+    for (let index = 0; index < output.length; index += 1) {
+        const current = output[index];
+        const next = output[index + 1];
+        if (state === "line") {
+            if (current === "\n" || current === "\r") {
+                state = "code";
+            }
+            else {
+                output[index] = " ";
+            }
+            continue;
+        }
+        if (state === "block") {
+            if (current === "*" && next === "/") {
+                output[index] = " ";
+                output[index + 1] = " ";
+                index += 1;
+                state = "code";
+            }
+            else if (current !== "\n" && current !== "\r") {
+                output[index] = " ";
+            }
+            continue;
+        }
+        if (state !== "code") {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (current === "\\") {
+                escaped = true;
+            }
+            else if ((state === "single" && current === "'") ||
+                (state === "double" && current === '"') ||
+                (state === "template" && current === "`")) {
+                state = "code";
+            }
+            continue;
+        }
+        if (current === "'") {
+            state = "single";
+        }
+        else if (current === '"') {
+            state = "double";
+        }
+        else if (current === "`") {
+            state = "template";
+        }
+        else if (current === "/" && next === "/") {
+            output[index] = " ";
+            output[index + 1] = " ";
+            index += 1;
+            state = "line";
+        }
+        else if (current === "/" && next === "*") {
+            output[index] = " ";
+            output[index + 1] = " ";
+            index += 1;
+            state = "block";
+        }
+    }
+    return output.join("");
+}
+export function lineAt(source, index) {
+    return source.slice(0, index).split("\n").length;
+}
+export function isDirectory(path) {
+    try {
+        return lstatSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function readOptionalText(path) {
+    return existsSync(path) ? readFileSync(path, "utf8") : null;
+}
+//# sourceMappingURL=source-files.js.map

package/dist/source-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-files.js","sourceRoot":"","sources":["../src/source-files.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, lstatSync, readFileSync, readdirSync } from \"node:fs\";\nimport { join, posix } from \"node:path\";\nimport ts from \"typescript\";\n\n/** Directory roots that can hold project-owned application source. */\nexport const BRANDLAB_SOURCE_ROOT_DIRECTORIES = [\n  \"src\",\n  \"app\",\n  \"components\",\n  \"lib\",\n  \"config\",\n  \"hooks\",\n  \"context\",\n  \"utils\",\n  \"data\",\n] as const;\n\nconst SOURCE_FILE_PATTERN = /\\.[cm]?[jt]sx?$/;\nconst TEST_FILE_PATTERN = /\\.(?:test|spec)\\.[cm]?[jt]sx?$/;\nconst ROOT_SOURCE_FILE_PATTERN =\n  /^(?:instrumentation[\\w.-]*|proxy|middleware|next\\.config|mdx-components)\\.[cm]?[jt]sx?$/;\nconst RESOLUTION_EXTENSIONS = [\".ts\", \".tsx\", \".mts\", \".cts\", \".js\", \".jsx\", \".mjs\", \".cjs\"];\n\nexport interface BrandlabSourceFile {\n  /** Project-relative path with forward slashes. */\n  path: string;\n  text: string;\n  /** The same text with comments blanked so offsets and lines are preserved. */\n  executable: string;\n}\n\nexport interface BrandlabSourceIndex {\n  root: string;\n  /** Recognised directory roots present in the project. */\n  directoryRoots: string[];\n  /** Recognised root-level framework files present in the project. */\n  rootFiles: string[];\n  files: BrandlabSourceFile[];\n  byPath: ReadonlyMap<string, BrandlabSourceFile>;\n}\n\nexport interface BrandlabImportBinding {\n  imported: string;\n  local: string;\n}\n\nexport interface BrandlabModuleReference {\n  specifier: string;\n  kind: \"import\" | \"export\" | \"dynamic\";\n  typeOnly: boolean;\n  bindings: BrandlabImportBinding[];\n  line: number;\n}\n\n/** Collect every non-test source file under the recognised project roots. */\nexport function collectBrandlabSource(root: string): BrandlabSourceIndex {\n  if (!isDirectory(root)) {\n    return { root, directoryRoots: [], rootFiles: [], files: [], byPath: new Map() };\n  }\n  const directoryRoots = BRANDLAB_SOURCE_ROOT_DIRECTORIES.filter((name) => isDirectory(join(root, name)));\n  const rootFiles = readdirSync(root, { withFileTypes: true })\n    .filter((entry) => entry.isFile() && ROOT_SOURCE_FILE_PATTERN.test(entry.name))\n    .map((entry) => entry.name)\n    .sort();\n  const paths = [\n    ...directoryRoots.flatMap((name) => walkSourceFiles(root, name)),\n    ...rootFiles,\n  ].sort();\n  const files = paths.map((path) => {\n    const text = readFileSync(join(root, path), \"utf8\");\n    return { path, text, executable: stripCommentsPreservingLayout(text) };\n  });\n  return {\n    root,\n    directoryRoots: [...directoryRoots],\n    rootFiles,\n    files,\n    byPath: new Map(files.map((file) => [file.path, file])),\n  };\n}\n\n/** List every file below a project-relative directory, skipping dependencies and dot entries. */\nexport function walkProjectFiles(root: string, directory: string): string[] {\n  const absolute = join(root, directory);\n  if (!isDirectory(absolute)) return [];\n  const files: string[] = [];\n  for (const entry of readdirSync(absolute, { withFileTypes: true })) {\n    if (entry.name.startsWith(\".\") || entry.name === \"node_modules\" || entry.isSymbolicLink()) continue;\n    const path = posix.join(directory, entry.name);\n    if (entry.isDirectory()) files.push(...walkProjectFiles(root, path));\n    else if (entry.isFile()) files.push(path);\n  }\n  return files.sort();\n}\n\nfunction walkSourceFiles(root: string, directory: string): string[] {\n  return walkProjectFiles(root, directory).filter((path) => {\n    const name = posix.basename(path);\n    return SOURCE_FILE_PATTERN.test(name) && !TEST_FILE_PATTERN.test(name);\n  });\n}\n\nconst parsedFiles = new WeakMap<BrandlabSourceFile, ts.SourceFile>();\n\nexport function parseBrandlabSourceFile(file: BrandlabSourceFile): ts.SourceFile {\n  const cached = parsedFiles.get(file);\n  if (cached) return cached;\n  const parsed = ts.createSourceFile(file.path, file.text, ts.ScriptTarget.Latest, true, scriptKind(file.path));\n  parsedFiles.set(file, parsed);\n  return parsed;\n}\n\nfunction scriptKind(path: string): ts.ScriptKind {\n  if (path.endsWith(\".tsx\")) return ts.ScriptKind.TSX;\n  if (path.endsWith(\".jsx\")) return ts.ScriptKind.JSX;\n  if (/\\.[cm]?js$/.test(path)) return ts.ScriptKind.JS;\n  return ts.ScriptKind.TS;\n}\n\n/** Static imports, re-exports and literal dynamic imports declared by one file. */\nexport function listModuleReferences(file: BrandlabSourceFile): BrandlabModuleReference[] {\n  const source = parseBrandlabSourceFile(file);\n  const references: BrandlabModuleReference[] = [];\n  const lineOf = (node: ts.Node) => source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1;\n  for (const statement of source.statements) {\n    if (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) {\n      const clause = statement.importClause;\n      const bindings: BrandlabImportBinding[] = [];\n      if (clause?.name) bindings.push({ imported: \"default\", local: clause.name.text });\n      const named = clause?.namedBindings;\n      if (named && ts.isNamespaceImport(named)) bindings.push({ imported: \"*\", local: named.name.text });\n      if (named && ts.isNamedImports(named)) {\n        for (const element of named.elements) {\n          bindings.push({ imported: (element.propertyName ?? element.name).text, local: element.name.text });\n        }\n      }\n      references.push({\n        specifier: statement.moduleSpecifier.text,\n        kind: \"import\",\n        typeOnly: Boolean(clause?.isTypeOnly),\n        bindings,\n        line: lineOf(statement),\n      });\n    } else if (\n      ts.isExportDeclaration(statement) &&\n      statement.moduleSpecifier &&\n      ts.isStringLiteral(statement.moduleSpecifier)\n    ) {\n      const clause = statement.exportClause;\n      const bindings = clause && ts.isNamedExports(clause)\n        ? clause.elements.map((element) => ({\n            imported: (element.propertyName ?? element.name).text,\n            local: element.name.text,\n          }))\n        : [{ imported: \"*\", local: \"*\" }];\n      references.push({\n        specifier: statement.moduleSpecifier.text,\n        kind: \"export\",\n        typeOnly: statement.isTypeOnly,\n        bindings,\n        line: lineOf(statement),\n      });\n    }\n  }\n  const visit = (node: ts.Node) => {\n    if (\n      ts.isCallExpression(node) &&\n      node.expression.kind === ts.SyntaxKind.ImportKeyword &&\n      node.arguments[0] &&\n      ts.isStringLiteralLike(node.arguments[0])\n    ) {\n      references.push({\n        specifier: node.arguments[0].text,\n        kind: \"dynamic\",\n        typeOnly: false,\n        bindings: [],\n        line: lineOf(node),\n      });\n    }\n    ts.forEachChild(node, visit);\n  };\n  visit(source);\n  return references;\n}\n\n/** Local names bound to an export of a package module, for example BrandlabGoogleTag. */\nexport function importedLocalNames(\n  file: BrandlabSourceFile,\n  modulePattern: RegExp,\n  importedName: string,\n): string[] {\n  return listModuleReferences(file)\n    .filter((reference) => reference.kind === \"import\" && modulePattern.test(reference.specifier))\n    .flatMap((reference) => reference.bindings)\n    .filter((binding) => binding.imported === importedName)\n    .map((binding) => binding.local);\n}\n\n/** Calls to a named export of a package module, following local import aliases. */\nexport function findImportedCalls(\n  file: BrandlabSourceFile,\n  modulePattern: RegExp,\n  importedName: string,\n): ts.CallExpression[] {\n  const locals = new Set(importedLocalNames(file, modulePattern, importedName));\n  if (locals.size === 0) return [];\n  const calls: ts.CallExpression[] = [];\n  const visit = (node: ts.Node) => {\n    if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && locals.has(node.expression.text)) {\n      calls.push(node);\n    }\n    ts.forEachChild(node, visit);\n  };\n  visit(parseBrandlabSourceFile(file));\n  return calls;\n}\n\nexport function lineOfNode(file: BrandlabSourceFile, node: ts.Node): number {\n  const source = parseBrandlabSourceFile(file);\n  return source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1;\n}\n\n/** The value of a named property in an object literal, or undefined. */\nexport function objectPropertyValue(\n  node: ts.Node | undefined,\n  name: string,\n): ts.Expression | undefined {\n  if (!node || !ts.isObjectLiteralExpression(node)) return undefined;\n  for (const property of node.properties) {\n    if (!ts.isPropertyAssignment(property)) continue;\n    const key = property.name;\n    const keyText = ts.isIdentifier(key) || ts.isStringLiteralLike(key) ? key.text : null;\n    if (keyText === name) return property.initializer;\n  }\n  return undefined;\n}\n\nexport function stringLiteralValue(node: ts.Node | undefined): string | null {\n  return node && ts.isStringLiteralLike(node) ? node.text : null;\n}\n\nexport type BrandlabModuleResolver = (fromPath: string, specifier: string) => string | null;\n\n/** Resolve project-local specifiers (relative and tsconfig path aliases) to indexed files. */\nexport function createBrandlabModuleResolver(\n  root: string,\n  knownPaths: ReadonlySet<string>,\n): BrandlabModuleResolver {\n  const aliases = readPathAliases(root);\n  const candidates = (base: string) => [\n    base,\n    ...RESOLUTION_EXTENSIONS.map((extension) => `${base}${extension}`),\n    ...RESOLUTION_EXTENSIONS.map((extension) => posix.join(base, `index${extension}`)),\n    ...(base.endsWith(\".js\") ? RESOLUTION_EXTENSIONS.map((extension) => base.replace(/\\.js$/, extension)) : []),\n  ];\n  const find = (base: string) => {\n    const normalised = posix.normalize(base).replace(/^\\.\\//, \"\");\n    return candidates(normalised).find((candidate) => knownPaths.has(candidate)) ?? null;\n  };\n  return (fromPath, specifier) => {\n    if (specifier.startsWith(\".\")) return find(posix.join(posix.dirname(fromPath), specifier));\n    for (const alias of aliases) {\n      if (alias.exact ? specifier !== alias.prefix : !specifier.startsWith(alias.prefix)) continue;\n      const rest = alias.exact ? \"\" : specifier.slice(alias.prefix.length);\n      for (const target of alias.targets) {\n        const resolved = find(target.replace(\"*\", rest));\n        if (resolved) return resolved;\n      }\n    }\n    return null;\n  };\n}\n\ninterface PathAlias {\n  prefix: string;\n  exact: boolean;\n  targets: string[];\n}\n\nfunction readPathAliases(root: string): PathAlias[] {\n  const fallback: PathAlias[] = [{ prefix: \"@/\", exact: false, targets: [\"src/*\"] }];\n  const configPath = join(root, \"tsconfig.json\");\n  if (!existsSync(configPath)) return fallback;\n  const parsed = ts.readConfigFile(configPath, (path) => readFileSync(path, \"utf8\"));\n  const options = parsed.config?.compilerOptions as { baseUrl?: string; paths?: Record<string, string[]> } | undefined;\n  if (!options?.paths) return fallback;\n  const baseUrl = posix.normalize((options.baseUrl ?? \".\").replaceAll(\"\\\\\", \"/\"));\n  return Object.entries(options.paths)\n    .filter(([, targets]) => Array.isArray(targets))\n    .map(([pattern, targets]) => ({\n      prefix: pattern.replace(/\\*$/, \"\"),\n      exact: !pattern.endsWith(\"*\"),\n      targets: targets.map((target) => posix.normalize(posix.join(baseUrl, target.replaceAll(\"\\\\\", \"/\")))),\n    }));\n}\n\n/** Blank comments while preserving string contents, offsets and line breaks. */\nexport function stripCommentsPreservingLayout(source: string): string {\n  const output = [...source];\n  let state: \"code\" | \"single\" | \"double\" | \"template\" | \"line\" | \"block\" =\n    \"code\";\n  let escaped = false;\n\n  for (let index = 0; index < output.length; index += 1) {\n    const current = output[index];\n    const next = output[index + 1];\n\n    if (state === \"line\") {\n      if (current === \"\\n\" || current === \"\\r\") {\n        state = \"code\";\n      } else {\n        output[index] = \" \";\n      }\n      continue;\n    }\n\n    if (state === \"block\") {\n      if (current === \"*\" && next === \"/\") {\n        output[index] = \" \";\n        output[index + 1] = \" \";\n        index += 1;\n        state = \"code\";\n      } else if (current !== \"\\n\" && current !== \"\\r\") {\n        output[index] = \" \";\n      }\n      continue;\n    }\n\n    if (state !== \"code\") {\n      if (escaped) {\n        escaped = false;\n      } else if (current === \"\\\\\") {\n        escaped = true;\n      } else if (\n        (state === \"single\" && current === \"'\") ||\n        (state === \"double\" && current === '\"') ||\n        (state === \"template\" && current === \"`\")\n      ) {\n        state = \"code\";\n      }\n      continue;\n    }\n\n    if (current === \"'\") {\n      state = \"single\";\n    } else if (current === '\"') {\n      state = \"double\";\n    } else if (current === \"`\") {\n      state = \"template\";\n    } else if (current === \"/\" && next === \"/\") {\n      output[index] = \" \";\n      output[index + 1] = \" \";\n      index += 1;\n      state = \"line\";\n    } else if (current === \"/\" && next === \"*\") {\n      output[index] = \" \";\n      output[index + 1] = \" \";\n      index += 1;\n      state = \"block\";\n    }\n  }\n\n  return output.join(\"\");\n}\n\nexport function lineAt(source: string, index: number): number {\n  return source.slice(0, index).split(\"\\n\").length;\n}\n\nexport function isDirectory(path: string): boolean {\n  try {\n    return lstatSync(path).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nexport function readOptionalText(path: string): string | null {\n  return existsSync(path) ? readFileSync(path, \"utf8\") : null;\n}\n"]}

package/dist/static-rules.d.ts

@@ -0,0 +1,45 @@
+import type { BrandlabFinding } from "./project.js";
+import { type BrandlabSourceFile, type BrandlabSourceIndex } from "./source-files.js";
+import type { BrandlabRuleEvaluation } from "./verification-policy.js";
+export interface StaticRuleContext {
+    root: string;
+    source: BrandlabSourceIndex;
+    /** brandlab.config.ts text, or null when it is missing. */
+    config: string | null;
+    findings: BrandlabFinding[];
+    evaluations: BrandlabRuleEvaluation[];
+}
+export declare function staticFinding(options: {
+    ruleId: string;
+    surface: string;
+    expected: string;
+    actual: string;
+    remediation: string;
+    path?: string;
+    line?: number;
+    severity?: BrandlabFinding["severity"];
+}): BrandlabFinding;
+export declare function recordEvaluation(evaluations: BrandlabRuleEvaluation[], surface: string, ...ruleIds: string[]): void;
+/** The minimal static rules behind the checks that previously passed without evidence. */
+export declare function inspectStaticRules(context: StaticRuleContext): void;
+export interface BrandlabProjectCapabilities {
+    contactEnabled: boolean;
+    reviewsEnabled: boolean;
+    locationsDeclared: boolean;
+    sitemapMode: "single" | "split" | null;
+}
+/** Capabilities declared by brandlab.config.ts, the contact route and the location data. */
+export declare function describeCapabilities(root: string, config: string | null): BrandlabProjectCapabilities;
+/** Evaluate gitignore-style patterns (last match wins) for a root-level file. */
+export declare function isIgnored(patterns: string, file: string): boolean;
+export interface ContactContractRecipient {
+    path: string;
+    line: number;
+    /** The literal delivery.recipientEnv key, or null when it is not statically declared. */
+    recipientEnv: string | null;
+}
+/** Every defineContactContract call and the recipient environment key it declares. */
+export declare function findContactContractRecipients(source: BrandlabSourceIndex): ContactContractRecipient[];
+/** Names a module exports, including `export { local as POST }` forms. */
+export declare function exportedNames(file: BrandlabSourceFile): Set<string>;
+//# sourceMappingURL=static-rules.d.ts.map

package/dist/static-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-rules.d.ts","sourceRoot":"","sources":["../src/static-rules.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AASpD,OAAO,EAcL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAEzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAOvE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,sBAAsB,EAAE,CAAC;CACvC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;CACxC,GAAG,eAAe,CAalB;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,sBAAsB,EAAE,EACrC,OAAO,EAAE,MAAM,EACf,GAAG,OAAO,EAAE,MAAM,EAAE,QAGrB;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,QAe5D;AAED,MAAM,WAAW,2BAA2B;IAC1C,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;CACxC;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,2BAA2B,CAgBrG;AAmqBD,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAajE;AAID,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,sFAAsF;AACtF,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mBAAmB,GAC1B,wBAAwB,EAAE,CAU5B;AA0BD,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBnE"}