c3b-lint 0.0.16 → 0.0.17

package/README.md

@@ -74,7 +74,8 @@ A project's own settings go in its `package.json`, under `"c3b-lint"`:
 "c3b-lint": {
     "ignore": ["src/experiment/**"],
     "globals": ["THREE", "gsap", "ScrollTrigger"],
-    "singularDirectories": ["mannequin-films"]
+    "singularDirectories": ["mannequin-films"],
+    "ignoreLength": ["src/index.html"]
 }
 ```
 
@@ -83,6 +84,8 @@ A project's own settings go in its `package.json`, under `"c3b-lint"`:
 - `globals` — the names a page's CDN `<script>` tags define (`THREE`, `gsap`, `Lenis`, …). ESLint lints each file on
   its own and never reads the HTML, so without them every use is "not defined". Read-only, `src/` scripts only.
 - `singularDirectories` — plural-looking directory names that are proper names (a client's brand).
+- `ignoreLength` — globs exempt from the 500-line limit and nothing else: the HTML, token, structure, ESLint and
+  Stylelint checks still run on them. For a file that can't be split, like a desktop app's one renderer page.
 
 The ESLint and Stylelint configs read these too, so WebStorm reports what the CLI does.
 

package/c3b-lint.js

@@ -9,7 +9,7 @@ import { checkCssTokens } from './check/css-tokens.js';
 import { checkHtml } from './check/html.js';
 import { checkStructure } from './check/structure.js';
 import { installHook } from './check/hook.js';
-import { ignoredPaths } from './config/project-settings.js';
+import { ignoredPaths, readSettings } from './config/project-settings.js';
 
 // Printed first so it's obvious which installed version is running.
 const HERE = dirname(fileURLToPath(import.meta.url));
@@ -128,7 +128,8 @@ function checkEditorconfig(report) {
 // general.md: no hand-written file past 500 lines. ESLint reports JS; this covers CSS and HTML.
 function checkFileLengths(report) {
     const ignored = ignoredPaths();
-    const files = globSync('src/**/*.{css,html}').map(toPosix).filter((file) => !file.includes('/vendor/') && !ignored.has(file));
+    const exempt = ignoredPaths(readSettings().ignoreLength);
+    const files = globSync('src/**/*.{css,html}').map(toPosix).filter((file) => !file.includes('/vendor/') && !ignored.has(file) && !exempt.has(file));
     for (const file of files.sort()) {
         // inline <svg> is vector art, not hand-written markup: its lines are not counted
         const content = readFileSync(file, 'utf8').replace(/<svg[\s\S]*?<\/svg>/g, '<svg/>');

package/config/eslint.config.js

@@ -130,8 +130,12 @@ export const librarySrc = {
     }
 };
 
+// the "ignoreLength" files: everything but max-lines still applies (ESLint refuses an empty files list)
+const lengthExempt = settings.ignoreLength.length ? [{ files: settings.ignoreLength, rules: { 'max-lines': 'off' } }] : [];
+
 export default [
     { ignores: ['node_modules/**', 'dist/**', 'c10g/**', 'src/**/vendor/**', '**/*.min.js', ...settings.ignore] },
     browser,
-    node
+    node,
+    ...lengthExempt
 ];

package/config/project-settings.js

@@ -7,7 +7,8 @@ import { resolve, sep } from 'path';
 //   "c3b-lint": {
 //       "ignore": ["src/experiment/**"],        globs no check looks at: ESLint, Stylelint and c3b-lint's own
 //       "globals": ["THREE", "gsap"],           names the pages' CDN <script> tags define, read-only in src/ scripts
-//       "singularDirectories": ["mannequin-films"]   plural-looking directory names that are proper names
+//       "singularDirectories": ["mannequin-films"],  plural-looking directory names that are proper names
+//       "ignoreLength": ["src/index.html"]      globs exempt from the 500-line limit only; every other check still runs
 //   }
 //
 // The ESLint and Stylelint configs read it too, so the editor reports what the CLI does.
@@ -22,17 +23,17 @@ export function readSettings() {
     return {
         ignore: settings.ignore ?? [],
         globals: settings.globals ?? [],
-        singularDirectories: settings.singularDirectories ?? []
+        singularDirectories: settings.singularDirectories ?? [],
+        ignoreLength: settings.ignoreLength ?? []
     };
 }
 
-// Every file and directory the "ignore" globs match, as posix paths from the project root, for the checks
-// c3b-lint runs itself (ESLint and Stylelint are handed the globs directly)
-export function ignoredPaths() {
-    const { ignore } = readSettings();
-    if (ignore.length === 0) {
+// Every file and directory the "ignore" globs (or the globs given) match, as posix paths from the project
+// root, for the checks c3b-lint runs itself (ESLint and Stylelint are handed the globs directly)
+export function ignoredPaths(globs = readSettings().ignore) {
+    if (globs.length === 0) {
         return new Set();
     }
 
-    return new Set(globSync(ignore).map((path) => path.split(sep).join('/')));
+    return new Set(globSync(globs).map((path) => path.split(sep).join('/')));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c3b-lint",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "description": "Lints a co:lab project against the rules a tool can check: ESLint, Stylelint, the 500-line limit and the shared .editorconfig; --init writes the config files.",
   "license": "GPL-3.0",
   "type": "module",