repopo 0.10.0 → 0.13.0

package/esm/policies/GleamTomlSorted.js

@@ -0,0 +1,157 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { resolve } from "pathe";
+import { defineGleamPolicy, } from "../policyDefiners/defineGleamPolicy.js";
+const DEFAULT_SORTED_SECTIONS = ["dependencies", "dev-dependencies"];
+const SECTION_HEADER_REGEX = /^\[([^\]]+)\]\s*$/;
+const KEY_VALUE_REGEX = /^(\S+)\s*=/;
+function isSorted(keys) {
+    for (let i = 1; i < keys.length; i++) {
+        const prev = keys[i - 1];
+        const curr = keys[i];
+        if (prev !== undefined && curr !== undefined && curr < prev) {
+            return false;
+        }
+    }
+    return true;
+}
+function classifyLine(line) {
+    if (SECTION_HEADER_REGEX.test(line)) {
+        return "section";
+    }
+    if (line.trim() === "") {
+        return "blank";
+    }
+    if (line.trim().startsWith("#")) {
+        return "comment";
+    }
+    if (KEY_VALUE_REGEX.test(line)) {
+        return "key";
+    }
+    return "continuation";
+}
+function handleCommentLine(entryLine, currentEntry) {
+    if (currentEntry) {
+        currentEntry.lines.push(entryLine);
+        return currentEntry;
+    }
+    return { key: "", lines: [entryLine] };
+}
+function processKeyLine(entryLine, currentEntry, entries) {
+    if (currentEntry) {
+        entries.push(currentEntry);
+    }
+    const keyMatch = entryLine.match(KEY_VALUE_REGEX);
+    return { key: keyMatch?.[1] ?? "", lines: [entryLine] };
+}
+function collectSectionEntries(lines, startIndex) {
+    const entries = [];
+    let currentEntry;
+    let i = startIndex;
+    while (i < lines.length) {
+        const entryLine = lines[i] ?? "";
+        const kind = classifyLine(entryLine);
+        if (kind === "section") {
+            break;
+        }
+        switch (kind) {
+            case "blank": {
+                break;
+            }
+            case "comment": {
+                currentEntry = handleCommentLine(entryLine, currentEntry);
+                break;
+            }
+            case "key": {
+                currentEntry = processKeyLine(entryLine, currentEntry, entries);
+                break;
+            }
+            case "continuation": {
+                currentEntry?.lines.push(entryLine);
+                break;
+            }
+            default: {
+                break;
+            }
+        }
+        i++;
+    }
+    if (currentEntry) {
+        entries.push(currentEntry);
+    }
+    return { entries, endIndex: i };
+}
+function sortTomlSections(content, sectionsToSort) {
+    const lines = content.split("\n");
+    const result = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i] ?? "";
+        const sectionMatch = line.match(SECTION_HEADER_REGEX);
+        if (sectionMatch && sectionsToSort.includes(sectionMatch[1] ?? "")) {
+            result.push(line);
+            i++;
+            const { entries, endIndex } = collectSectionEntries(lines, i);
+            entries.sort((a, b) => a.key.localeCompare(b.key));
+            for (const entry of entries) {
+                result.push(...entry.lines);
+            }
+            i = endIndex;
+            continue;
+        }
+        result.push(line);
+        i++;
+    }
+    return result.join("\n");
+}
+/**
+ * A policy that ensures dependency sections in gleam.toml are sorted alphabetically.
+ *
+ * @public
+ */
+export const GleamTomlSorted = defineGleamPolicy({
+    name: "GleamTomlSorted",
+    description: "Ensures dependency sections in gleam.toml are sorted alphabetically.",
+    handler: async (toml, { file, root, resolve: shouldResolve, config }) => {
+        const sections = config?.sections ?? DEFAULT_SORTED_SECTIONS;
+        const unsortedSections = [];
+        for (const section of sections) {
+            const sectionData = toml[section];
+            if (sectionData !== undefined && !isSorted(Object.keys(sectionData))) {
+                unsortedSections.push(section);
+            }
+        }
+        if (unsortedSections.length === 0) {
+            return [];
+        }
+        if (shouldResolve) {
+            try {
+                const filePath = resolve(root, file);
+                const content = await readFile(filePath, "utf-8");
+                const sorted = sortTomlSections(content, unsortedSections);
+                await writeFile(filePath, sorted);
+                return [
+                    {
+                        message: `Unsorted sections: [${unsortedSections.join("], [")}]`,
+                        fixStatus: "fixed",
+                    },
+                ];
+            }
+            catch {
+                return [
+                    {
+                        message: `Unsorted sections: [${unsortedSections.join("], [")}]. Auto-fix failed.`,
+                        fixStatus: "failed",
+                    },
+                ];
+            }
+        }
+        return [
+            {
+                message: `Unsorted sections: [${unsortedSections.join("], [")}]`,
+                fixStatus: "available",
+                manualFix: "Sort the dependency keys alphabetically in the listed sections.",
+            },
+        ];
+    },
+});
+//# sourceMappingURL=GleamTomlSorted.js.map

