feat: re-implement remark

.npmrc

@@ -10,4 +10,5 @@ public-hoist-pattern[]=*eslint*
 public-hoist-pattern[]=*knip*
 public-hoist-pattern[]=*mdat*
 public-hoist-pattern[]=*prettier*
+public-hoist-pattern[]=*remark*
 public-hoist-pattern[]=*stylelint*

.remarkrc.js

@@ -0,0 +1,3 @@
+import { remarkConfig } from '@envsa/remark-config';
+
+export default remarkConfig();

package.json

@@ -10,6 +10,8 @@
     "prettier-config",
     "browserslist-config",
     "typescript-config",
+    "remark-config",
+    "remark-lint",
     "github-actions",
     "cspell",
     "tsconfig",
@@ -52,6 +54,7 @@
     "@envsa/eslint-config": "workspace:*",
     "@envsa/mdat-config": "workspace:*",
     "@envsa/prettier-config": "workspace:*",
+    "@envsa/remark-config": "workspace:*",
     "@envsa/repo-config": "workspace:*",
     "@envsa/shared-config": "workspace:*",
     "@envsa/stylelint-config": "workspace:*",

packages/browserslist-config/readme.md

@@ -25,7 +25,7 @@ It's a shared [Browserslist](https://browsersl.ist) config.
 
 <!-- recommendation -->
 
-> \[!IMPORTANT]
+> [!IMPORTANT]
 >
 > **You can use this package on its own, but it's recommended to use [`@envsa/shared-config`](https://www.npmjs.com/package/@envsa/shared-config) instead for a single-dependency and single-package approach to linting and fixing your project.**
 >

packages/cspell-config/dictionaries/envsa-misc.txt

@@ -365,6 +365,8 @@ redactorcustomstyles
 relatedsub
 rella
 rellafella
+remarklint
+remarkrc
 renmark
 renxt
 retcon

packages/cspell-config/readme.md

@@ -25,7 +25,7 @@ It's a shared [CSpell](https://cspell.org) config, plus a command-line tool `env
 
 <!-- recommendation -->
 
-> \[!IMPORTANT]
+> [!IMPORTANT]
 >
 > **You can use this package on its own, but it's recommended to use [`@envsa/shared-config`](https://www.npmjs.com/package/@envsa/shared-config) instead for a single-dependency and single-package approach to linting and fixing your project.**
 >
@@ -52,7 +52,7 @@ To use just this CSpell config in isolation:
 3. Add the starter `.cspell.json` file to your project root, and add any customizations you'd like:
 
    ```sh
-   pnpm exec kpi-cspell init
+   pnpm exec envsa-cspell init
    ```
 
 ## Usage

packages/eslint-config/readme.md

@@ -25,7 +25,7 @@ It's a shared [ESLint](https://eslint.org) config, plus a command-line tool `env
 
 <!-- recommendation -->
 
-> \[!IMPORTANT]
+> [!IMPORTANT]
 >
 > **You can use this package on its own, but it's recommended to use [`@envsa/shared-config`](https://www.npmjs.com/package/@envsa/shared-config) instead for a single-dependency and single-package approach to linting and fixing your project.**
 >

packages/eslint-config/src/configs/json.ts

@@ -92,6 +92,7 @@ export async function json(options: OptionsOverrides = {}): Promise<TypedFlatCon
               'knip',
               'mdat',
               'prettier',
+              'remarkConfig',
               'stylelint',
             ]),
           },

packages/eslint-config/src/types.ts

@@ -37,7 +37,7 @@ export type OptionsConfig = {
   json?: OptionsOverrides;
 
   /**
-   * Enable linting for Markdown
+   * Enable linting for Markdown via Remark, and Markdown code snippets.
    * @default true
    */
   md?: OptionsOverrides & OptionsOverridesEmbeddedScripts;

packages/knip-config/readme.md

@@ -25,7 +25,7 @@ It's a shared [knip](https://knip.dev) config, plus a command-line tool `envsa-k
 
 <!-- recommendation -->
 
-> \[!IMPORTANT]
+> [!IMPORTANT]
 >
 > **You can use this package on its own, but it's recommended to use [`@envsa/shared-config`](https://www.npmjs.com/package/@envsa/shared-config) instead for a single-dependency and single-package approach to linting and fixing your project.**
 >

packages/knip-config/src/index.ts

@@ -13,6 +13,7 @@ const sharedKnipConfig: KnipConfig = {
     // Customized entries
     'src/{bin,lib,cli}/{index,cli,main}.{js,mjs,cjs,ts,mts,cts}!',
     'scripts/**/*.ts',
+    '.remarkrc.js',
     'cspell.config.js',
     'eslint.config.ts',
     'mdat.config.ts',
@@ -25,6 +26,7 @@ const sharedKnipConfig: KnipConfig = {
     '@envsa/knip-config',
     '@envsa/mdat-config',
     '@envsa/prettier-config',
+    '@envsa/remark-config',
     '@envsa/stylelint-config',
   ],
 };

packages/mdat-config/readme.md

@@ -25,7 +25,7 @@ It's a shared [MDAT (Markdown Autophagic Template)](https://github.com/kitschpat
 
 <!-- recommendation -->
 
-> \[!IMPORTANT]
+> [!IMPORTANT]
 >
 > **You can use this package on its own, but it's recommended to use [`@envsa/shared-config`](https://www.npmjs.com/package/@envsa/shared-config) instead for a single-dependency and single-package approach to linting and fixing your project.**
 >

packages/prettier-config/readme.md

@@ -25,7 +25,7 @@ It's a shared [Prettier](https://prettier.io) config, plus a command-line tool `
 
 <!-- recommendation -->
 
-> \[!IMPORTANT]
+> [!IMPORTANT]
 >
 > **You can use this package on its own, but it's recommended to use [`@envsa/shared-config`](https://www.npmjs.com/package/@envsa/shared-config) instead for a single-dependency and single-package approach to linting and fixing your project.**
 >

packages/prettier-config/src/index.ts

@@ -82,6 +82,7 @@ const sharedPrettierConfig: PrettierConfig = {
           'knip',
           'mdat',
           'prettier',
+          'remarkConfig',
           'stylelint',
         ]),
       },

