repopo 0.9.0 → 0.12.0

package/esm/policies/GleamMonorepoConsistency.js

@@ -0,0 +1,74 @@
+import { readFile } from "node:fs/promises";
+import path from "pathe";
+import { makePolicyDefinition } from "../makePolicy.js";
+import { parseToml } from "../policyDefiners/tomlParser.js";
+const DEFAULT_SYNC_FIELDS = ["licences"];
+async function loadGleamToml(filePath) {
+    try {
+        const content = await readFile(filePath, "utf-8");
+        return await parseToml(content);
+    }
+    catch {
+        return undefined;
+    }
+}
+function checkFieldConsistency(packages, field) {
+    const values = new Map();
+    for (const [pkg, toml] of packages) {
+        const value = JSON.stringify(toml[field] ?? null);
+        if (!values.has(value)) {
+            values.set(value, []);
+        }
+        values.get(value)?.push(pkg);
+    }
+    if (values.size <= 1) {
+        return [];
+    }
+    const details = [...values.entries()]
+        .map(([val, pkgs]) => `${val} in ${pkgs.join(", ")}`)
+        .join("; ");
+    return [`Inconsistent "${field}" across packages: ${details}`];
+}
+/**
+ * A policy that enforces consistent metadata across Gleam packages in a monorepo.
+ *
+ * @alpha
+ */
+export const GleamMonorepoConsistency = makePolicyDefinition({
+    name: "GleamMonorepoConsistency",
+    description: "Enforces consistent metadata (licences, gleam version, etc.) across Gleam packages in a monorepo.",
+    match: /^gleam\.toml$/,
+    handler: async ({ root, config }) => {
+        const packagePaths = config?.packages;
+        if (!packagePaths || packagePaths.length < 2) {
+            return true;
+        }
+        const syncFields = config?.syncFields ?? DEFAULT_SYNC_FIELDS;
+        const syncGleamVersion = config?.syncGleamVersion ?? true;
+        const packages = new Map();
+        for (const pkgPath of packagePaths) {
+            const toml = await loadGleamToml(path.resolve(root, pkgPath));
+            if (toml) {
+                packages.set(pkgPath, toml);
+            }
+        }
+        if (packages.size < 2) {
+            return true;
+        }
+        const errors = [];
+        for (const field of syncFields) {
+            errors.push(...checkFieldConsistency(packages, field));
+        }
+        if (syncGleamVersion) {
+            errors.push(...checkFieldConsistency(packages, "gleam"));
+        }
+        if (errors.length > 0) {
+            return {
+                error: errors.join("; "),
+                manualFix: "Ensure all Gleam packages in the monorepo use consistent metadata values.",
+            };
+        }
+        return true;
+    },
+});
+//# sourceMappingURL=GleamMonorepoConsistency.js.map

package/esm/policies/GleamMonorepoConsistency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamMonorepoConsistency.js","sourceRoot":"","sources":["../../src/policies/GleamMonorepoConsistency.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport path from \"pathe\";\nimport { makePolicyDefinition } from \"../makePolicy.js\";\nimport type { PolicyDefinition } from \"../policy.js\";\nimport { parseToml } from \"../policyDefiners/tomlParser.js\";\n\n/**\n * Configuration for the GleamMonorepoConsistency policy.\n *\n * @alpha\n */\nexport interface GleamMonorepoConsistencyConfig {\n\t/**\n\t * Top-level fields that should be consistent across all packages.\n\t * @defaultValue [\"licences\"]\n\t */\n\tsyncFields?: string[];\n\n\t/**\n\t * If true, ensure the `gleam` version constraint is consistent.\n\t * @defaultValue true\n\t */\n\tsyncGleamVersion?: boolean;\n\n\t/**\n\t * Paths to gleam.toml files to compare (relative to repo root).\n\t * If not specified, the policy only checks the file it matches against.\n\t */\n\tpackages?: string[];\n}\n\nconst DEFAULT_SYNC_FIELDS = [\"licences\"];\n\nasync function loadGleamToml(\n\tfilePath: string,\n): Promise<Record<string, unknown> | undefined> {\n\ttry {\n\t\tconst content = await readFile(filePath, \"utf-8\");\n\t\treturn await parseToml(content);\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction checkFieldConsistency(\n\tpackages: Map<string, Record<string, unknown>>,\n\tfield: string,\n): string[] {\n\tconst values = new Map<string, string[]>();\n\n\tfor (const [pkg, toml] of packages) {\n\t\tconst value = JSON.stringify(toml[field] ?? null);\n\t\tif (!values.has(value)) {\n\t\t\tvalues.set(value, []);\n\t\t}\n\t\tvalues.get(value)?.push(pkg);\n\t}\n\n\tif (values.size <= 1) {\n\t\treturn [];\n\t}\n\n\tconst details = [...values.entries()]\n\t\t.map(([val, pkgs]) => `${val} in ${pkgs.join(\", \")}`)\n\t\t.join(\"; \");\n\treturn [`Inconsistent \"${field}\" across packages: ${details}`];\n}\n\n/**\n * A policy that enforces consistent metadata across Gleam packages in a monorepo.\n *\n * @alpha\n */\nexport const GleamMonorepoConsistency: PolicyDefinition<GleamMonorepoConsistencyConfig> =\n\tmakePolicyDefinition({\n\t\tname: \"GleamMonorepoConsistency\",\n\t\tdescription:\n\t\t\t\"Enforces consistent metadata (licences, gleam version, etc.) across Gleam packages in a monorepo.\",\n\t\tmatch: /^gleam\\.toml$/,\n\t\thandler: async ({ root, config }) => {\n\t\t\tconst packagePaths = config?.packages;\n\t\t\tif (!packagePaths || packagePaths.length < 2) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst syncFields = config?.syncFields ?? DEFAULT_SYNC_FIELDS;\n\t\t\tconst syncGleamVersion = config?.syncGleamVersion ?? true;\n\n\t\t\tconst packages = new Map<string, Record<string, unknown>>();\n\t\t\tfor (const pkgPath of packagePaths) {\n\t\t\t\tconst toml = await loadGleamToml(path.resolve(root, pkgPath));\n\t\t\t\tif (toml) {\n\t\t\t\t\tpackages.set(pkgPath, toml);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (packages.size < 2) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst errors: string[] = [];\n\n\t\t\tfor (const field of syncFields) {\n\t\t\t\terrors.push(...checkFieldConsistency(packages, field));\n\t\t\t}\n\n\t\t\tif (syncGleamVersion) {\n\t\t\t\terrors.push(...checkFieldConsistency(packages, \"gleam\"));\n\t\t\t}\n\n\t\t\tif (errors.length > 0) {\n\t\t\t\treturn {\n\t\t\t\t\terror: errors.join(\"; \"),\n\t\t\t\t\tmanualFix:\n\t\t\t\t\t\t\"Ensure all Gleam packages in the monorepo use consistent metadata values.\",\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn true;\n\t\t},\n\t});\n"]}