package/esm/policies/GleamTomlSorted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamTomlSorted.js","sourceRoot":"","sources":["../../src/policies/GleamTomlSorted.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport { resolve } from \"pathe\";\nimport type { FilePolicyDefinition } from \"../policy.js\";\nimport {\n\tdefineGleamPolicy,\n\ttype GleamToml,\n} from \"../policyDefiners/defineGleamPolicy.js\";\n\n/**\n * Configuration for the GleamTomlSorted policy.\n *\n * @public\n */\nexport interface GleamTomlSortedConfig {\n\t/**\n\t * Sections whose keys should be sorted alphabetically.\n\t * @defaultValue [\"dependencies\", \"dev-dependencies\"]\n\t */\n\tsections?: string[];\n}\n\nconst DEFAULT_SORTED_SECTIONS = [\"dependencies\", \"dev-dependencies\"];\n\nconst SECTION_HEADER_REGEX = /^\\[([^\\]]+)\\]\\s*$/;\nconst KEY_VALUE_REGEX = /^(\\S+)\\s*=/;\n\nfunction isSorted(keys: string[]): boolean {\n\tfor (let i = 1; i < keys.length; i++) {\n\t\tconst prev = keys[i - 1];\n\t\tconst curr = keys[i];\n\t\tif (prev !== undefined && curr !== undefined && curr < prev) {\n\t\t\treturn false;\n\t\t}\n\t}\n\treturn true;\n}\n\ninterface TomlEntry {\n\tkey: string;\n\tlines: string[];\n}\n\nfunction classifyLine(\n\tline: string,\n): \"section\" | \"blank\" | \"comment\" | \"key\" | \"continuation\" {\n\tif (SECTION_HEADER_REGEX.test(line)) {\n\t\treturn \"section\";\n\t}\n\tif (line.trim() === \"\") {\n\t\treturn \"blank\";\n\t}\n\tif (line.trim().startsWith(\"#\")) {\n\t\treturn \"comment\";\n\t}\n\tif (KEY_VALUE_REGEX.test(line)) {\n\t\treturn \"key\";\n\t}\n\treturn \"continuation\";\n}\n\nfunction handleCommentLine(\n\tentryLine: string,\n\tcurrentEntry: TomlEntry | undefined,\n): TomlEntry {\n\tif (currentEntry) {\n\t\tcurrentEntry.lines.push(entryLine);\n\t\treturn currentEntry;\n\t}\n\treturn { key: \"\", lines: [entryLine] };\n}\n\nfunction processKeyLine(\n\tentryLine: string,\n\tcurrentEntry: TomlEntry | undefined,\n\tentries: TomlEntry[],\n): TomlEntry {\n\tif (currentEntry) {\n\t\tentries.push(currentEntry);\n\t}\n\tconst keyMatch = entryLine.match(KEY_VALUE_REGEX);\n\treturn { key: keyMatch?.[1] ?? \"\", lines: [entryLine] };\n}\n\nfunction collectSectionEntries(\n\tlines: string[],\n\tstartIndex: number,\n): {\n\tentries: TomlEntry[];\n\tendIndex: number;\n} {\n\tconst entries: TomlEntry[] = [];\n\tlet currentEntry: TomlEntry | undefined;\n\tlet i = startIndex;\n\n\twhile (i < lines.length) {\n\t\tconst entryLine = lines[i] ?? \"\";\n\t\tconst kind = classifyLine(entryLine);\n\n\t\tif (kind === \"section\") {\n\t\t\tbreak;\n\t\t}\n\n\t\tswitch (kind) {\n\t\t\tcase \"blank\": {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"comment\": {\n\t\t\t\tcurrentEntry = handleCommentLine(entryLine, currentEntry);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"key\": {\n\t\t\t\tcurrentEntry = processKeyLine(entryLine, currentEntry, entries);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"continuation\": {\n\t\t\t\tcurrentEntry?.lines.push(entryLine);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\ti++;\n\t}\n\tif (currentEntry) {\n\t\tentries.push(currentEntry);\n\t}\n\treturn { entries, endIndex: i };\n}\n\nfunction sortTomlSections(content: string, sectionsToSort: string[]): string {\n\tconst lines = content.split(\"\\n\");\n\tconst result: string[] = [];\n\tlet i = 0;\n\n\twhile (i < lines.length) {\n\t\tconst line = lines[i] ?? \"\";\n\t\tconst sectionMatch = line.match(SECTION_HEADER_REGEX);\n\n\t\tif (sectionMatch && sectionsToSort.includes(sectionMatch[1] ?? \"\")) {\n\t\t\tresult.push(line);\n\t\t\ti++;\n\t\t\tconst { entries, endIndex } = collectSectionEntries(lines, i);\n\t\t\tentries.sort((a, b) => a.key.localeCompare(b.key));\n\t\t\tfor (const entry of entries) {\n\t\t\t\tresult.push(...entry.lines);\n\t\t\t}\n\t\t\ti = endIndex;\n\t\t\tcontinue;\n\t\t}\n\n\t\tresult.push(line);\n\t\ti++;\n\t}\n\n\treturn result.join(\"\\n\");\n}\n\n/**\n * A policy that ensures dependency sections in gleam.toml are sorted alphabetically.\n *\n * @public\n */\nexport const GleamTomlSorted = defineGleamPolicy({\n\tname: \"GleamTomlSorted\",\n\tdescription:\n\t\t\"Ensures dependency sections in gleam.toml are sorted alphabetically.\",\n\thandler: async (\n\t\ttoml: GleamToml,\n\t\t{ file, root, resolve: shouldResolve, config },\n\t) => {\n\t\tconst sections = config?.sections ?? DEFAULT_SORTED_SECTIONS;\n\t\tconst unsortedSections: string[] = [];\n\n\t\tfor (const section of sections) {\n\t\t\tconst sectionData = toml[section] as Record<string, unknown> | undefined;\n\t\t\tif (sectionData !== undefined && !isSorted(Object.keys(sectionData))) {\n\t\t\t\tunsortedSections.push(section);\n\t\t\t}\n\t\t}\n\n\t\tif (unsortedSections.length === 0) {\n\t\t\treturn [];\n\t\t}\n\n\t\tif (shouldResolve) {\n\t\t\ttry {\n\t\t\t\tconst filePath = resolve(root, file);\n\t\t\t\tconst content = await readFile(filePath, \"utf-8\");\n\t\t\t\tconst sorted = sortTomlSections(content, unsortedSections);\n\t\t\t\tawait writeFile(filePath, sorted);\n\t\t\t\treturn [\n\t\t\t\t\t{\n\t\t\t\t\t\tmessage: `Unsorted sections: [${unsortedSections.join(\"], [\")}]`,\n\t\t\t\t\t\tfixStatus: \"fixed\",\n\t\t\t\t\t},\n\t\t\t\t];\n\t\t\t} catch {\n\t\t\t\treturn [\n\t\t\t\t\t{\n\t\t\t\t\t\tmessage: `Unsorted sections: [${unsortedSections.join(\"], [\")}]. Auto-fix failed.`,\n\t\t\t\t\t\tfixStatus: \"failed\",\n\t\t\t\t\t},\n\t\t\t\t];\n\t\t\t}\n\t\t}\n\t\treturn [\n\t\t\t{\n\t\t\t\tmessage: `Unsorted sections: [${unsortedSections.join(\"], [\")}]`,\n\t\t\t\tfixStatus: \"available\",\n\t\t\t\tmanualFix:\n\t\t\t\t\t\"Sort the dependency keys alphabetically in the listed sections.\",\n\t\t\t},\n\t\t];\n\t},\n}) satisfies FilePolicyDefinition<GleamTomlSortedConfig>;\n"]}

package/esm/policies/GleamVersionConstraint.d.ts

@@ -0,0 +1,20 @@
+import type { FilePolicyDefinition } from "../policy.js";
+/**
+ * Configuration for the GleamVersionConstraint policy.
+ *
+ * @public
+ */
+export interface GleamVersionConstraintConfig {
+    /**
+     * Minimum Gleam compiler version to require (e.g., "1.0.0").
+     * If set, the constraint must specify at least this version.
+     */
+    minimumVersion?: string;
+}
+/**
+ * A policy that ensures the Gleam compiler version constraint is set in gleam.toml.
+ *
+ * @public
+ */
+export declare const GleamVersionConstraint: FilePolicyDefinition<GleamVersionConstraintConfig>;
+//# sourceMappingURL=GleamVersionConstraint.d.ts.map

package/esm/policies/GleamVersionConstraint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamVersionConstraint.d.ts","sourceRoot":"","sources":["../../src/policies/GleamVersionConstraint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMzD;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC5C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAyCD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,oDA8B4B,CAAC"}

package/esm/policies/GleamVersionConstraint.js

