repopo 0.10.0 → 0.12.0

package/esm/policies/GleamDocExists.js

@@ -0,0 +1,39 @@
+import { existsSync } from "node:fs";
+import path from "pathe";
+import { defineGleamPolicy, } from "../policyDefiners/defineGleamPolicy.js";
+const DEFAULT_REQUIRED = ["README.md"];
+/**
+ * A policy that validates documentation files exist for Gleam packages.
+ *
+ * @alpha
+ */
+export const GleamDocExists = defineGleamPolicy({
+    name: "GleamDocExists",
+    description: "Validates that documentation files (README.md, etc.) exist for Gleam packages.",
+    handler: async (toml, { file, root, config }) => {
+        // Skip if the package looks like it's not for publishing
+        if (!(toml.description || toml.licences)) {
+            return true;
+        }
+        const dir = path.dirname(path.resolve(root, file));
+        const required = config?.required ?? DEFAULT_REQUIRED;
+        const recommended = config?.recommended ?? [];
+        const errors = [];
+        const missingRequired = required.filter((f) => !existsSync(path.join(dir, f)));
+        const missingRecommended = recommended.filter((f) => !existsSync(path.join(dir, f)));
+        if (missingRequired.length > 0) {
+            errors.push(`Missing required documentation: ${missingRequired.join(", ")}`);
+        }
+        if (missingRecommended.length > 0) {
+            errors.push(`Missing recommended documentation: ${missingRecommended.join(", ")}`);
+        }
+        if (errors.length > 0) {
+            return {
+                error: errors.join("; "),
+                manualFix: "Create the missing documentation files alongside gleam.toml.",
+            };
+        }
+        return true;
+    },
+});
+//# sourceMappingURL=GleamDocExists.js.map

package/esm/policies/GleamDocExists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamDocExists.js","sourceRoot":"","sources":["../../src/policies/GleamDocExists.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;AAoBhD,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAC1B,iBAAiB,CAAC;IACjB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACV,gFAAgF;IACjF,OAAO,EAAE,KAAK,EAAE,IAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1D,yDAAyD;QACzD,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,gBAAgB,CAAC;QACtD,MAAM,WAAW,GAAG,MAAM,EAAE,WAAW,IAAI,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CACrC,CAAC;QACF,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CACrC,CAAC;QAEF,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CACV,mCAAmC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/D,CAAC;QACH,CAAC;QACD,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CACV,sCAAsC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrE,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,8DAA8D;aAC/D,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\n/**\n * Configuration for the GleamDocExists policy.\n *\n * @alpha\n */\nexport interface GleamDocExistsConfig {\n\t/**\n\t * Files that must exist alongside the gleam.toml.\n\t * @defaultValue [\"README.md\"]\n\t */\n\trequired?: string[];\n\n\t/**\n\t * Files that are recommended but not required. Missing ones produce warnings.\n\t */\n\trecommended?: string[];\n}\n\nconst DEFAULT_REQUIRED = [\"README.md\"];\n\n/**\n * A policy that validates documentation files exist for Gleam packages.\n *\n * @alpha\n */\nexport const GleamDocExists: PolicyShape<GleamDocExistsConfig> =\n\tdefineGleamPolicy({\n\t\tname: \"GleamDocExists\",\n\t\tdescription:\n\t\t\t\"Validates that documentation files (README.md, etc.) exist for Gleam packages.\",\n\t\thandler: async (toml: GleamToml, { file, root, config }) => {\n\t\t\t// Skip if the package looks like it's not for publishing\n\t\t\tif (!(toml.description || toml.licences)) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst dir = path.dirname(path.resolve(root, file));\n\t\t\tconst required = config?.required ?? DEFAULT_REQUIRED;\n\t\t\tconst recommended = config?.recommended ?? [];\n\t\t\tconst errors: string[] = [];\n\n\t\t\tconst missingRequired = required.filter(\n\t\t\t\t(f) => !existsSync(path.join(dir, f)),\n\t\t\t);\n\t\t\tconst missingRecommended = recommended.filter(\n\t\t\t\t(f) => !existsSync(path.join(dir, f)),\n\t\t\t);\n\n\t\t\tif (missingRequired.length > 0) {\n\t\t\t\terrors.push(\n\t\t\t\t\t`Missing required documentation: ${missingRequired.join(\", \")}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (missingRecommended.length > 0) {\n\t\t\t\terrors.push(\n\t\t\t\t\t`Missing recommended documentation: ${missingRecommended.join(\", \")}`,\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\"Create the missing documentation files alongside gleam.toml.\",\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn true;\n\t\t},\n\t});\n"]}