package/esm/policies/GleamNameRestrictions.d.ts

@@ -0,0 +1,25 @@
+import type { PolicyShape } from "../policy.js";
+/**
+ * Configuration for the GleamNameRestrictions policy.
+ *
+ * @alpha
+ */
+export interface GleamNameRestrictionsConfig {
+    /**
+     * Prefixes that are denied for package names.
+     * @defaultValue ["gleam_"]
+     */
+    denyPrefixes?: string[];
+    /**
+     * If true, require snake_case naming.
+     * @defaultValue true
+     */
+    requireSnakeCase?: boolean;
+}
+/**
+ * A policy that enforces naming conventions for Gleam packages.
+ *
+ * @alpha
+ */
+export declare const GleamNameRestrictions: PolicyShape<GleamNameRestrictionsConfig>;
+//# sourceMappingURL=GleamNameRestrictions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamNameRestrictions.d.ts","sourceRoot":"","sources":["../../src/policies/GleamNameRestrictions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAiBD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,2BAA2B,CAoCxE,CAAC"}

package/esm/policies/GleamNameRestrictions.js

@@ -0,0 +1,44 @@
+import { defineGleamPolicy, } from "../policyDefiners/defineGleamPolicy.js";
+const DEFAULT_DENY_PREFIXES = ["gleam_"];
+const SNAKE_CASE_REGEX = /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/;
+function checkDeniedPrefixes(name, prefixes) {
+    for (const prefix of prefixes) {
+        if (name.startsWith(prefix)) {
+            return `Package name "${name}" uses reserved prefix "${prefix}". The "gleam_" prefix is reserved for official Gleam packages.`;
+        }
+    }
+    return undefined;
+}
+/**
+ * A policy that enforces naming conventions for Gleam packages.
+ *
+ * @alpha
+ */
+export const GleamNameRestrictions = defineGleamPolicy({
+    name: "GleamNameRestrictions",
+    description: 'Enforces Gleam package naming conventions: no "gleam_" prefix, snake_case required.',
+    handler: async (toml, { config }) => {
+        const name = toml.name;
+        if (!name) {
+            return true;
+        }
+        const errors = [];
+        const denyPrefixes = config?.denyPrefixes ?? DEFAULT_DENY_PREFIXES;
+        const requireSnakeCase = config?.requireSnakeCase ?? true;
+        const prefixError = checkDeniedPrefixes(name, denyPrefixes);
+        if (prefixError) {
+            errors.push(prefixError);
+        }
+        if (requireSnakeCase && !SNAKE_CASE_REGEX.test(name)) {
+            errors.push(`Package name "${name}" is not snake_case. Gleam package names should use lowercase letters, digits, and underscores.`);
+        }
+        if (errors.length > 0) {
+            return {
+                error: errors.join("; "),
+                manualFix: "Rename the package to follow Gleam naming conventions (snake_case, no gleam_ prefix).",
+            };
+        }
+        return true;
+    },
+});
+//# sourceMappingURL=GleamNameRestrictions.js.map