@@ -0,0 +1,68 @@
+import { defineGleamPolicy, } from "../policyDefiners/defineGleamPolicy.js";
+const SEMVER_PREFIX_REGEX = /^[><=~^!\s]+/;
+/**
+ * Parse a simple semver string into comparable parts.
+ */
+function parseSemver(version) {
+    const cleaned = version.replace(SEMVER_PREFIX_REGEX, "").trim();
+    const parts = cleaned.split(".");
+    if (parts.length < 2) {
+        return undefined;
+    }
+    const major = Number.parseInt(parts[0] ?? "0", 10);
+    const minor = Number.parseInt(parts[1] ?? "0", 10);
+    const patch = Number.parseInt(parts[2] ?? "0", 10);
+    if (Number.isNaN(major) || Number.isNaN(minor) || Number.isNaN(patch)) {
+        return undefined;
+    }
+    return [major, minor, patch];
+}
+function isVersionAtLeast(constraint, minimum) {
+    const constraintParts = parseSemver(constraint);
+    const minimumParts = parseSemver(minimum);
+    if (!(constraintParts && minimumParts)) {
+        return false;
+    }
+    for (let i = 0; i < 3; i++) {
+        const c = constraintParts[i] ?? 0;
+        const m = minimumParts[i] ?? 0;
+        if (c > m) {
+            return true;
+        }
+        if (c < m) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * A policy that ensures the Gleam compiler version constraint is set in gleam.toml.
+ *
+ * @public
+ */
+export const GleamVersionConstraint = defineGleamPolicy({
+    name: "GleamVersionConstraint",
+    description: "Ensures gleam.toml has a Gleam compiler version constraint to prevent incompatible builds.",
+    handler: async (toml, { config }) => {
+        const gleamVersion = toml.gleam;
+        if (gleamVersion === undefined || gleamVersion === "") {
+            return [
+                {
+                    message: "Missing gleam version constraint in gleam.toml.",
+                    manualFix: 'Add gleam = ">= 1.0.0" (or appropriate version) to gleam.toml.',
+                },
+            ];
+        }
+        if (config?.minimumVersion &&
+            !isVersionAtLeast(gleamVersion, config.minimumVersion)) {
+            return [
+                {
+                    message: `Gleam version constraint "${gleamVersion}" is below minimum "${config.minimumVersion}".`,
+                    manualFix: `Update to gleam = ">= ${config.minimumVersion}" or higher.`,
+                },
+            ];
+        }
+        return [];
+    },
+});
+//# sourceMappingURL=GleamVersionConstraint.js.map

package/esm/policies/GleamVersionConstraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamVersionConstraint.js","sourceRoot":"","sources":["../../src/policies/GleamVersionConstraint.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FilePolicyDefinition } from \"../policy.js\";\nimport {\n\tdefineGleamPolicy,\n\ttype GleamToml,\n} from \"../policyDefiners/defineGleamPolicy.js\";\n\n/**\n * Configuration for the GleamVersionConstraint policy.\n *\n * @public\n */\nexport interface GleamVersionConstraintConfig {\n\t/**\n\t * Minimum Gleam compiler version to require (e.g., \"1.0.0\").\n\t * If set, the constraint must specify at least this version.\n\t */\n\tminimumVersion?: string;\n}\n\nconst SEMVER_PREFIX_REGEX = /^[><=~^!\\s]+/;\n\n/**\n * Parse a simple semver string into comparable parts.\n */\nfunction parseSemver(version: string): [number, number, number] | undefined {\n\tconst cleaned = version.replace(SEMVER_PREFIX_REGEX, \"\").trim();\n\tconst parts = cleaned.split(\".\");\n\tif (parts.length < 2) {\n\t\treturn undefined;\n\t}\n\tconst major = Number.parseInt(parts[0] ?? \"0\", 10);\n\tconst minor = Number.parseInt(parts[1] ?? \"0\", 10);\n\tconst patch = Number.parseInt(parts[2] ?? \"0\", 10);\n\tif (Number.isNaN(major) || Number.isNaN(minor) || Number.isNaN(patch)) {\n\t\treturn undefined;\n\t}\n\treturn [major, minor, patch];\n}\n\nfunction isVersionAtLeast(constraint: string, minimum: string): boolean {\n\tconst constraintParts = parseSemver(constraint);\n\tconst minimumParts = parseSemver(minimum);\n\tif (!(constraintParts && minimumParts)) {\n\t\treturn false;\n\t}\n\tfor (let i = 0; i < 3; i++) {\n\t\tconst c = constraintParts[i] ?? 0;\n\t\tconst m = minimumParts[i] ?? 0;\n\t\tif (c > m) {\n\t\t\treturn true;\n\t\t}\n\t\tif (c < m) {\n\t\t\treturn false;\n\t\t}\n\t}\n\treturn true;\n}\n\n/**\n * A policy that ensures the Gleam compiler version constraint is set in gleam.toml.\n *\n * @public\n */\nexport const GleamVersionConstraint = defineGleamPolicy({\n\tname: \"GleamVersionConstraint\",\n\tdescription:\n\t\t\"Ensures gleam.toml has a Gleam compiler version constraint to prevent incompatible builds.\",\n\thandler: async (toml: GleamToml, { config }) => {\n\t\tconst gleamVersion = toml.gleam as string | undefined;\n\n\t\tif (gleamVersion === undefined || gleamVersion === \"\") {\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tmessage: \"Missing gleam version constraint in gleam.toml.\",\n\t\t\t\t\tmanualFix:\n\t\t\t\t\t\t'Add gleam = \">= 1.0.0\" (or appropriate version) to gleam.toml.',\n\t\t\t\t},\n\t\t\t];\n\t\t}\n\n\t\tif (\n\t\t\tconfig?.minimumVersion &&\n\t\t\t!isVersionAtLeast(gleamVersion, config.minimumVersion)\n\t\t) {\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tmessage: `Gleam version constraint \"${gleamVersion}\" is below minimum \"${config.minimumVersion}\".`,\n\t\t\t\t\tmanualFix: `Update to gleam = \">= ${config.minimumVersion}\" or higher.`,\n\t\t\t\t},\n\t\t\t];\n\t\t}\n\t\treturn [];\n\t},\n}) satisfies FilePolicyDefinition<GleamVersionConstraintConfig>;\n"]}

package/esm/policies/HtmlFileHeaders.d.ts

@@ -2,7 +2,9 @@ import { type FileHeaderPolicyConfig } from "../policyDefiners/defineFileHeaderP
 /**
  * A RepoPolicy that checks that HTML files have the configured header comment.
  *
- * @alpha
+ * @public
  */
-export declare const HtmlFileHeaders: import("../policy.js").PolicyShape<FileHeaderPolicyConfig>;
+export declare const HtmlFileHeaders: import("../policy.js").FilePolicyDefinition<FileHeaderPolicyConfig> & {
+    requiresConfig: true;
+};
 //# sourceMappingURL=HtmlFileHeaders.d.ts.map