package/esm/policies/GleamInternalModulesConfigured.d.ts

@@ -0,0 +1,21 @@
+import type { PolicyShape } from "../policy.js";
+/**
+ * Configuration for the GleamInternalModulesConfigured policy.
+ *
+ * @alpha
+ */
+export interface GleamInternalModulesConfiguredConfig {
+    /**
+     * If true, suggest common internal_modules patterns when the field is missing.
+     * @defaultValue true
+     */
+    suggestPatterns?: boolean;
+}
+/**
+ * A policy that ensures `internal_modules` is configured in gleam.toml
+ * to hide implementation details from generated documentation.
+ *
+ * @alpha
+ */
+export declare const GleamInternalModulesConfigured: PolicyShape<GleamInternalModulesConfiguredConfig>;
+//# sourceMappingURL=GleamInternalModulesConfigured.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamInternalModulesConfigured.d.ts","sourceRoot":"","sources":["../../src/policies/GleamInternalModulesConfigured.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD;;;;GAIG;AACH,MAAM,WAAW,oCAAoC;IACpD;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,EAAE,WAAW,CAAC,oCAAoC,CA+B1F,CAAC"}

package/esm/policies/GleamInternalModulesConfigured.js

@@ -0,0 +1,30 @@
+import { defineGleamPolicy, } from "../policyDefiners/defineGleamPolicy.js";
+/**
+ * A policy that ensures `internal_modules` is configured in gleam.toml
+ * to hide implementation details from generated documentation.
+ *
+ * @alpha
+ */
+export const GleamInternalModulesConfigured = defineGleamPolicy({
+    name: "GleamInternalModulesConfigured",
+    description: "Ensures internal_modules is configured in gleam.toml to hide implementation details from docs.",
+    handler: async (toml, { config }) => {
+        const internalModules = toml.internal_modules;
+        if (internalModules !== undefined &&
+            Array.isArray(internalModules) &&
+            internalModules.length > 0) {
+            return true;
+        }
+        const name = toml.name;
+        const suggestPatterns = config?.suggestPatterns ?? true;
+        let manualFix = "Add an internal_modules field to gleam.toml to hide implementation details from docs.";
+        if (suggestPatterns && name) {
+            manualFix = `Add to gleam.toml:\ninternal_modules = ["${name}/internal", "${name}/internal/*"]`;
+        }
+        return {
+            error: "Missing internal_modules configuration in gleam.toml. Published packages should hide internal modules from documentation.",
+            manualFix,
+        };
+    },
+});
+//# sourceMappingURL=GleamInternalModulesConfigured.js.map

package/esm/policies/GleamInternalModulesConfigured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamInternalModulesConfigured.js","sourceRoot":"","sources":["../../src/policies/GleamInternalModulesConfigured.ts"],"names":[],"mappings":"AACA,OAAO,EACN,iBAAiB,GAEjB,MAAM,wCAAwC,CAAC;AAehD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAC1C,iBAAiB,CAAC;IACjB,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACV,gGAAgG;IACjG,OAAO,EAAE,KAAK,EAAE,IAAe,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC9C,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAwC,CAAC;QAEtE,IACC,eAAe,KAAK,SAAS;YAC7B,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;YAC9B,eAAe,CAAC,MAAM,GAAG,CAAC,EACzB,CAAC;YACF,OAAO,IAAI,CAAC;QACb,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAA0B,CAAC;QAC7C,MAAM,eAAe,GAAG,MAAM,EAAE,eAAe,IAAI,IAAI,CAAC;QAExD,IAAI,SAAS,GACZ,uFAAuF,CAAC;QACzF,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;YAC7B,SAAS,GAAG,4CAA4C,IAAI,gBAAgB,IAAI,eAAe,CAAC;QACjG,CAAC;QAED,OAAO;YACN,KAAK,EACJ,2HAA2H;YAC5H,SAAS;SACT,CAAC;IACH,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 GleamInternalModulesConfigured policy.\n *\n * @alpha\n */\nexport interface GleamInternalModulesConfiguredConfig {\n\t/**\n\t * If true, suggest common internal_modules patterns when the field is missing.\n\t * @defaultValue true\n\t */\n\tsuggestPatterns?: boolean;\n}\n\n/**\n * A policy that ensures `internal_modules` is configured in gleam.toml\n * to hide implementation details from generated documentation.\n *\n * @alpha\n */\nexport const GleamInternalModulesConfigured: PolicyShape<GleamInternalModulesConfiguredConfig> =\n\tdefineGleamPolicy({\n\t\tname: \"GleamInternalModulesConfigured\",\n\t\tdescription:\n\t\t\t\"Ensures internal_modules is configured in gleam.toml to hide implementation details from docs.\",\n\t\thandler: async (toml: GleamToml, { config }) => {\n\t\t\tconst internalModules = toml.internal_modules as string[] | undefined;\n\n\t\t\tif (\n\t\t\t\tinternalModules !== undefined &&\n\t\t\t\tArray.isArray(internalModules) &&\n\t\t\t\tinternalModules.length > 0\n\t\t\t) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst name = toml.name as string | undefined;\n\t\t\tconst suggestPatterns = config?.suggestPatterns ?? true;\n\n\t\t\tlet manualFix =\n\t\t\t\t\"Add an internal_modules field to gleam.toml to hide implementation details from docs.\";\n\t\t\tif (suggestPatterns && name) {\n\t\t\t\tmanualFix = `Add to gleam.toml:\\ninternal_modules = [\"${name}/internal\", \"${name}/internal/*\"]`;\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\terror:\n\t\t\t\t\t\"Missing internal_modules configuration in gleam.toml. Published packages should hide internal modules from documentation.\",\n\t\t\t\tmanualFix,\n\t\t\t};\n\t\t},\n\t});\n"]}