package/esm/policies/GleamNameRestrictions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamNameRestrictions.js","sourceRoot":"","sources":["../../src/policies/GleamNameRestrictions.ts"],"names":[],"mappings":"AACA,OAAO,EACN,iBAAiB,GAEjB,MAAM,wCAAwC,CAAC;AAqBhD,MAAM,qBAAqB,GAAG,CAAC,QAAQ,CAAC,CAAC;AACzC,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAEzD,SAAS,mBAAmB,CAC3B,IAAY,EACZ,QAAkB;IAElB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,iBAAiB,IAAI,2BAA2B,MAAM,iEAAiE,CAAC;QAChI,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GACjC,iBAAiB,CAAC;IACjB,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACV,qFAAqF;IACtF,OAAO,EAAE,KAAK,EAAE,IAAe,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAA0B,CAAC;QAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,MAAM,EAAE,YAAY,IAAI,qBAAqB,CAAC;QACnE,MAAM,gBAAgB,GAAG,MAAM,EAAE,gBAAgB,IAAI,IAAI,CAAC;QAE1D,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC5D,IAAI,WAAW,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,gBAAgB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,CAAC,IAAI,CACV,iBAAiB,IAAI,iGAAiG,CACtH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO;gBACN,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxB,SAAS,EACR,uFAAuF;aACxF,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;CACD,CAAC,CAAC","sourcesContent":["import type { PolicyShape } from \"../policy.js\";\nimport {\n\tdefineGleamPolicy,\n\ttype GleamToml,\n} from \"../policyDefiners/defineGleamPolicy.js\";\n\n/**\n * Configuration for the GleamNameRestrictions policy.\n *\n * @alpha\n */\nexport interface GleamNameRestrictionsConfig {\n\t/**\n\t * Prefixes that are denied for package names.\n\t * @defaultValue [\"gleam_\"]\n\t */\n\tdenyPrefixes?: string[];\n\n\t/**\n\t * If true, require snake_case naming.\n\t * @defaultValue true\n\t */\n\trequireSnakeCase?: boolean;\n}\n\nconst DEFAULT_DENY_PREFIXES = [\"gleam_\"];\nconst SNAKE_CASE_REGEX = /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/;\n\nfunction checkDeniedPrefixes(\n\tname: string,\n\tprefixes: string[],\n): string | undefined {\n\tfor (const prefix of prefixes) {\n\t\tif (name.startsWith(prefix)) {\n\t\t\treturn `Package name \"${name}\" uses reserved prefix \"${prefix}\". The \"gleam_\" prefix is reserved for official Gleam packages.`;\n\t\t}\n\t}\n\treturn undefined;\n}\n\n/**\n * A policy that enforces naming conventions for Gleam packages.\n *\n * @alpha\n */\nexport const GleamNameRestrictions: PolicyShape<GleamNameRestrictionsConfig> =\n\tdefineGleamPolicy({\n\t\tname: \"GleamNameRestrictions\",\n\t\tdescription:\n\t\t\t'Enforces Gleam package naming conventions: no \"gleam_\" prefix, snake_case required.',\n\t\thandler: async (toml: GleamToml, { config }) => {\n\t\t\tconst name = toml.name as string | undefined;\n\t\t\tif (!name) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst errors: string[] = [];\n\t\t\tconst denyPrefixes = config?.denyPrefixes ?? DEFAULT_DENY_PREFIXES;\n\t\t\tconst requireSnakeCase = config?.requireSnakeCase ?? true;\n\n\t\t\tconst prefixError = checkDeniedPrefixes(name, denyPrefixes);\n\t\t\tif (prefixError) {\n\t\t\t\terrors.push(prefixError);\n\t\t\t}\n\n\t\t\tif (requireSnakeCase && !SNAKE_CASE_REGEX.test(name)) {\n\t\t\t\terrors.push(\n\t\t\t\t\t`Package name \"${name}\" is not snake_case. Gleam package names should use lowercase letters, digits, and underscores.`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (errors.length > 0) {\n\t\t\t\treturn {\n\t\t\t\t\terror: errors.join(\"; \"),\n\t\t\t\t\tmanualFix:\n\t\t\t\t\t\t\"Rename the package to follow Gleam naming conventions (snake_case, no gleam_ prefix).\",\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn true;\n\t\t},\n\t});\n"]}

package/esm/policies/GleamNoPathDepsInPublished.d.ts

@@ -0,0 +1,22 @@
+import type { PolicyShape } from "../policy.js";
+/**
+ * Configuration for the GleamNoPathDepsInPublished policy.
+ *
+ * @alpha
+ */
+export interface GleamNoPathDepsInPublishedConfig {
+    /**
+     * If true, only check packages that don't have a "private" marker.
+     * Since Gleam doesn't have a native "private" field, this checks for
+     * the absence of a description (unpublished packages often lack one).
+     * @defaultValue false
+     */
+    onlyPublishable?: boolean;
+}
+/**
+ * A policy that warns when path dependencies are used in packages intended for publishing.
+ *
+ * @alpha
+ */
+export declare const GleamNoPathDepsInPublished: PolicyShape<GleamNoPathDepsInPublishedConfig>;
+//# sourceMappingURL=GleamNoPathDepsInPublished.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamNoPathDepsInPublished.d.ts","sourceRoot":"","sources":["../../src/policies/GleamNoPathDepsInPublished.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAChD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAeD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,gCAAgC,CAgClF,CAAC"}

package/esm/policies/GleamNoPathDepsInPublished.js

@@ -0,0 +1,43 @@
+import { defineGleamPolicy, } from "../policyDefiners/defineGleamPolicy.js";
+function findPathDeps(deps) {
+    const pathDeps = [];
+    for (const [name, value] of Object.entries(deps)) {
+        if (typeof value === "object" && value !== null) {
+            const record = value;
+            if (typeof record.path === "string") {
+                pathDeps.push(name);
+            }
+        }
+    }
+    return pathDeps;
+}
+/**
+ * A policy that warns when path dependencies are used in packages intended for publishing.
+ *
+ * @alpha
+ */
+export const GleamNoPathDepsInPublished = defineGleamPolicy({
+    name: "GleamNoPathDepsInPublished",
+    description: "Warns when path dependencies are used in packages intended for publishing to Hex.",
+    handler: async (toml, { config }) => {
+        if (config?.onlyPublishable && !toml.description) {
+            return true;
+        }
+        const errors = [];
+        const deps = toml.dependencies;
+        if (deps) {
+            const pathDeps = findPathDeps(deps);
+            for (const dep of pathDeps) {
+                errors.push(`[dependencies] "${dep}" uses a path dependency, which will break when published to Hex`);
+            }
+        }
+        if (errors.length > 0) {
+            return {
+                error: errors.join("; "),
+                manualFix: "Replace path dependencies with version constraints before publishing.",
+            };
+        }
+        return true;
+    },
+});
+//# sourceMappingURL=GleamNoPathDepsInPublished.js.map