package/esm/policies/HtmlFileHeaders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HtmlFileHeaders.d.ts","sourceRoot":"","sources":["../../src/policies/HtmlFileHeaders.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,6CAA6C,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,eAAe,4DAkB1B,CAAC"}
+{"version":3,"file":"HtmlFileHeaders.d.ts","sourceRoot":"","sources":["../../src/policies/HtmlFileHeaders.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,6CAA6C,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;CAe1B,CAAC"}

package/esm/policies/HtmlFileHeaders.js

@@ -3,13 +3,13 @@ import { defineFileHeaderPolicy, } from "../policyDefiners/defineFileHeaderPolic
 /**
  * A RepoPolicy that checks that HTML files have the configured header comment.
  *
- * @alpha
+ * @public
  */
 export const HtmlFileHeaders = defineFileHeaderPolicy({
     name: "HtmlFileHeaders",
     description: "Ensures HTML files have the configured header comment.",
     config: {
-        match: /(^|\/)[^/]+\.[mc]?[jt]sx?$/i,
+        match: /(^|\/)[^/]+\.html?$/i,
         lineStart: /<!-- /, // Lines begin with '<!-- '
         lineEnd: / -->\r?\n/, // Lines end with ' -->' followed by CRLF or LF
         replacer: (content, { headerText }) => {

package/esm/policies/HtmlFileHeaders.js.map

@@ -1 +1 @@
-{"version":3,"file":"HtmlFileHeaders.js","sourceRoot":"","sources":["../../src/policies/HtmlFileHeaders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EACN,sBAAsB,GAEtB,MAAM,6CAA6C,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;IACrD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,wDAAwD;IACrE,MAAM,EAAE;QACP,KAAK,EAAE,6BAA6B;QACpC,SAAS,EAAE,OAAO,EAAE,2BAA2B;QAC/C,OAAO,EAAE,WAAW,EAAE,+CAA+C;QACrE,QAAQ,EAAE,CACT,OAAe,EACf,EAAE,UAAU,EAA0B,EAC7B,EAAE;YACX,MAAM,UAAU,GAAG,QAAQ,UAAU,CAAC,OAAO,CAC5C,OAAO,EACP,OAAO,OAAO,OAAO,CACrB,OAAO,OAAO,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;YACtC,OAAO,UAAU,CAAC;QACnB,CAAC;KACD;CACD,CAAC,CAAC","sourcesContent":["import { EOL as newline } from \"node:os\";\nimport {\n\tdefineFileHeaderPolicy,\n\ttype FileHeaderPolicyConfig,\n} from \"../policyDefiners/defineFileHeaderPolicy.js\";\n\n/**\n * A RepoPolicy that checks that HTML files have the configured header comment.\n *\n * @alpha\n */\nexport const HtmlFileHeaders = defineFileHeaderPolicy({\n\tname: \"HtmlFileHeaders\",\n\tdescription: \"Ensures HTML files have the configured header comment.\",\n\tconfig: {\n\t\tmatch: /(^|\\/)[^/]+\\.[mc]?[jt]sx?$/i,\n\t\tlineStart: /<!-- /, // Lines begin with '<!-- '\n\t\tlineEnd: / -->\\r?\\n/, // Lines end with ' -->' followed by CRLF or LF\n\t\treplacer: (\n\t\t\tcontent: string,\n\t\t\t{ headerText }: FileHeaderPolicyConfig,\n\t\t): string => {\n\t\t\tconst newContent = `<!-- ${headerText.replace(\n\t\t\t\tnewline,\n\t\t\t\t` -->${newline}<!-- `,\n\t\t\t)} -->${newline}${newline}${content}`;\n\t\t\treturn newContent;\n\t\t},\n\t},\n});\n"]}
+{"version":3,"file":"HtmlFileHeaders.js","sourceRoot":"","sources":["../../src/policies/HtmlFileHeaders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EACN,sBAAsB,GAEtB,MAAM,6CAA6C,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;IACrD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,wDAAwD;IACrE,MAAM,EAAE;QACP,KAAK,EAAE,sBAAsB;QAC7B,SAAS,EAAE,OAAO,EAAE,2BAA2B;QAC/C,OAAO,EAAE,WAAW,EAAE,+CAA+C;QACrE,QAAQ,EAAE,CACT,OAAe,EACf,EAAE,UAAU,EAA0B,EAC7B,EAAE;YACX,MAAM,UAAU,GAAG,QAAQ,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,OAAO,OAAO,CAAC,OAAO,OAAO,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;YAClH,OAAO,UAAU,CAAC;QACnB,CAAC;KACD;CACD,CAAC,CAAC","sourcesContent":["import { EOL as newline } from \"node:os\";\nimport {\n\tdefineFileHeaderPolicy,\n\ttype FileHeaderPolicyConfig,\n} from \"../policyDefiners/defineFileHeaderPolicy.js\";\n\n/**\n * A RepoPolicy that checks that HTML files have the configured header comment.\n *\n * @public\n */\nexport const HtmlFileHeaders = defineFileHeaderPolicy({\n\tname: \"HtmlFileHeaders\",\n\tdescription: \"Ensures HTML files have the configured header comment.\",\n\tconfig: {\n\t\tmatch: /(^|\\/)[^/]+\\.html?$/i,\n\t\tlineStart: /<!-- /, // Lines begin with '<!-- '\n\t\tlineEnd: / -->\\r?\\n/, // Lines end with ' -->' followed by CRLF or LF\n\t\treplacer: (\n\t\t\tcontent: string,\n\t\t\t{ headerText }: FileHeaderPolicyConfig,\n\t\t): string => {\n\t\t\tconst newContent = `<!-- ${headerText.replace(newline, ` -->${newline}<!-- `)} -->${newline}${newline}${content}`;\n\t\t\treturn newContent;\n\t\t},\n\t},\n});\n"]}

package/esm/policies/JsTsFileHeaders.d.ts

@@ -2,7 +2,9 @@ import { type FileHeaderPolicyConfig } from "../policyDefiners/defineFileHeaderP
 /**
  * A RepoPolicy that checks that JavaScript and TypeScript source files have the configured header comment
  *
- * @alpha
+ * @public
  */
-export declare const JsTsFileHeaders: import("../policy.js").PolicyShape<FileHeaderPolicyConfig>;
+export declare const JsTsFileHeaders: import("../policy.js").FilePolicyDefinition<FileHeaderPolicyConfig> & {
+    requiresConfig: true;
+};
 //# sourceMappingURL=JsTsFileHeaders.d.ts.map

package/esm/policies/JsTsFileHeaders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JsTsFileHeaders.d.ts","sourceRoot":"","sources":["../../src/policies/JsTsFileHeaders.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,6CAA6C,CAAC;AAkBrD;;;;GAIG;AACH,eAAO,MAAM,eAAe,4DAY1B,CAAC"}
+{"version":3,"file":"JsTsFileHeaders.d.ts","sourceRoot":"","sources":["../../src/policies/JsTsFileHeaders.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,6CAA6C,CAAC;AAerD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;CAY1B,CAAC"}

package/esm/policies/JsTsFileHeaders.js

@@ -11,7 +11,7 @@ const jsTsReplacer = (prevContent, { headerText }) => {
 /**
  * A RepoPolicy that checks that JavaScript and TypeScript source files have the configured header comment
  *
- * @alpha
+ * @public
  */
 export const JsTsFileHeaders = defineFileHeaderPolicy({
     name: "JsTsFileHeaders",

package/esm/policies/JsTsFileHeaders.js.map

@@ -1 +1 @@
-{"version":3,"file":"JsTsFileHeaders.js","sourceRoot":"","sources":["../../src/policies/JsTsFileHeaders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EACN,sBAAsB,GAEtB,MAAM,6CAA6C,CAAC;AAErD,MAAM,YAAY,GAAG,CACpB,WAAmB,EACnB,EAAE,UAAU,EAA0B,EAC7B,EAAE;IACX,qCAAqC;IACrC,MAAM,SAAS,GACd,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3D,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,MAAM,UAAU,GAAG,MAAM,OAAO,MAAM,UAAU,CAAC,OAAO,CACvD,OAAO,EACP,GAAG,OAAO,KAAK,CACf,GAAG,OAAO,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC;IAC3C,OAAO,UAAU,CAAC;AACnB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;IACrD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACV,oFAAoF;IACrF,MAAM,EAAE;QACP,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,4BAA4B,EAAE,kDAAkD;QAC7F,SAAS,EAAE,MAAM,EAAE,qCAAqC;QACxD,OAAO,EAAE,OAAO,EAAE,uCAAuC;QACzD,SAAS,EAAE,iBAAiB,EAAE,0EAA0E;QACxG,QAAQ,EAAE,YAAY;KACtB;CACD,CAAC,CAAC","sourcesContent":["import { EOL as newline } from \"node:os\";\nimport {\n\tdefineFileHeaderPolicy,\n\ttype FileHeaderPolicyConfig,\n} from \"../policyDefiners/defineFileHeaderPolicy.js\";\n\nconst jsTsReplacer = (\n\tprevContent: string,\n\t{ headerText }: FileHeaderPolicyConfig,\n): string => {\n\t// prepend header to existing content\n\tconst separator =\n\t\tprevContent.startsWith(\"\\r\") || prevContent.startsWith(\"\\n\")\n\t\t\t? newline\n\t\t\t: newline + newline;\n\tconst newContent = `/*!${newline} * ${headerText.replace(\n\t\tnewline,\n\t\t`${newline} * `,\n\t)}${newline} */${separator}${prevContent}`;\n\treturn newContent;\n};\n\n/**\n * A RepoPolicy that checks that JavaScript and TypeScript source files have the configured header comment\n *\n * @alpha\n */\nexport const JsTsFileHeaders = defineFileHeaderPolicy({\n\tname: \"JsTsFileHeaders\",\n\tdescription:\n\t\t\"Ensures JavaScript and TypeScript source files have the configured header comment.\",\n\tconfig: {\n\t\tmatch: /(^|\\/)[^/]+\\.[mc]?[jt]sx?$/i,\n\t\theaderStart: /(#![^\\n]*\\r?\\n)?\\/\\*!\\r?\\n/, // Begins with optional hashbang followed by '/*!'\n\t\tlineStart: / \\* /, // Subsequent lines begins with ' * '\n\t\tlineEnd: /\\r?\\n/, // Subsequent lines end with CRLF or LF\n\t\theaderEnd: / \\*\\/\\r?\\n\\r?\\n/, // Header ends with ' */' on a line by itself, followed by another newline\n\t\treplacer: jsTsReplacer,\n\t},\n});\n"]}
+{"version":3,"file":"JsTsFileHeaders.js","sourceRoot":"","sources":["../../src/policies/JsTsFileHeaders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EACN,sBAAsB,GAEtB,MAAM,6CAA6C,CAAC;AAErD,MAAM,YAAY,GAAG,CACpB,WAAmB,EACnB,EAAE,UAAU,EAA0B,EAC7B,EAAE;IACX,qCAAqC;IACrC,MAAM,SAAS,GACd,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3D,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,MAAM,UAAU,GAAG,MAAM,OAAO,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,KAAK,CAAC,GAAG,OAAO,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC;IAC5H,OAAO,UAAU,CAAC;AACnB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;IACrD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACV,oFAAoF;IACrF,MAAM,EAAE;QACP,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,4BAA4B,EAAE,kDAAkD;QAC7F,SAAS,EAAE,MAAM,EAAE,qCAAqC;QACxD,OAAO,EAAE,OAAO,EAAE,uCAAuC;QACzD,SAAS,EAAE,iBAAiB,EAAE,0EAA0E;QACxG,QAAQ,EAAE,YAAY;KACtB;CACD,CAAC,CAAC","sourcesContent":["import { EOL as newline } from \"node:os\";\nimport {\n\tdefineFileHeaderPolicy,\n\ttype FileHeaderPolicyConfig,\n} from \"../policyDefiners/defineFileHeaderPolicy.js\";\n\nconst jsTsReplacer = (\n\tprevContent: string,\n\t{ headerText }: FileHeaderPolicyConfig,\n): string => {\n\t// prepend header to existing content\n\tconst separator =\n\t\tprevContent.startsWith(\"\\r\") || prevContent.startsWith(\"\\n\")\n\t\t\t? newline\n\t\t\t: newline + newline;\n\tconst newContent = `/*!${newline} * ${headerText.replace(newline, `${newline} * `)}${newline} */${separator}${prevContent}`;\n\treturn newContent;\n};\n\n/**\n * A RepoPolicy that checks that JavaScript and TypeScript source files have the configured header comment\n *\n * @public\n */\nexport const JsTsFileHeaders = defineFileHeaderPolicy({\n\tname: \"JsTsFileHeaders\",\n\tdescription:\n\t\t\"Ensures JavaScript and TypeScript source files have the configured header comment.\",\n\tconfig: {\n\t\tmatch: /(^|\\/)[^/]+\\.[mc]?[jt]sx?$/i,\n\t\theaderStart: /(#![^\\n]*\\r?\\n)?\\/\\*!\\r?\\n/, // Begins with optional hashbang followed by '/*!'\n\t\tlineStart: / \\* /, // Subsequent lines begins with ' * '\n\t\tlineEnd: /\\r?\\n/, // Subsequent lines end with CRLF or LF\n\t\theaderEnd: / \\*\\/\\r?\\n\\r?\\n/, // Header ends with ' */' on a line by itself, followed by another newline\n\t\treplacer: jsTsReplacer,\n\t},\n});\n"]}

package/esm/policies/LicenseFileExists.d.ts

@@ -1,8 +1,7 @@
-import type { PolicyDefinition } from "../policy.js";
 /**
  * Policy settings for the LicenseFileExists repo policy.
  *
- * @alpha
+ * @public
  */
 export interface LicenseFileExistsSettings {
     /**
@@ -14,7 +13,14 @@ export interface LicenseFileExistsSettings {
  * A repo policy that checks that a LICENSE file exists in the repository root.
  * This is essential for open source projects to clarify usage rights and obligations.
  *
- * @alpha
+ * @public
  */
-export declare const LicenseFileExists: PolicyDefinition<LicenseFileExistsSettings>;
+export declare const LicenseFileExists: {
+    name: string;
+    description: string;
+    scope: "repository";
+    handler: ({ root, files, config }: import("../policy.js").RepositoryPolicyArgs<LicenseFileExistsSettings>) => Promise<{
+        message: string;
+    }[]>;
+};
 //# sourceMappingURL=LicenseFileExists.d.ts.map

package/esm/policies/LicenseFileExists.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LicenseFileExists.d.ts","sourceRoot":"","sources":["../../src/policies/LicenseFileExists.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,cAAc,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACzC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAgBD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,CAAC,yBAAyB,CA8BvE,CAAC"}
+{"version":3,"file":"LicenseFileExists.d.ts","sourceRoot":"","sources":["../../src/policies/LicenseFileExists.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACzC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAgBD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;CAoCmC,CAAC"}

package/esm/policies/LicenseFileExists.js

@@ -1,6 +1,5 @@
-import { existsSync } from "node:fs";
+import { stat } from "node:fs/promises";
 import path from "pathe";
-import { makePolicyDefinition } from "../makePolicy.js";
 /**
  * Default license file names to check for.
  */
@@ -18,29 +17,37 @@ const DEFAULT_LICENSE_NAMES = [
  * A repo policy that checks that a LICENSE file exists in the repository root.
  * This is essential for open source projects to clarify usage rights and obligations.
  *
- * @alpha
+ * @public
  */
-export const LicenseFileExists = makePolicyDefinition({
+export const LicenseFileExists = {
     name: "LicenseFileExists",
     description: "Ensures a LICENSE file exists in the repository root for open source projects.",
-    // Only trigger on package.json to check once per repository
-    match: /^package\.json$/,
-    handler: async ({ root, config }) => {
+    scope: "repository",
+    handler: async ({ root, files, config }) => {
         const acceptedNames = config?.acceptedNames ?? DEFAULT_LICENSE_NAMES;
         // Check if any of the accepted license files exist in the root
-        const hasLicenseFile = acceptedNames.some((name) => existsSync(path.join(root, name)));
-        if (hasLicenseFile) {
-            return true;
+        for (const name of acceptedNames) {
+            if (!files.includes(name)) {
+                continue;
+            }
+            try {
+                if ((await stat(path.join(root, name))).isFile()) {
+                    return [];
+                }
+            }
+            catch (error) {
+                if (!(error instanceof Error &&
+                    "code" in error &&
+                    error.code === "ENOENT")) {
+                    throw error;
+                }
+            }
         }
-        const result = {
-            name: LicenseFileExists.name,
-            file: ".", // Report against repository root
-            autoFixable: false,
-            errorMessages: [
-                `No LICENSE file found in repository root. Expected one of: ${acceptedNames.join(", ")}`,
-            ],
-        };
-        return result;
+        return [
+            {
+                message: `No LICENSE file found in repository root. Expected one of: ${acceptedNames.join(", ")}`,
+            },
+        ];
     },
-});
+};
 //# sourceMappingURL=LicenseFileExists.js.map

package/esm/policies/LicenseFileExists.js.map

@@ -1 +1 @@
-{"version":3,"file":"LicenseFileExists.js","sourceRoot":"","sources":["../../src/policies/LicenseFileExists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,OAAO,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAexD;;GAEG;AACH,MAAM,qBAAqB,GAAG;IAC7B,SAAS;IACT,aAAa;IACb,YAAY;IACZ,aAAa;IACb,SAAS;IACT,aAAa;IACb,YAAY;IACZ,aAAa;CACb,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC7B,oBAAoB,CAAC;IACpB,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACV,gFAAgF;IACjF,4DAA4D;IAC5D,KAAK,EAAE,iBAAiB;IACxB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QACnC,MAAM,aAAa,GAAG,MAAM,EAAE,aAAa,IAAI,qBAAqB,CAAC;QAErE,+DAA+D;QAC/D,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAClD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CACjC,CAAC;QAEF,IAAI,cAAc,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,MAAM,GAAkB;YAC7B,IAAI,EAAE,iBAAiB,CAAC,IAAI;YAC5B,IAAI,EAAE,GAAG,EAAE,iCAAiC;YAC5C,WAAW,EAAE,KAAK;YAClB,aAAa,EAAE;gBACd,8DAA8D,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACxF;SACD,CAAC;QAEF,OAAO,MAAM,CAAC;IACf,CAAC;CACD,CAAC,CAAC","sourcesContent":["import { existsSync } from \"node:fs\";\nimport path from \"pathe\";\nimport { makePolicyDefinition } from \"../makePolicy.js\";\nimport type { PolicyDefinition, PolicyFailure } from \"../policy.js\";\n\n/**\n * Policy settings for the LicenseFileExists repo policy.\n *\n * @alpha\n */\nexport interface LicenseFileExistsSettings {\n\t/**\n\t * Array of acceptable license file names. Defaults to common variations.\n\t */\n\tacceptedNames?: string[];\n}\n\n/**\n * Default license file names to check for.\n */\nconst DEFAULT_LICENSE_NAMES = [\n\t\"LICENSE\",\n\t\"LICENSE.txt\",\n\t\"LICENSE.md\",\n\t\"LICENSE.rst\",\n\t\"LICENCE\",\n\t\"LICENCE.txt\",\n\t\"LICENCE.md\",\n\t\"LICENCE.rst\",\n];\n\n/**\n * A repo policy that checks that a LICENSE file exists in the repository root.\n * This is essential for open source projects to clarify usage rights and obligations.\n *\n * @alpha\n */\nexport const LicenseFileExists: PolicyDefinition<LicenseFileExistsSettings> =\n\tmakePolicyDefinition({\n\t\tname: \"LicenseFileExists\",\n\t\tdescription:\n\t\t\t\"Ensures a LICENSE file exists in the repository root for open source projects.\",\n\t\t// Only trigger on package.json to check once per repository\n\t\tmatch: /^package\\.json$/,\n\t\thandler: async ({ root, config }) => {\n\t\t\tconst acceptedNames = config?.acceptedNames ?? DEFAULT_LICENSE_NAMES;\n\n\t\t\t// Check if any of the accepted license files exist in the root\n\t\t\tconst hasLicenseFile = acceptedNames.some((name) =>\n\t\t\t\texistsSync(path.join(root, name)),\n\t\t\t);\n\n\t\t\tif (hasLicenseFile) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst result: PolicyFailure = {\n\t\t\t\tname: LicenseFileExists.name,\n\t\t\t\tfile: \".\", // Report against repository root\n\t\t\t\tautoFixable: false,\n\t\t\t\terrorMessages: [\n\t\t\t\t\t`No LICENSE file found in repository root. Expected one of: ${acceptedNames.join(\", \")}`,\n\t\t\t\t],\n\t\t\t};\n\n\t\t\treturn result;\n\t\t},\n\t});\n"]}
+{"version":3,"file":"LicenseFileExists.js","sourceRoot":"","sources":["../../src/policies/LicenseFileExists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,IAAI,MAAM,OAAO,CAAC;AAezB;;GAEG;AACH,MAAM,qBAAqB,GAAG;IAC7B,SAAS;IACT,aAAa;IACb,YAAY;IACZ,aAAa;IACb,SAAS;IACT,aAAa;IACb,YAAY;IACZ,aAAa;CACb,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACV,gFAAgF;IACjF,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1C,MAAM,aAAa,GAAG,MAAM,EAAE,aAAa,IAAI,qBAAqB,CAAC;QAErE,+DAA+D;QAC/D,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACV,CAAC;YACD,IAAI,CAAC;gBACJ,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;oBAClD,OAAO,EAAE,CAAC;gBACX,CAAC;YACF,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACzB,IACC,CAAC,CACA,KAAK,YAAY,KAAK;oBACtB,MAAM,IAAI,KAAK;oBACf,KAAK,CAAC,IAAI,KAAK,QAAQ,CACvB,EACA,CAAC;oBACF,MAAM,KAAK,CAAC;gBACb,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO;YACN;gBACC,OAAO,EAAE,8DAA8D,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACjG;SACD,CAAC;IACH,CAAC;CAC+D,CAAC","sourcesContent":["import { stat } from \"node:fs/promises\";\nimport path from \"pathe\";\nimport type { RepositoryPolicyDefinition } from \"../policy.js\";\n\n/**\n * Policy settings for the LicenseFileExists repo policy.\n *\n * @public\n */\nexport interface LicenseFileExistsSettings {\n\t/**\n\t * Array of acceptable license file names. Defaults to common variations.\n\t */\n\tacceptedNames?: string[];\n}\n\n/**\n * Default license file names to check for.\n */\nconst DEFAULT_LICENSE_NAMES = [\n\t\"LICENSE\",\n\t\"LICENSE.txt\",\n\t\"LICENSE.md\",\n\t\"LICENSE.rst\",\n\t\"LICENCE\",\n\t\"LICENCE.txt\",\n\t\"LICENCE.md\",\n\t\"LICENCE.rst\",\n];\n\n/**\n * A repo policy that checks that a LICENSE file exists in the repository root.\n * This is essential for open source projects to clarify usage rights and obligations.\n *\n * @public\n */\nexport const LicenseFileExists = {\n\tname: \"LicenseFileExists\",\n\tdescription:\n\t\t\"Ensures a LICENSE file exists in the repository root for open source projects.\",\n\tscope: \"repository\",\n\thandler: async ({ root, files, config }) => {\n\t\tconst acceptedNames = config?.acceptedNames ?? DEFAULT_LICENSE_NAMES;\n\n\t\t// Check if any of the accepted license files exist in the root\n\t\tfor (const name of acceptedNames) {\n\t\t\tif (!files.includes(name)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tif ((await stat(path.join(root, name))).isFile()) {\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t} catch (error: unknown) {\n\t\t\t\tif (\n\t\t\t\t\t!(\n\t\t\t\t\t\terror instanceof Error &&\n\t\t\t\t\t\t\"code\" in error &&\n\t\t\t\t\t\terror.code === \"ENOENT\"\n\t\t\t\t\t)\n\t\t\t\t) {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn [\n\t\t\t{\n\t\t\t\tmessage: `No LICENSE file found in repository root. Expected one of: ${acceptedNames.join(\", \")}`,\n\t\t\t},\n\t\t];\n\t},\n} satisfies RepositoryPolicyDefinition<LicenseFileExistsSettings>;\n"]}

package/esm/policies/MutuallyExclusiveScripts.d.ts

@@ -1,7 +1,7 @@
 /**
  * Configuration for the MutuallyExclusiveScripts policy.
  *
- * @alpha
+ * @public
  */
 export interface MutuallyExclusiveScriptsConfig {
     /**
@@ -29,18 +29,20 @@ export interface MutuallyExclusiveScriptsConfig {
  *
  * @example
  * ```typescript
- * import { policy } from "repopo";
+ * import { makePolicy } from "repopo";
  * import { MutuallyExclusiveScripts } from "repopo/policies";
  *
- * policy(MutuallyExclusiveScripts, {
+ * makePolicy(MutuallyExclusiveScripts, { config: {
  *   groups: [
  *     ["lint:eslint", "lint:biome"],
  *     ["test:jest", "test:vitest"],
  *   ],
- * })
+ * } })
  * ```
  *
- * @alpha
+ * @public
  */
-export declare const MutuallyExclusiveScripts: import("../policy.js").PolicyShape<MutuallyExclusiveScriptsConfig | undefined>;
+export declare const MutuallyExclusiveScripts: import("../policy.js").FilePolicyDefinition<MutuallyExclusiveScriptsConfig | undefined> & {
+    requiresConfig: true;
+};
 //# sourceMappingURL=MutuallyExclusiveScripts.d.ts.map

package/esm/policies/MutuallyExclusiveScripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MutuallyExclusiveScripts.d.ts","sourceRoot":"","sources":["../../src/policies/MutuallyExclusiveScripts.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC9C;;;;;;;;;;;;OAYG;IACH,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;CACnB;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,wBAAwB,gFAsCnC,CAAC"}
+{"version":3,"file":"MutuallyExclusiveScripts.d.ts","sourceRoot":"","sources":["../../src/policies/MutuallyExclusiveScripts.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC9C;;;;;;;;;;;;OAYG;IACH,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;CACnB;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,wBAAwB;;CAiCnC,CAAC"}

package/esm/policies/MutuallyExclusiveScripts.js

@@ -10,25 +10,26 @@ const POLICY_NAME = "MutuallyExclusiveScripts";
  *
  * @example
  * ```typescript
- * import { policy } from "repopo";
+ * import { makePolicy } from "repopo";
  * import { MutuallyExclusiveScripts } from "repopo/policies";
  *
- * policy(MutuallyExclusiveScripts, {
+ * makePolicy(MutuallyExclusiveScripts, { config: {
  *   groups: [
  *     ["lint:eslint", "lint:biome"],
  *     ["test:jest", "test:vitest"],
  *   ],
- * })
+ * } })
  * ```
  *
- * @alpha
+ * @public
  */
 export const MutuallyExclusiveScripts = definePackagePolicy({
+    requiresConfig: true,
     name: POLICY_NAME,
     description: "Validates that at most one script from each exclusive group exists in package.json.",
-    handler: async (json, { file, config }) => {
+    handler: async (json, { config }) => {
         if (config === undefined || config.groups.length === 0) {
-            return true;
+            return [];
         }
         const scripts = json.scripts ?? {};
         const errors = [];
@@ -39,14 +40,9 @@ export const MutuallyExclusiveScripts = definePackagePolicy({
             }
         }
         if (errors.length === 0) {
-            return true;
+            return [];
         }
-        return {
-            name: POLICY_NAME,
-            file,
-            autoFixable: false,
-            errorMessages: errors,
-        };
+        return errors.map((message) => ({ message }));
     },
 });
 //# sourceMappingURL=MutuallyExclusiveScripts.js.map

package/esm/policies/MutuallyExclusiveScripts.js.map

@@ -1 +1 @@
-{"version":3,"file":"MutuallyExclusiveScripts.js","sourceRoot":"","sources":["../../src/policies/MutuallyExclusiveScripts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAwB/E,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,mBAAmB,CAGzD;IACD,IAAI,EAAE,WAAW;IACjB,WAAW,EACV,qFAAqF;IACtF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QACzC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACnC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAClD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAClC,CAAC;YAEF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CACV,6CAA6C,cAAc,CAAC,MAAM,KAAK,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClG,CAAC;YACH,CAAC;QACF,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO;YACN,IAAI,EAAE,WAAW;YACjB,IAAI;YACJ,WAAW,EAAE,KAAK;YAClB,aAAa,EAAE,MAAM;SACrB,CAAC;IACH,CAAC;CACD,CAAC,CAAC","sourcesContent":["import type { PackageJson } from \"type-fest\";\nimport { definePackagePolicy } from \"../policyDefiners/definePackagePolicy.js\";\n\n/**\n * Configuration for the MutuallyExclusiveScripts policy.\n *\n * @alpha\n */\nexport interface MutuallyExclusiveScriptsConfig {\n\t/**\n\t * List of mutually exclusive script groups. Each group is an array of script names\n\t * where at most one script from the group can be present.\n\t *\n\t * Packages can have zero scripts from the group (all optional), but cannot have\n\t * multiple scripts from the same group.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Allow \"test:unit\" OR \"test:vitest\" OR neither, but not both\n\t * groups: [[\"test:unit\", \"test:vitest\"]]\n\t * ```\n\t */\n\tgroups: string[][];\n}\n\nconst POLICY_NAME = \"MutuallyExclusiveScripts\";\n\n/**\n * A policy that validates mutually exclusive script groups in package.json.\n *\n * @remarks\n * Use this policy when you want to enforce that only one script from a group\n * can exist in a package. This is useful for ensuring that packages don't have\n * conflicting scripts (e.g., both \"lint:eslint\" and \"lint:biome\").\n *\n * @example\n * ```typescript\n * import { policy } from \"repopo\";\n * import { MutuallyExclusiveScripts } from \"repopo/policies\";\n *\n * policy(MutuallyExclusiveScripts, {\n *   groups: [\n *     [\"lint:eslint\", \"lint:biome\"],\n *     [\"test:jest\", \"test:vitest\"],\n *   ],\n * })\n * ```\n *\n * @alpha\n */\nexport const MutuallyExclusiveScripts = definePackagePolicy<\n\tPackageJson,\n\tMutuallyExclusiveScriptsConfig | undefined\n>({\n\tname: POLICY_NAME,\n\tdescription:\n\t\t\"Validates that at most one script from each exclusive group exists in package.json.\",\n\thandler: async (json, { file, config }) => {\n\t\tif (config === undefined || config.groups.length === 0) {\n\t\t\treturn true;\n\t\t}\n\n\t\tconst scripts = json.scripts ?? {};\n\t\tconst errors: string[] = [];\n\n\t\tfor (const group of config.groups) {\n\t\t\tconst presentScripts = group.filter((scriptName) =>\n\t\t\t\tObject.hasOwn(scripts, scriptName),\n\t\t\t);\n\n\t\t\tif (presentScripts.length > 1) {\n\t\t\t\terrors.push(\n\t\t\t\t\t`Scripts are mutually exclusive, but found ${presentScripts.length}: ${presentScripts.join(\", \")}`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tif (errors.length === 0) {\n\t\t\treturn true;\n\t\t}\n\n\t\treturn {\n\t\t\tname: POLICY_NAME,\n\t\t\tfile,\n\t\t\tautoFixable: false,\n\t\t\terrorMessages: errors,\n\t\t};\n\t},\n});\n"]}
+{"version":3,"file":"MutuallyExclusiveScripts.js","sourceRoot":"","sources":["../../src/policies/MutuallyExclusiveScripts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAwB/E,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,mBAAmB,CAGzD;IACD,cAAc,EAAE,IAAI;IACpB,IAAI,EAAE,WAAW;IACjB,WAAW,EACV,qFAAqF;IACtF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,EAAE,CAAC;QACX,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACnC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAClD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAClC,CAAC;YAEF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CACV,6CAA6C,cAAc,CAAC,MAAM,KAAK,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClG,CAAC;YACH,CAAC;QACF,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACX,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;CACD,CAAC,CAAC","sourcesContent":["import type { PackageJson } from \"type-fest\";\nimport { definePackagePolicy } from \"../policyDefiners/definePackagePolicy.js\";\n\n/**\n * Configuration for the MutuallyExclusiveScripts policy.\n *\n * @public\n */\nexport interface MutuallyExclusiveScriptsConfig {\n\t/**\n\t * List of mutually exclusive script groups. Each group is an array of script names\n\t * where at most one script from the group can be present.\n\t *\n\t * Packages can have zero scripts from the group (all optional), but cannot have\n\t * multiple scripts from the same group.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Allow \"test:unit\" OR \"test:vitest\" OR neither, but not both\n\t * groups: [[\"test:unit\", \"test:vitest\"]]\n\t * ```\n\t */\n\tgroups: string[][];\n}\n\nconst POLICY_NAME = \"MutuallyExclusiveScripts\";\n\n/**\n * A policy that validates mutually exclusive script groups in package.json.\n *\n * @remarks\n * Use this policy when you want to enforce that only one script from a group\n * can exist in a package. This is useful for ensuring that packages don't have\n * conflicting scripts (e.g., both \"lint:eslint\" and \"lint:biome\").\n *\n * @example\n * ```typescript\n * import { makePolicy } from \"repopo\";\n * import { MutuallyExclusiveScripts } from \"repopo/policies\";\n *\n * makePolicy(MutuallyExclusiveScripts, { config: {\n *   groups: [\n *     [\"lint:eslint\", \"lint:biome\"],\n *     [\"test:jest\", \"test:vitest\"],\n *   ],\n * } })\n * ```\n *\n * @public\n */\nexport const MutuallyExclusiveScripts = definePackagePolicy<\n\tPackageJson,\n\tMutuallyExclusiveScriptsConfig | undefined\n>({\n\trequiresConfig: true,\n\tname: POLICY_NAME,\n\tdescription:\n\t\t\"Validates that at most one script from each exclusive group exists in package.json.\",\n\thandler: async (json, { config }) => {\n\t\tif (config === undefined || config.groups.length === 0) {\n\t\t\treturn [];\n\t\t}\n\n\t\tconst scripts = json.scripts ?? {};\n\t\tconst errors: string[] = [];\n\n\t\tfor (const group of config.groups) {\n\t\t\tconst presentScripts = group.filter((scriptName) =>\n\t\t\t\tObject.hasOwn(scripts, scriptName),\n\t\t\t);\n\n\t\t\tif (presentScripts.length > 1) {\n\t\t\t\terrors.push(\n\t\t\t\t\t`Scripts are mutually exclusive, but found ${presentScripts.length}: ${presentScripts.join(\", \")}`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tif (errors.length === 0) {\n\t\t\treturn [];\n\t\t}\n\t\treturn errors.map((message) => ({ message }));\n\t},\n});\n"]}

package/esm/policies/NoBuildDirectory.d.ts

@@ -0,0 +1,15 @@
+import type { Operation } from "effection";
+import type { PolicyFinding } from "../policy.js";
+/**
+ * A policy that prevents accidental commits of build directory contents.
+ * Applies to Gleam's `build/` output directory.
+ *
+ * @public
+ */
+export declare const NoBuildDirectory: {
+    name: string;
+    description: string;
+    match: RegExp;
+    handler: ({ file }: import("../policy.js").PolicyArgs<void>) => Operation<PolicyFinding[]>;
+};
+//# sourceMappingURL=NoBuildDirectory.d.ts.map

package/esm/policies/NoBuildDirectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoBuildDirectory.d.ts","sourceRoot":"","sources":["../../src/policies/NoBuildDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAwB,aAAa,EAAE,MAAM,cAAc,CAAC;AAOxE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;oEAKG,SAAS,CAAC,aAAa,EAAE,CAAC;CAS1B,CAAC"}