package/esm/policies/GleamLicenceConfigured.d.ts

@@ -0,0 +1,29 @@
+import type { PolicyShape } from "../policy.js";
+/**
+ * Configuration for the GleamLicenceConfigured policy.
+ *
+ * @alpha
+ */
+export interface GleamLicenceConfiguredConfig {
+    /**
+     * Allowed SPDX licence identifiers. If set, only these are accepted.
+     */
+    allowedLicences?: string[];
+    /**
+     * If true, validate licence values against the SPDX licence list
+     * using `spdx-correct`. When enabled, typos like "MIIT" are detected
+     * and can be auto-fixed to the correct identifier ("MIT").
+     *
+     * Requires the optional peer dependency `spdx-correct` to be installed.
+     *
+     * @defaultValue false
+     */
+    validateSpdx?: boolean;
+}
+/**
+ * A policy that ensures licence metadata is properly configured in gleam.toml.
+ *
+ * @alpha
+ */
+export declare const GleamLicenceConfigured: PolicyShape<GleamLicenceConfiguredConfig>;
+//# sourceMappingURL=GleamLicenceConfigured.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamLicenceConfigured.d.ts","sourceRoot":"","sources":["../../src/policies/GleamLicenceConfigured.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC5C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAKD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,4BAA4B,CAgC1E,CAAC"}

package/esm/policies/GleamLicenceConfigured.js

@@ -0,0 +1,34 @@
+import { resolve } from "pathe";
+import { defineGleamPolicy, } from "../policyDefiners/defineGleamPolicy.js";
+import { validateLicenceField } from "../policyDefiners/spdxValidator.js";
+const MANUAL_FIX = "Use valid SPDX licence identifiers (e.g., MIT, Apache-2.0, MPL-2.0).";
+/**
+ * A policy that ensures licence metadata is properly configured in gleam.toml.
+ *
+ * @alpha
+ */
+export const GleamLicenceConfigured = defineGleamPolicy({
+    name: "GleamLicenceConfigured",
+    description: "Ensures gleam.toml has valid SPDX licence identifiers configured.",
+    handler: async (toml, { file, root, resolve: shouldResolve, config }) => {
+        const licences = toml.licences;
+        if (!Array.isArray(licences) || licences.length === 0) {
+            return {
+                error: "Missing or empty licences field in gleam.toml.",
+                manualFix: 'Add licences = ["MIT"] (or appropriate SPDX identifier) to gleam.toml.',
+            };
+        }
+        const result = await validateLicenceField({
+            licences: licences,
+            ...(config?.allowedLicences !== undefined && {
+                allowedLicences: config.allowedLicences,
+            }),
+            validateSpdx: config?.validateSpdx ?? false,
+            shouldResolve,
+            filePath: resolve(root, file),
+            manualFixMessage: MANUAL_FIX,
+        });
+        return result ?? true;
+    },
+});
+//# sourceMappingURL=GleamLicenceConfigured.js.map

