oxlint-plugin-arch 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.2.4
+
+- Add `trailingRoles` and `roleSeparators` so `export-file-prefix`, `declaration-name`, and `no-extra-exports` can treat `onchain-utils.ts` like `onchain.utils.ts`.
+
 ## 0.2.3
 
 - Add `declaration-name` so selected declarations can follow a file prefix or pattern per glob.

package/README.md

@@ -47,13 +47,13 @@ Copy the shapes that match your repository; do not copy globs or naming policy b
 
 ## Rules
 
-- `declaration-name` — require selected declarations to match a filename-derived prefix or a consumer pattern.
-- `export-file-prefix` — require export names, or every function and type, to start with a filename-derived prefix, optionally singularized.
+- `declaration-name` — require selected declarations to match a filename-derived prefix or a consumer pattern. Optional `trailingRoles` treat `onchain-utils.ts` like `onchain.utils.ts`.
+- `export-file-prefix` — require export names, or every function and type, to start with a filename-derived prefix, optionally singularized. Optional `trailingRoles` drop a configured role suffix from that prefix.
 - `export-name-pattern` — require export names, or every function and type, to match a configured regular expression.
 - `filename-export-name` — derive expected function names from filename templates, optionally including locals.
 - `filename-match` — require filenames to match a configured pattern.
 - `folder-prefix` — require filenames to start with their parent folder name, or the folders after a configured root.
-- `no-extra-exports` — restrict files to configured export templates.
+- `no-extra-exports` — restrict files to configured export templates. Optional `trailingRoles` apply to `{Domain}` the same way as the prefix rules.
 - `no-extra-factory-keys` — restrict direct factory return keys.
 - `no-file-level-helpers` — keep unapproved helpers out of module scope.
 - `no-imported-type-alias` — reject exported aliases that only rename imported types.

package/dist/index.js

@@ -422,9 +422,37 @@ function namingMatchTemplate(basename, template, placeholderPattern = "[a-z0-9-]
   }
   return new RegExp(`^${pattern}$`).exec(basename)?.groups ?? null;
 }
+var namingStemModes = ["before-first-dot", "full-basename"];
 function namingNormalized(value, normalize) {
   return normalize === "none" ? value : value.replaceAll(/[-_]/g, "").toLowerCase();
 }
+function namingFileStem(basename, mode = "before-first-dot", trailingRoles = [], roleSeparators = [".", "-"]) {
+  const stem = mode === "full-basename" ? basename : basename.split(".")[0] ?? "";
+  const roles = [...new Set(trailingRoles.filter(Boolean))].sort((left, right) => right.length - left.length);
+  const separators = [...new Set(roleSeparators.filter(Boolean))];
+  if (roles.length === 0 || separators.length === 0) {
+    return stem;
+  }
+  let remaining = stem;
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const role of roles) {
+      for (const separator of separators) {
+        const suffix = `${separator}${role}`;
+        if (remaining.length > suffix.length && remaining.endsWith(suffix)) {
+          remaining = remaining.slice(0, -suffix.length);
+          changed = true;
+          break;
+        }
+      }
+      if (changed) {
+        break;
+      }
+    }
+  }
+  return remaining;
+}
 function namingFilePrefixes(stem, normalize = "remove-separators", singularize = "none") {
   const prefixes = [namingNormalized(stem, normalize)];
   const parts = stem.split(/[-_]+/).filter(Boolean);
@@ -699,7 +727,9 @@ var declarationName = defineRule({
         },
         pattern: { type: "string" },
         flags: { type: "string" },
-        stem: { type: "string", enum: ["before-first-dot", "full-basename"] },
+        stem: { type: "string", enum: [...namingStemModes] },
+        trailingRoles: { type: "array", items: { type: "string" } },
+        roleSeparators: { type: "array", items: { type: "string" } },
         normalize: { type: "string", enum: ["remove-separators", "none"] },
         singularize: { type: "string", enum: ["none", "trailing-s"] },
         allowPattern: { type: "string" }
@@ -720,7 +750,7 @@ var declarationName = defineRule({
         const allowed = options2.allowPattern ? new RegExp(options2.allowPattern) : null;
         const expected = options2.pattern ? new RegExp(options2.pattern, options2.flags) : null;
         const basename = namingFileBasename(context.filename).replace(/\.(tsx?|jsx?)$/, "");
-        const stem = options2.stem === "full-basename" ? basename : basename.split(".")[0] ?? "";
+        const stem = namingFileStem(basename, options2.stem, options2.trailingRoles, options2.roleSeparators);
         const prefixes = namingFilePrefixes(stem, options2.normalize ?? "remove-separators", options2.singularize ?? "none");
         const seen = new Set;
         for (const item of declarationsCollectNamed(program, options2.kinds)) {
@@ -751,7 +781,9 @@ var exportFilePrefix = defineRule2({
       type: "object",
       additionalProperties: false,
       properties: {
-        stem: { type: "string", enum: ["before-first-dot", "full-basename"] },
+        stem: { type: "string", enum: [...namingStemModes] },
+        trailingRoles: { type: "array", items: { type: "string" } },
+        roleSeparators: { type: "array", items: { type: "string" } },
         normalize: { type: "string", enum: ["remove-separators", "none"] },
         singularize: { type: "string", enum: ["none", "trailing-s"] },
         allDeclarations: { type: "boolean" },
@@ -770,7 +802,7 @@ var exportFilePrefix = defineRule2({
           normalize: "remove-separators"
         });
         const basename = namingFileBasename(context.filename).replace(/\.(tsx?|jsx?)$/, "");
-        const stem = options2.stem === "full-basename" ? basename : basename.split(".")[0] ?? "";
+        const stem = namingFileStem(basename, options2.stem, options2.trailingRoles, options2.roleSeparators);
         const prefixes = namingFilePrefixes(stem, options2.normalize ?? "remove-separators", options2.singularize ?? "none");
         const allowed = options2.allowPattern ? new RegExp(options2.allowPattern) : null;
         const names = options2.allDeclarations ? declarationsCollectNamed(program) : exportsCollect(program).map((binding) => ({
@@ -1003,7 +1035,9 @@ var noExtraExports = defineRule7({
       additionalProperties: false,
       properties: {
         names: { type: "array", items: { type: "string" } },
-        domainStem: { type: "string", enum: ["before-first-dot", "full-basename"] },
+        domainStem: { type: "string", enum: [...namingStemModes] },
+        trailingRoles: { type: "array", items: { type: "string" } },
+        roleSeparators: { type: "array", items: { type: "string" } },
         allowTypeExports: { type: "boolean" }
       },
       required: ["names"]
@@ -1017,7 +1051,7 @@ var noExtraExports = defineRule7({
       Program(program) {
         const options2 = optionsFirst(context);
         const basename = namingFileBasename(context.filename).replace(/\.(tsx?|jsx?)$/, "");
-        const domain = options2.domainStem === "full-basename" ? basename : basename.split(".")[0] ?? "";
+        const domain = namingFileStem(basename, options2.domainStem, options2.trailingRoles, options2.roleSeparators);
         const allowed = options2.names.map((template) => template.replaceAll("{Domain}", namingPascalCase(domain)).replaceAll("{domain}", namingCamelCase(domain)));
         for (const binding of exportsCollect(program)) {
           if (options2.allowTypeExports && binding.typeOnly) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxlint-plugin-arch",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Configurable architecture rules for Oxlint JavaScript plugins.",
   "type": "module",
   "main": "./dist/index.js",