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

package/dist/cli.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { type BrandlabConformanceMode } from "./project.js";
+interface CliOptions {
+    root: string;
+    installedRelease?: string | null;
+    targetRelease?: string | null;
+    supportPolicyPath: string | null;
+    mode: BrandlabConformanceMode;
+    json: boolean;
+    help: boolean;
+}
+interface CliIo {
+    stdout: (value: string) => void;
+    stderr: (value: string) => void;
+}
+export declare function parseBrandlabConformanceArgs(argv: readonly string[]): CliOptions;
+export declare function runBrandlabConformanceCli(argv: readonly string[], io?: CliIo): number;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAIA,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,cAAc,CAAC;AAGtB,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,KAAK;IACb,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAcD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CA2ChF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,GAAE,KAGH,GACA,MAAM,CAqBR"}

package/dist/cli.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { evaluateBrandlabProject, shouldFailBrandlabConformance, } from "./project.js";
+const HELP = `Brandlab version-aware conformance
+
+Usage:
+  brandlab-conformance --support-policy <path> [--root <path>]
+    [--installed-release <version|unadopted>]
+    [--target-release <version|none>] [--mode <local|ci|preflight>] [--json]
+
+Exit status:
+  local/ci   fail only for installed-release maintenance blockers
+  preflight  also fails for target-release migration blockers
+`;
+export function parseBrandlabConformanceArgs(argv) {
+    const parsed = {
+        root: process.cwd(),
+        supportPolicyPath: null,
+        mode: "local",
+        json: false,
+        help: false,
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        if (argument === "--help" || argument === "-h") {
+            parsed.help = true;
+        }
+        else if (argument === "--json") {
+            parsed.json = true;
+        }
+        else if (argument === "--root") {
+            parsed.root = resolve(requireValue(argv, ++index, "--root"));
+        }
+        else if (argument === "--support-policy") {
+            parsed.supportPolicyPath = resolve(requireValue(argv, ++index, "--support-policy"));
+        }
+        else if (argument === "--installed-release") {
+            const value = requireValue(argv, ++index, "--installed-release");
+            parsed.installedRelease = value === "unadopted" ? null : value;
+        }
+        else if (argument === "--target-release") {
+            const value = requireValue(argv, ++index, "--target-release");
+            parsed.targetRelease = value === "none" ? null : value;
+        }
+        else if (argument === "--mode") {
+            const value = requireValue(argv, ++index, "--mode");
+            if (value !== "local" && value !== "ci" && value !== "preflight") {
+                throw new Error(`Invalid --mode ${value}.`);
+            }
+            parsed.mode = value;
+        }
+        else {
+            throw new Error(`Unknown argument ${argument}.`);
+        }
+    }
+    if (!parsed.help && parsed.supportPolicyPath === null) {
+        throw new Error("--support-policy is required.");
+    }
+    return parsed;
+}
+export function runBrandlabConformanceCli(argv, io = {
+    stdout: (value) => process.stdout.write(value),
+    stderr: (value) => process.stderr.write(value),
+}) {
+    try {
+        const options = parseBrandlabConformanceArgs(argv);
+        if (options.help) {
+            io.stdout(HELP);
+            return 0;
+        }
+        const result = evaluateBrandlabProject({
+            root: options.root,
+            installedRelease: options.installedRelease,
+            targetRelease: options.targetRelease,
+            mode: options.mode,
+            supportPolicy: loadSupportPolicy(options.supportPolicyPath),
+        });
+        io.stdout(options.json ? `${JSON.stringify(result, null, 2)}\n` : formatResult(result));
+        return shouldFailBrandlabConformance(result) ? 1 : 0;
+    }
+    catch (error) {
+        io.stderr(`${error instanceof Error ? error.message : String(error)}\n\n${HELP}`);
+        return 2;
+    }
+}
+function loadSupportPolicy(path) {
+    if (path === null)
+        throw new Error("--support-policy is required.");
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to load support policy from ${path}: ${detail}`);
+    }
+}
+function formatResult(result) {
+    const lines = [
+        "Brandlab conformance",
+        `installed: ${result.installedRelease ?? "unadopted"}`,
+        `target: ${result.targetRelease ?? "none"}`,
+        `maintenance: ${formatSummary(result.maintenance)}`,
+        `migration: ${formatSummary(result.migration)}`,
+        `advisory: ${formatSummary(result.advisory)}`,
+    ];
+    for (const finding of result.findings) {
+        const location = finding.path
+            ? ` (${finding.path}${finding.line ? `:${finding.line}` : ""})`
+            : "";
+        lines.push(`[${finding.classification}/${finding.severity}] ${finding.ruleId}${location}: ${finding.actual}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+function formatSummary(summary) {
+    return `${summary.status}; ${summary.blockers} blocker(s), ${summary.warnings} warning(s), ${summary.info} info`;
+}
+function requireValue(argv, index, argument) {
+    const value = argv[index];
+    if (!value || value.startsWith("--"))
+        throw new Error(`${argument} requires a value.`);
+    return value;
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
+    process.exitCode = runBrandlabConformanceCli(process.argv.slice(2));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/locations.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Location-page conformance rules (Brandlab Location Pages Standard §11).
+ *
+ * These checks are heuristics over project source text and sitemap output.
+ * They are deliberately conservative: each rule documents its escape hatch so
+ * a compliant pattern is never impossible, only explicit.
+ */
+import type { SourcePattern, SourcePatternMatch, SourceTextFile } from "./vitest.js";
+export declare const BRANDLAB_LOCATION_FORBIDDEN_SOURCE_PATTERNS: readonly SourcePattern[];
+/**
+ * Flags `approvedIndexable*` assignments whose value is produced by code
+ * (call/map/flatMap) instead of an explicit literal list (standard §7.4).
+ *
+ * Escape hatch: statements that reference an identifier containing "frozen"
+ * are allowed — that is the documented snapshot pattern (an explicit,
+ * human-edited literal module filtered into record shape).
+ */
+export declare function findGeneratedServiceLocationApprovals(files: readonly SourceTextFile[]): SourcePatternMatch[];
+export interface LocationLinkDumpOptions {
+    files: readonly SourceTextFile[];
+    /** Path prefixes that identify location URLs, e.g. ['/locations/']. */
+    locationPathPrefixes: readonly string[];
+    /** Only files whose path matches are checked. Default: footer/nav components. */
+    filePathPattern?: RegExp;
+    /** Maximum location links allowed per matching file. Default 20 (≈ regions, never all suburbs). */
+    maxLinks?: number;
+}
+export interface LocationLinkDumpFinding {
+    file: string;
+    linkCount: number;
+    maxLinks: number;
+}
+/**
+ * Flags footer/nav components that link a suburb dump (standard §6.6 — nav
+ * and footer carry region links only; "blocks of text that list cities and
+ * regions" is Google's own keyword-stuffing example).
+ */
+export declare function findLocationLinkDumps({ files, locationPathPrefixes, filePathPattern, maxLinks, }: LocationLinkDumpOptions): LocationLinkDumpFinding[];
+/**
+ * Copy-hygiene patterns for location data modules (standard §3.8). Applied to
+ * `src/data/locations/**` and `src/data/serviceLocations/**` rendered-string
+ * sources: unresolved tokens and template wording must never reach a
+ * customer-facing surface.
+ */
+export declare const BRANDLAB_LOCATION_COPY_PATTERNS: readonly SourcePattern[];
+export interface LocationUrlShareOptions {
+    /** All sitemap entry URLs (absolute or root-relative). */
+    urls: readonly string[];
+    /** Predicate identifying location-family URLs. */
+    isLocationUrl: (url: string) => boolean;
+    /** Warn when location URLs exceed this share of all URLs. Default 0.4 (standard §8.8). */
+    maxShare?: number;
+}
+export interface LocationUrlShareResult {
+    locationUrlCount: number;
+    totalUrlCount: number;
+    share: number;
+    maxShare: number;
+    exceeded: boolean;
+}
+/** Volume alarm for location-heavy sitemaps (standard §8.8). */
+export declare function evaluateLocationUrlShare({ urls, isLocationUrl, maxShare, }: LocationUrlShareOptions): LocationUrlShareResult;
+//# sourceMappingURL=locations.d.ts.map

package/dist/locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../src/locations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErF,eAAO,MAAM,2CAA2C,EAAE,SAAS,aAAa,EAkB/E,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,kBAAkB,EAAE,CAuBtB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,uEAAuE;IACvE,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,oBAAoB,EACpB,eAAiC,EACjC,QAAa,GACd,EAAE,uBAAuB,GAAG,uBAAuB,EAAE,CAiBrD;AAED;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,aAAa,EAcnE,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,kDAAkD;IAClD,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,EACvC,IAAI,EACJ,aAAa,EACb,QAAc,GACf,EAAE,uBAAuB,GAAG,sBAAsB,CAYlD"}

package/dist/locations.js

@@ -0,0 +1,105 @@
+export const BRANDLAB_LOCATION_FORBIDDEN_SOURCE_PATTERNS = [
+    {
+        // Rating markup about the business/its services is never emitted
+        // (standard §6.2). Matches emission sites, not prose/comments.
+        name: "self-serving rating schema emission",
+        pattern: /['"]@type['"]\s*:\s*['"](?:AggregateRating|Review)['"]/,
+    },
+    {
+        name: "self-serving rating schema builder",
+        pattern: /\bbuild(?:Service)?(?:AggregateRating|Rating|Review)Schema\b/,
+    },
+    {
+        // Named constant reused as every sitemap entry's lastModified defeats
+        // the freshness signal (standard §6.3). Use per-record
+        // lastSubstantialUpdate dates instead.
+        name: "constant sitemap lastModified",
+        pattern: /lastModified\s*:\s*SITEMAP_LAST_MODIFIED\b/,
+    },
+];
+/**
+ * Flags `approvedIndexable*` assignments whose value is produced by code
+ * (call/map/flatMap) instead of an explicit literal list (standard §7.4).
+ *
+ * Escape hatch: statements that reference an identifier containing "frozen"
+ * are allowed — that is the documented snapshot pattern (an explicit,
+ * human-edited literal module filtered into record shape).
+ */
+export function findGeneratedServiceLocationApprovals(files) {
+    const matches = [];
+    const assignment = /\bapprovedIndexable\w*\s*[:=]/;
+    const generated = /[:=][^;\n]*(?:\.flatMap\(|\.map\(|\w+\(\s*\))/;
+    for (const file of files) {
+        const lines = file.text.split("\n");
+        lines.forEach((line, index) => {
+            if (!assignment.test(line))
+                return;
+            if (/frozen/i.test(line))
+                return;
+            if (!generated.test(line))
+                return;
+            matches.push({
+                file: file.path,
+                patternName: "generated service-location approvals",
+                line: index + 1,
+                column: line.search(assignment) + 1,
+                text: line.trim(),
+            });
+        });
+    }
+    return matches;
+}
+/**
+ * Flags footer/nav components that link a suburb dump (standard §6.6 — nav
+ * and footer carry region links only; "blocks of text that list cities and
+ * regions" is Google's own keyword-stuffing example).
+ */
+export function findLocationLinkDumps({ files, locationPathPrefixes, filePathPattern = /(footer|nav)/i, maxLinks = 20, }) {
+    const findings = [];
+    for (const file of files) {
+        if (!filePathPattern.test(file.path))
+            continue;
+        let linkCount = 0;
+        for (const prefix of locationPathPrefixes) {
+            linkCount += file.text.split(prefix).length - 1;
+        }
+        if (linkCount > maxLinks) {
+            findings.push({ file: file.path, linkCount, maxLinks });
+        }
+    }
+    return findings;
+}
+/**
+ * Copy-hygiene patterns for location data modules (standard §3.8). Applied to
+ * `src/data/locations/**` and `src/data/serviceLocations/**` rendered-string
+ * sources: unresolved tokens and template wording must never reach a
+ * customer-facing surface.
+ */
+export const BRANDLAB_LOCATION_COPY_PATTERNS = [
+    {
+        name: "unresolved bracket token",
+        pattern: /\[(?:Suburb|Region|Location|Service|Business Name|Phone|Email)\]/,
+    },
+    {
+        name: "unresolved curly token in string",
+        pattern: /['"`][^'"`\n]*\{(?:suburb|region|location|service)\}[^'"`\n]*['"`]/,
+    },
+    {
+        name: "template wording",
+        pattern: /\b(?:lorem ipsum|placeholder copy|copy goes here|content goes here|insert copy|TODO copy|sample copy|starter copy|boilerplate copy)\b/i,
+    },
+];
+/** Volume alarm for location-heavy sitemaps (standard §8.8). */
+export function evaluateLocationUrlShare({ urls, isLocationUrl, maxShare = 0.4, }) {
+    const totalUrlCount = urls.length;
+    const locationUrlCount = urls.filter((url) => isLocationUrl(url)).length;
+    const share = totalUrlCount === 0 ? 0 : locationUrlCount / totalUrlCount;
+    return {
+        locationUrlCount,
+        totalUrlCount,
+        share,
+        maxShare,
+        exceeded: share > maxShare,
+    };
+}
+//# sourceMappingURL=locations.js.map

package/dist/locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.js","sourceRoot":"","sources":["../src/locations.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,2CAA2C,GAA6B;IACnF;QACE,iEAAiE;QACjE,+DAA+D;QAC/D,IAAI,EAAE,qCAAqC;QAC3C,OAAO,EAAE,wDAAwD;KAClE;IACD;QACE,IAAI,EAAE,oCAAoC;QAC1C,OAAO,EAAE,8DAA8D;KACxE;IACD;QACE,sEAAsE;QACtE,uDAAuD;QACvD,uCAAuC;QACvC,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,4CAA4C;KACtD;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,qCAAqC,CACnD,KAAgC;IAEhC,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,+BAA+B,CAAC;IACnD,MAAM,SAAS,GAAG,+CAA+C,CAAC;IAElE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE;YAC5C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO;YACnC,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO;YACjC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO;YAElC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,sCAAsC;gBACnD,IAAI,EAAE,KAAK,GAAG,CAAC;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;aAClB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAkBD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,KAAK,EACL,oBAAoB,EACpB,eAAe,GAAG,eAAe,EACjC,QAAQ,GAAG,EAAE,GACW;IACxB,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAE/C,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;YAC1C,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,SAAS,GAAG,QAAQ,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAA6B;IACvE;QACE,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,kEAAkE;KAC5E;IACD;QACE,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,oEAAoE;KAC9E;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,OAAO,EACL,wIAAwI;KAC3I;CACF,CAAC;AAmBF,gEAAgE;AAChE,MAAM,UAAU,wBAAwB,CAAC,EACvC,IAAI,EACJ,aAAa,EACb,QAAQ,GAAG,GAAG,GACU;IACxB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IAClC,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IACzE,MAAM,KAAK,GAAG,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,GAAG,aAAa,CAAC;IAEzE,OAAO;QACL,gBAAgB;QAChB,aAAa;QACb,KAAK;QACL,QAAQ;QACR,QAAQ,EAAE,KAAK,GAAG,QAAQ;KAC3B,CAAC;AACJ,CAAC"}

package/dist/project-config.d.ts

@@ -0,0 +1,31 @@
+export declare const BRANDLAB_CONFIG_V2_PROFILES: readonly ["next-local-service", "next-root-level", "next-static-legacy", "legacy-php"];
+export interface InspectedBrandlabProjectConfig {
+    projectId: string;
+    profile: (typeof BRANDLAB_CONFIG_V2_PROFILES)[number];
+    routes: {
+        families: readonly string[];
+    };
+    capabilities: {
+        blogAdapter: string | null;
+        contactEnabled: boolean;
+    };
+}
+export interface BrandlabConfigV2Issue {
+    ruleId: string;
+    surface: string;
+    severity: "blocker" | "warning" | "info";
+    evidenceKind: "static" | "behavioural" | "runtime";
+    path?: string;
+    line?: number;
+    expected: string;
+    actual: string;
+    remediation: string;
+}
+export interface BrandlabConfigV2Inspection {
+    config: InspectedBrandlabProjectConfig | null;
+    imports: ReadonlySet<string>;
+    executableImports: ReadonlySet<string>;
+    issues: BrandlabConfigV2Issue[];
+}
+export declare function inspectBrandlabConfigV2(root: string): BrandlabConfigV2Inspection;
+//# sourceMappingURL=project-config.d.ts.map

package/dist/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../src/project-config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,2BAA2B,wFAK9B,CAAC;AA0CX,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE;QACN,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;KAC7B,CAAC;IACF,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,YAAY,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,8BAA8B,GAAG,IAAI,CAAC;IAC9C,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAqDD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,CA2FhF"}