packages/remark-config/init/.remarkrc.js

@@ -0,0 +1,3 @@
+import { remarkConfig } from '@envsa/remark-config';
+
+export default remarkConfig();

packages/remark-config/init/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["unifiedjs.vscode-mdx"]
+}

packages/remark-config/license.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023-2025 Liam Rella
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

packages/remark-config/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@envsa/remark-config",
+  "version": "5.0.5",
+  "description": "Markdown and MDX linting for @envsa/shared-config.",
+  "keywords": [
+    "shared-config",
+    "remark-config",
+    "remark-lint",
+    "remark",
+    "cli",
+    "envsa",
+    "envsa-remark"
+  ],
+  "homepage": "https://github.com/envsa/shared-config/tree/main/packages/remark-config",
+  "bugs": "https://github.com/envsa/shared-config/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/envsa/shared-config.git",
+    "directory": "packages/remark-config"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Liam Rella",
+    "url": "https://github.com/rellafella"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "envsa-remark": "bin/cli.js"
+  },
+  "files": [
+    "bin/*",
+    "dist/*",
+    "init/*"
+  ],
+  "scripts": {
+    "build": "tsc && ../../scripts/build.ts",
+    "cli": "node ./bin/cli.js",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@pinojs/json-colorizer": "^4.0.0",
+    "@types/mdast": "^4.0.4",
+    "cosmiconfig": "^9.0.0",
+    "execa": "^9.5.2",
+    "find-workspaces": "^0.3.1",
+    "fs-extra": "^11.3.0",
+    "mdast-util-to-markdown": "^2.1.2",
+    "prettier": "^3.5.0",
+    "remark-directive": "^3.0.1",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.0",
+    "remark-lint": "^10.0.1",
+    "remark-lint-checkbox-content-indent": "^5.0.1",
+    "remark-lint-fenced-code-flag": "^4.1.1",
+    "remark-lint-final-definition": "^4.0.2",
+    "remark-lint-first-heading-level": "^4.0.1",
+    "remark-lint-heading-increment": "^4.0.1",
+    "remark-lint-linebreak-style": "^4.0.1",
+    "remark-lint-maximum-heading-length": "^4.1.1",
+    "remark-lint-no-duplicate-defined-urls": "^3.0.1",
+    "remark-lint-no-duplicate-definitions": "^4.0.1",
+    "remark-lint-no-duplicate-headings": "^4.0.1",
+    "remark-lint-no-duplicate-headings-in-section": "^4.0.1",
+    "remark-lint-no-empty-url": "^4.0.1",
+    "remark-lint-no-file-name-articles": "^3.0.1",
+    "remark-lint-no-file-name-consecutive-dashes": "^3.0.1",
+    "remark-lint-no-file-name-irregular-characters": "^3.0.1",
+    "remark-lint-no-file-name-outer-dashes": "^3.0.1",
+    "remark-lint-no-heading-indent": "^5.0.1",
+    "remark-lint-no-heading-like-paragraph": "^4.0.1",
+    "remark-lint-no-multiple-toplevel-headings": "^4.0.1",
+    "remark-lint-no-paragraph-content-indent": "^5.0.1",
+    "remark-lint-no-reference-like-url": "^4.0.1",
+    "remark-lint-no-shell-dollars": "^4.0.1",
+    "remark-lint-no-shortcut-reference-image": "^4.0.1",
+    "remark-lint-no-shortcut-reference-link": "^4.0.1",
+    "remark-lint-no-tabs": "^4.0.1",
+    "remark-lint-no-undefined-references": "^5.0.1",
+    "remark-lint-no-unneeded-full-reference-image": "^4.0.1",
+    "remark-lint-no-unneeded-full-reference-link": "^4.0.1",
+    "remark-lint-no-unused-definitions": "^4.0.1",
+    "remark-lint-strikethrough-marker": "^3.0.1",
+    "remark-stringify": "^11.0.0",
+    "remark-validate-links": "^13.0.2",
+    "unified": "^11.0.5"
+  },
+  "engines": {
+    "node": ">=22.0.0",
+    "pnpm": ">=10.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}