package/esm/policies/GleamLicenceConfigured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamLicenceConfigured.js","sourceRoot":"","sources":["../../src/policies/GleamLicenceConfigured.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EACN,iBAAiB,GAEjB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAyB1E,MAAM,UAAU,GACf,sEAAsE,CAAC;AAExE;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAClC,iBAAiB,CAAC;IACjB,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACV,mEAAmE;IACpE,OAAO,EAAE,KAAK,EACb,IAAe,EACf,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,EAC7C,EAAE;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO;gBACN,KAAK,EAAE,gDAAgD;gBACvD,SAAS,EACR,wEAAwE;aACzE,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;YACzC,QAAQ,EAAE,QAAoB;YAC9B,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,SAAS,IAAI;gBAC5C,eAAe,EAAE,MAAM,CAAC,eAAe;aACvC,CAAC;YACF,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,KAAK;YAC3C,aAAa;YACb,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;YAC7B,gBAAgB,EAAE,UAAU;SAC5B,CAAC,CAAC;QAEH,OAAO,MAAM,IAAI,IAAI,CAAC;IACvB,CAAC;CACD,CAAC,CAAC","sourcesContent":["import { resolve } from \"pathe\";\nimport type { PolicyShape } from \"../policy.js\";\nimport {\n\tdefineGleamPolicy,\n\ttype GleamToml,\n} from \"../policyDefiners/defineGleamPolicy.js\";\nimport { validateLicenceField } from \"../policyDefiners/spdxValidator.js\";\n\n/**\n * Configuration for the GleamLicenceConfigured policy.\n *\n * @alpha\n */\nexport interface GleamLicenceConfiguredConfig {\n\t/**\n\t * Allowed SPDX licence identifiers. If set, only these are accepted.\n\t */\n\tallowedLicences?: string[];\n\n\t/**\n\t * If true, validate licence values against the SPDX licence list\n\t * using `spdx-correct`. When enabled, typos like \"MIIT\" are detected\n\t * and can be auto-fixed to the correct identifier (\"MIT\").\n\t *\n\t * Requires the optional peer dependency `spdx-correct` to be installed.\n\t *\n\t * @defaultValue false\n\t */\n\tvalidateSpdx?: boolean;\n}\n\nconst MANUAL_FIX =\n\t\"Use valid SPDX licence identifiers (e.g., MIT, Apache-2.0, MPL-2.0).\";\n\n/**\n * A policy that ensures licence metadata is properly configured in gleam.toml.\n *\n * @alpha\n */\nexport const GleamLicenceConfigured: PolicyShape<GleamLicenceConfiguredConfig> =\n\tdefineGleamPolicy({\n\t\tname: \"GleamLicenceConfigured\",\n\t\tdescription:\n\t\t\t\"Ensures gleam.toml has valid SPDX licence identifiers configured.\",\n\t\thandler: async (\n\t\t\ttoml: GleamToml,\n\t\t\t{ file, root, resolve: shouldResolve, config },\n\t\t) => {\n\t\t\tconst licences = toml.licences;\n\n\t\t\tif (!Array.isArray(licences) || licences.length === 0) {\n\t\t\t\treturn {\n\t\t\t\t\terror: \"Missing or empty licences field in gleam.toml.\",\n\t\t\t\t\tmanualFix:\n\t\t\t\t\t\t'Add licences = [\"MIT\"] (or appropriate SPDX identifier) to gleam.toml.',\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tconst result = await validateLicenceField({\n\t\t\t\tlicences: licences as string[],\n\t\t\t\t...(config?.allowedLicences !== undefined && {\n\t\t\t\t\tallowedLicences: config.allowedLicences,\n\t\t\t\t}),\n\t\t\t\tvalidateSpdx: config?.validateSpdx ?? false,\n\t\t\t\tshouldResolve,\n\t\t\t\tfilePath: resolve(root, file),\n\t\t\t\tmanualFixMessage: MANUAL_FIX,\n\t\t\t});\n\n\t\t\treturn result ?? true;\n\t\t},\n\t});\n"]}

package/esm/policies/GleamManifestCommitted.d.ts

