@archpublicwebsite/eslint-config 1.0.7 → 1.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archpublicwebsite/eslint-config",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "author": "Archipelago International",
   "description": "Reusable ESLint flat config and git-hook toolkit for Archipelago projects",
   "type": "module",

package/tools/setup/install.mjs

@@ -3,6 +3,12 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'n
 import { join } from 'node:path'
 import { ensureVscodeSettings } from './vscode.mjs'
 
+const TAG = '[@archpublicwebsite/eslint-config]'
+
+function log(msg) {
+  console.log(`${TAG} ${msg}`)
+}
+
 function getProjectRoot() {
   const root = process.env.INIT_CWD || process.cwd()
   if (!existsSync(join(root, 'package.json')))
@@ -10,18 +16,67 @@ function getProjectRoot() {
   return root
 }
 
-function ensureDir(path) {
-  if (!existsSync(path))
-    mkdirSync(path, { recursive: true })
+function ensureDir(dirPath) {
+  if (!existsSync(dirPath))
+    mkdirSync(dirPath, { recursive: true })
 }
 
-function writeIfMissing(path, content) {
-  if (existsSync(path))
+function writeIfMissing(filePath, content) {
+  if (existsSync(filePath))
     return false
-  writeFileSync(path, content, 'utf8')
+  writeFileSync(filePath, content, 'utf8')
   return true
 }
 
+// ─── .editorconfig ──────────────────────────────────────────────────────────
+
+function ensureEditorConfig(projectRoot) {
+  const editorConfigPath = join(projectRoot, '.editorconfig')
+  const content = `# EditorConfig — consistent coding style across editors
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab
+`
+  if (writeIfMissing(editorConfigPath, content))
+    log('Created .editorconfig')
+}
+
+// ─── eslint.config.mjs ─────────────────────────────────────────────────────
+
+function ensureEslintConfig(projectRoot) {
+  const eslintConfigPath = join(projectRoot, 'eslint.config.mjs')
+  const content = `import { createArchipelagoConfig } from '@archpublicwebsite/eslint-config'
+
+export default createArchipelagoConfig({
+  name: 'project/overrides',
+  rules: {
+    // Add your project overrides here
+  },
+})
+`
+  if (writeIfMissing(eslintConfigPath, content))
+    log('Created eslint.config.mjs')
+}
+
+// ─── .prettierrc ────────────────────────────────────────────────────────────
+
 function ensurePrettierConfig(projectRoot) {
   const prettierPath = join(projectRoot, '.prettierrc')
   const defaults = {
@@ -36,6 +91,7 @@ function ensurePrettierConfig(projectRoot) {
 
   if (!existsSync(prettierPath)) {
     writeFileSync(prettierPath, `${JSON.stringify(defaults, null, 2)}\n`, 'utf8')
+    log('Created .prettierrc')
     return
   }
 
@@ -49,17 +105,14 @@ function ensurePrettierConfig(projectRoot) {
     if (typeof current.semi !== 'boolean')
       current.semi = false
     writeFileSync(prettierPath, `${JSON.stringify(current, null, 2)}\n`, 'utf8')
+    log('Updated .prettierrc')
   }
   catch {
     // Keep existing file untouched if it is not JSON.
   }
 }
 
-function ensureEslintConfig(projectRoot) {
-  const eslintConfigPath = join(projectRoot, 'eslint.config.mjs')
-  const content = `import { createArchipelagoConfig } from 'eslint-config'\n\nexport default createArchipelagoConfig({\n  name: 'project/overrides',\n  rules: {\n    // Add your project overrides here\n  },\n})\n`
-  writeIfMissing(eslintConfigPath, content)
-}
+// ─── .hooks ─────────────────────────────────────────────────────────────────
 
 function ensureHooks(projectRoot) {
   const hooksDir = join(projectRoot, '.hooks')
@@ -70,33 +123,38 @@ function ensureHooks(projectRoot) {
 set -euo pipefail
 
 cd "$(git rev-parse --show-toplevel)"
-node node_modules/eslint-config/tools/git-hooks/pre-commit.mjs
+node node_modules/@archpublicwebsite/eslint-config/tools/git-hooks/pre-commit.mjs
 `,
     'prepare-commit-msg': `#!/usr/bin/env bash
 set -euo pipefail
 
 cd "$(git rev-parse --show-toplevel)"
-node node_modules/eslint-config/tools/git-hooks/prepare-commit-msg.mjs "$@"
+node node_modules/@archpublicwebsite/eslint-config/tools/git-hooks/prepare-commit-msg.mjs "$@"
 `,
     'commit-msg': `#!/usr/bin/env bash
 set -euo pipefail
 
 cd "$(git rev-parse --show-toplevel)"
-node node_modules/eslint-config/tools/git-hooks/commit-msg.mjs "$1"
+node node_modules/@archpublicwebsite/eslint-config/tools/git-hooks/commit-msg.mjs "$1"
 `,
     'post-commit': `#!/usr/bin/env bash
 set -euo pipefail
 
 cd "$(git rev-parse --show-toplevel)"
-node node_modules/eslint-config/tools/git-hooks/post-commit.mjs
+node node_modules/@archpublicwebsite/eslint-config/tools/git-hooks/post-commit.mjs
 `,
   }
 
+  let created = false
   Object.entries(hooks).forEach(([name, content]) => {
-    const path = join(hooksDir, name)
-    if (writeIfMissing(path, content))
-      chmodSync(path, 0o755)
+    const hookPath = join(hooksDir, name)
+    if (writeIfMissing(hookPath, content)) {
+      chmodSync(hookPath, 0o755)
+      created = true
+    }
   })
+  if (created)
+    log('Created .hooks/ (pre-commit, prepare-commit-msg, commit-msg, post-commit)')
 }
 
 function ensureHooksPath(projectRoot) {
@@ -104,18 +162,20 @@ function ensureHooksPath(projectRoot) {
     return
   try {
     execSync('git config core.hooksPath .hooks', { cwd: projectRoot, stdio: 'ignore' })
+    log('Set git core.hooksPath → .hooks')
   }
   catch {
     // Ignore setup failures in non-git contexts.
   }
 }
 
+// ─── .vscode/extensions.json ────────────────────────────────────────────────
+
 function ensureVscodeExtensions(projectRoot) {
   const vscodeDir = join(projectRoot, '.vscode')
   const extPath = join(vscodeDir, 'extensions.json')
 
-  if (!existsSync(vscodeDir))
-    mkdirSync(vscodeDir, { recursive: true })
+  ensureDir(vscodeDir)
 
   const recommended = [
     'dbaeumer.vscode-eslint',
@@ -138,19 +198,27 @@ function ensureVscodeExtensions(projectRoot) {
   const merged = [...new Set([...current.recommendations, ...recommended])]
   current.recommendations = merged
   writeFileSync(extPath, `${JSON.stringify(current, null, 2)}\n`, 'utf8')
+  log('Created/updated .vscode/extensions.json')
 }
 
+// ─── main ───────────────────────────────────────────────────────────────────
+
 function main() {
   const projectRoot = getProjectRoot()
   if (!projectRoot)
     return
 
-  ensureHooks(projectRoot)
-  ensureHooksPath(projectRoot)
+  log('Setting up project...')
+
+  ensureEditorConfig(projectRoot)
   ensureEslintConfig(projectRoot)
   ensurePrettierConfig(projectRoot)
+  ensureHooks(projectRoot)
+  ensureHooksPath(projectRoot)
   ensureVscodeSettings(projectRoot)
   ensureVscodeExtensions(projectRoot)
+
+  log('Setup complete ✓')
 }
 
 main()

package/tools/setup/vscode.mjs

@@ -1,6 +1,8 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 
+const TAG = '[@archpublicwebsite/eslint-config]'
+
 /**
  * VS Code settings required for ESLint flat config to work properly.
  * These tell the ESLint extension to use flat config mode and validate
@@ -116,4 +118,5 @@ export function ensureVscodeSettings(projectRoot) {
 
   const merged = deepMerge(current, VSCODE_ESLINT_SETTINGS)
   writeFileSync(settingsPath, `${JSON.stringify(merged, null, 2)}\n`, 'utf8')
+  console.log(`${TAG} Created/updated .vscode/settings.json`)
 }