package/esm/policies/GleamNoPathDepsInPublished.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamNoPathDepsInPublished.js","sourceRoot":"","sources":["../../src/policies/GleamNoPathDepsInPublished.ts"],"names":[],"mappings":"AACA,OAAO,EACN,iBAAiB,GAEjB,MAAM,wCAAwC,CAAC;AAiBhD,SAAS,YAAY,CAAC,IAA6B;IAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GACtC,iBAAiB,CAAC;IACjB,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACV,mFAAmF;IACpF,OAAO,EAAE,KAAK,EAAE,IAAe,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9C,IAAI,MAAM,EAAE,eAAe,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,MAAM,IAAI,GAAG,IAAI,CAAC,YAAmD,CAAC;QACtE,IAAI,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACpC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CACV,mBAAmB,GAAG,kEAAkE,CACxF,CAAC;YACH,CAAC;QACF,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO;gBACN,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxB,SAAS,EACR,uEAAuE;aACxE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;CACD,CAAC,CAAC","sourcesContent":["import type { PolicyShape } from \"../policy.js\";\nimport {\n\tdefineGleamPolicy,\n\ttype GleamToml,\n} from \"../policyDefiners/defineGleamPolicy.js\";\n\n/**\n * Configuration for the GleamNoPathDepsInPublished policy.\n *\n * @alpha\n */\nexport interface GleamNoPathDepsInPublishedConfig {\n\t/**\n\t * If true, only check packages that don't have a \"private\" marker.\n\t * Since Gleam doesn't have a native \"private\" field, this checks for\n\t * the absence of a description (unpublished packages often lack one).\n\t * @defaultValue false\n\t */\n\tonlyPublishable?: boolean;\n}\n\nfunction findPathDeps(deps: Record<string, unknown>): string[] {\n\tconst pathDeps: string[] = [];\n\tfor (const [name, value] of Object.entries(deps)) {\n\t\tif (typeof value === \"object\" && value !== null) {\n\t\t\tconst record = value as Record<string, unknown>;\n\t\t\tif (typeof record.path === \"string\") {\n\t\t\t\tpathDeps.push(name);\n\t\t\t}\n\t\t}\n\t}\n\treturn pathDeps;\n}\n\n/**\n * A policy that warns when path dependencies are used in packages intended for publishing.\n *\n * @alpha\n */\nexport const GleamNoPathDepsInPublished: PolicyShape<GleamNoPathDepsInPublishedConfig> =\n\tdefineGleamPolicy({\n\t\tname: \"GleamNoPathDepsInPublished\",\n\t\tdescription:\n\t\t\t\"Warns when path dependencies are used in packages intended for publishing to Hex.\",\n\t\thandler: async (toml: GleamToml, { config }) => {\n\t\t\tif (config?.onlyPublishable && !toml.description) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst errors: string[] = [];\n\n\t\t\tconst deps = toml.dependencies as Record<string, unknown> | undefined;\n\t\t\tif (deps) {\n\t\t\t\tconst pathDeps = findPathDeps(deps);\n\t\t\t\tfor (const dep of pathDeps) {\n\t\t\t\t\terrors.push(\n\t\t\t\t\t\t`[dependencies] \"${dep}\" uses a path dependency, which will break when published to Hex`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (errors.length > 0) {\n\t\t\t\treturn {\n\t\t\t\t\terror: errors.join(\"; \"),\n\t\t\t\t\tmanualFix:\n\t\t\t\t\t\t\"Replace path dependencies with version constraints before publishing.\",\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn true;\n\t\t},\n\t});\n"]}

package/esm/policies/GleamPathDepsValid.d.ts

@@ -0,0 +1,9 @@
+import type { PolicyShape } from "../policy.js";
+/**
+ * A policy that validates all path dependency targets in gleam.toml exist
+ * and contain a gleam.toml file.
+ *
+ * @alpha
+ */
+export declare const GleamPathDepsValid: PolicyShape;
+//# sourceMappingURL=GleamPathDepsValid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamPathDepsValid.d.ts","sourceRoot":"","sources":["../../src/policies/GleamPathDepsValid.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAkDhD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAqB/B,CAAC"}

package/esm/policies/GleamPathDepsValid.js

@@ -0,0 +1,59 @@
+import { existsSync } from "node:fs";
+import path from "pathe";
+import { defineGleamPolicy, } from "../policyDefiners/defineGleamPolicy.js";
+function validatePathDep(depName, depValue, sectionName, baseDir) {
+    if (typeof depValue !== "object" || depValue === null) {
+        return undefined;
+    }
+    const record = depValue;
+    if (typeof record.path !== "string") {
+        return undefined;
+    }
+    const depDir = path.resolve(baseDir, record.path);
+    if (!existsSync(depDir)) {
+        return `[${sectionName}] "${depName}" path "${record.path}" does not exist`;
+    }
+    if (!existsSync(path.join(depDir, "gleam.toml"))) {
+        return `[${sectionName}] "${depName}" path "${record.path}" exists but has no gleam.toml`;
+    }
+    return undefined;
+}
+function checkSection(sectionName, data, baseDir) {
+    if (!data || typeof data !== "object") {
+        return [];
+    }
+    const deps = data;
+    const errors = [];
+    for (const [depName, depValue] of Object.entries(deps)) {
+        const error = validatePathDep(depName, depValue, sectionName, baseDir);
+        if (error) {
+            errors.push(error);
+        }
+    }
+    return errors;
+}
+/**
+ * A policy that validates all path dependency targets in gleam.toml exist
+ * and contain a gleam.toml file.
+ *
+ * @alpha
+ */
+export const GleamPathDepsValid = defineGleamPolicy({
+    name: "GleamPathDepsValid",
+    description: "Validates that all path dependency targets exist and contain a gleam.toml file.",
+    handler: async (toml, { file, root }) => {
+        const baseDir = path.resolve(root, path.dirname(file));
+        const errors = [
+            ...checkSection("dependencies", toml.dependencies, baseDir),
+            ...checkSection("dev-dependencies", toml["dev-dependencies"], baseDir),
+        ];
+        if (errors.length > 0) {
+            return {
+                error: errors.join("; "),
+                manualFix: "Fix the path dependencies to point to valid Gleam project directories.",
+            };
+        }
+        return true;
+    },
+});
+//# sourceMappingURL=GleamPathDepsValid.js.map

