@gesslar/uglier 2.3.1 → 2.4.1

package/LICENSE.txt

@@ -0,0 +1,12 @@
+Copyright (C) 2026 by Brian M. Workman bmw@gesslar.dev
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -253,17 +253,17 @@ it, you good-deed profiteer.
 
 ## License
 
-uglier is released into the public domain under the
-[Unlicense](UNLICENSE.txt).
+`@gesslar/uglier` is released under the [0BSD](LICENSE.txt).
 
 This package includes or depends on third-party components under their own
 licenses:
 
 | Dependency | License |
 | --- | --- |
-| [@gesslar/colours](https://github.com/gesslar/colours) | Unlicense |
-| [@gesslar/toolkit](https://github.com/gesslar/toolkit) | Unlicense |
+| [@gesslar/colours](https://github.com/gesslar/colours) | 0BSD |
+| [@gesslar/toolkit](https://github.com/gesslar/toolkit) | 0BSD |
 | [@skarab/detect-package-manager](https://github.com/skarab42/detect-package-manager) | MIT |
 | [@stylistic/eslint-plugin](https://github.com/eslint-stylistic/eslint-stylistic) | MIT |
+| [eslint-plugin-astro](https://github.com/ota-meshi/eslint-plugin-astro) | MIT |
 | [eslint-plugin-jsdoc](https://github.com/gajus/eslint-plugin-jsdoc) | BSD-3-Clause |
 | [globals](https://github.com/sindresorhus/globals) | MIT |

package/package.json

@@ -5,7 +5,7 @@
     "name": "gesslar",
     "url": "https://gesslar.dev"
   },
-  "version": "2.3.1",
+  "version": "2.4.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/gesslar/uglier.git"
@@ -23,7 +23,7 @@
   "files": [
     "src",
     "bin",
-    "UNLICENSE.txt"
+    "LICENSE.txt"
   ],
   "keywords": [
     "eslint",
@@ -48,25 +48,24 @@
     "patch": "npm version patch",
     "minor": "npm version minor",
     "major": "npm version major",
-    "docs:dev": "cd docs && npm run start",
-    "docs:build": "cd docs && npm run build",
-    "docs:deploy": "gh workflow run deploy-docs.yml"
+    "docs": "gh workflow run ReleaseStarlight.yaml"
   },
-  "license": "Unlicense",
+  "license": "0BSD",
   "engines": {
-    "node": ">=24.13.0"
+    "node": ">=24.11.0"
   },
   "dependencies": {
-    "@gesslar/colours": ">=0.8.0",
-    "@gesslar/toolkit": ">=4.4.0",
+    "@gesslar/colours": ">=1.0.0",
+    "@gesslar/toolkit": ">=5.0.1",
     "@skarab/detect-package-manager": ">=1.0.0",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "eslint-plugin-jsdoc": ">=62.8.1",
+    "eslint-plugin-astro": "^1.7.0",
+    "eslint-plugin-jsdoc": ">=62.9.0",
     "globals": ">=17.4.0"
   },
   "devDependencies": {
-    "@gesslar/uglier": ">=2.2.0",
-    "eslint": ">=10.1.0",
+    "@gesslar/uglier": ">=2.4.0",
+    "eslint": ">=10.2.0",
     "typescript": "^6.0.2"
   }
 }

package/src/types/uglier.d.ts

@@ -14,7 +14,7 @@ export const availableConfigs: Array<ConfigName>;
 /**
  * Available config block names
  */
-export type ConfigName = "lints-js" | "lints-jsdoc" | "languageOptions" | "web" | "node" | "react" | "tauri" | "vscode-extension" | "cjs-override" | "mjs-override";
+export type ConfigName = "lints-js" | "lints-jsdoc" | "languageOptions" | "web" | "node" | "react" | "docusaurus" | "starlight" | "tauri" | "vscode-extension" | "cjs-override" | "mjs-override";
 /**
  * ESLint rule severity or configuration
  */
@@ -128,6 +128,8 @@ export type PerConfigOptions = {
     web?: EnvironmentOptions;
     node?: EnvironmentOptions;
     react?: EnvironmentOptions;
+    docusaurus?: EnvironmentOptions;
+    starlight?: EnvironmentOptions;
     tauri?: EnvironmentOptions;
     "vscode-extension"?: EnvironmentOptions;
     "cjs-override"?: ModuleOverrideOptions;
@@ -161,7 +163,7 @@ export type FlatConfig = {
     /**
      * - Glob patterns for files this config applies to
      */
-    files?: Array<string>;
+    files?: Array<string | string[]>;
     /**
      * - Glob patterns for files to ignore
      */

package/src/uglier.js

@@ -77,7 +77,7 @@
 /**
  * Available config block names
  *
- * @typedef {"lints-js" | "lints-jsdoc" | "languageOptions" | "web" | "node" | "react" | "tauri" | "vscode-extension" | "cjs-override" | "mjs-override"} ConfigName
+ * @typedef {"lints-js" | "lints-jsdoc" | "languageOptions" | "web" | "node" | "react" | "docusaurus" | "starlight" | "tauri" | "vscode-extension" | "cjs-override" | "mjs-override"} ConfigName
  */
 
 /**
@@ -141,7 +141,7 @@
 /**
  * Per-config options map
  *
- * @typedef {{"lints-js"?: LintsJsOptions, "lints-jsdoc"?: LintsJsdocOptions, languageOptions?: LanguageOptionsOptions, web?: EnvironmentOptions, node?: EnvironmentOptions, react?: EnvironmentOptions, tauri?: EnvironmentOptions, "vscode-extension"?: EnvironmentOptions, "cjs-override"?: ModuleOverrideOptions, "mjs-override"?: ModuleOverrideOptions}} PerConfigOptions
+ * @typedef {{"lints-js"?: LintsJsOptions, "lints-jsdoc"?: LintsJsdocOptions, languageOptions?: LanguageOptionsOptions, web?: EnvironmentOptions, node?: EnvironmentOptions, react?: EnvironmentOptions, docusaurus?: EnvironmentOptions, starlight?: EnvironmentOptions, tauri?: EnvironmentOptions, "vscode-extension"?: EnvironmentOptions, "cjs-override"?: ModuleOverrideOptions, "mjs-override"?: ModuleOverrideOptions}} PerConfigOptions
  */
 
 /**
@@ -158,7 +158,7 @@
  *
  * @typedef {object} FlatConfig
  * @property {string} [name] - Config name for debugging
- * @property {Array<string>} [files] - Glob patterns for files this config applies to
+ * @property {Array<string | string[]>} [files] - Glob patterns for files this config applies to
  * @property {Array<string>} [ignores] - Glob patterns for files to ignore
  * @property {{[pluginName: string]: object}} [plugins] - ESLint plugins
  * @property {{[ruleName: string]: RuleEntry}} [rules] - ESLint rules
@@ -167,6 +167,7 @@
  */
 
 import jsdoc from "eslint-plugin-jsdoc"
+import astro from "eslint-plugin-astro"
 import stylistic from "@stylistic/eslint-plugin"
 import globals from "globals"
 
@@ -174,7 +175,7 @@ import globals from "globals"
  * Registry of named configuration blocks.
  * Each config is a factory function that returns an ESLint flat config object.
  *
- * @type {{[K in ConfigName]: (options?: object) => FlatConfig}}
+ * @type {{[K in ConfigName]: (options?: object) => FlatConfig | Array<FlatConfig>}}
  */
 const CONFIGS = {
   /**
@@ -512,6 +513,63 @@ const CONFIGS = {
     }
   },
 
+  /**
+   * Docusaurus documentation site globals (browser + React + Docusaurus)
+   *
+   * @param {EnvironmentOptions} options - Configuration options
+   * @returns {FlatConfig} ESLint flat config object
+   */
+  "docusaurus": (options = {}) => {
+    const {
+      files = ["src/**/*.{js,jsx,mjs,cjs}", "docs/**/*.{js,jsx,mjs,cjs}"],
+      ignores = [],
+      additionalGlobals = {},
+    } = options
+
+    return {
+      name: "gesslar/uglier/docusaurus",
+      files: Array.isArray(files) ? files : [files],
+      ignores: Array.isArray(ignores) ? ignores : [ignores],
+      languageOptions: {
+        globals: {
+          ...globals.browser,
+          React: "readonly",
+          ReactDOM: "readonly",
+          ...additionalGlobals,
+        }
+      }
+    }
+  },
+
+  /**
+   * Starlight documentation site (browser + Astro + eslint-plugin-astro)
+   *
+   * @param {EnvironmentOptions} options - Configuration options
+   * @returns {Array<FlatConfig>} ESLint flat config array
+   */
+  "starlight": (options = {}) => {
+    const {
+      files = ["src/**/*.{js,mjs,cjs}", "docs/**/*.{js,mjs,cjs}"],
+      ignores = [],
+      additionalGlobals = {},
+    } = options
+
+    return [
+      ...astro.configs["flat/recommended"],
+      {
+        name: "gesslar/uglier/starlight",
+        files: Array.isArray(files) ? files : [files],
+        ignores: Array.isArray(ignores) ? ignores : [ignores],
+        languageOptions: {
+          globals: {
+            ...globals.browser,
+            ...additionalGlobals,
+          }
+        }
+      },
+    ]
+  },
+
   /**
    * Tauri application configuration (browser + Tauri APIs, no Node.js)
    *
@@ -570,7 +628,10 @@ export default function(options = {}) {
     const configOptions = perConfigOptions[configName] || {}
     const config = CONFIGS[configName](configOptions)
 
-    configs.push(config)
+    if(Array.isArray(config))
+      configs.push(...config)
+    else
+      configs.push(config)
   }
 
   return configs

package/UNLICENSE.txt

@@ -1,24 +0,0 @@
-This is free and unencumbered software released into the public domain.
-
-Anyone is free to copy, modify, publish, use, compile, sell, or
-distribute this software, either in source code form or as a compiled
-binary, for any purpose, commercial or non-commercial, and by any
-means.
-
-In jurisdictions that recognize copyright laws, the author or authors
-of this software dedicate any and all copyright interest in the
-software to the public domain. We make this dedication for the benefit
-of the public at large and to the detriment of our heirs and
-successors. We intend this dedication to be an overt act of
-relinquishment in perpetuity of all present and future rights to this
-software under copyright law.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
-OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
-ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-OTHER DEALINGS IN THE SOFTWARE.
-
-For more information, please refer to <https://unlicense.org>