@kitschpatrol/shared-config 8.2.0 → 8.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/bin/cli.js +12 -12
  2. package/package.json +12 -12
  3. package/readme.md +9 -7
package/bin/cli.js CHANGED
@@ -1,13 +1,13 @@
1
1
  #!/usr/bin/env node
2
- import{cosmiconfig as e}from"cosmiconfig";import{TypeScriptLoader as t}from"cosmiconfig-typescript-loader";import{execa as n}from"execa";import r from"fs-extra";import i,{constants as a}from"node:fs";import o from"node:path";import{PassThrough as s,Transform as c}from"node:stream";import{fileURLToPath as l}from"node:url";import{packageUp as u,packageUpSync as d}from"package-up";import f from"picocolors";import p from"yargs";import{hideBin as m}from"yargs/helpers";import{stripVTControlCharacters as h}from"node:util";import g from"@pinojs/json-colorizer";import ee from"decircular";import te from"deepmerge";import ne from"json-stringify-pretty-compact";import{findWorkspaces as re,findWorkspacesRoot as ie}from"find-workspaces";import _,{access as ae}from"node:fs/promises";import{getDefaultConfigLoader as v,resolveConfigFileImports as y}from"cspell-lib";import{createReaderWriter as oe}from"cspell-config-lib";import{loadFile as se,writeFile as ce}from"magicast";import{getDefaultExportOptions as le}from"magicast/helpers";import{lint as ue}from"cspell";import"deepmerge-ts";import{loadConfig as de}from"mdat";import{globby as fe}from"globby";import b,{gt as x,minVersion as pe}from"semver";import{readWantedLockfile as me}from"@pnpm/lockfile.fs";import he from"stylelint";var ge=`8.2.0`;function S(e,t){let n=o.isAbsolute(e)?e:o.resolve(t,e),r=o.relative(process.cwd(),n);return r===``?`.`:r}const _e=/\s*\n\s*/gv,ve=/\r?\n/v;function ye(e){let t=e.message.replaceAll(_e,` `),n=e.rule===void 0?e.tool:`${e.tool}/${e.rule}`;return e.file===void 0?`${e.severity}: ${t} [${n}]`:`${e.file}:${e.line??1}:${e.column??1}: ${e.severity}: ${t} [${n}]`}function be(e,t){let n=(e.file??`￿`).localeCompare(t.file??`￿`);if(n!==0)return n;let r=(e.line??0)-(t.line??0);return r===0?(e.column??0)-(t.column??0):r}function xe(e,t){let n=t.toSorted(be);return{cwd:process.cwd(),diagnostics:n,success:e.every(e=>e.exitCode===0),summary:{errors:n.filter(e=>e.severity===`error`).length,infos:n.filter(e=>e.severity===`info`).length,warnings:n.filter(e=>e.severity===`warning`).length},tools:e,version:1}}function C(e){return h(e).split(ve).map(e=>e.trimEnd()).filter(e=>e.trim().length>0)}function Se(e){return e instanceof Error&&`exitCode`in e&&typeof e.exitCode==`number`}function w(e){return g(ne(ee(e),{indent:2,replacer(e,t){return typeof t==`function`?t.name:t}}),{colors:{BRACKET:`gray`}})}const Ce=(e,t,n)=>{let r=[...e];for(let[i,a]of t.entries())r[i]===void 0?r[i]=n.cloneUnlessOtherwiseSpecified(a,n):n.isMergeableObject(a)?r[i]=T(e[i],a,n):e.includes(a)||r.push(a);return r};function T(e,t,n={arrayMerge:Ce}){return te(e,t,n)}function we(e){let{tasks:t}=e;return Array.isArray(t)?t:[]}function Te(e,t){let n=[...we(e)];for(let e of we(t)){let t=n.findIndex(t=>t.label!==void 0&&t.label===e.label);t===-1?n.push(e):n[t]=e}return{...e,...t,tasks:n}}const E=[`json`,`machine`,`native`],Ee=E;function D(e){return typeof e==`string`&&E.includes(e)}function O(){let e=process.env.KSC_FORMAT;return D(e)?e:`native`}function De(){let{argv:e}=process;for(let[t,n]of e.entries()){let r;n===`--format`?r=e[t+1]:n.startsWith(`--format=`)&&(r=n.slice(9)),D(r)&&(process.env.KSC_FORMAT=r)}}function Oe(e,t){return e.startsWith(t+o.sep)}function k(){let e=A(),t=new Set([e]),n=re();if(n!==null)for(let r of n){let n=o.resolve(r.location);Oe(n,e)&&t.add(n)}return[...t]}function A(){let e=d();if(e===void 0)throw Error(`No package.json found.`);return o.dirname(e)}function ke(){return ie()!==null}function j(){let e=ie();return e===null?A():o.resolve(e.location)}function M(e){let t=o.join(j(),e);if(r.existsSync(t))return t}function N(e){if(e===`workspace-root`)return j();if(e===`package-dir`)return A();if(typeof e==`string`){if(!r.pathExistsSync(e))throw Error(`Custom cwd directory does not exist: ${e}`);return e}return process.cwd()}async function Ae(e,t){try{let{default:n}=await import(`prettier`),r=await n.resolveConfig(e),i=await n.format(t,{filepath:e,...r});await _.writeFile(e,i,`utf8`)}catch{console.warn(`Skipped formatting ${e} since Prettier is not installed.`)}}async function P(e){try{await Ae(e,await _.readFile(e,`utf8`))}catch{}}const je=/\r?\n/v;function Me(e){let t=``,n=t=>t.filter(t=>t.trim()!==``&&!e(h(t))).map(e=>`${e}\n`).join(``);return new c({flush(e){e(void 0,n([t]))},transform(e,r,i){let a=(t+e.toString()).split(je);t=a.pop()??``,i(void 0,n(a))}})}function F(e,t){let n=O()===`native`?e:void 0,r=n===void 0||n===``?``:t===void 0?n:f[t](n),i=``,a=e=>e.filter(e=>e.trim().length>0).map(e=>r===``?`${e}\n`:`${r} ${e}\n`).join(``);return new c({flush(e){e(void 0,a([i]))},transform(e,t,n){let r=(i+e.toString()).split(je);i=r.pop()??``,n(void 0,a(r))}})}async function Ne(e){let t=[];return new Promise((n,r)=>{e.on(`data`,e=>{t.push(e)}),e.on(`error`,e=>{r(e)}),e.on(`end`,()=>{n(Buffer.concat(t).toString(`utf8`))})})}function Pe(e){return e.replaceAll(/[A-Z\u{C0}-\u{D6}\u{D8}-\u{DE}]/gv,e=>`-`+e.toLowerCase())}function I(e,t){return t===1?e:e+`s`}async function L(e){return typeof e==`function`?e():e}async function Fe(e,t,n,r,i){let a;if(r.logPrefix===void 0)a=e;else{let t=F(r.logPrefix,r.logColor);t.pipe(e),a=t}i&&a.write(f.bold(`Running: "${r.name}() with Positional arguments: ${String(t)} and Option flags: ${String(n)}"`)+`
3
- `);try{return await r.execute(a,t,n)}catch(e){return console.error(String(e)),1}}function Ie(e,t,n,r){return[...e.subcommands??[],...e.receiveOptionFlags?n:[],...r??[],...e.receivePositionalArguments?t:[],...e.positionalArguments??[]]}async function Le(e,t,r,i,a){let o=1,c;if(i.logPrefix===void 0)c=e;else{let t=F(i.logPrefix,i.logColor);t.pipe(e),c=t}let l=Ie(i,t,r,i.optionFlags),u=N(i.cwdOverride);a&&c.write(`Running: "${i.name} ${l.join(` `)}"\n`);let d=i.prettyJsonOutput?new s:c,f=O()===`native`?process.env.NO_COLOR===void 0?{FORCE_COLOR:`true`}:{}:{NO_COLOR:`1`};try{let e=n(i.name,l,{cwd:u,env:{...f},preferLocal:!0,reject:!1,stdin:`inherit`});if(i.outputFilter){let t=Me(i.outputFilter),n=Me(i.outputFilter);e.stdout.pipe(t).pipe(d,{end:!1}),e.stderr.pipe(n).pipe(d,{end:!1})}else e.stdout.pipe(d,{end:!1}),e.stderr.pipe(d,{end:!1});if(await e,i.prettyJsonOutput){d.end();let e=await Ne(d),t=w(JSON.parse(e)).split(`
4
- `);for(let e of t)c.write(`${e}\n`)}o=e.exitCode??1}catch(e){console.error(`${i.name} failed with error:`),console.error(e),Se(e)&&(o=typeof e.exitCode==`number`?e.exitCode:1)}return o}function R(e){return`execute`in e}async function Re(e,t,r,i){let a=Ie(r,e,t,r.collect?.optionFlags??r.optionFlags),o=N(r.cwdOverride);try{let e=n(r.name,a,{cwd:o,env:{NO_COLOR:`1`},preferLocal:!0,reject:!1,stdin:`inherit`});i!==void 0&&e.stderr.pipe(i,{end:!1});let t=await e;return{cwd:o,exitCode:t.exitCode??1,stderr:t.stderr,stdout:t.stdout}}catch(e){return console.error(`${r.name} failed with error:`),console.error(e),{cwd:o,exitCode:Se(e)&&typeof e.exitCode==`number`?e.exitCode:1,stderr:``,stdout:``}}}function ze(e){return typeof e==`object`&&!!e&&`version`in e&&e.version===1&&`diagnostics`in e&&Array.isArray(e.diagnostics)&&`tools`in e&&Array.isArray(e.tools)}async function Be(e,t,n,r){let i=Date.now(),a=()=>Date.now()-i;if(R(r)){if(r.collect!==void 0)try{let{diagnostics:e,exitCode:i,unparsed:o}=await r.collect(t,n);return{diagnostics:e,exitCode:i,tools:[{durationMs:a(),exitCode:i,name:r.name,unparsed:o}]}}catch(e){return{diagnostics:[],exitCode:1,tools:[{durationMs:a(),exitCode:1,name:r.name,unparsed:[String(e)]}]}}let e=``,i=new s;i.on(`data`,t=>{e+=t.toString()});let o;try{o=await r.execute(i,t,n)}catch(t){e+=`\n${String(t)}`,o=1}return{diagnostics:[],exitCode:o,tools:[{durationMs:a(),exitCode:o,name:r.name,unparsed:C(e)}]}}if(r.outputFormatAware){let i=await Re(t,n,r,e);try{let e=JSON.parse(i.stdout);if(!ze(e))throw Error(`Child output is not a lint report`);return{diagnostics:e.diagnostics,exitCode:i.exitCode,tools:e.tools}}catch{return{diagnostics:[],exitCode:i.exitCode,tools:[{durationMs:a(),exitCode:i.exitCode,name:r.name,unparsed:C(i.stdout)}]}}}let o=await Re(t,n,r);if(r.collect!==void 0)try{let{diagnostics:e,unparsed:t}=r.collect.parse(o);return{diagnostics:e,exitCode:o.exitCode,tools:[{durationMs:a(),exitCode:o.exitCode,name:r.name,unparsed:t}]}}catch(e){return{diagnostics:[],exitCode:o.exitCode,tools:[{durationMs:a(),exitCode:o.exitCode,name:r.name,unparsed:[...C(o.stdout),...C(o.stderr),String(e)]}]}}return{diagnostics:[],exitCode:o.exitCode,tools:[{durationMs:a(),exitCode:o.exitCode,name:r.name,unparsed:[...C(o.stdout),...C(o.stderr)]}]}}const Ve=/^ksc-/v;function z(e){return e.replace(Ve,``)}function B(e){return e===void 0||e.length===0?[]:e.flatMap(e=>e.split(`,`)).map(e=>z(e.trim()))}function V(e){return e.option(`skip`,{array:!0,describe:`Tool names to skip (with or without "ksc-" prefix).`,type:`string`})}function He(e){return e.option(`format`,{choices:Ee,default:`native`,describe:`Output format: "native" streams each tool's own output, "machine" prints one parseable line per issue for editor problem matchers, "json" prints an aggregate report.`})}function Ue(e,t){return t===`native`||t===`machine`&&!R(e)&&e.outputFormatAware===!0}function We(e,t){for(let n of t.diagnostics)e.write(`${ye(n)}\n`);for(let n of t.tools)for(let t of n.unparsed)e.write(`${t}\n`)}function Ge(e,t,n){let r=[],i=[];for(let e of t)n.length>0&&n.includes(z(e.name))?i.push(e):r.push(e);if(n.length>0){let r=new Set(i.map(e=>z(e.name))),a=n.filter(e=>!r.has(e));if(a.length>0){let n=t.map(e=>z(e.name)).join(`, `);e.write(`⚠️ ${f.yellow(`Unrecognized --skip ${I(`value`,a.length)}: ${a.join(`, `)}. Available: ${n}`)}\n`)}}return{commandsToRun:r,skippedCommands:i}}async function H(e,t,n,r,i,a,o,s=`native`){let{commandsToRun:c,skippedCommands:l}=Ge(e,r,o??[]),u=[],d=[],p=[],m=s===`native`&&i;for(let r of c){if(Ue(r,s)){let i=await(R(r)?Fe(e,t,n,r,m):Le(e,t,n,r,m));u.push({exitCode:i,name:r.name});continue}let i=await Be(e,t,n,r);u.push({exitCode:i.exitCode,name:r.name}),d.push(...i.tools),p.push(...i.diagnostics),s===`machine`&&We(e,i)}let h=r.length;if(s===`native`&&l.length>0){let t=l.map(({name:e})=>e),n=f.bold(`${t.length} / ${h} ${I(`Command`,t.length)} Skipped:`);e.write(`⏭️ ${f.dim(n)} ${f.dim(t.join(`, `))}\n`)}if(s===`native`&&a){let t=u.filter(({exitCode:e})=>e===0).map(({name:e})=>e),n=u.filter(({exitCode:e})=>e!==0).map(({name:e})=>e);if(t.length>0){let n=f.bold(`${t.length} / ${h} ${I(`Command`,t.length)} Succeeded:`);e.write(`✅ ${f.green(n)} ${f.green(t.join(`, `))}\n`)}if(n.length>0){let t=f.bold(`${n.length} / ${h} ${I(`Command`,n.length)} Failed:`);e.write(`❌ ${f.red(t)} ${f.red(n.join(`, `))}\n`)}}return{exitCode:+!u.every(({exitCode:e})=>e===0),report:s===`json`?xe(d,p):void 0}}async function Ke(e,t,n,a){let s=await u();if(s===void 0)throw Error("The `init` command must be used in a directory with a package.json file");let c=await u({cwd:l(import.meta.url)});if(c===void 0)return e.write(`Error: The script being called was not in a package, weird.
5
- `),1;let d=o.join(o.dirname(c),`init`),f=o.dirname(s),p=(t===`file`||t===`package`)&&n!==void 0&&a!==void 0;try{if(p){let n=Object.keys(a)[0],i=r.readJsonSync(s);if(t===`package`){e.write(`Merging: \nPackage config key "${n}" → "${f}" (Because --location is set to "package")\n`);let t=T(i,a);r.writeJSONSync(s,t,{spaces:` `}),await P(s)}else n!==void 0&&Object.keys(i).includes(n)&&(e.write(`Deleting: \nPackage config key "${n}" in "${f}" (Because --location is set to "file")\n`),delete i[n],r.writeJSONSync(s,i,{spaces:` `}),await P(s))}if(!await r.pathExists(d))return 0;if((await r.readdir(d)).length===0)return e.write(`Source directory "${d}" is empty.\n`),0;e.write(`Adding initial configuration files from:\n"${d}" → "${f}"\n`),await r.copy(d,f,{async filter(a,s){let c=i.statSync(a).isFile(),l=i.existsSync(s);if(c){if(p&&t===`package`&&a.includes(n))return l?(e.write(`Deleting: \n"${a}" → "${s}" (Because --location is set to "package")\n`),r.removeSync(s)):e.write(`Skipping: \n"${a}" → "${s}" (Because --location is set to "package")\n`),!1;if(l&&(s.includes(`.vscode/`)||s.includes(`package.json`))&&o.extname(s)===`.json`){e.write(`Merging: \n"${a}" → "${s}"\n`);let t=r.readJSONSync(a),n=r.readJSONSync(s),i=s.endsWith(`.vscode/tasks.json`)?Te(n,t):T(n,t);return r.writeJSONSync(s,i,{spaces:` `}),await P(s),!1}return l?(e.write(`Overwriting: \n"${a}" → "${s}"\n`),await P(s),!0):(e.write(`Copying: \n"${a}" → "${s}"\n`),await P(s),!0)}return!0},overwrite:!0})}catch(e){return console.error(String(e)),1}return 0}async function qe(e){let{commands:{fix:t,init:n,lint:r,printConfig:i},description:a,logColor:o,logPrefix:s,name:c,showSummary:l,verbose:u}=e;De();let d=F(s,o);d.pipe(O()===`json`?process.stderr:process.stdout);let f=p(m(process.argv)).scriptName(c).usage(`$0 <command>`,a);n!==void 0&&f.command({builder(e){let t=n.locationOptionFlag?e.option(`location`,{choices:[`file`,`package`],default:`file`,describe:`Where to store the configuration.`,type:`string`}):e;return l?V(t):t},command:`init`,describe:n.description??`Initialize by copying starter config files to your project root${n.locationOptionFlag?` or to your package.json file.`:`.`}`,async handler(e){let t=n.locationOptionFlag?e.location:void 0,r=B(e.skip),{exitCode:i}=await H(d,[],t===void 0?[]:[`--location`,t],[{async execute(e,t,r){return Ke(e,r.at(1),n.configFile,n.configPackageJson)},name:`copyAndMergeInitFiles`},...n.commands??[]],void 0,void 0,r);process.exitCode=i}}),r!==void 0&&f.command({builder(e){let t=He(r.positionalArgumentMode===`none`?e:e.positional(`files`,{array:!0,...r.positionalArgumentDefault!==void 0&&{default:r.positionalArgumentDefault},describe:`Files or glob pattern to lint.`,type:`string`}));return l?V(t):t},command:r.positionalArgumentMode===`none`?`lint`:r.positionalArgumentMode===`optional`?`lint [files..]`:`lint <files..>`,describe:r.description,async handler(e){let t=e.files??[],n=B(e.skip),i=O(),{exitCode:a,report:o}=await H(d,t,[],await L(r.commands),u,l,n,i);o!==void 0&&process.stdout.write(`${JSON.stringify(o,void 0,` `)}\n`),process.exitCode=a}}),t!==void 0&&f.command({builder(e){let n=He(t.positionalArgumentMode===`none`?e:e.positional(`files`,{array:!0,...t.positionalArgumentDefault!==void 0&&{default:t.positionalArgumentDefault},describe:`Files or glob pattern to fix.`,type:`string`}));return l?V(n):n},command:t.positionalArgumentMode===`none`?`fix`:t.positionalArgumentMode===`optional`?`fix [files..]`:`fix <files..>`,describe:t.description,async handler(e){let n=e.files??[],r=B(e.skip),i=O(),{exitCode:a,report:o}=await H(d,n,[],await L(t.commands),void 0,void 0,r,i);o!==void 0&&process.stdout.write(`${JSON.stringify(o,void 0,` `)}\n`),process.exitCode=a}}),i!==void 0&&f.command({builder(e){let t=i.positionalArgumentMode===`none`?e:e.positional(`file`,{...i.positionalArgumentDefault!==void 0&&{default:i.positionalArgumentDefault},describe:`File or glob pattern to print configuration for.`,type:`string`});return l?V(t):t},command:i.positionalArgumentMode===`none`?`print-config`:i.positionalArgumentMode===`optional`?`print-config [file]`:`print-config <file>`,describe:i.description,async handler(e){let t=e.file??void 0,n=t===void 0?[]:[t],r=B(e.skip),{exitCode:a}=await H(d,n,[],await L(i.commands),u,l,r);process.exitCode=a}}),f.alias(`h`,`help`),f.version(ge),f.alias(`v`,`version`),f.help(),f.wrap(process.stdout.isTTY?Math.min(120,f.terminalWidth()):0),await f.parseAsync()}function U(e){return{async execute(t){let n=await W(e);if(n===void 0)return 1;let{config:r,filepath:i,isEmpty:a}=n;if(t.write(`Found ${e} configuration at "${i}"\n`),a)return t.write(`Configuration is empty.
6
- `),0;let o=w(r).split(`
7
- `);for(let e of o)t.write(`${e}\n`);return 0},name:`Cosmiconfig ${e}`}}async function W(n){let r=e(n,{loaders:{".ts":t()},searchStrategy:`project`});try{let e=await r.search();if(e===null){console.error(`No ${n} configuration found.`);return}return e}catch(e){console.error(`Error while searching for ${n} configuration:`,e);return}}const G={fileRun:`Matches files below the current working directory by default.`,monorepoRun:`In a monorepo, it will also run in all packages below the current working directory.`,monorepoSearch:`Searches up to the root of a monorepo if necessary.`,multiArgumentCaveat:`Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope.`,multiOptionCaveat:`Will use option flags where possible if provided, but some of the invoked tools will ignore them.`,optionalFileRun:`Package-scoped by default, file-scoped if a file argument is provided.`,packageRun:`Package-scoped.`,packageSearch:`Package-scoped.`},Je=/['\u{2019}\u{2018}]s$/v;async function K(e=[`.`]){let t=await v().searchForConfigFile(void 0);if(t===void 0)throw Error(`No CSpell configuration found.`);let{settings:n,url:r}=t;if(n.words===void 0||n.words.length===0)return{errors:0,filesChecked:0,unusedWords:[]};let i=[...n.words];delete n.words;let a=await ue(e,{config:{settings:n,url:r},progress:!1,unique:!0,wordsOnly:!0},{issue({text:e,uri:t}){i=i.filter(n=>n.toLowerCase()!==e.toLowerCase().replace(Je,``)||t===r.href)}});return{errors:a.errors,filesChecked:a.files,unusedWords:i}}const Ye=new Set([`.cjs`,`.cts`,`.js`,`.mjs`,`.mts`,`.ts`]);async function Xe(e=[`**/*`]){let t=await v().searchForConfigFile(void 0);if(t===void 0)throw Error(`No CSpell configuration found.`);let n=l(t.url),r=[...t.settings.words??[]];if(r.length===0)return;let{errors:i,filesChecked:a,unusedWords:o}=await K(e);if(a===0||i>0)throw Error(`Refusing to modify "${n}": CSpell checked ${a} files with ${i} errors, so word usage can't be determined. Check your file globs and configuration.`);let s=new Set(o),c=r.filter(e=>!s.has(e)),u=Ze([...new Set(c)]);return Qe(u,r)?{configFilePath:n,removedWords:[],reordered:!1}:(await $e(t.url,u),{configFilePath:n,removedWords:[...s],reordered:!Qe(u,c)})}function Ze(e){return e.toSorted((e,t)=>{let n=e.toLowerCase().localeCompare(t.toLowerCase());return n===0?e.localeCompare(t):n})}function Qe(e,t){return e.length===t.length&&e.every((e,n)=>e===t[n])}async function $e(e,t){let n=l(e),r=o.extname(n).toLowerCase();if(Ye.has(r)){let e=await se(n),r=le(e);r.words=t,await ce(e,n),await P(n);return}let i=oe(),a=await i.readConfig(e);if(a.readonly)throw Error(`CSpell configuration file "${n}" can't be modified automatically. Please update the words list manually.`);a.setValue(`words`,t),await i.writeConfig(a)}async function et(){let e=await v().searchForConfigFile(void 0);return e===void 0?void 0:l(e.url)}async function tt(){let e=await v().searchForConfigFile(void 0);if(e===void 0)throw Error(`No CSpell configuration found.`);let t=await y(e);return t.ignorePaths===void 0?``:Array.from(t.ignorePaths,e=>typeof e==`string`?e:e.glob).join(`,`)}const nt=/^(?<file>.+?):(?<line>\d+):(?<column>\d+) - (?<message>.+)$/v,rt=/ fix: \((?<suggestion>[^\)]+)\)$/v;function it(e){let t=[],n=[];for(let r of C(`${e.stdout}\n${e.stderr}`)){let i=nt.exec(r);if(i?.groups===void 0){n.push(r);continue}let{column:a,file:o,line:s,message:c}=i.groups,l=rt.exec(c??``),u=l?.groups?.suggestion;t.push({column:Number(a),file:S(o??``,e.cwd),line:Number(s),message:l===null?c??``:(c??``).slice(0,-l[0].length),...u!==void 0&&{suggestion:u},severity:`warning`,tool:`cspell`})}return{diagnostics:t,unparsed:n}}async function at(e,t){let{errors:n,filesChecked:r,unusedWords:i}=await K(t);if(n>0||r===0&&i.length>0){let t=F(`[Unused Words]`,`cyanBright`);return t.pipe(e),t.write(`Could not check for unused words: CSpell checked ${r} files with ${n} errors.\n`),1}if(i.length>0){let t=F(`[Unused Words]`,`cyanBright`);t.pipe(e);for(let e of i)t.write(`${e}\n`);return 1}return 0}async function ot(e){let{errors:t,filesChecked:n,unusedWords:r}=await K(e);if(t>0||n===0&&r.length>0)return{diagnostics:[{message:`Could not check for unused words: CSpell checked ${n} files with ${t} errors`,severity:`error`,tool:`unused-words`}],exitCode:1,unparsed:[]};let i=await et(),a=i===void 0?{}:{file:S(i,process.cwd())};return{diagnostics:r.map(e=>({...a,message:`Unused word in CSpell config "words" array: ${e}`,severity:`warning`,tool:`unused-words`})),exitCode:+(r.length>0),unparsed:[]}}async function st(e,t){let n=F(`[Words]`,`cyanBright`);n.pipe(e);let r=await Xe(t);if(r===void 0)return 0;for(let e of r.removedWords)n.write(`Removed unused word: ${e}\n`);return r.reordered&&n.write(`Sorted the "words" array alphabetically.
8
- `),0}async function ct(){let e=import.meta.resolve(`@kitschpatrol/cspell-config`),t=await u({cwd:o.dirname(l(e))});if(t===void 0)throw Error(`Could not find Case Police dictionary parent package.`);let n=o.join(o.dirname(t),`dictionaries`,`case-police.json`);try{await ae(n,a.F_OK)}catch{throw Error(`Case Police dictionary file "${n}" does not exist.`)}return n}const lt=/^(?<from>\S+) → (?<to>\S+)\s+(?<file>\S+):(?<line>\d+):(?<column>\d+)$/v;function ut(e){let t=[],n=[];for(let r of C(`${e.stdout}\n${e.stderr}`)){if(!r.includes(`→`))continue;let i=lt.exec(r);if(i?.groups===void 0){n.push(r);continue}let{column:a,file:o,from:s,line:c,to:l}=i.groups;t.push({column:Number(a),file:S(o??``,e.cwd),line:Number(c),message:`Case error: "${s}" should be "${l}"`,severity:`warning`,...l!==void 0&&{suggestion:l},tool:`case-police`})}return{diagnostics:t,unparsed:n}}async function dt(e){let t=await v().searchForConfigFile(void 0);if(t===void 0)throw Error(`No CSpell configuration found.`);e.write(`Found cspell readme configuration at "${l(t.url)}"\n`);let n=w(await y(t)).split(`
9
- `);for(let t of n)e.write(`${t}\n`);return 0}const ft={commands:{fix:{commands:[{execute:st,name:`words`}],description:`Remove unused words from the local CSpell configuration's "words" array and sort it alphabetically. ${G.fileRun}`,positionalArgumentDefault:`**/*`,positionalArgumentMode:`optional`},init:{configFile:`cspell.config.ts`,configPackageJson:{cspell:{import:`@kitschpatrol/cspell-config`}},locationOptionFlag:!0},lint:{async commands(){return[{collect:{parse:it},name:`cspell`,optionFlags:[`--quiet`],receivePositionalArguments:!0},{collect:ot,execute:at,name:`unused-words`},{collect:{parse:ut},logColor:`cyanBright`,logPrefix:`[Case Police]`,name:`case-police`,optionFlags:[`--dict`,await ct(),`--ignore`,await tt()],outputFilter:e=>!e.includes(`→`),receivePositionalArguments:!0}]},description:`Check for spelling mistakes. ${G.fileRun}`,positionalArgumentDefault:`**/*`,positionalArgumentMode:`optional`},printConfig:{commands:[{execute:dt,name:`cspell-config`}],description:`Print the resolved CSpell configuration. ${G.packageSearch} ${G.monorepoSearch}`,positionalArgumentMode:`none`}},description:`Kitschpatrol's CSpell shared configuration tools.`,logColor:`cyan`,logPrefix:`[CSpell]`,name:`ksc-cspell`,order:6};async function pt(e,t){let n,[r]=t;if(r===void 0)n=U(`eslint`);else{let t=o.join(process.cwd(),r);e.write(`Showing configuration for file: ${t}\n`),n={name:`eslint`,optionFlags:[`--print-config`],receivePositionalArguments:!0}}let{exitCode:i}=await H(e,t,[],[n]);return i}function mt(e){let t;try{t=JSON.parse(e.stdout)}catch{return{diagnostics:[],unparsed:[...C(e.stdout),...C(e.stderr)]}}let n=[];for(let r of t)for(let t of r.messages)n.push({column:t.column,endColumn:t.endColumn,endLine:t.endLine,file:S(r.filePath,e.cwd),line:t.line,message:t.message,rule:t.ruleId??void 0,severity:t.fatal===!0||t.severity===2?`error`:`warning`,tool:`eslint`});return{diagnostics:n,unparsed:C(e.stderr)}}const ht={commands:{fix:{commands:[{collect:{optionFlags:[`--fix`,`--format`,`json`],parse:mt},name:`eslint`,optionFlags:[`--fix`],receivePositionalArguments:!0}],description:`Fix your project with ESLint. ${G.fileRun}`,positionalArgumentDefault:`.`,positionalArgumentMode:`optional`},init:{locationOptionFlag:!1},lint:{commands:[{collect:{optionFlags:[`--max-warnings`,`0`,`--format`,`json`],parse:mt},name:`eslint`,optionFlags:[`--max-warnings`,`0`],receivePositionalArguments:!0}],description:`Lint your project with ESLint. ${G.fileRun}`,positionalArgumentDefault:`.`,positionalArgumentMode:`optional`},printConfig:{commands:[{execute:pt,name:`eslint-config`}],description:`Print the effective ESLint configuration. ${G.optionalFileRun} Use \`@eslint/config-inspector\` for a more detailed view.`,positionalArgumentMode:`optional`}},description:`Kitschpatrol's ESLint shared configuration tools.`,logColor:`magenta`,logPrefix:`[ESLint]`,name:`ksc-eslint`,order:4},gt={entry:[`{index,cli,main}.{js,mjs,cjs,jsx,ts,tsx,mts,cts}!`,`src/{index,cli,main}.{js,mjs,cjs,jsx,ts,tsx,mts,cts}!`,`src/{bin,lib,cli}/{index,cli,main}.{js,mjs,cjs,jsx,ts,tsx,mts,cts}!`,`scripts/**/*.{js,mjs,cjs,ts,mts,cts}`,`.remarkrc.{js,mjs,cjs,ts,mts,cts}`,`cspell.config.{js,mjs,cjs,ts,mts,cts}`,`eslint.config.{js,mjs,cjs,ts,mts,cts}`,`mdat.config.{js,mjs,cjs,ts,mts,cts}`,`prettier.config.{js,mjs,cjs,ts,mts,cts}`,`stylelint.config.{js,mjs,cjs,ts,mts,cts}`],ignoreBinaries:[`ksc-repo`,`ksc-mdat`,`ksc-typescript`,`ksc-eslint`,`ksc-stylelint`,`ksc-cspell`,`ksc-knip`,`ksc-remark`,`ksc-prettier`,`op`,`gh`],ignoreDependencies:[`@kitschpatrol/cspell-config`,`@kitschpatrol/dict-en-wiktionary`,`@kitschpatrol/eslint-config`,`@kitschpatrol/knip-config`,`@kitschpatrol/mdat-config`,`@kitschpatrol/prettier-config`,`@kitschpatrol/remark-config`,`@kitschpatrol/repo-config`,`@kitschpatrol/stylelint-config`,`@kitschpatrol/typescript-config`,`@prettier/plugin-php`,`@prettier/plugin-ruby`,`@prettier/plugin-xml`,`prettier-plugin-packagejson`,`prettier-plugin-sh`,`prettier-plugin-tailwindcss`,`prettier-plugin-toml`,`remark-attribute-list`,`remark-directive`]},_t={binaries:`Unlisted binary`,catalog:`Unused catalog entry`,classMembers:`Unused class member`,dependencies:`Unused dependency`,devDependencies:`Unused devDependency`,duplicates:`Duplicate export`,enumMembers:`Unused enum member`,exports:`Unused export`,files:`Unused file`,namespaceMembers:`Unused namespace member`,nsExports:`Unused namespace export`,nsTypes:`Unused namespace type`,optionalPeerDependencies:`Unused optional peer dependency`,types:`Unused exported type`,unlisted:`Unlisted dependency`,unresolved:`Unresolved import`};function vt(e){return Array.isArray(e)?e.flatMap(e=>Array.isArray(e)?e:[e]):[]}function yt(e){let t;try{t=JSON.parse(e.stdout)}catch{return{diagnostics:[],unparsed:[...C(e.stdout),...C(e.stderr)]}}let n=[],r=t.issues??[];for(let t of r){let r=S(t.file,e.cwd);for(let[e,i]of Object.entries(t)){let t=_t[e];if(t!==void 0)for(let a of vt(i)){let i=typeof a==`string`?a:a.name,o=typeof a==`string`?{}:{column:a.col,line:a.line};n.push({...o,file:r,message:e===`files`?t:`${t}: ${i}`,rule:e,severity:`warning`,tool:`knip`})}}}return{diagnostics:n,unparsed:C(e.stderr)}}function bt(){if(ke()){let e=A(),t=j();if(e!==t){let n=o.relative(t,e);if(n!==``)return[`--workspace`,n.split(o.sep).join(`/`)]}}return[]}function xt(){return{knip:gt}}const St={commands:{init:{configFile:`knip.config.ts`,configPackageJson:xt(),locationOptionFlag:!0},lint:{commands:[{collect:{optionFlags:[`--no-progress`,`--no-config-hints`,...bt(),`--reporter`,`json`],parse:yt},cwdOverride:`workspace-root`,name:`knip`,optionFlags:[`--no-progress`,`--no-config-hints`,...bt()]}],description:`Check for unused code and dependencies. ${G.packageRun} ${G.monorepoRun}`,positionalArgumentMode:`none`},printConfig:{commands:[U(`knip`)],description:`Print the effective Knip configuration. ${G.packageSearch} ${G.monorepoSearch}`,positionalArgumentMode:`none`}},description:`Kitschpatrol's Knip shared configuration tools.`,logColor:`cyan`,logPrefix:`[Knip]`,name:`ksc-knip`,order:7};async function Ct(){return(await W(`mdat`))?.filepath}async function wt(e){let t=`mdat`,n=await W(t);n!==void 0&&e.write(`Found ${t} readme configuration at "${n.filepath}"\n`);let r=w(await de({additionalConfig:await de()})).split(`
10
- `);for(let t of r)e.write(`${t}\n`);return 0}async function Tt(e){let t=k(),n=await Ct(),r=[];for(let i of t)r.push({cwdOverride:i,name:`mdat`,optionFlags:n===void 0||n===``?[`--format`]:[`--config`,n,`--format`],subcommands:[e]});return r}const Et={commands:{fix:{commands:await Tt(`expand`),description:`Expand all Mdat content placeholders in your readme.md file(s). ${G.packageRun} ${G.monorepoRun}`,positionalArgumentMode:`none`},init:{configFile:`mdat.config.ts`,configPackageJson:{mdat:{$import:`node_modules/@kitschpatrol/mdat-config/dist/index.js`}},locationOptionFlag:!0},lint:{commands:await Tt(`check`),description:`Validate that all Mdat content placeholders in your readme.md file(s) have been expanded and are up to date. ${G.packageRun} ${G.monorepoRun}`,positionalArgumentMode:`none`},printConfig:{commands:[{execute:wt,name:`mdat-config`}],description:`Print the effective Mdat configuration. ${G.packageSearch}. ${G.monorepoSearch}.`,positionalArgumentMode:`none`}},description:`Kitschpatrol's Mdat shared configuration tools.`,logColor:`green`,logPrefix:`[Mdat Config]`,name:`ksc-mdat`,order:2},Dt=/^\[warn\] (?<file>\S+)$/v,Ot=/^\[error\] (?<message>.+)$/v;function kt(e){let t=[],n=[];for(let r of C(`${e.stdout}\n${e.stderr}`)){let i=Dt.exec(r);if(i?.groups?.file!==void 0){t.push({file:S(i.groups.file,e.cwd),message:`File is not formatted with Prettier`,severity:`warning`,tool:`prettier`});continue}if(r.startsWith(`[warn] Code style issues found`))continue;let a=Ot.exec(r);if(a?.groups?.message!==void 0){t.push({message:a.groups.message,severity:`error`,tool:`prettier`});continue}n.push(r)}return{diagnostics:t,unparsed:n}}const At=[`--log-level=warn`,`--plugin=@kitschpatrol/prettier-plugin-astro`,`--plugin=@prettier/plugin-php`,`--plugin=@prettier/plugin-ruby`,`--plugin=@prettier/plugin-xml`,`--plugin=prettier-plugin-jsdoc`,`--plugin=prettier-plugin-packagejson`,`--plugin=prettier-plugin-sh`,`--plugin=prettier-plugin-svelte`,`--plugin=prettier-plugin-toml`,`--ignore-path=${M(`.gitignore`)??`.gitignore`}`,`--ignore-path=${M(`.prettierignore`)??`.prettierignore`}`],jt={commands:{fix:{commands:[{collect:{parse:kt},name:`prettier`,optionFlags:[...At,`--write`],receivePositionalArguments:!0}],description:`Format files according to your Prettier configuration. ${G.fileRun}`,positionalArgumentDefault:`.`,positionalArgumentMode:`optional`},init:{configFile:`prettier.config.ts`,configPackageJson:{prettier:`@kitschpatrol/prettier-config`},locationOptionFlag:!0},lint:{commands:[{collect:{parse:kt},name:`prettier`,optionFlags:[...At,`--check`],receivePositionalArguments:!0}],description:`Check that files are formatted according to your Prettier configuration. ${G.fileRun}`,positionalArgumentDefault:`.`,positionalArgumentMode:`optional`},printConfig:{commands:[U(`prettier`)],description:`Print the effective Prettier configuration. ${G.packageSearch}. ${G.monorepoSearch}.`,positionalArgumentMode:`none`}},description:`Kitschpatrol's Prettier shared configuration tools.`,logColor:`blue`,logPrefix:`[Prettier]`,name:`ksc-prettier`,order:9},Mt={commands:{init:{configFile:`.remarkrc.js`,configPackageJson:{remarkConfig:{plugins:[`@kitschpatrol/remark-config`]}},locationOptionFlag:!0},printConfig:{commands:[U(`remark`)],description:`Print the effective Remark configuration. ${G.packageSearch} ${G.monorepoSearch}`,positionalArgumentMode:`none`}},description:`Kitschpatrol's Remark and Remark Lint shared configuration tools. (Actual linting and fixing is managed through @kitschpatrol/eslint-config.)`,logColor:`blue`,logPrefix:`[remarklint]`,name:`ksc-remark`,order:8},Nt=[/Version 2\.0,?\s*January 2004/gv,/Version 1,?\s*February 1989/gv,/Version 2,?\s*June 1991/gv,/Version 3,?\s*29 June 2007/gv,/Version 2\.1,?\s*February 1999/gv,/Version 3,?\s*19 November 2007/gv,/Version 1\.0\s*-\s*August 17th,?\s*2003/gv,/Version 1\.1,?\s*March 2000/gv,/Version 1\.2,?\s*November 2002/gv,/Version 1\.3,?\s*3 November 2008/gv,/Version 1\.0\s*-\s*22 November 2005/gv,/Version 1\.1\s*-\s*26 February 2007/gv,/Version 2,?\s*December 2004/gv,/20 December 1996/gv,/December 20,?\s*1996/gv,/11 March 1996/gv,/28 March 2007/gv,/November 1,?\s*2008/gv,/August 1,?\s*2009/gv,/1 April 19\d{2}/gv,/Copyright \(c\) 2000-2006,?\s*The Perl Foundation/giv,/Copyright \(C\) (?:\d{4},?\s*)+Free Software Foundation/gv],Pt=[`node_modules/**`,`test/**`];function Ft(e){let t=e;for(let e of Nt)e.lastIndex=0,t=t.replace(e,e=>e.replaceAll(/\d/gv,`X`));return t}const It=/(\d{4})\s*-\s*(\d{4})/v,Lt=/(\d{4})/v;function Rt(e,t){let n=Ft(e),r=It,i=r.exec(n);if(i){let[,n,a]=i;if(Number(a)!==t){let a=`${n}-${t}`;return e.slice(0,i.index)+e.slice(i.index).replace(r,()=>a)}return e}let a=Lt,o=a.exec(n);if(o){let[,n]=o;if(Number(n)!==t){let r=`${n}-${t}`;return e.slice(0,o.index)+e.slice(o.index).replace(a,()=>r)}return e}return e}async function zt(e){let t=new Date().getFullYear(),n=await fe([`**/license.txt`,`**/license`,...Pt.map(e=>`!${e}`)],{caseSensitiveMatch:!1,cwd:A(),followSymbolicLinks:!1,gitignore:!0}),r=[];for(let i of n)try{let n=await _.readFile(i,`utf8`),a=Rt(n,t);a!==n&&(r.push(i),e&&await _.writeFile(i,a,`utf8`))}catch(e){console.error(`Failed to process ${i}:`,e)}return r}async function Bt(e,t=!1){let n=await zt(t);if(n.length>0){e.write(`${t?`Fixed`:`Found`} ${n.length} license ${I(`file`,n.length)} with outdated copyright year:\n`);for(let t of n)e.write(` - ${t}\n`);return+!t}return 0}async function Vt(e){return Bt(e,!1)}async function Ht(){let e=await zt(!1);return{diagnostics:e.map(e=>({file:S(e,A()),message:`License file has an outdated copyright year`,severity:`error`,tool:`copyright-year`})),exitCode:+(e.length>0),unparsed:[]}}async function Ut(e){return Bt(e,!0)}const q=`pnpm-lock.yaml`;function Wt(e){let t=j(),n=o.resolve(e);for(;;){if(r.existsSync(o.join(n,q)))return n;if(n===t)break;let e=o.dirname(n);if(e===n)break;n=e}}function Gt(e,t,n){let r=`${e}@${t}`;if(Object.hasOwn(n,r))return r;if(Object.hasOwn(n,t))return t}function Kt(e,t){return e===void 0||e===``?t===void 0||t===``?void 0:t:t===void 0||t===``||x(e,t)?e:t}async function qt(e){let t=Wt(e);if(t===void 0||t===``)throw Error(`${q} not found at or above "${e}".`);let n=o.join(t,q),r=await me(t,{ignoreIncompatible:!1});if(!r?.importers)throw Error(`Lockfile at "${n}" is unreadable or missing importers.`);let i=r.packages??{},a,s,c={},l={};function u(e,t){let n,r=new Set;function a(e,t){if(t.startsWith(`link:`))return;let o=Gt(e,t,i);if(o===void 0||o===``||r.has(o))return;r.add(o);let s=i[o];if(s===void 0)return;let c=s.engines?.node;if(c!==void 0&&c!==``){let e=pe(c)?.version;e!==void 0&&e!==``&&(n===void 0||n===``||x(e,n))&&(n=e)}if(s.dependencies)for(let[e,t]of Object.entries(s.dependencies))a(e,t)}return a(e,t),n}function d(e,t){for(let[n,r]of Object.entries(e)){let e=u(n,typeof r==`string`?r:r.version);if(e!==void 0&&e!==``){let r=t?l:c;r[e]??=new Set,r[e].add(n);let i=t?s:a;(i===void 0||i===``||x(e,i))&&(t?s=e:a=e)}}}let f=o.relative(t,e),p=f===``?`.`:f,m=r.importers[p];m!==void 0&&(m.dependencies&&d(m.dependencies,!1),m.devDependencies&&d(m.devDependencies,!0));let h=Kt(a,s),g=h===void 0?void 0:`>=${h}`;return{dependencies:a!==void 0&&a!==``?{topLevelCauses:[...c[a]??[]],version:`>=${a}`}:void 0,devDependencies:s!==void 0&&s!==``?{topLevelCauses:[...l[s]??[]],version:`>=${s}`}:void 0,lockfile:n,version:g}}function Jt(e){let t=e.devEngines;if(t?.runtime)return(Array.isArray(t.runtime)?t.runtime:[t.runtime]).find(e=>e.name===`node`)?.version}function Yt(e,t){let n=e.devEngines??{};if(n.runtime)if(Array.isArray(n.runtime)){let e=n.runtime.find(e=>e.name===`node`);e===void 0?n.runtime.push({name:`node`,version:t}):e.version=t}else n.runtime.name===`node`?n.runtime.version=t:n.runtime=[n.runtime,{name:`node`,version:t}];else n.runtime={name:`node`,version:t};e.devEngines=n}function Xt(e){let t=e.devEngines;if(t?.runtime){if(Array.isArray(t.runtime)){t.runtime=t.runtime.filter(e=>e.name!==`node`);let[e]=t.runtime;e===void 0?delete t.runtime:t.runtime.length===1&&(t.runtime=e)}else t.runtime.name===`node`&&delete t.runtime;Object.keys(t).length===0&&delete e.devEngines}}function J(e){return e.length===0?``:` (from ${e.join(`, `)})`}async function Zt(e,t){let n=o.join(t,`package.json`);if(!r.existsSync(n))return{issues:[],packageJsonPath:n};let i=r.readJsonSync(n),a=i.engines?.node,s=Jt(i),c=await qt(t),l=c.dependencies?.version,u=c.dependencies?.topLevelCauses??[],d=c.version,f=c.devDependencies?.topLevelCauses??[],p=[];if(l!==void 0)if(a===void 0){if(p.push(`Missing engines.node — suggest setting to "${l}"${J(u)}`),e){let e=i.engines??{};e.node=l,i.engines=e}}else{let t=b.minVersion(a),n=b.minVersion(l);t&&n&&b.lt(t,n)&&(p.push(`engines.node is "${a}" but production dependencies require at least "${l}"${J(u)}`),e&&(i.engines.node=l))}let m=(()=>{if(l!==void 0&&l!==``&&a!==void 0&&a!==``){let e=b.minVersion(l),t=b.minVersion(a);if(e&&t)return b.gt(e,t)?l:a}return l??a})(),h=m!==void 0&&m!==``?b.minVersion(m):void 0,g=d!==void 0&&d!==``?b.minVersion(d):void 0,ee=g&&h&&b.gt(g,h);if(d!==void 0&&ee)if(s===void 0)p.push(`devDependencies require a higher Node.js minimum (${d}) than engines.node (${m??`none`}) — suggest adding devEngines.runtime for node with version "${d}"${J(f)}`),e&&Yt(i,d);else{let t=b.minVersion(s);t&&b.lt(t,g)&&(p.push(`devEngines.runtime.version for node is "${s}" but all dependencies require at least "${d}"${J(f)}`),e&&Yt(i,d))}else if(s!==void 0){let t=b.minVersion(s);t&&h&&b.lte(t,h)&&(p.push(`devEngines.runtime.version for node is redundant (engines.node already covers the requirement) — suggest removing`),e&&Xt(i))}return e&&p.length>0&&(r.writeJsonSync(n,i,{spaces:` `}),await P(n)),{issues:p,packageJsonPath:n}}async function Y(e,t){let n=k(),r=0;for(let i of n){let{issues:n,packageJsonPath:a}=await Zt(t,i);if(n.length>0){e.write(`${t?`Fixed`:`Found`} ${n.length} Node.js version ${I(`issue`,n.length)} in ${a}:\n`);for(let t of n)e.write(` - ${t}\n`);t||(r=1)}}return r}async function Qt(){let e=k(),t=[];for(let n of e){let{issues:e,packageJsonPath:r}=await Zt(!1,n);for(let n of e)t.push({file:S(r,process.cwd()),message:n,severity:`error`,tool:`node-version`})}return{diagnostics:t,exitCode:+(t.length>0),unparsed:[]}}async function $t(e){let t=w(await qt(A())).split(`
11
- `);for(let n of t)e.write(`${n}\n`);return 0}async function en(e){return Y(e,!1)}async function tn(e){return Y(e,!0)}const nn={commands:{fix:{commands:[{execute:Ut,name:`copyright-year`},{execute:tn,name:`node-version`}],description:`Fix common issues like outdated copyright years in license files. ${G.packageRun} ${G.monorepoRun}`,positionalArgumentMode:`none`},init:{locationOptionFlag:!1},lint:{commands:[{collect:Ht,execute:Vt,name:`copyright-year`},{collect:Qt,execute:en,name:`node-version`}],description:`Check the repo for common issues. ${G.packageRun} ${G.monorepoRun}`,positionalArgumentMode:`none`},printConfig:{commands:[{execute:$t,name:`node-version`}],description:`Print minimum Node.js version constraints from the pnpm lockfile.`,positionalArgumentMode:`none`}},description:`Kitschpatrol's repository-related shared configuration tools.`,logColor:`gray`,logPrefix:`[Repo Config]`,name:`ksc-repo`,order:1},X=[`--ignore-path`,M(`.gitignore`)??`.gitignore`,`--allow-empty-input`],rn=`**/*.{${[`css`,`scss`,`sass`,`svelte`,`html`,`astro`,`tsx`,`jsx`,`php`,`vue`].join(`,`)}}`;function Z(e){let t;try{t=JSON.parse(e.stderr)}catch{return{diagnostics:[],unparsed:[...C(e.stdout),...C(e.stderr)]}}let n=[];for(let r of t){let t=S(r.source,e.cwd);for(let e of r.warnings){let r=e.rule===void 0?void 0:` (${e.rule})`,i=r!==void 0&&e.text.endsWith(r)?e.text.slice(0,-r.length):e.text;n.push({column:e.column,endColumn:e.endColumn,endLine:e.endLine,file:t,line:e.line,message:i,rule:e.rule,severity:e.severity===`warning`?`warning`:`error`,tool:`stylelint`})}let i=r.parseErrors??[];for(let e of i)n.push({column:e.column,file:t,line:e.line,message:e.text,rule:`parse-error`,severity:`error`,tool:`stylelint`})}return{diagnostics:n,unparsed:C(e.stdout)}}async function an(e,t){let n=`stylelint`,r=await W(n);if(r===void 0)return 1;let{filepath:i,isEmpty:a}=r;if(a)return e.write(`Configuration is empty.
12
- `),0;e.write(`Found ${n} configuration at "${i}"\n`);let s,[c]=t;c===void 0?s=N(`package-dir`):(s=o.join(process.cwd(),c),e.write(`Showing config for file at "${s}"\n`));let l=w(await he.resolveConfig(s)).split(`
13
- `);for(let t of l)e.write(`${t}\n`);return 0}const on={commands:{fix:{commands:[{collect:{optionFlags:[...X,`--fix`,`--formatter`,`json`],parse:Z},name:`stylelint`,optionFlags:[...X,`--fix`],receivePositionalArguments:!0}],description:`Fix your project with Stylelint. ${G.fileRun}`,positionalArgumentDefault:rn,positionalArgumentMode:`optional`},init:{configFile:`stylelint.config.js`,configPackageJson:{stylelint:{extends:`@kitschpatrol/stylelint-config`}},locationOptionFlag:!0},lint:{commands:[{collect:{optionFlags:[...X,`--formatter`,`json`],parse:Z},name:`stylelint`,optionFlags:X,receivePositionalArguments:!0}],description:`Lint your project with Stylelint. ${G.fileRun}`,positionalArgumentDefault:rn,positionalArgumentMode:`optional`},printConfig:{commands:[{execute:an,name:`stylelint-config`}],description:`Print the effective Stylelint configuration. ${G.optionalFileRun}.`,positionalArgumentMode:`optional`}},description:`Kitschpatrol's Stylelint shared configuration tools.`,logColor:`greenBright`,logPrefix:`[Stylelint]`,name:`ksc-stylelint`,order:5},sn=/^(?<file>.+?)\((?<line>\d+),(?<column>\d+)\): (?<severity>error|warning) (?<code>TS\d+): (?<message>.*)$/v,cn=/^(?<severity>error|warning) (?<code>TS\d+): (?<message>.*)$/v,ln=/^\s/v;function un(e){let t=[],n=[];for(let r of C(`${e.stdout}\n${e.stderr}`)){let i=sn.exec(r);if(i?.groups!==void 0){let{code:n,column:r,file:a,line:o,message:s,severity:c}=i.groups;t.push({column:Number(r),file:S(a??``,e.cwd),line:Number(o),message:s??``,rule:n,severity:c===`warning`?`warning`:`error`,tool:`tsc`});continue}let a=cn.exec(r);if(a?.groups!==void 0){let{code:e,message:n,severity:r}=a.groups;t.push({message:n??``,rule:e,severity:r===`warning`?`warning`:`error`,tool:`tsc`});continue}let o=t.at(-1);if(o!==void 0&&ln.test(r)){o.message+=`\n${r.trim()}`;continue}n.push(r)}return{diagnostics:t,unparsed:n}}async function dn(){let e=A(),t=await r.readJson(o.join(e,`package.json`));return new Set([...Object.keys(t.dependencies??{}),...Object.keys(t.devDependencies??{})])}async function fn(){let e=await dn(),t=e.has(`@astrojs/check`),n=e.has(`svelte-check`);if(t||n){let e=[];return t&&e.push({cwdOverride:`package-dir`,name:`astro`,subcommands:[`check`]}),n&&e.push({cwdOverride:`package-dir`,name:`svelte-check`,optionFlags:t?[]:[`--tsconfig`,`./tsconfig.json`]}),e}return[{collect:{parse:un},cwdOverride:`package-dir`,name:`tsc`,optionFlags:[`--noEmit`]}]}const Q=[ht,ft,St,Et,jt,Mt,nn,on,{commands:{init:{locationOptionFlag:!1},lint:{commands:fn,description:`Run type checking on your project. ${G.packageRun} ${G.monorepoRun}`,positionalArgumentMode:`none`},printConfig:{commands:[{name:`tsc`,optionFlags:[`--showConfig`],prettyJsonOutput:!0}],description:`Print the TypeScript configuration for the project. ${G.packageSearch} ${G.monorepoSearch}`,positionalArgumentMode:`none`}},description:`Kitschpatrol's TypeScript shared configuration tools.`,logColor:`blueBright`,logPrefix:`[TypeScript Config]`,name:`ksc-typescript`,order:3}];function $(e,t){t.sort((e,t)=>e.order-t.order);let n=[];for(let r of t)Object.keys(r.commands).includes(e)&&n.push({name:r.name,...e===`init`?{receiveOptionFlags:r.commands[e]?.locationOptionFlag??!1}:{receivePositionalArguments:r.commands[e]?.positionalArgumentMode!==`none`},...(e===`lint`||e===`fix`)&&{outputFormatAware:!0},subcommands:[Pe(e)]});return n}await qe({commands:{fix:{commands:$(`fix`,Q),description:`Fix your project with multiple tools in one go. ${G.multiArgumentCaveat}`,positionalArgumentMode:`optional`},init:{commands:$(`init`,Q),description:`Initialize configuration files for the entire suite of @kitschpatrol/shared-config tools. ${G.multiOptionCaveat}`,locationOptionFlag:!0},lint:{commands:$(`lint`,Q),description:`Lint your project with multiple tools in one go. ${G.multiArgumentCaveat}`,positionalArgumentMode:`optional`},printConfig:{commands:$(`printConfig`,Q),description:`Print aggregated tool configuration data. ${G.multiArgumentCaveat}`,positionalArgumentMode:`optional`}},description:`Run aggregated @kitschpatrol/shared-config commands.`,logColor:`yellow`,logPrefix:`🔬`,name:`ksc`,order:0,showSummary:!0,verbose:!0});export{};
2
+ import{cosmiconfig as e}from"cosmiconfig";import{TypeScriptLoader as t}from"cosmiconfig-typescript-loader";import{execa as n}from"execa";import r from"fs-extra";import i,{constants as a}from"node:fs";import{availableParallelism as o}from"node:os";import s from"node:path";import{PassThrough as c,Transform as l}from"node:stream";import{fileURLToPath as u}from"node:url";import{packageUp as d,packageUpSync as f}from"package-up";import p from"yargs";import{hideBin as m}from"yargs/helpers";import h from"picocolors";import{stripVTControlCharacters as g}from"node:util";import ee from"@pinojs/json-colorizer";import te from"decircular";import _ from"deepmerge";import v from"json-stringify-pretty-compact";import{findWorkspaces as ne,findWorkspacesRoot as re}from"find-workspaces";import y,{access as ie}from"node:fs/promises";import{getDefaultConfigLoader as b,resolveConfigFileImports as ae}from"cspell-lib";import{createReaderWriter as oe}from"cspell-config-lib";import{loadFile as se,writeFile as ce}from"magicast";import{getDefaultExportOptions as le}from"magicast/helpers";import{lint as ue}from"cspell";import"deepmerge-ts";import{loadConfig as de}from"mdat";import{globby as fe}from"globby";import x,{gt as S,minVersion as pe}from"semver";import{readWantedLockfile as me}from"@pnpm/lockfile.fs";import he from"stylelint";var ge=`8.3.0`;const _e=[`json`,`machine`,`native`],ve=_e;function ye(e){return typeof e==`string`&&_e.includes(e)}function C(){let e=process.env.KSC_FORMAT;return ye(e)?e:`native`}function be(){let{argv:e}=process;for(let[t,n]of e.entries()){let r;n===`--format`?r=e[t+1]:n.startsWith(`--format=`)&&(r=n.slice(9)),ye(r)&&(process.env.KSC_FORMAT=r)}}function xe(){let{env:e}=process;if(e.NO_COLOR!==void 0&&e.NO_COLOR!==``)return!1;if(e.FORCE_COLOR!==void 0)return e.FORCE_COLOR!==`0`&&e.FORCE_COLOR!==`false`;if(e.TERM===`dumb`)return!1}function w(e,{ciColor:t=!0}={}){let n=xe();return n===void 0?e.isTTY===!0||t&&!!process.env.CI:n}function T(){return C()===`json`?process.stderr:process.stdout}function E(){return C()===`machine`?h.createColors(!1):h.createColors(w(T()))}function Se(e){if(!e)return{FORCE_COLOR:`0`,NO_COLOR:`1`};let t=process.env.FORCE_COLOR;return t===void 0||t===``?{FORCE_COLOR:`1`}:{}}function D(e,t){let n=s.isAbsolute(e)?e:s.resolve(t,e),r=s.relative(process.cwd(),n);return r===``?`.`:r}const Ce=/\s*\n\s*/gv,we=/\r?\n/v;function Te(e){let t=e.message.replaceAll(Ce,` `),n=e.rule===void 0?e.tool:`${e.tool}/${e.rule}`;return e.file===void 0?`${e.severity}: ${t} [${n}]`:`${e.file}:${e.line??1}:${e.column??1}: ${e.severity}: ${t} [${n}]`}function Ee(e,t){let n=(e.file??`￿`).localeCompare(t.file??`￿`);if(n!==0)return n;let r=(e.line??0)-(t.line??0);return r===0?(e.column??0)-(t.column??0):r}function De(e,t){let n=t.toSorted(Ee);return{cwd:process.cwd(),diagnostics:n,success:e.every(e=>e.exitCode===0),summary:{errors:n.filter(e=>e.severity===`error`).length,infos:n.filter(e=>e.severity===`info`).length,warnings:n.filter(e=>e.severity===`warning`).length},tools:e,version:1}}function O(e){return g(e).split(we).map(e=>e.trimEnd()).filter(e=>e.trim().length>0)}function Oe(e){return e instanceof Error&&`exitCode`in e&&typeof e.exitCode==`number`}function k(e){return w(process.stdout,{ciColor:!1})?Ae(e):ke(e)}function ke(e){return v(te(e),{indent:2,replacer(e,t){return typeof t==`function`?t.name:t}})}function Ae(e){return ee(ke(e),{colors:{BRACKET:`gray`}})}const je=(e,t,n)=>{let r=[...e];for(let[i,a]of t.entries())r[i]===void 0?r[i]=n.cloneUnlessOtherwiseSpecified(a,n):n.isMergeableObject(a)?r[i]=A(e[i],a,n):e.includes(a)||r.push(a);return r};function A(e,t,n={arrayMerge:je}){return _(e,t,n)}function Me(e){let{tasks:t}=e;return Array.isArray(t)?t:[]}function Ne(e,t){let n=[...Me(e)];for(let e of Me(t)){let t=n.findIndex(t=>t.label!==void 0&&t.label===e.label);t===-1?n.push(e):n[t]=e}return{...e,...t,tasks:n}}function Pe(e,t){return e.startsWith(t+s.sep)}function j(){let e=M(),t=new Set([e]),n=ne();if(n!==null)for(let r of n){let n=s.resolve(r.location);Pe(n,e)&&t.add(n)}return[...t]}function M(){let e=f();if(e===void 0)throw Error(`No package.json found.`);return s.dirname(e)}function Fe(){return re()!==null}function N(){let e=re();return e===null?M():s.resolve(e.location)}function Ie(e){let t=s.join(N(),e);if(r.existsSync(t))return t}function P(e){if(e===`workspace-root`)return N();if(e===`package-dir`)return M();if(typeof e==`string`){if(!r.pathExistsSync(e))throw Error(`Custom cwd directory does not exist: ${e}`);return e}return process.cwd()}async function Le(e,t){try{let{default:n}=await import(`prettier`),r=await n.resolveConfig(e),i=await n.format(t,{filepath:e,...r});await y.writeFile(e,i,`utf8`)}catch{console.warn(`Skipped formatting ${e} since Prettier is not installed.`)}}async function F(e){try{await Le(e,await y.readFile(e,`utf8`))}catch{}}const Re=/\r?\n/v;function ze(e){let t=``,n=t=>t.filter(t=>t.trim()!==``&&!e(g(t))).map(e=>`${e}\n`).join(``);return new l({flush(e){e(void 0,n([t]))},transform(e,r,i){let a=(t+e.toString()).split(Re);t=a.pop()??``,i(void 0,n(a))}})}function I(e,t){let n=C()===`native`?e:void 0,r=n===void 0||n===``?``:t===void 0?n:E()[t](n),i=``,a=e=>e.filter(e=>e.trim().length>0).map(e=>r===``?`${e}\n`:`${r} ${e}\n`).join(``);return new l({flush(e){e(void 0,a([i]))},transform(e,t,n){let r=(i+e.toString()).split(Re);i=r.pop()??``,n(void 0,a(r))}})}async function Be(e){let t=[];return new Promise((n,r)=>{e.on(`data`,e=>{t.push(e)}),e.on(`error`,e=>{r(e)}),e.on(`end`,()=>{n(Buffer.concat(t).toString(`utf8`))})})}function Ve(e){return e.replaceAll(/[A-Z\u{C0}-\u{D6}\u{D8}-\u{DE}]/gv,e=>`-`+e.toLowerCase())}function L(e,t){return t===1?e:e+`s`}async function R(e){return typeof e==`function`?e():e}async function He(e,t,n,r,i){let a;if(r.logPrefix===void 0)a=e;else{let t=I(r.logPrefix,r.logColor);t.pipe(e),a=t}i&&a.write(E().bold(`Running: "${r.name}() with Positional arguments: ${String(t)} and Option flags: ${String(n)}"`)+`
3
+ `);try{return await r.execute(a,t,n)}catch(e){return console.error(String(e)),1}}function Ue(e,t,n,r,i){return[...e.subcommands??[],...e.receiveOptionFlags?n:[],...r??[],...i&&e.cache!==void 0?[...e.cache.flags,`--cache-location`,s.join(N(),`node_modules`,`.cache`,`ksc`,e.cache.name)]:[],...e.receivePositionalArguments?t:[],...e.positionalArguments??[]]}async function We(e,t,r,i,a,o){let s=1,l;if(i.logPrefix===void 0)l=e;else{let t=I(i.logPrefix,i.logColor);t.pipe(e),l=t}let u=Ue(i,t,r,i.optionFlags,a),d=P(i.cwdOverride);o&&l.write(`Running: "${i.name} ${u.join(` `)}"\n`);let f=i.prettyJsonOutput?new c:l,p=Se(C()===`native`&&i.prettyJsonOutput!==!0&&w(T()));try{let e=n(i.name,u,{cwd:d,env:{...p},preferLocal:!0,reject:!1,stdin:`inherit`});if(i.outputFilter){let t=ze(i.outputFilter),n=ze(i.outputFilter);e.stdout.pipe(t).pipe(f,{end:!1}),e.stderr.pipe(n).pipe(f,{end:!1})}else e.stdout.pipe(f,{end:!1}),e.stderr.pipe(f,{end:!1});let t=await e;if(i.prettyJsonOutput){f.end();let e=await Be(f),t=k(JSON.parse(e)).split(`
4
+ `);for(let e of t)l.write(`${e}\n`)}s=t.exitCode??1}catch(e){console.error(`${i.name} failed with error:`),console.error(e),Oe(e)&&(s=typeof e.exitCode==`number`?e.exitCode:1)}return s}function z(e){return`execute`in e}function B(e){return`kind`in e}async function Ge(e,t,r,i,a){let o=Ue(r,e,t,r.collect?.optionFlags??r.optionFlags,i),s=P(r.cwdOverride);try{let e=n(r.name,o,{cwd:s,env:Se(!1),preferLocal:!0,reject:!1,stdin:`inherit`});a!==void 0&&e.stderr.pipe(a,{end:!1});let t=await e;return{cwd:s,exitCode:t.exitCode??1,stderr:t.stderr,stdout:t.stdout}}catch(e){return console.error(`${r.name} failed with error:`),console.error(e),{cwd:s,exitCode:Oe(e)&&typeof e.exitCode==`number`?e.exitCode:1,stderr:``,stdout:``}}}function Ke(e){return typeof e==`object`&&!!e&&`version`in e&&e.version===1&&`diagnostics`in e&&Array.isArray(e.diagnostics)&&`tools`in e&&Array.isArray(e.tools)}async function qe(e,t,n,r,i){let a=Date.now(),o=()=>Date.now()-a;if(z(r)){if(r.collect!==void 0)try{let{diagnostics:e,exitCode:i,unparsed:a}=await r.collect(t,n);return{diagnostics:e,exitCode:i,tools:[{durationMs:o(),exitCode:i,name:r.name,unparsed:a}]}}catch(e){return{diagnostics:[],exitCode:1,tools:[{durationMs:o(),exitCode:1,name:r.name,unparsed:[String(e)]}]}}let e=``,i=new c;i.on(`data`,t=>{e+=t.toString()});let a;try{a=await r.execute(i,t,n)}catch(t){e+=`\n${String(t)}`,a=1}return{diagnostics:[],exitCode:a,tools:[{durationMs:o(),exitCode:a,name:r.name,unparsed:O(e)}]}}if(B(r))throw Error(`Command groups must be expanded before collection`);if(r.outputFormatAware){let a=await Ge(t,n,r,i,e);try{let e=JSON.parse(a.stdout);if(!Ke(e))throw Error(`Child output is not a lint report`);return{diagnostics:e.diagnostics,exitCode:a.exitCode,tools:e.tools}}catch{return{diagnostics:[],exitCode:a.exitCode,tools:[{durationMs:o(),exitCode:a.exitCode,name:r.name,unparsed:O(a.stdout)}]}}}let s=await Ge(t,n,r,i);if(r.collect!==void 0)try{let{diagnostics:e,unparsed:t}=r.collect.parse(s);return{diagnostics:e,exitCode:s.exitCode,tools:[{durationMs:o(),exitCode:s.exitCode,name:r.name,unparsed:t}]}}catch(e){return{diagnostics:[],exitCode:s.exitCode,tools:[{durationMs:o(),exitCode:s.exitCode,name:r.name,unparsed:[...O(s.stdout),...O(s.stderr),String(e)]}]}}return{diagnostics:[],exitCode:s.exitCode,tools:[{durationMs:o(),exitCode:s.exitCode,name:r.name,unparsed:[...O(s.stdout),...O(s.stderr)]}]}}const Je=/^ksc-/v;function V(e){return e.replace(Je,``)}function H(e){return e===void 0||e.length===0?[]:e.flatMap(e=>e.split(`,`)).map(e=>V(e.trim()))}function U(e){return e.option(`skip`,{array:!0,describe:`Tool names to skip (with or without "ksc-" prefix).`,type:`string`})}function Ye(e){return e.option(`format`,{choices:ve,default:`native`,describe:`Output format: "native" streams each tool's own output, "machine" prints one parseable line per issue for editor problem matchers, "json" prints an aggregate report.`})}function Xe(e){return e.option(`cache`,{boolean:!0,default:!0,describe:`Use tool-native caches stored below node_modules/.cache/ksc at the workspace root. Disable with --no-cache.`})}function Ze(e,t){return t===`native`||t===`machine`&&!z(e)&&!B(e)&&e.outputFormatAware===!0}function Qe(e,t){for(let n of t.diagnostics)e.write(`${Te(n)}\n`);for(let n of t.tools)for(let t of n.unparsed)e.write(`${t}\n`)}function $e(){return Math.min(4,o())}var et=class{concurrency;active=0;queue=[];constructor(e){this.concurrency=e}async run(e){this.active>=this.concurrency&&await new Promise(e=>{this.queue.push(e)}),this.active+=1;try{return await e()}finally{--this.active,this.queue.shift()?.()}}};async function tt(e){let t=e.cache??!1,n=e.concurrency??$e();if(!Number.isInteger(n)||n<1)throw Error(`Concurrency must be a positive integer.`);return t&&await r.ensureDir(s.join(N(),`node_modules`,`.cache`,`ksc`)),{cache:t,scheduler:new et(n)}}function nt(e,t){return e.positionalArgumentMode===`none`?[]:t.length>0?t:e.positionalArgumentDefault===void 0?[]:[e.positionalArgumentDefault]}function rt(e,t){if(t.logPrefix===void 0)return e;let n=I(t.logPrefix,t.logColor);return n.pipe(e),n}async function it(e,t){if(B(e)){if(t.nativeVerbose){let n=[e.subcommand,...t.positionalArguments].join(` `);t.logStream.write(`Running: "${e.name} ${n}"\n`)}let n=rt(t.logStream,e);try{let r=await at(await R(e.commands),{...t,logStream:n,nativeVerbose:e.verbose,positionalArguments:nt(e,t.positionalArguments)},e.parallel===!0);return{diagnostics:r.flatMap(({diagnostics:e})=>e),exitCode:+!r.every(({exitCode:e})=>e===0),machineOutcomes:r.flatMap(({machineOutcomes:e})=>e),name:e.name,tools:r.flatMap(({tools:e})=>e)}}catch(r){let i=String(r),a={durationMs:0,exitCode:1,name:e.name,unparsed:[i]};return t.format===`native`&&n.write(`${i}\n`),{diagnostics:[],exitCode:1,machineOutcomes:[{diagnostics:[],exitCode:1,tools:[a]}],name:e.name,tools:[a]}}}return t.scheduler.run(async()=>{if(Ze(e,t.format))return{diagnostics:[],exitCode:await(z(e)?He(t.logStream,t.positionalArguments,t.optionFlags,e,t.nativeVerbose):We(t.logStream,t.positionalArguments,t.optionFlags,e,t.cache,t.nativeVerbose)),machineOutcomes:[],name:e.name,tools:[]};let n=await qe(t.logStream,t.positionalArguments,t.optionFlags,e,t.cache);return{diagnostics:n.diagnostics,exitCode:n.exitCode,machineOutcomes:[n],name:e.name,tools:n.tools}})}async function at(e,t,n){if(!n||t.scheduler.concurrency===1){let n=[];for(let r of e)n.push(await it(r,t));return n}await Promise.resolve();let r=new Map;for(let[t,n]of e.entries()){let e=n.stage??0,i=r.get(e)??[];i.push({command:n,index:t}),r.set(e,i)}let i=Array.from({length:e.length}),a=r.keys().toArray().toSorted((e,t)=>e-t);for(let e of a){let n=r.get(e)??[],a=await Promise.all(n.map(async({command:e,index:n})=>({index:n,outcome:await it(e,t)})));for(let{index:e,outcome:t}of a)i[e]=t}return i.filter(e=>e!==void 0)}function ot(e,t,n){let r=[],i=[];for(let e of t)n.length>0&&n.includes(V(e.name))?i.push(e):r.push(e);if(n.length>0){let r=new Set(i.map(e=>V(e.name))),a=n.filter(e=>!r.has(e));if(a.length>0){let n=t.map(e=>V(e.name)).join(`, `);e.write(`⚠️ ${E().yellow(`Unrecognized --skip ${L(`value`,a.length)}: ${a.join(`, `)}. Available: ${n}`)}\n`)}}return{commandsToRun:r,skippedCommands:i}}async function W(e,t,n,r,i,a,o,s=`native`){let c=typeof s==`string`?{}:s,l=typeof s==`string`?s:c.format??`native`,{commandsToRun:u,skippedCommands:d}=ot(e,r,o??[]),f=l===`native`&&i,{cache:p,scheduler:m}=await tt(c),h=await at(u,{cache:p,format:l,logStream:e,nativeVerbose:f,optionFlags:n,positionalArguments:t,scheduler:m},c.parallel===!0),g=h.map(({exitCode:e,name:t})=>({exitCode:e,name:t})),ee=h.flatMap(({tools:e})=>e),te=h.flatMap(({diagnostics:e})=>e);if(l===`machine`)for(let t of h)for(let n of t.machineOutcomes)Qe(e,n);let _=r.length,v=E();if(l===`native`&&d.length>0){let t=d.map(({name:e})=>e),n=v.bold(`${t.length} / ${_} ${L(`Command`,t.length)} Skipped:`);e.write(`⏭️ ${v.dim(n)} ${v.dim(t.join(`, `))}\n`)}if(l===`native`&&a){let t=g.filter(({exitCode:e})=>e===0).map(({name:e})=>e),n=g.filter(({exitCode:e})=>e!==0).map(({name:e})=>e);if(t.length>0){let n=v.bold(`${t.length} / ${_} ${L(`Command`,t.length)} Succeeded:`);e.write(`✅ ${v.green(n)} ${v.green(t.join(`, `))}\n`)}if(n.length>0){let t=v.bold(`${n.length} / ${_} ${L(`Command`,n.length)} Failed:`);e.write(`❌ ${v.red(t)} ${v.red(n.join(`, `))}\n`)}}return{exitCode:+!g.every(({exitCode:e})=>e===0),report:l===`json`?De(ee,te):void 0}}async function st(e,t,n,a){let o=await d();if(o===void 0)throw Error("The `init` command must be used in a directory with a package.json file");let c=await d({cwd:u(import.meta.url)});if(c===void 0)return e.write(`Error: The script being called was not in a package, weird.
5
+ `),1;let l=s.join(s.dirname(c),`init`),f=s.dirname(o),p=(t===`file`||t===`package`)&&n!==void 0&&a!==void 0;try{if(p){let n=Object.keys(a)[0],i=r.readJsonSync(o);if(t===`package`){e.write(`Merging: \nPackage config key "${n}" → "${f}" (Because --location is set to "package")\n`);let t=A(i,a);r.writeJSONSync(o,t,{spaces:` `}),await F(o)}else n!==void 0&&Object.keys(i).includes(n)&&(e.write(`Deleting: \nPackage config key "${n}" in "${f}" (Because --location is set to "file")\n`),delete i[n],r.writeJSONSync(o,i,{spaces:` `}),await F(o))}if(!await r.pathExists(l))return 0;if((await r.readdir(l)).length===0)return e.write(`Source directory "${l}" is empty.\n`),0;e.write(`Adding initial configuration files from:\n"${l}" → "${f}"\n`),await r.copy(l,f,{async filter(a,o){let c=i.statSync(a).isFile(),l=i.existsSync(o);if(c){if(p&&t===`package`&&a.includes(n))return l?(e.write(`Deleting: \n"${a}" → "${o}" (Because --location is set to "package")\n`),r.removeSync(o)):e.write(`Skipping: \n"${a}" → "${o}" (Because --location is set to "package")\n`),!1;if(l&&(o.includes(`.vscode/`)||o.includes(`package.json`))&&s.extname(o)===`.json`){e.write(`Merging: \n"${a}" → "${o}"\n`);let t=r.readJSONSync(a),n=r.readJSONSync(o),i=o.endsWith(`.vscode/tasks.json`)?Ne(n,t):A(n,t);return r.writeJSONSync(o,i,{spaces:` `}),await F(o),!1}return l?(e.write(`Overwriting: \n"${a}" → "${o}"\n`),await F(o),!0):(e.write(`Copying: \n"${a}" → "${o}"\n`),await F(o),!0)}return!0},overwrite:!0})}catch(e){return console.error(String(e)),1}return 0}async function ct(e){let{commands:{fix:t,init:n,lint:r,printConfig:i},description:a,logColor:o,logPrefix:s,name:c,showSummary:l,verbose:u}=e;be();let d=I(s,o);d.pipe(T());let f=p(m(process.argv)).scriptName(c).usage(`$0 <command>`,a);n!==void 0&&f.command({builder(e){let t=n.locationOptionFlag?e.option(`location`,{choices:[`file`,`package`],default:`file`,describe:`Where to store the configuration.`,type:`string`}):e;return l?U(t):t},command:`init`,describe:n.description??`Initialize by copying starter config files to your project root${n.locationOptionFlag?` or to your package.json file.`:`.`}`,async handler(e){let t=n.locationOptionFlag?e.location:void 0,r=H(e.skip),{exitCode:i}=await W(d,[],t===void 0?[]:[`--location`,t],[{async execute(e,t,r){return st(e,r.at(1),n.configFile,n.configPackageJson)},name:`copyAndMergeInitFiles`},...n.commands??[]],void 0,void 0,r);process.exitCode=i}}),r!==void 0&&f.command({builder(e){let t=Xe(Ye(r.positionalArgumentMode===`none`?e:e.positional(`files`,{array:!0,...r.positionalArgumentDefault!==void 0&&{default:r.positionalArgumentDefault},describe:`Files or glob pattern to lint.`,type:`string`})));return l?U(t):t},command:r.positionalArgumentMode===`none`?`lint`:r.positionalArgumentMode===`optional`?`lint [files..]`:`lint <files..>`,describe:r.description,async handler(e){let t=e.files??[],n=H(e.skip),i=C(),{exitCode:a,report:o}=await W(d,t,[],await R(r.commands),u,l,n,{cache:e.cache,format:i,parallel:r.parallel});o!==void 0&&process.stdout.write(`${k(o)}\n`),process.exitCode=a}}),t!==void 0&&f.command({builder(e){let n=Xe(Ye(t.positionalArgumentMode===`none`?e:e.positional(`files`,{array:!0,...t.positionalArgumentDefault!==void 0&&{default:t.positionalArgumentDefault},describe:`Files or glob pattern to fix.`,type:`string`})));return l?U(n):n},command:t.positionalArgumentMode===`none`?`fix`:t.positionalArgumentMode===`optional`?`fix [files..]`:`fix <files..>`,describe:t.description,async handler(e){let n=e.files??[],r=H(e.skip),i=C(),{exitCode:a,report:o}=await W(d,n,[],await R(t.commands),void 0,void 0,r,{cache:e.cache,format:i,parallel:t.parallel});o!==void 0&&process.stdout.write(`${k(o)}\n`),process.exitCode=a}}),i!==void 0&&f.command({builder(e){let t=i.positionalArgumentMode===`none`?e:e.positional(`file`,{...i.positionalArgumentDefault!==void 0&&{default:i.positionalArgumentDefault},describe:`File or glob pattern to print configuration for.`,type:`string`});return l?U(t):t},command:i.positionalArgumentMode===`none`?`print-config`:i.positionalArgumentMode===`optional`?`print-config [file]`:`print-config <file>`,describe:i.description,async handler(e){let t=e.file??void 0,n=t===void 0?[]:[t],r=H(e.skip),{exitCode:a}=await W(d,n,[],await R(i.commands),u,l,r);process.exitCode=a}}),f.alias(`h`,`help`),f.version(ge),f.alias(`v`,`version`),f.help(),f.wrap(process.stdout.isTTY?Math.min(120,f.terminalWidth()):0),await f.parseAsync()}function G(e){return{async execute(t){let n=await K(e);if(n===void 0)return 1;let{config:r,filepath:i,isEmpty:a}=n;if(t.write(`Found ${e} configuration at "${i}"\n`),a)return t.write(`Configuration is empty.
6
+ `),0;let o=k(r).split(`
7
+ `);for(let e of o)t.write(`${e}\n`);return 0},name:`Cosmiconfig ${e}`}}async function K(n){let r=e(n,{loaders:{".ts":t()},searchStrategy:`project`});try{let e=await r.search();if(e===null){console.error(`No ${n} configuration found.`);return}return e}catch(e){console.error(`Error while searching for ${n} configuration:`,e);return}}const q={fileRun:`Matches files below the current working directory by default.`,monorepoRun:`In a monorepo, it will also run in all packages below the current working directory.`,monorepoSearch:`Searches up to the root of a monorepo if necessary.`,multiArgumentCaveat:`Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope.`,multiOptionCaveat:`Will use option flags where possible if provided, but some of the invoked tools will ignore them.`,optionalFileRun:`Package-scoped by default, file-scoped if a file argument is provided.`,packageRun:`Package-scoped.`,packageSearch:`Package-scoped.`},lt=/['\u{2019}\u{2018}]s$/v;async function J(e=[`.`]){let t=await b().searchForConfigFile(void 0);if(t===void 0)throw Error(`No CSpell configuration found.`);let{settings:n,url:r}=t;if(n.words===void 0||n.words.length===0)return{errors:0,filesChecked:0,unusedWords:[]};let i=[...n.words];delete n.words;let a=await ue(e,{config:{settings:n,url:r},progress:!1,unique:!0,wordsOnly:!0},{issue({text:e,uri:t}){i=i.filter(n=>n.toLowerCase()!==e.toLowerCase().replace(lt,``)||t===r.href)}});return{errors:a.errors,filesChecked:a.files,unusedWords:i}}const ut=new Set([`.cjs`,`.cts`,`.js`,`.mjs`,`.mts`,`.ts`]);async function dt(e=[`**/*`]){let t=await b().searchForConfigFile(void 0);if(t===void 0)throw Error(`No CSpell configuration found.`);let n=u(t.url),r=[...t.settings.words??[]];if(r.length===0)return;let{errors:i,filesChecked:a,unusedWords:o}=await J(e);if(a===0||i>0)throw Error(`Refusing to modify "${n}": CSpell checked ${a} files with ${i} errors, so word usage can't be determined. Check your file globs and configuration.`);let s=new Set(o),c=r.filter(e=>!s.has(e)),l=ft([...new Set(c)]);return pt(l,r)?{configFilePath:n,removedWords:[],reordered:!1}:(await mt(t.url,l),{configFilePath:n,removedWords:[...s],reordered:!pt(l,c)})}function ft(e){return e.toSorted((e,t)=>{let n=e.toLowerCase().localeCompare(t.toLowerCase());return n===0?e.localeCompare(t):n})}function pt(e,t){return e.length===t.length&&e.every((e,n)=>e===t[n])}async function mt(e,t){let n=u(e),r=s.extname(n).toLowerCase();if(ut.has(r)){let e=await se(n),r=le(e);r.words=t,await ce(e,n),await F(n);return}let i=oe(),a=await i.readConfig(e);if(a.readonly)throw Error(`CSpell configuration file "${n}" can't be modified automatically. Please update the words list manually.`);a.setValue(`words`,t),await i.writeConfig(a)}async function ht(){let e=await b().searchForConfigFile(void 0);return e===void 0?void 0:u(e.url)}async function gt(){let e=await b().searchForConfigFile(void 0);if(e===void 0)throw Error(`No CSpell configuration found.`);let t=await ae(e);return t.ignorePaths===void 0?``:Array.from(t.ignorePaths,e=>typeof e==`string`?e:e.glob).join(`,`)}const _t=/^(?<file>.+?):(?<line>\d+):(?<column>\d+) - (?<message>.+)$/v,vt=/ fix: \((?<suggestion>[^\)]+)\)$/v;function yt(e){let t=[],n=[];for(let r of O(`${e.stdout}\n${e.stderr}`)){let i=_t.exec(r);if(i?.groups===void 0){n.push(r);continue}let{column:a,file:o,line:s,message:c}=i.groups,l=vt.exec(c??``),u=l?.groups?.suggestion;t.push({column:Number(a),file:D(o??``,e.cwd),line:Number(s),message:l===null?c??``:(c??``).slice(0,-l[0].length),...u!==void 0&&{suggestion:u},severity:`warning`,tool:`cspell`})}return{diagnostics:t,unparsed:n}}async function bt(e,t){let{errors:n,filesChecked:r,unusedWords:i}=await J(t);if(n>0||r===0&&i.length>0){let t=I(`[Unused Words]`,`cyanBright`);return t.pipe(e),t.write(`Could not check for unused words: CSpell checked ${r} files with ${n} errors.\n`),1}if(i.length>0){let t=I(`[Unused Words]`,`cyanBright`);t.pipe(e);for(let e of i)t.write(`${e}\n`);return 1}return 0}async function xt(e){let{errors:t,filesChecked:n,unusedWords:r}=await J(e);if(t>0||n===0&&r.length>0)return{diagnostics:[{message:`Could not check for unused words: CSpell checked ${n} files with ${t} errors`,severity:`error`,tool:`unused-words`}],exitCode:1,unparsed:[]};let i=await ht(),a=i===void 0?{}:{file:D(i,process.cwd())};return{diagnostics:r.map(e=>({...a,message:`Unused word in CSpell config "words" array: ${e}`,severity:`warning`,tool:`unused-words`})),exitCode:+(r.length>0),unparsed:[]}}async function St(e,t){let n=I(`[Words]`,`cyanBright`);n.pipe(e);let r=await dt(t);if(r===void 0)return 0;for(let e of r.removedWords)n.write(`Removed unused word: ${e}\n`);return r.reordered&&n.write(`Sorted the "words" array alphabetically.
8
+ `),0}async function Ct(){let e=import.meta.resolve(`@kitschpatrol/cspell-config`),t=await d({cwd:s.dirname(u(e))});if(t===void 0)throw Error(`Could not find Case Police dictionary parent package.`);let n=s.join(s.dirname(t),`dictionaries`,`case-police.json`);try{await ie(n,a.F_OK)}catch{throw Error(`Case Police dictionary file "${n}" does not exist.`)}return n}const wt=/^(?<from>\S+) → (?<to>\S+)\s+(?<file>\S+):(?<line>\d+):(?<column>\d+)$/v;function Tt(e){let t=[],n=[];for(let r of O(`${e.stdout}\n${e.stderr}`)){if(!r.includes(`→`))continue;let i=wt.exec(r);if(i?.groups===void 0){n.push(r);continue}let{column:a,file:o,from:s,line:c,to:l}=i.groups;t.push({column:Number(a),file:D(o??``,e.cwd),line:Number(c),message:`Case error: "${s}" should be "${l}"`,severity:`warning`,...l!==void 0&&{suggestion:l},tool:`case-police`})}return{diagnostics:t,unparsed:n}}async function Et(e){let t=await b().searchForConfigFile(void 0);if(t===void 0)throw Error(`No CSpell configuration found.`);e.write(`Found cspell readme configuration at "${u(t.url)}"\n`);let n=k(await ae(t)).split(`
9
+ `);for(let t of n)e.write(`${t}\n`);return 0}const Dt={commands:{fix:{async commands(){return[{collect:{parse:Tt},logColor:`cyanBright`,logPrefix:`[Case Police]`,name:`case-police`,optionFlags:[`--fix`,`--dict`,await Ct(),`--ignore`,await gt()],outputFilter:e=>!e.includes(`→`),receivePositionalArguments:!0},{execute:St,name:`words`},{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`cspell`},collect:{parse:yt},name:`cspell`,optionFlags:[`--quiet`],receivePositionalArguments:!0}]},description:`Fix letter casing issues, remove unused words from the local CSpell configuration's "words" array, and report remaining (unfixable) spelling errors. ${q.fileRun}`,positionalArgumentDefault:`**/*`,positionalArgumentMode:`optional`},init:{configFile:`cspell.config.ts`,configPackageJson:{cspell:{import:`@kitschpatrol/cspell-config`}},locationOptionFlag:!0},lint:{async commands(){return[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`cspell`},collect:{parse:yt},name:`cspell`,optionFlags:[`--quiet`],receivePositionalArguments:!0},{collect:xt,execute:bt,name:`unused-words`},{collect:{parse:Tt},logColor:`cyanBright`,logPrefix:`[Case Police]`,name:`case-police`,optionFlags:[`--dict`,await Ct(),`--ignore`,await gt()],outputFilter:e=>!e.includes(`→`),receivePositionalArguments:!0}]},description:`Check for spelling mistakes. ${q.fileRun}`,positionalArgumentDefault:`**/*`,positionalArgumentMode:`optional`},printConfig:{commands:[{execute:Et,name:`cspell-config`}],description:`Print the resolved CSpell configuration. ${q.packageSearch} ${q.monorepoSearch}`,positionalArgumentMode:`none`}},description:`Kitschpatrol's CSpell shared configuration tools.`,logColor:`cyan`,logPrefix:`[CSpell]`,name:`ksc-cspell`,order:6};async function Ot(e,t){let n,[r]=t;if(r===void 0)n=G(`eslint`);else{let t=s.join(process.cwd(),r);e.write(`Showing configuration for file: ${t}\n`),n={name:`eslint`,optionFlags:[`--print-config`],receivePositionalArguments:!0}}let{exitCode:i}=await W(e,t,[],[n]);return i}function kt(e){let t;try{t=JSON.parse(e.stdout)}catch{return{diagnostics:[],unparsed:[...O(e.stdout),...O(e.stderr)]}}let n=[];for(let r of t)for(let t of r.messages)n.push({column:t.column,endColumn:t.endColumn,endLine:t.endLine,file:D(r.filePath,e.cwd),line:t.line,message:t.message,rule:t.ruleId??void 0,severity:t.fatal===!0||t.severity===2?`error`:`warning`,tool:`eslint`});return{diagnostics:n,unparsed:O(e.stderr)}}const At={commands:{fix:{commands:[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`eslint`},collect:{optionFlags:[`--fix`,`--max-warnings`,`0`,`--format`,`json`],parse:kt},name:`eslint`,optionFlags:[`--fix`,`--max-warnings`,`0`],receivePositionalArguments:!0}],description:`Fix your project with ESLint. ${q.fileRun}`,positionalArgumentDefault:`.`,positionalArgumentMode:`optional`},init:{locationOptionFlag:!1},lint:{commands:[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`eslint`},collect:{optionFlags:[`--max-warnings`,`0`,`--format`,`json`],parse:kt},name:`eslint`,optionFlags:[`--max-warnings`,`0`],receivePositionalArguments:!0}],description:`Lint your project with ESLint. ${q.fileRun}`,positionalArgumentDefault:`.`,positionalArgumentMode:`optional`},printConfig:{commands:[{execute:Ot,name:`eslint-config`}],description:`Print the effective ESLint configuration. ${q.optionalFileRun} Use \`@eslint/config-inspector\` for a more detailed view.`,positionalArgumentMode:`optional`}},description:`Kitschpatrol's ESLint shared configuration tools.`,logColor:`magenta`,logPrefix:`[ESLint]`,name:`ksc-eslint`,order:4},jt={entry:[`{index,cli,main}.{js,mjs,cjs,jsx,ts,tsx,mts,cts}!`,`src/{index,cli,main}.{js,mjs,cjs,jsx,ts,tsx,mts,cts}!`,`src/{bin,lib,cli}/{index,cli,main}.{js,mjs,cjs,jsx,ts,tsx,mts,cts}!`,`scripts/**/*.{js,mjs,cjs,ts,mts,cts}`,`.remarkrc.{js,mjs,cjs,ts,mts,cts}`,`cspell.config.{js,mjs,cjs,ts,mts,cts}`,`eslint.config.{js,mjs,cjs,ts,mts,cts}`,`mdat.config.{js,mjs,cjs,ts,mts,cts}`,`prettier.config.{js,mjs,cjs,ts,mts,cts}`,`stylelint.config.{js,mjs,cjs,ts,mts,cts}`],ignoreBinaries:[`ksc-repo`,`ksc-mdat`,`ksc-typescript`,`ksc-eslint`,`ksc-stylelint`,`ksc-cspell`,`ksc-knip`,`ksc-remark`,`ksc-prettier`,`op`,`gh`],ignoreDependencies:[`@kitschpatrol/cspell-config`,`@kitschpatrol/dict-en-wiktionary`,`@kitschpatrol/eslint-config`,`@kitschpatrol/knip-config`,`@kitschpatrol/mdat-config`,`@kitschpatrol/prettier-config`,`@kitschpatrol/remark-config`,`@kitschpatrol/repo-config`,`@kitschpatrol/stylelint-config`,`@kitschpatrol/typescript-config`,`@prettier/plugin-php`,`@prettier/plugin-ruby`,`@prettier/plugin-xml`,`prettier-plugin-packagejson`,`prettier-plugin-sh`,`prettier-plugin-tailwindcss`,`prettier-plugin-toml`,`remark-attribute-list`,`remark-directive`]},Mt={binaries:`Unlisted binary`,catalog:`Unused catalog entry`,classMembers:`Unused class member`,dependencies:`Unused dependency`,devDependencies:`Unused devDependency`,duplicates:`Duplicate export`,enumMembers:`Unused enum member`,exports:`Unused export`,files:`Unused file`,namespaceMembers:`Unused namespace member`,nsExports:`Unused namespace export`,nsTypes:`Unused namespace type`,optionalPeerDependencies:`Unused optional peer dependency`,types:`Unused exported type`,unlisted:`Unlisted dependency`,unresolved:`Unresolved import`};function Nt(e){return Array.isArray(e)?e.flatMap(e=>Array.isArray(e)?e:[e]):[]}function Pt(e){let t;try{t=JSON.parse(e.stdout)}catch{return{diagnostics:[],unparsed:[...O(e.stdout),...O(e.stderr)]}}let n=[],r=t.issues??[];for(let t of r){let r=D(t.file,e.cwd);for(let[e,i]of Object.entries(t)){let t=Mt[e];if(t!==void 0)for(let a of Nt(i)){let i=typeof a==`string`?a:a.name,o=typeof a==`string`?{}:{column:a.col,line:a.line};n.push({...o,file:r,message:e===`files`?t:`${t}: ${i}`,rule:e,severity:`warning`,tool:`knip`})}}}return{diagnostics:n,unparsed:O(e.stderr)}}function Ft(){if(Fe()){let e=M(),t=N();if(e!==t){let n=s.relative(t,e);if(n!==``)return[`--workspace`,n.split(s.sep).join(`/`)]}}return[]}function It(){return{knip:jt}}const Lt={commands:{init:{configFile:`knip.config.ts`,configPackageJson:It(),locationOptionFlag:!0},lint:{commands:[{collect:{optionFlags:[`--no-progress`,`--no-config-hints`,...Ft(),`--reporter`,`json`],parse:Pt},cwdOverride:`workspace-root`,name:`knip`,optionFlags:[`--no-progress`,`--no-config-hints`,...Ft()]}],description:`Check for unused code and dependencies. ${q.packageRun} ${q.monorepoRun}`,positionalArgumentMode:`none`},printConfig:{commands:[G(`knip`)],description:`Print the effective Knip configuration. ${q.packageSearch} ${q.monorepoSearch}`,positionalArgumentMode:`none`}},description:`Kitschpatrol's Knip shared configuration tools.`,logColor:`cyan`,logPrefix:`[Knip]`,name:`ksc-knip`,order:7};async function Rt(){return(await K(`mdat`))?.filepath}async function zt(e){let t=`mdat`,n=await K(t);n!==void 0&&e.write(`Found ${t} readme configuration at "${n.filepath}"\n`);let r=k(await de({additionalConfig:await de()})).split(`
10
+ `);for(let t of r)e.write(`${t}\n`);return 0}async function Bt(e){let t=j(),n=await Rt(),r=[];for(let i of t)r.push({cwdOverride:i,name:`mdat`,optionFlags:n===void 0||n===``?[`--format`]:[`--config`,n,`--format`],subcommands:[e]});return r}const Vt={commands:{fix:{commands:await Bt(`expand`),description:`Expand all Mdat content placeholders in your readme.md file(s). ${q.packageRun} ${q.monorepoRun}`,parallel:!0,positionalArgumentMode:`none`},init:{configFile:`mdat.config.ts`,configPackageJson:{mdat:{$import:`node_modules/@kitschpatrol/mdat-config/dist/index.js`}},locationOptionFlag:!0},lint:{commands:await Bt(`check`),description:`Validate that all Mdat content placeholders in your readme.md file(s) have been expanded and are up to date. ${q.packageRun} ${q.monorepoRun}`,parallel:!0,positionalArgumentMode:`none`},printConfig:{commands:[{execute:zt,name:`mdat-config`}],description:`Print the effective Mdat configuration. ${q.packageSearch}. ${q.monorepoSearch}.`,positionalArgumentMode:`none`}},description:`Kitschpatrol's Mdat shared configuration tools.`,logColor:`green`,logPrefix:`[Mdat Config]`,name:`ksc-mdat`,order:2},Ht=/^\[warn\] (?<file>\S+)$/v,Ut=/^\[error\] (?<message>.+)$/v;function Wt(e){let t=[],n=[];for(let r of O(`${e.stdout}\n${e.stderr}`)){let i=Ht.exec(r);if(i?.groups?.file!==void 0){t.push({file:D(i.groups.file,e.cwd),message:`File is not formatted with Prettier`,severity:`warning`,tool:`prettier`});continue}if(r.startsWith(`[warn] Code style issues found`))continue;let a=Ut.exec(r);if(a?.groups?.message!==void 0){t.push({message:a.groups.message,severity:`error`,tool:`prettier`});continue}n.push(r)}return{diagnostics:t,unparsed:n}}const Gt=[`--log-level=warn`,`--plugin=@kitschpatrol/prettier-plugin-astro`,`--plugin=@prettier/plugin-php`,`--plugin=@prettier/plugin-ruby`,`--plugin=@prettier/plugin-xml`,`--plugin=prettier-plugin-jsdoc`,`--plugin=prettier-plugin-packagejson`,`--plugin=prettier-plugin-sh`,`--plugin=prettier-plugin-svelte`,`--plugin=prettier-plugin-toml`,`--ignore-path=${Ie(`.gitignore`)??`.gitignore`}`,`--ignore-path=${Ie(`.prettierignore`)??`.prettierignore`}`],Kt={commands:{fix:{commands:[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`prettier`},collect:{parse:Wt},name:`prettier`,optionFlags:[...Gt,`--write`],receivePositionalArguments:!0}],description:`Format files according to your Prettier configuration. ${q.fileRun}`,positionalArgumentDefault:`.`,positionalArgumentMode:`optional`},init:{configFile:`prettier.config.ts`,configPackageJson:{prettier:`@kitschpatrol/prettier-config`},locationOptionFlag:!0},lint:{commands:[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`prettier`},collect:{parse:Wt},name:`prettier`,optionFlags:[...Gt,`--check`],receivePositionalArguments:!0}],description:`Check that files are formatted according to your Prettier configuration. ${q.fileRun}`,positionalArgumentDefault:`.`,positionalArgumentMode:`optional`},printConfig:{commands:[G(`prettier`)],description:`Print the effective Prettier configuration. ${q.packageSearch}. ${q.monorepoSearch}.`,positionalArgumentMode:`none`}},description:`Kitschpatrol's Prettier shared configuration tools.`,logColor:`blue`,logPrefix:`[Prettier]`,name:`ksc-prettier`,order:9},qt={commands:{init:{configFile:`.remarkrc.js`,configPackageJson:{remarkConfig:{plugins:[`@kitschpatrol/remark-config`]}},locationOptionFlag:!0},printConfig:{commands:[G(`remark`)],description:`Print the effective Remark configuration. ${q.packageSearch} ${q.monorepoSearch}`,positionalArgumentMode:`none`}},description:`Kitschpatrol's Remark and Remark Lint shared configuration tools. (Actual linting and fixing is managed through @kitschpatrol/eslint-config.)`,logColor:`blue`,logPrefix:`[remarklint]`,name:`ksc-remark`,order:8},Jt=[/Version 2\.0,?\s*January 2004/gv,/Version 1,?\s*February 1989/gv,/Version 2,?\s*June 1991/gv,/Version 3,?\s*29 June 2007/gv,/Version 2\.1,?\s*February 1999/gv,/Version 3,?\s*19 November 2007/gv,/Version 1\.0\s*-\s*August 17th,?\s*2003/gv,/Version 1\.1,?\s*March 2000/gv,/Version 1\.2,?\s*November 2002/gv,/Version 1\.3,?\s*3 November 2008/gv,/Version 1\.0\s*-\s*22 November 2005/gv,/Version 1\.1\s*-\s*26 February 2007/gv,/Version 2,?\s*December 2004/gv,/20 December 1996/gv,/December 20,?\s*1996/gv,/11 March 1996/gv,/28 March 2007/gv,/November 1,?\s*2008/gv,/August 1,?\s*2009/gv,/1 April 19\d{2}/gv,/Copyright \(c\) 2000-2006,?\s*The Perl Foundation/giv,/Copyright \(C\) (?:\d{4},?\s*)+Free Software Foundation/gv],Yt=[`node_modules/**`,`test/**`];function Xt(e){let t=e;for(let e of Jt)e.lastIndex=0,t=t.replace(e,e=>e.replaceAll(/\d/gv,`X`));return t}const Zt=/(\d{4})\s*-\s*(\d{4})/v,Qt=/(\d{4})/v;function $t(e,t){let n=Xt(e),r=Zt,i=r.exec(n);if(i){let[,n,a]=i;if(Number(a)!==t){let a=`${n}-${t}`;return e.slice(0,i.index)+e.slice(i.index).replace(r,()=>a)}return e}let a=Qt,o=a.exec(n);if(o){let[,n]=o;if(Number(n)!==t){let r=`${n}-${t}`;return e.slice(0,o.index)+e.slice(o.index).replace(a,()=>r)}return e}return e}async function en(e){let t=new Date().getFullYear(),n=await fe([`**/license.txt`,`**/license`,...Yt.map(e=>`!${e}`)],{caseSensitiveMatch:!1,cwd:M(),followSymbolicLinks:!1,gitignore:!0}),r=[];for(let i of n)try{let n=await y.readFile(i,`utf8`),a=$t(n,t);a!==n&&(r.push(i),e&&await y.writeFile(i,a,`utf8`))}catch(e){console.error(`Failed to process ${i}:`,e)}return r}async function tn(e,t=!1){let n=await en(t);if(n.length>0){e.write(`${t?`Fixed`:`Found`} ${n.length} license ${L(`file`,n.length)} with outdated copyright year:\n`);for(let t of n)e.write(` - ${t}\n`);return+!t}return 0}async function nn(e){return tn(e,!1)}async function rn(){let e=await en(!1);return{diagnostics:e.map(e=>({file:D(e,M()),message:`License file has an outdated copyright year`,severity:`error`,tool:`copyright-year`})),exitCode:+(e.length>0),unparsed:[]}}async function an(e){return tn(e,!0)}const Y=`pnpm-lock.yaml`;function on(e){let t=N(),n=s.resolve(e);for(;;){if(r.existsSync(s.join(n,Y)))return n;if(n===t)break;let e=s.dirname(n);if(e===n)break;n=e}}function sn(e,t,n){let r=`${e}@${t}`;if(Object.hasOwn(n,r))return r;if(Object.hasOwn(n,t))return t}function cn(e,t){return e===void 0||e===``?t===void 0||t===``?void 0:t:t===void 0||t===``||S(e,t)?e:t}async function ln(e){let t=on(e);if(t===void 0||t===``)throw Error(`${Y} not found at or above "${e}".`);let n=s.join(t,Y),r=await me(t,{ignoreIncompatible:!1});if(!r?.importers)throw Error(`Lockfile at "${n}" is unreadable or missing importers.`);let i=r.packages??{},a,o,c={},l={};function u(e,t){let n,r=new Set;function a(e,t){if(t.startsWith(`link:`))return;let o=sn(e,t,i);if(o===void 0||o===``||r.has(o))return;r.add(o);let s=i[o];if(s===void 0)return;let c=s.engines?.node;if(c!==void 0&&c!==``){let e=pe(c)?.version;e!==void 0&&e!==``&&(n===void 0||n===``||S(e,n))&&(n=e)}if(s.dependencies)for(let[e,t]of Object.entries(s.dependencies))a(e,t)}return a(e,t),n}function d(e,t){for(let[n,r]of Object.entries(e)){let e=u(n,typeof r==`string`?r:r.version);if(e!==void 0&&e!==``){let r=t?l:c;r[e]??=new Set,r[e].add(n);let i=t?o:a;(i===void 0||i===``||S(e,i))&&(t?o=e:a=e)}}}let f=s.relative(t,e),p=f===``?`.`:f,m=r.importers[p];m!==void 0&&(m.dependencies&&d(m.dependencies,!1),m.devDependencies&&d(m.devDependencies,!0));let h=cn(a,o),g=h===void 0?void 0:`>=${h}`;return{dependencies:a!==void 0&&a!==``?{topLevelCauses:[...c[a]??[]],version:`>=${a}`}:void 0,devDependencies:o!==void 0&&o!==``?{topLevelCauses:[...l[o]??[]],version:`>=${o}`}:void 0,lockfile:n,version:g}}function un(e){let t=e.devEngines;if(t?.runtime)return(Array.isArray(t.runtime)?t.runtime:[t.runtime]).find(e=>e.name===`node`)?.version}function dn(e,t){let n=e.devEngines??{};if(n.runtime)if(Array.isArray(n.runtime)){let e=n.runtime.find(e=>e.name===`node`);e===void 0?n.runtime.push({name:`node`,version:t}):e.version=t}else n.runtime.name===`node`?n.runtime.version=t:n.runtime=[n.runtime,{name:`node`,version:t}];else n.runtime={name:`node`,version:t};e.devEngines=n}function fn(e){let t=e.devEngines;if(t?.runtime){if(Array.isArray(t.runtime)){t.runtime=t.runtime.filter(e=>e.name!==`node`);let[e]=t.runtime;e===void 0?delete t.runtime:t.runtime.length===1&&(t.runtime=e)}else t.runtime.name===`node`&&delete t.runtime;Object.keys(t).length===0&&delete e.devEngines}}function X(e){return e.length===0?``:` (from ${e.join(`, `)})`}async function pn(e,t){let n=s.join(t,`package.json`);if(!r.existsSync(n))return{issues:[],packageJsonPath:n};let i=r.readJsonSync(n),a=i.engines?.node,o=un(i),c=await ln(t),l=c.dependencies?.version,u=c.dependencies?.topLevelCauses??[],d=c.version,f=c.devDependencies?.topLevelCauses??[],p=[];if(l!==void 0)if(a===void 0){if(p.push(`Missing engines.node — suggest setting to "${l}"${X(u)}`),e){let e=i.engines??{};e.node=l,i.engines=e}}else{let t=x.minVersion(a),n=x.minVersion(l);t&&n&&x.lt(t,n)&&(p.push(`engines.node is "${a}" but production dependencies require at least "${l}"${X(u)}`),e&&(i.engines.node=l))}let m=(()=>{if(l!==void 0&&l!==``&&a!==void 0&&a!==``){let e=x.minVersion(l),t=x.minVersion(a);if(e&&t)return x.gt(e,t)?l:a}return l??a})(),h=m!==void 0&&m!==``?x.minVersion(m):void 0,g=d!==void 0&&d!==``?x.minVersion(d):void 0,ee=g&&h&&x.gt(g,h);if(d!==void 0&&ee)if(o===void 0)p.push(`devDependencies require a higher Node.js minimum (${d}) than engines.node (${m??`none`}) — suggest adding devEngines.runtime for node with version "${d}"${X(f)}`),e&&dn(i,d);else{let t=x.minVersion(o);t&&x.lt(t,g)&&(p.push(`devEngines.runtime.version for node is "${o}" but all dependencies require at least "${d}"${X(f)}`),e&&dn(i,d))}else if(o!==void 0){let t=x.minVersion(o);t&&h&&x.lte(t,h)&&(p.push(`devEngines.runtime.version for node is redundant (engines.node already covers the requirement) — suggest removing`),e&&fn(i))}return e&&p.length>0&&(r.writeJsonSync(n,i,{spaces:` `}),await F(n)),{issues:p,packageJsonPath:n}}async function mn(e,t){let n=j(),r=0;for(let i of n){let{issues:n,packageJsonPath:a}=await pn(t,i);if(n.length>0){e.write(`${t?`Fixed`:`Found`} ${n.length} Node.js version ${L(`issue`,n.length)} in ${a}:\n`);for(let t of n)e.write(` - ${t}\n`);t||(r=1)}}return r}async function hn(){let e=j(),t=[];for(let n of e){let{issues:e,packageJsonPath:r}=await pn(!1,n);for(let n of e)t.push({file:D(r,process.cwd()),message:n,severity:`error`,tool:`node-version`})}return{diagnostics:t,exitCode:+(t.length>0),unparsed:[]}}async function gn(e){let t=k(await ln(M())).split(`
11
+ `);for(let n of t)e.write(`${n}\n`);return 0}async function _n(e){return mn(e,!1)}async function vn(e){return mn(e,!0)}const yn={commands:{fix:{commands:[{execute:an,name:`copyright-year`},{execute:vn,name:`node-version`}],description:`Fix common issues like outdated copyright years in license files. ${q.packageRun} ${q.monorepoRun}`,positionalArgumentMode:`none`},init:{locationOptionFlag:!1},lint:{commands:[{collect:rn,execute:nn,name:`copyright-year`},{collect:hn,execute:_n,name:`node-version`}],description:`Check the repo for common issues. ${q.packageRun} ${q.monorepoRun}`,positionalArgumentMode:`none`},printConfig:{commands:[{execute:gn,name:`node-version`}],description:`Print minimum Node.js version constraints from the pnpm lockfile.`,positionalArgumentMode:`none`}},description:`Kitschpatrol's repository-related shared configuration tools.`,logColor:`gray`,logPrefix:`[Repo Config]`,name:`ksc-repo`,order:1},Z=[`--ignore-path`,Ie(`.gitignore`)??`.gitignore`,`--allow-empty-input`],bn=`**/*.{${[`css`,`scss`,`sass`,`svelte`,`html`,`astro`,`tsx`,`jsx`,`php`,`vue`].join(`,`)}}`;function xn(e){let t;try{t=JSON.parse(e.stderr)}catch{return{diagnostics:[],unparsed:[...O(e.stdout),...O(e.stderr)]}}let n=[];for(let r of t){let t=D(r.source,e.cwd);for(let e of r.warnings){let r=e.rule===void 0?void 0:` (${e.rule})`,i=r!==void 0&&e.text.endsWith(r)?e.text.slice(0,-r.length):e.text;n.push({column:e.column,endColumn:e.endColumn,endLine:e.endLine,file:t,line:e.line,message:i,rule:e.rule,severity:e.severity===`warning`?`warning`:`error`,tool:`stylelint`})}let i=r.parseErrors??[];for(let e of i)n.push({column:e.column,file:t,line:e.line,message:e.text,rule:`parse-error`,severity:`error`,tool:`stylelint`})}return{diagnostics:n,unparsed:O(e.stdout)}}async function Sn(e,t){let n=`stylelint`,r=await K(n);if(r===void 0)return 1;let{filepath:i,isEmpty:a}=r;if(a)return e.write(`Configuration is empty.
12
+ `),0;e.write(`Found ${n} configuration at "${i}"\n`);let o,[c]=t;c===void 0?o=P(`package-dir`):(o=s.join(process.cwd(),c),e.write(`Showing config for file at "${o}"\n`));let l=k(await he.resolveConfig(o)).split(`
13
+ `);for(let t of l)e.write(`${t}\n`);return 0}const Cn={commands:{fix:{commands:[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`stylelint`},collect:{optionFlags:[...Z,`--fix`,`--formatter`,`json`],parse:xn},name:`stylelint`,optionFlags:[...Z,`--fix`],receivePositionalArguments:!0}],description:`Fix your project with Stylelint. ${q.fileRun}`,positionalArgumentDefault:bn,positionalArgumentMode:`optional`},init:{configFile:`stylelint.config.js`,configPackageJson:{stylelint:{extends:`@kitschpatrol/stylelint-config`}},locationOptionFlag:!0},lint:{commands:[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`stylelint`},collect:{optionFlags:[...Z,`--formatter`,`json`],parse:xn},name:`stylelint`,optionFlags:Z,receivePositionalArguments:!0}],description:`Lint your project with Stylelint. ${q.fileRun}`,positionalArgumentDefault:bn,positionalArgumentMode:`optional`},printConfig:{commands:[{execute:Sn,name:`stylelint-config`}],description:`Print the effective Stylelint configuration. ${q.optionalFileRun}.`,positionalArgumentMode:`optional`}},description:`Kitschpatrol's Stylelint shared configuration tools.`,logColor:`greenBright`,logPrefix:`[Stylelint]`,name:`ksc-stylelint`,order:5},wn=/^(?<file>.+?)\((?<line>\d+),(?<column>\d+)\): (?<severity>error|warning) (?<code>TS\d+): (?<message>.*)$/v,Tn=/^(?<severity>error|warning) (?<code>TS\d+): (?<message>.*)$/v,En=/^\s/v,Dn=/^(?:Loading svelte-check in workspace: |Getting Svelte diagnostics\.\.\.|svelte-check found 0 errors and 0 warnings$)/v,On=/^\d+ (?:START "|COMPLETED \d+ FILES 0 ERRORS 0 WARNINGS 0 FILES_WITH_PROBLEMS$)/v;function kn(e){return Dn.test(e)||On.test(e)}function An(e){let t=[],n=[];for(let r of O(`${e.stdout}\n${e.stderr}`)){let i=wn.exec(r);if(i?.groups!==void 0){let{code:n,column:r,file:a,line:o,message:s,severity:c}=i.groups;t.push({column:Number(r),file:D(a??``,e.cwd),line:Number(o),message:s??``,rule:n,severity:c===`warning`?`warning`:`error`,tool:`tsc`});continue}let a=Tn.exec(r);if(a?.groups!==void 0){let{code:e,message:n,severity:r}=a.groups;t.push({message:n??``,rule:e,severity:r===`warning`?`warning`:`error`,tool:`tsc`});continue}let o=t.at(-1);if(o!==void 0&&En.test(r)){o.message+=`\n${r.trim()}`;continue}n.push(r)}return{diagnostics:t,unparsed:n}}async function jn(){let e=M(),t=await r.readJson(s.join(e,`package.json`));return new Set([...Object.keys(t.dependencies??{}),...Object.keys(t.devDependencies??{})])}async function Mn(){let e=await jn(),t=e.has(`@astrojs/check`),n=e.has(`svelte-check`);if(t||n){let e=[];return t&&e.push({cwdOverride:`package-dir`,name:`astro`,subcommands:[`check`]}),n&&e.push({cwdOverride:`package-dir`,name:`svelte-check`,optionFlags:t?[]:[`--tsconfig`,`./tsconfig.json`],outputFilter:kn}),e}return[{collect:{parse:An},cwdOverride:`package-dir`,name:`tsc`,optionFlags:[`--noEmit`]}]}const Q=[At,Dt,Lt,Vt,Kt,qt,yn,Cn,{commands:{init:{locationOptionFlag:!1},lint:{commands:Mn,description:`Run type checking on your project. ${q.packageRun} ${q.monorepoRun}`,positionalArgumentMode:`none`},printConfig:{commands:[{name:`tsc`,optionFlags:[`--showConfig`],prettyJsonOutput:!0}],description:`Print the TypeScript configuration for the project. ${q.packageSearch} ${q.monorepoSearch}`,positionalArgumentMode:`none`}},description:`Kitschpatrol's TypeScript shared configuration tools.`,logColor:`blueBright`,logPrefix:`[TypeScript Config]`,name:`ksc-typescript`,order:3}],Nn={"ksc-cspell":4,"ksc-eslint":2,"ksc-knip":6,"ksc-mdat":1,"ksc-prettier":5,"ksc-repo":0,"ksc-stylelint":3,"ksc-typescript":6};function $(e,t){t.sort((e,t)=>e.order-t.order);let n=[];for(let r of t)r.commands[e]!==void 0&&n.push({definition:r,effectiveKey:e});if(e===`fix`)for(let e of t)e.commands.fix===void 0&&e.commands.lint!==void 0&&n.push({definition:e,effectiveKey:`lint`});let r=[];for(let{definition:t,effectiveKey:i}of n){let n=i===`lint`?t.commands.lint:i===`fix`?t.commands.fix:void 0;if(n!==void 0&&(e===`lint`||e===`fix`)){let a={commands:n.commands,kind:`group`,logColor:t.logColor,logPrefix:t.logPrefix,name:t.name,parallel:n.parallel,positionalArgumentDefault:n.positionalArgumentDefault,positionalArgumentMode:n.positionalArgumentMode,stage:e===`fix`?Nn[t.name]??7:0,subcommand:Ve(i),verbose:t.verbose};r.push(a);continue}let a={name:t.name,...i===`init`?{receiveOptionFlags:t.commands.init?.locationOptionFlag??!1}:{receivePositionalArguments:t.commands[i]?.positionalArgumentMode!==`none`},subcommands:[Ve(i)]};r.push(a)}return r}await ct({commands:{fix:{commands:$(`fix`,Q),description:`Fix your project with multiple tools in one go. Tools without auto-fixes run their checks afterward, so remaining issues match a subsequent lint. ${q.multiArgumentCaveat}`,parallel:!0,positionalArgumentMode:`optional`},init:{commands:$(`init`,Q),description:`Initialize configuration files for the entire suite of @kitschpatrol/shared-config tools. ${q.multiOptionCaveat}`,locationOptionFlag:!0},lint:{commands:$(`lint`,Q),description:`Lint your project with multiple tools in one go. ${q.multiArgumentCaveat}`,parallel:!0,positionalArgumentMode:`optional`},printConfig:{commands:$(`printConfig`,Q),description:`Print aggregated tool configuration data. ${q.multiArgumentCaveat}`,positionalArgumentMode:`optional`}},description:`Run aggregated @kitschpatrol/shared-config commands.`,logColor:`yellow`,logPrefix:`🔬`,name:`ksc`,order:0,showSummary:!0,verbose:!0});export{};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kitschpatrol/shared-config",
3
- "version": "8.2.0",
3
+ "version": "8.3.0",
4
4
  "description": "A collection of shared configurations, linters, and formatting tools for TypeScript projects. All managed as a single dependency. All invoked via a single CLI command.",
5
5
  "keywords": [
6
6
  "shared-config",
@@ -54,7 +54,7 @@
54
54
  ],
55
55
  "dependencies": {
56
56
  "@pinojs/json-colorizer": "^4.0.0",
57
- "@pnpm/lockfile.fs": "^1100.1.8",
57
+ "@pnpm/lockfile.fs": "1100.1.11",
58
58
  "cosmiconfig": "^9.0.2",
59
59
  "cosmiconfig-typescript-loader": "^6.3.0",
60
60
  "cspell": "^10.0.1",
@@ -63,7 +63,7 @@
63
63
  "decircular": "^1.0.0",
64
64
  "deepmerge": "^4.3.1",
65
65
  "deepmerge-ts": "^7.1.5",
66
- "execa": "^9.6.1",
66
+ "execa": "^10.0.0",
67
67
  "find-workspaces": "^0.3.1",
68
68
  "fs-extra": "^11.3.6",
69
69
  "globby": "^16.2.1",
@@ -76,15 +76,15 @@
76
76
  "semver": "^7.8.5",
77
77
  "stylelint": "^17.14.0",
78
78
  "yargs": "^18.0.0",
79
- "@kitschpatrol/cspell-config": "8.2.0",
80
- "@kitschpatrol/knip-config": "8.2.0",
81
- "@kitschpatrol/mdat-config": "8.2.0",
82
- "@kitschpatrol/eslint-config": "8.2.0",
83
- "@kitschpatrol/remark-config": "8.2.0",
84
- "@kitschpatrol/repo-config": "8.2.0",
85
- "@kitschpatrol/stylelint-config": "8.2.0",
86
- "@kitschpatrol/prettier-config": "8.2.0",
87
- "@kitschpatrol/typescript-config": "8.2.0"
79
+ "@kitschpatrol/cspell-config": "8.3.0",
80
+ "@kitschpatrol/eslint-config": "8.3.0",
81
+ "@kitschpatrol/knip-config": "8.3.0",
82
+ "@kitschpatrol/mdat-config": "8.3.0",
83
+ "@kitschpatrol/prettier-config": "8.3.0",
84
+ "@kitschpatrol/repo-config": "8.3.0",
85
+ "@kitschpatrol/typescript-config": "8.3.0",
86
+ "@kitschpatrol/remark-config": "8.3.0",
87
+ "@kitschpatrol/stylelint-config": "8.3.0"
88
88
  },
89
89
  "engines": {
90
90
  "node": "^24.16.0 || >=26.3.0"
package/readme.md CHANGED
@@ -229,12 +229,12 @@ Usage:
229
229
  ksc <command>
230
230
  ```
231
231
 
232
- | Command | Argument | Description |
233
- | -------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
234
- | `init` | | Initialize configuration files for the entire suite of @kitschpatrol/shared-config tools. Will use option flags where possible if provided, but some of the invoked tools will ignore them. |
235
- | `lint` | `[files..]` | Lint your project with multiple tools in one go. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope. |
236
- | `fix` | `[files..]` | Fix your project with multiple tools in one go. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope. |
237
- | `print-config` | `[file]` | Print aggregated tool configuration data. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope. |
232
+ | Command | Argument | Description |
233
+ | -------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
234
+ | `init` | | Initialize configuration files for the entire suite of @kitschpatrol/shared-config tools. Will use option flags where possible if provided, but some of the invoked tools will ignore them. |
235
+ | `lint` | `[files..]` | Lint your project with multiple tools in one go. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope. |
236
+ | `fix` | `[files..]` | Fix your project with multiple tools in one go. Tools without auto-fixes run their checks afterward, so remaining issues match a subsequent lint. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope. |
237
+ | `print-config` | `[file]` | Print aggregated tool configuration data. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope. |
238
238
 
239
239
  | Option | Description | Type |
240
240
  | ------------------- | ------------------- | --------- |
@@ -277,13 +277,14 @@ ksc lint [files..]
277
277
  | Option | Description | Type | Default |
278
278
  | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ---------- |
279
279
  | `--format` | Output format: "native" streams each tool's own output, "machine" prints one parseable line per issue for editor problem matchers, "json" prints an aggregate report. | `"json"` `"machine"` `"native"` | `"native"` |
280
+ | `--cache` | Use tool-native caches stored below node\_modules/.cache/ksc at the workspace root. Disable with --no-cache. | `boolean` | `true` |
280
281
  | `--skip` | Tool names to skip (with or without "ksc-" prefix). | `array` | |
281
282
  | `--help`<br>`-h` | Show help | `boolean` | |
282
283
  | `--version`<br>`-v` | Show version number | `boolean` | |
283
284
 
284
285
  #### Subcommand: `ksc fix`
285
286
 
286
- Fix your project with multiple tools in one go. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope.
287
+ Fix your project with multiple tools in one go. Tools without auto-fixes run their checks afterward, so remaining issues match a subsequent lint. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package scope.
287
288
 
288
289
  Usage:
289
290
 
@@ -298,6 +299,7 @@ ksc fix [files..]
298
299
  | Option | Description | Type | Default |
299
300
  | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ---------- |
300
301
  | `--format` | Output format: "native" streams each tool's own output, "machine" prints one parseable line per issue for editor problem matchers, "json" prints an aggregate report. | `"json"` `"machine"` `"native"` | `"native"` |
302
+ | `--cache` | Use tool-native caches stored below node\_modules/.cache/ksc at the workspace root. Disable with --no-cache. | `boolean` | `true` |
301
303
  | `--skip` | Tool names to skip (with or without "ksc-" prefix). | `array` | |
302
304
  | `--help`<br>`-h` | Show help | `boolean` | |
303
305
  | `--version`<br>`-v` | Show version number | `boolean` | |