package/esm/policies/GleamPathDepsValid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamPathDepsValid.js","sourceRoot":"","sources":["../../src/policies/GleamPathDepsValid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,OAAO,CAAC;AAEzB,OAAO,EACN,iBAAiB,GAEjB,MAAM,wCAAwC,CAAC;AAEhD,SAAS,eAAe,CACvB,OAAe,EACf,QAAiB,EACjB,WAAmB,EACnB,OAAe;IAEf,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACvD,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,QAAmC,CAAC;IACnD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAElD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,WAAW,MAAM,OAAO,WAAW,MAAM,CAAC,IAAI,kBAAkB,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO,IAAI,WAAW,MAAM,OAAO,WAAW,MAAM,CAAC,IAAI,gCAAgC,CAAC;IAC3F,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CACpB,WAAmB,EACnB,IAAa,EACb,OAAe;IAEf,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,EAAE,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,IAA+B,CAAC;IAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACvE,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgB,iBAAiB,CAAC;IAChE,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACV,iFAAiF;IAClF,OAAO,EAAE,KAAK,EAAE,IAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,MAAM,MAAM,GAAa;YACxB,GAAG,YAAY,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;YAC3D,GAAG,YAAY,CAAC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;SACtE,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO;gBACN,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxB,SAAS,EACR,wEAAwE;aACzE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;CACD,CAAC,CAAC","sourcesContent":["import { existsSync } from \"node:fs\";\nimport path from \"pathe\";\nimport type { PolicyShape } from \"../policy.js\";\nimport {\n\tdefineGleamPolicy,\n\ttype GleamToml,\n} from \"../policyDefiners/defineGleamPolicy.js\";\n\nfunction validatePathDep(\n\tdepName: string,\n\tdepValue: unknown,\n\tsectionName: string,\n\tbaseDir: string,\n): string | undefined {\n\tif (typeof depValue !== \"object\" || depValue === null) {\n\t\treturn undefined;\n\t}\n\tconst record = depValue as Record<string, unknown>;\n\tif (typeof record.path !== \"string\") {\n\t\treturn undefined;\n\t}\n\n\tconst depDir = path.resolve(baseDir, record.path);\n\n\tif (!existsSync(depDir)) {\n\t\treturn `[${sectionName}] \"${depName}\" path \"${record.path}\" does not exist`;\n\t}\n\tif (!existsSync(path.join(depDir, \"gleam.toml\"))) {\n\t\treturn `[${sectionName}] \"${depName}\" path \"${record.path}\" exists but has no gleam.toml`;\n\t}\n\treturn undefined;\n}\n\nfunction checkSection(\n\tsectionName: string,\n\tdata: unknown,\n\tbaseDir: string,\n): string[] {\n\tif (!data || typeof data !== \"object\") {\n\t\treturn [];\n\t}\n\tconst deps = data as Record<string, unknown>;\n\tconst errors: string[] = [];\n\tfor (const [depName, depValue] of Object.entries(deps)) {\n\t\tconst error = validatePathDep(depName, depValue, sectionName, baseDir);\n\t\tif (error) {\n\t\t\terrors.push(error);\n\t\t}\n\t}\n\treturn errors;\n}\n\n/**\n * A policy that validates all path dependency targets in gleam.toml exist\n * and contain a gleam.toml file.\n *\n * @alpha\n */\nexport const GleamPathDepsValid: PolicyShape = defineGleamPolicy({\n\tname: \"GleamPathDepsValid\",\n\tdescription:\n\t\t\"Validates that all path dependency targets exist and contain a gleam.toml file.\",\n\thandler: async (toml: GleamToml, { file, root }) => {\n\t\tconst baseDir = path.resolve(root, path.dirname(file));\n\t\tconst errors: string[] = [\n\t\t\t...checkSection(\"dependencies\", toml.dependencies, baseDir),\n\t\t\t...checkSection(\"dev-dependencies\", toml[\"dev-dependencies\"], baseDir),\n\t\t];\n\n\t\tif (errors.length > 0) {\n\t\t\treturn {\n\t\t\t\terror: errors.join(\"; \"),\n\t\t\t\tmanualFix:\n\t\t\t\t\t\"Fix the path dependencies to point to valid Gleam project directories.\",\n\t\t\t};\n\t\t}\n\n\t\treturn true;\n\t},\n});\n"]}

package/esm/policies/GleamProjectStructure.d.ts

@@ -0,0 +1,25 @@
+import type { PolicyDefinition } from "../policy.js";
+/**
+ * Configuration for the GleamProjectStructure policy.
+ *
+ * @alpha
+ */
+export interface GleamProjectStructureConfig {
+    /**
+     * If true, require the src/ directory to exist.
+     * @defaultValue true
+     */
+    requireSrcDir?: boolean;
+    /**
+     * If true, require the test/ directory to exist.
+     * @defaultValue false
+     */
+    requireTestDir?: boolean;
+}
+/**
+ * A policy that validates standard Gleam project structure.
+ *
+ * @alpha
+ */
+export declare const GleamProjectStructure: PolicyDefinition<GleamProjectStructureConfig>;
+//# sourceMappingURL=GleamProjectStructure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamProjectStructure.d.ts","sourceRoot":"","sources":["../../src/policies/GleamProjectStructure.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBAAgB,CAAC,2BAA2B,CA+B7E,CAAC"}