@@ -0,0 +1,9 @@
+import type { PolicyDefinition } from "../policy.js";
+/**
+ * A policy that ensures manifest.toml is committed alongside gleam.toml
+ * for reproducible Gleam builds.
+ *
+ * @alpha
+ */
+export declare const GleamManifestCommitted: PolicyDefinition;
+//# sourceMappingURL=GleamManifestCommitted.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamManifestCommitted.d.ts","sourceRoot":"","sources":["../../src/policies/GleamManifestCommitted.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,gBAoBnC,CAAC"}

package/esm/policies/GleamManifestCommitted.js

@@ -0,0 +1,26 @@
+import { existsSync } from "node:fs";
+import path from "pathe";
+import { makePolicyDefinition } from "../makePolicy.js";
+/**
+ * A policy that ensures manifest.toml is committed alongside gleam.toml
+ * for reproducible Gleam builds.
+ *
+ * @alpha
+ */
+export const GleamManifestCommitted = makePolicyDefinition({
+    name: "GleamManifestCommitted",
+    description: "Ensures manifest.toml is committed alongside gleam.toml for reproducible builds.",
+    match: /gleam\.toml$/,
+    handler: async ({ file, root }) => {
+        const dir = path.dirname(path.resolve(root, file));
+        const manifestPath = path.join(dir, "manifest.toml");
+        if (existsSync(manifestPath)) {
+            return true;
+        }
+        return {
+            error: "Missing manifest.toml. Gleam projects should commit manifest.toml for reproducible builds.",
+            manualFix: "Run `gleam build` to generate manifest.toml, then commit it to source control.",
+        };
+    },
+});
+//# sourceMappingURL=GleamManifestCommitted.js.map

package/esm/policies/GleamManifestCommitted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GleamManifestCommitted.js","sourceRoot":"","sources":["../../src/policies/GleamManifestCommitted.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;AAGxD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAqB,oBAAoB,CAAC;IAC5E,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACV,kFAAkF;IACnF,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAErD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO;YACN,KAAK,EACJ,4FAA4F;YAC7F,SAAS,EACR,gFAAgF;SACjF,CAAC;IACH,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 * A policy that ensures manifest.toml is committed alongside gleam.toml\n * for reproducible Gleam builds.\n *\n * @alpha\n */\nexport const GleamManifestCommitted: PolicyDefinition = makePolicyDefinition({\n\tname: \"GleamManifestCommitted\",\n\tdescription:\n\t\t\"Ensures manifest.toml is committed alongside gleam.toml for reproducible builds.\",\n\tmatch: /gleam\\.toml$/,\n\thandler: async ({ file, root }) => {\n\t\tconst dir = path.dirname(path.resolve(root, file));\n\t\tconst manifestPath = path.join(dir, \"manifest.toml\");\n\n\t\tif (existsSync(manifestPath)) {\n\t\t\treturn true;\n\t\t}\n\n\t\treturn {\n\t\t\terror:\n\t\t\t\t\"Missing manifest.toml. Gleam projects should commit manifest.toml for reproducible builds.\",\n\t\t\tmanualFix:\n\t\t\t\t\"Run `gleam build` to generate manifest.toml, then commit it to source control.\",\n\t\t};\n\t},\n});\n"]}

package/esm/policies/GleamMonorepoConsistency.d.ts

@@ -0,0 +1,30 @@
+import type { PolicyDefinition } from "../policy.js";
+/**
+ * Configuration for the GleamMonorepoConsistency policy.
+ *
+ * @alpha
+ */
+export interface GleamMonorepoConsistencyConfig {
+    /**
+     * Top-level fields that should be consistent across all packages.
+     * @defaultValue ["licences"]
+     */
+    syncFields?: string[];
+    /**
+     * If true, ensure the `gleam` version constraint is consistent.
+     * @defaultValue true
+     */
+    syncGleamVersion?: boolean;
+    /**
+     * Paths to gleam.toml files to compare (relative to repo root).
+     * If not specified, the policy only checks the file it matches against.
+     */
+    packages?: string[];
+}
+/**
+ * A policy that enforces consistent metadata across Gleam packages in a monorepo.
+ *
+ * @alpha
+ */
+export declare const GleamMonorepoConsistency: PolicyDefinition<GleamMonorepoConsistencyConfig>;
+//# sourceMappingURL=GleamMonorepoConsistency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GleamMonorepoConsistency.d.ts","sourceRoot":"","sources":["../../src/policies/GleamMonorepoConsistency.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC9C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAuCD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,CAAC,8BAA8B,CA+CnF,CAAC"}

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"]}