package/esm/policies/GleamProjectStructure.js

@@ -0,0 +1,33 @@
+import { existsSync } from "node:fs";
+import path from "pathe";
+import { makePolicyDefinition } from "../makePolicy.js";
+/**
+ * A policy that validates standard Gleam project structure.
+ *
+ * @alpha
+ */
+export const GleamProjectStructure = makePolicyDefinition({
+    name: "GleamProjectStructure",
+    description: "Validates that Gleam projects have the standard directory structure (src/, test/).",
+    match: /gleam\.toml$/,
+    handler: async ({ file, root, config }) => {
+        const dir = path.dirname(path.resolve(root, file));
+        const requireSrc = config?.requireSrcDir ?? true;
+        const requireTest = config?.requireTestDir ?? false;
+        const errors = [];
+        if (requireSrc && !existsSync(path.join(dir, "src"))) {
+            errors.push("Missing src/ directory. Gleam projects require a src/ directory for source modules.");
+        }
+        if (requireTest && !existsSync(path.join(dir, "test"))) {
+            errors.push("Missing test/ directory.");
+        }
+        if (errors.length > 0) {
+            return {
+                error: errors.join("; "),
+                manualFix: "Create the missing directories in your Gleam project.",
+            };
+        }
+        return true;
+    },
+});
+//# sourceMappingURL=GleamProjectStructure.js.map

package/esm/policies/GleamProjectStructure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamProjectStructure.js","sourceRoot":"","sources":["../../src/policies/GleamProjectStructure.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;AAsBxD;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GACjC,oBAAoB,CAAC;IACpB,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACV,oFAAoF;IACrF,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,MAAM,EAAE,aAAa,IAAI,IAAI,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,EAAE,cAAc,IAAI,KAAK,CAAC;QACpD,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YACtD,MAAM,CAAC,IAAI,CACV,qFAAqF,CACrF,CAAC;QACH,CAAC;QAED,IAAI,WAAW,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO;gBACN,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;gBACxB,SAAS,EAAE,uDAAuD;aAClE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;CACD,CAAC,CAAC","sourcesContent":["import { existsSync } from \"node:fs\";\nimport path from \"pathe\";\nimport { makePolicyDefinition } from \"../makePolicy.js\";\nimport type { PolicyDefinition } from \"../policy.js\";\n\n/**\n * Configuration for the GleamProjectStructure policy.\n *\n * @alpha\n */\nexport interface GleamProjectStructureConfig {\n\t/**\n\t * If true, require the src/ directory to exist.\n\t * @defaultValue true\n\t */\n\trequireSrcDir?: boolean;\n\n\t/**\n\t * If true, require the test/ directory to exist.\n\t * @defaultValue false\n\t */\n\trequireTestDir?: boolean;\n}\n\n/**\n * A policy that validates standard Gleam project structure.\n *\n * @alpha\n */\nexport const GleamProjectStructure: PolicyDefinition<GleamProjectStructureConfig> =\n\tmakePolicyDefinition({\n\t\tname: \"GleamProjectStructure\",\n\t\tdescription:\n\t\t\t\"Validates that Gleam projects have the standard directory structure (src/, test/).\",\n\t\tmatch: /gleam\\.toml$/,\n\t\thandler: async ({ file, root, config }) => {\n\t\t\tconst dir = path.dirname(path.resolve(root, file));\n\t\t\tconst requireSrc = config?.requireSrcDir ?? true;\n\t\t\tconst requireTest = config?.requireTestDir ?? false;\n\t\t\tconst errors: string[] = [];\n\n\t\t\tif (requireSrc && !existsSync(path.join(dir, \"src\"))) {\n\t\t\t\terrors.push(\n\t\t\t\t\t\"Missing src/ directory. Gleam projects require a src/ directory for source modules.\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (requireTest && !existsSync(path.join(dir, \"test\"))) {\n\t\t\t\terrors.push(\"Missing test/ directory.\");\n\t\t\t}\n\n\t\t\tif (errors.length > 0) {\n\t\t\t\treturn {\n\t\t\t\t\terror: errors.join(\"; \"),\n\t\t\t\t\tmanualFix: \"Create the missing directories in your Gleam project.\",\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn true;\n\t\t},\n\t});\n"]}

package/esm/policies/GleamSharedDependencyVersions.d.ts

@@ -0,0 +1,29 @@
+import type { PolicyDefinition } from "../policy.js";
+/**
+ * Configuration for the GleamSharedDependencyVersions policy.
+ *
+ * @alpha
+ */
+export interface GleamSharedDependencyVersionsConfig {
+    /**
+     * If true, detect version mismatches across packages.
+     * @defaultValue true
+     */
+    detectMismatches?: boolean;
+    /**
+     * If true, also check dev-dependencies for mismatches.
+     * @defaultValue false
+     */
+    includeDev?: boolean;
+    /**
+     * Paths to gleam.toml files to compare (relative to repo root).
+     */
+    packages?: string[];
+}
+/**
+ * A policy that detects dependency version mismatches across Gleam packages in a monorepo.
+ *
+ * @alpha
+ */
+export declare const GleamSharedDependencyVersions: PolicyDefinition<GleamSharedDependencyVersionsConfig>;
+//# sourceMappingURL=GleamSharedDependencyVersions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamSharedDependencyVersions.d.ts","sourceRoot":"","sources":["../../src/policies/GleamSharedDependencyVersions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD;;;;GAIG;AACH,MAAM,WAAW,mCAAmC;IACnD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AA2DD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,CAAC,mCAAmC,CAsD7F,CAAC"}

package/esm/policies/GleamSharedDependencyVersions.js

@@ -0,0 +1,101 @@
+import { readFile } from "node:fs/promises";
+import path from "pathe";
+import { makePolicyDefinition } from "../makePolicy.js";
+import { parseToml } from "../policyDefiners/tomlParser.js";
+function extractVersion(dep) {
+    if (typeof dep === "string") {
+        return dep;
+    }
+    if (typeof dep === "object" && dep !== null) {
+        const record = dep;
+        if (typeof record.version === "string") {
+            return record.version;
+        }
+    }
+    return undefined;
+}
+function collectDeps(toml, includeDev) {
+    const deps = new Map();
+    const sections = ["dependencies"];
+    if (includeDev) {
+        sections.push("dev-dependencies");
+    }
+    for (const section of sections) {
+        const sectionDeps = toml[section];
+        if (!sectionDeps) {
+            continue;
+        }
+        for (const [name, value] of Object.entries(sectionDeps)) {
+            const version = extractVersion(value);
+            if (version) {
+                deps.set(name, version);
+            }
+        }
+    }
+    return deps;
+}
+function recordDependency(allDeps, depName, version, pkgPath) {
+    if (!allDeps.has(depName)) {
+        allDeps.set(depName, new Map());
+    }
+    const versionMap = allDeps.get(depName);
+    if (versionMap === undefined) {
+        return;
+    }
+    if (!versionMap.has(version)) {
+        versionMap.set(version, []);
+    }
+    versionMap.get(version)?.push(pkgPath);
+}
+/**
+ * A policy that detects dependency version mismatches across Gleam packages in a monorepo.
+ *
+ * @alpha
+ */
+export const GleamSharedDependencyVersions = makePolicyDefinition({
+    name: "GleamSharedDependencyVersions",
+    description: "Detects dependency version mismatches across Gleam packages in a monorepo.",
+    match: /^gleam\.toml$/,
+    handler: async ({ root, config }) => {
+        const packagePaths = config?.packages;
+        if (!packagePaths || packagePaths.length < 2) {
+            return true;
+        }
+        const detectMismatches = config?.detectMismatches ?? true;
+        if (!detectMismatches) {
+            return true;
+        }
+        const includeDev = config?.includeDev ?? false;
+        const allDeps = new Map();
+        for (const pkgPath of packagePaths) {
+            try {
+                const content = await readFile(path.resolve(root, pkgPath), "utf-8");
+                const toml = await parseToml(content);
+                const deps = collectDeps(toml, includeDev);
+                for (const [name, version] of deps) {
+                    recordDependency(allDeps, name, version, pkgPath);
+                }
+            }
+            catch {
+                // Package might not exist
+            }
+        }
+        const errors = [];
+        for (const [dep, versionMap] of allDeps) {
+            if (versionMap.size > 1) {
+                const details = [...versionMap.entries()]
+                    .map(([ver, pkgs]) => `"${ver}" in ${pkgs.join(", ")}`)
+                    .join("; ");
+                errors.push(`Version mismatch for "${dep}": ${details}`);
+            }
+        }
+        if (errors.length > 0) {
+            return {
+                error: errors.join("; "),
+                manualFix: "Align dependency versions across all Gleam packages in the monorepo.",
+            };
+        }
+        return true;
+    },
+});
+//# sourceMappingURL=GleamSharedDependencyVersions.js.map

package/esm/policies/GleamSharedDependencyVersions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamSharedDependencyVersions.js","sourceRoot":"","sources":["../../src/policies/GleamSharedDependencyVersions.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport path from \"pathe\";\nimport { makePolicyDefinition } from \"../makePolicy.js\";\nimport type { PolicyDefinition } from \"../policy.js\";\nimport { parseToml } from \"../policyDefiners/tomlParser.js\";\n\n/**\n * Configuration for the GleamSharedDependencyVersions policy.\n *\n * @alpha\n */\nexport interface GleamSharedDependencyVersionsConfig {\n\t/**\n\t * If true, detect version mismatches across packages.\n\t * @defaultValue true\n\t */\n\tdetectMismatches?: boolean;\n\n\t/**\n\t * If true, also check dev-dependencies for mismatches.\n\t * @defaultValue false\n\t */\n\tincludeDev?: boolean;\n\n\t/**\n\t * Paths to gleam.toml files to compare (relative to repo root).\n\t */\n\tpackages?: string[];\n}\n\nfunction extractVersion(dep: unknown): string | undefined {\n\tif (typeof dep === \"string\") {\n\t\treturn dep;\n\t}\n\tif (typeof dep === \"object\" && dep !== null) {\n\t\tconst record = dep as Record<string, unknown>;\n\t\tif (typeof record.version === \"string\") {\n\t\t\treturn record.version;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction collectDeps(\n\ttoml: Record<string, unknown>,\n\tincludeDev: boolean,\n): Map<string, string> {\n\tconst deps = new Map<string, string>();\n\tconst sections = [\"dependencies\"];\n\tif (includeDev) {\n\t\tsections.push(\"dev-dependencies\");\n\t}\n\n\tfor (const section of sections) {\n\t\tconst sectionDeps = toml[section] as Record<string, unknown> | undefined;\n\t\tif (!sectionDeps) {\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const [name, value] of Object.entries(sectionDeps)) {\n\t\t\tconst version = extractVersion(value);\n\t\t\tif (version) {\n\t\t\t\tdeps.set(name, version);\n\t\t\t}\n\t\t}\n\t}\n\treturn deps;\n}\n\nfunction recordDependency(\n\tallDeps: Map<string, Map<string, string[]>>,\n\tdepName: string,\n\tversion: string,\n\tpkgPath: string,\n): void {\n\tif (!allDeps.has(depName)) {\n\t\tallDeps.set(depName, new Map());\n\t}\n\tconst versionMap = allDeps.get(depName);\n\tif (versionMap === undefined) {\n\t\treturn;\n\t}\n\tif (!versionMap.has(version)) {\n\t\tversionMap.set(version, []);\n\t}\n\tversionMap.get(version)?.push(pkgPath);\n}\n\n/**\n * A policy that detects dependency version mismatches across Gleam packages in a monorepo.\n *\n * @alpha\n */\nexport const GleamSharedDependencyVersions: PolicyDefinition<GleamSharedDependencyVersionsConfig> =\n\tmakePolicyDefinition({\n\t\tname: \"GleamSharedDependencyVersions\",\n\t\tdescription:\n\t\t\t\"Detects dependency version mismatches across Gleam packages in a monorepo.\",\n\t\tmatch: /^gleam\\.toml$/,\n\t\thandler: async ({ root, config }) => {\n\t\t\tconst packagePaths = config?.packages;\n\t\t\tif (!packagePaths || packagePaths.length < 2) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst detectMismatches = config?.detectMismatches ?? true;\n\t\t\tif (!detectMismatches) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst includeDev = config?.includeDev ?? false;\n\t\t\tconst allDeps = new Map<string, Map<string, string[]>>();\n\n\t\t\tfor (const pkgPath of packagePaths) {\n\t\t\t\ttry {\n\t\t\t\t\tconst content = await readFile(path.resolve(root, pkgPath), \"utf-8\");\n\t\t\t\t\tconst toml = await parseToml(content);\n\t\t\t\t\tconst deps = collectDeps(toml, includeDev);\n\n\t\t\t\t\tfor (const [name, version] of deps) {\n\t\t\t\t\t\trecordDependency(allDeps, name, version, pkgPath);\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// Package might not exist\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst errors: string[] = [];\n\t\t\tfor (const [dep, versionMap] of allDeps) {\n\t\t\t\tif (versionMap.size > 1) {\n\t\t\t\t\tconst details = [...versionMap.entries()]\n\t\t\t\t\t\t.map(([ver, pkgs]) => `\"${ver}\" in ${pkgs.join(\", \")}`)\n\t\t\t\t\t\t.join(\"; \");\n\t\t\t\t\terrors.push(`Version mismatch for \"${dep}\": ${details}`);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (errors.length > 0) {\n\t\t\t\treturn {\n\t\t\t\t\terror: errors.join(\"; \"),\n\t\t\t\t\tmanualFix:\n\t\t\t\t\t\t\"Align dependency versions across all Gleam packages in the monorepo.\",\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn true;\n\t\t},\n\t});\n"]}

package/esm/policies/GleamTomlRequired.d.ts

@@ -0,0 +1,30 @@
+import type { PolicyShape } from "../policy.js";
+/**
+ * Configuration for the GleamTomlRequired policy.
+ *
+ * @alpha
+ */
+export interface GleamTomlRequiredConfig {
+    /**
+     * Top-level fields that must exist in gleam.toml.
+     * @defaultValue ["name", "version"]
+     */
+    required?: string[];
+    /**
+     * If true, require the `gleam` compiler version constraint.
+     * @defaultValue false
+     */
+    requireGleamVersion?: boolean;
+    /**
+     * If true, require the `[repository]` section.
+     * @defaultValue false
+     */
+    requireRepository?: boolean;
+}
+/**
+ * A policy that enforces required fields exist in gleam.toml.
+ *
+ * @alpha
+ */
+export declare const GleamTomlRequired: PolicyShape<GleamTomlRequiredConfig>;
+//# sourceMappingURL=GleamTomlRequired.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamTomlRequired.d.ts","sourceRoot":"","sources":["../../src/policies/GleamTomlRequired.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACvC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAcD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,uBAAuB,CA8BhE,CAAC"}

package/esm/policies/GleamTomlRequired.js

@@ -0,0 +1,37 @@
+import { defineGleamPolicy, } from "../policyDefiners/defineGleamPolicy.js";
+const DEFAULT_REQUIRED_FIELDS = ["name", "version"];
+function checkRequiredFields(toml, fields) {
+    const errors = [];
+    for (const field of fields) {
+        if (toml[field] === undefined || toml[field] === "") {
+            errors.push(`Missing required field: ${field}`);
+        }
+    }
+    return errors;
+}
+/**
+ * A policy that enforces required fields exist in gleam.toml.
+ *
+ * @alpha
+ */
+export const GleamTomlRequired = defineGleamPolicy({
+    name: "GleamTomlRequired",
+    description: "Ensures gleam.toml files contain required fields for proper project configuration.",
+    handler: async (toml, { config }) => {
+        const errors = checkRequiredFields(toml, config?.required ?? DEFAULT_REQUIRED_FIELDS);
+        if (config?.requireGleamVersion && toml.gleam === undefined) {
+            errors.push('Missing gleam version constraint. Add gleam = ">= x.y.z" to gleam.toml.');
+        }
+        if (config?.requireRepository && toml.repository === undefined) {
+            errors.push("Missing [repository] section in gleam.toml.");
+        }
+        if (errors.length > 0) {
+            return {
+                error: errors.join("; "),
+                manualFix: "Add the missing fields to your gleam.toml file.",
+            };
+        }
+        return true;
+    },
+});
+//# sourceMappingURL=GleamTomlRequired.js.map