@kitschpatrol/shared-config 8.3.0 → 8.4.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.
- package/bin/cli.js +12 -12
- package/dist/index.d.ts +6 -4
- package/dist/index.js +1 -1
- package/package.json +12 -12
- package/readme.md +1 -1
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{availableParallelism as o}from"node:os";import s from"node:path";import{PassThrough as c,Transform as l}from"node:stream";import{
|
|
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(
|
|
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),
|
|
5
|
-
`),1;let l=s.
|
|
6
|
-
`),0;let o=
|
|
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.`},
|
|
8
|
-
`),0}async function
|
|
9
|
-
`);for(let t of n)e.write(`${t}\n`);return 0}const
|
|
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
|
|
12
|
-
`),0;e.write(`Found ${n} configuration at "${i}"\n`);let o,[c]=t;c===void 0?o=
|
|
13
|
-
`);for(let t of l)e.write(`${t}\n`);return 0}const
|
|
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{packageUp as u,packageUpSync as d}from"package-up";import f from"yargs";import{hideBin as p}from"yargs/helpers";import m from"picocolors";import{stripVTControlCharacters as h}from"node:util";import g from"@pinojs/json-colorizer";import _ from"decircular";import ee from"deepmerge";import v from"json-stringify-pretty-compact";import{findWorkspaces as y,findWorkspacesRoot as te}from"find-workspaces";import b,{access as ne}from"node:fs/promises";import{getDefaultConfigLoader as x,resolveConfigFileImports as re}from"cspell-lib";import{fileURLToPath as S}from"node:url";import{createReaderWriter as ie}from"cspell-config-lib";import{loadFile as ae,writeFile as oe}from"magicast";import{getDefaultExportOptions as se}from"magicast/helpers";import{lint as ce}from"cspell";import"deepmerge-ts";import{loadConfig as le}from"mdat";import{globby as ue}from"globby";import C,{gt as de,minVersion as fe}from"semver";import{readWantedLockfile as pe}from"@pnpm/lockfile.fs";import me from"stylelint";var he=`8.4.0`;const ge=[`json`,`machine`,`native`],_e=ge;function ve(e){return typeof e==`string`&&ge.includes(e)}function w(){let e=process.env.KSC_FORMAT;return ve(e)?e:`native`}function ye(){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)),ve(r)&&(process.env.KSC_FORMAT=r)}}function be(){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 T(e,{ciColor:t=!0}={}){let n=be();return n===void 0?e.isTTY===!0||t&&!!process.env.CI:n}function E(){return w()===`json`?process.stderr:process.stdout}function D(){return w()===`machine`?m.createColors(!1):m.createColors(T(E()))}function xe(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 O(e,t){let n=s.isAbsolute(e)?e:s.resolve(t,e),r=s.relative(process.cwd(),n);return r===``?`.`:r}const Se=/\s*\n\s*/gv,Ce=/\r?\n/v;function we(e){let t=e.message.replaceAll(Se,` `),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 Te(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 Ee(e,t){let n=t.toSorted(Te);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 k(e){return h(e).split(Ce).map(e=>e.trimEnd()).filter(e=>e.trim().length>0)}function De(e){return e instanceof Error&&`exitCode`in e&&typeof e.exitCode==`number`}function A(e){return T(process.stdout,{ciColor:!1})?ke(e):Oe(e)}function Oe(e){return v(_(e),{indent:2,replacer(e,t){return typeof t==`function`?t.name:t}})}function ke(e){return g(Oe(e),{colors:{BRACKET:`gray`}})}const Ae=(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]=j(e[i],a,n):e.includes(a)||r.push(a);return r};function j(e,t,n={arrayMerge:Ae}){return ee(e,t,n)}function je(e){let{tasks:t}=e;return Array.isArray(t)?t:[]}function Me(e,t){let n=[...je(e)];for(let e of je(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 Ne(e,t){return e.startsWith(t+s.sep)}function M(){let e=N(),t=new Set([e]),n=y();if(n!==null)for(let r of n){let n=s.resolve(r.location);Ne(n,e)&&t.add(n)}return[...t]}function N(){let e=d();if(e===void 0)throw Error(`No package.json found.`);return s.dirname(e)}function Pe(){return te()!==null}function P(){let e=te();return e===null?N():s.resolve(e.location)}function Fe(e){let t=s.join(P(),e);if(r.existsSync(t))return t}function Ie(e){if(e===`workspace-root`)return P();if(e===`package-dir`)return N();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 b.writeFile(e,i,`utf8`)}catch{console.warn(`Skipped formatting ${e} since Prettier is not installed.`)}}async function F(e){try{await Le(e,await b.readFile(e,`utf8`))}catch{}}const Re=/\r?\n/v;function ze(e){let t=``,n=t=>t.filter(t=>{let n=h(t);return n.trim()!==``&&!e(n)}).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=w()===`native`?e:void 0,r=n===void 0||n===``?``:t===void 0?n:D()[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(D().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(P(),`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=Ie(i.cwdOverride);o&&l.write(`Running: "${i.name} ${u.join(` `)}"\n`);let f=i.prettyJsonOutput?new c:void 0,p=f??l,m=xe(w()===`native`&&i.prettyJsonOutput!==!0&&T(E()));try{let e=n(i.name,u,{cwd:d,env:m,preferLocal:!0,reject:!1,stdin:`inherit`});if(i.outputFilter){let t=ze(i.outputFilter),n=ze(i.outputFilter);e.stdout.pipe(t).pipe(p,{end:!1}),e.stderr.pipe(n).pipe(p,{end:!1})}else e.stdout.pipe(p,{end:!1}),e.stderr.pipe(p,{end:!1});let t=await e;if(f!==void 0){f.end();let e=await Be(f),t=A(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),De(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=Ie(r.cwdOverride);try{let e=n(r.name,o,{cwd:s,env:xe(!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:De(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)&&`success`in e&&typeof e.success==`boolean`&&`tools`in e&&Array.isArray(e.tools)}function qe(e,t){return e===0&&t.some(({severity:e})=>e===`error`)?1:e}async function Je(e,t,n,r,i){let a=Date.now(),o=()=>Date.now()-a;if(z(r)){if(r.collect!==void 0)try{let e=await r.collect(t,n),i=qe(e.exitCode,e.diagnostics);return{diagnostics:e.diagnostics,exitCode:i,tools:[{durationMs:o(),exitCode:i,name:r.name,unparsed:e.unparsed}]}}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:k(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===0&&e.success&&e.diagnostics.every(({severity:e})=>e!==`error`)?0:1,tools:e.tools}}catch{return{diagnostics:[],exitCode:a.exitCode,tools:[{durationMs:o(),exitCode:a.exitCode,name:r.name,unparsed:k(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),n=qe(s.exitCode,e);return{diagnostics:e,exitCode:n,tools:[{durationMs:o(),exitCode:n,name:r.name,unparsed:t}]}}catch(e){return{diagnostics:[],exitCode:s.exitCode,tools:[{durationMs:o(),exitCode:s.exitCode,name:r.name,unparsed:[...k(s.stdout),...k(s.stderr),String(e)]}]}}return{diagnostics:[],exitCode:s.exitCode,tools:[{durationMs:o(),exitCode:s.exitCode,name:r.name,unparsed:[...k(s.stdout),...k(s.stderr)]}]}}const Ye=/^ksc-/v;function V(e){return e.replace(Ye,``)}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 Xe(e){return e.option(`format`,{choices:_e,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 Ze(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 Qe(e,t){return t===`native`||t===`machine`&&!z(e)&&!B(e)&&e.outputFormatAware===!0}function $e(e,t){for(let n of t.diagnostics)e.write(`${we(n)}\n`);for(let n of t.tools)for(let t of n.unparsed)e.write(`${t}\n`)}function et(){return Math.min(4,o())}var tt=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 nt(e){let t=e.cache??!1,n=e.concurrency??et();if(!Number.isInteger(n)||n<1)throw Error(`Concurrency must be a positive integer.`);return t&&await r.ensureDir(s.join(P(),`node_modules`,`.cache`,`ksc`)),{cache:t,scheduler:new tt(n)}}function rt(e,t){return e.positionalArgumentMode===`none`?[]:t.length>0?t:e.positionalArgumentDefault===void 0?[]:[e.positionalArgumentDefault]}function it(e,t){if(t.logPrefix===void 0)return e;let n=I(t.logPrefix,t.logColor);return n.pipe(e),n}function at(e){return B(e)?`${e.name} ${e.subcommand}`:!z(e)&&e.subcommands!==void 0?[e.name,...e.subcommands].join(` `):e.name}async function ot(e,t){if(B(e)){let n=it(t.logStream,e);try{let r=await R(e.commands);if(t.nativeVerbose){let n=[e.subcommand,...t.positionalArguments].join(` `),i=e.showResolvedCommands?` (${r.map(e=>at(e)).join(`, `)})`:``;t.logStream.write(`Running: "${e.name} ${n}"${i}\n`)}let i=await st(r,{...t,logStream:n,nativeVerbose:e.verbose,positionalArguments:rt(e,t.positionalArguments)},e.parallel===!0);return{diagnostics:i.flatMap(({diagnostics:e})=>e),exitCode:+!i.every(({exitCode:e})=>e===0),machineOutcomes:i.flatMap(({machineOutcomes:e})=>e),name:e.name,tools:i.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(Qe(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 Je(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 st(e,t,n){if(!n||t.scheduler.concurrency===1){let n=[];for(let r of e)n.push(await ot(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 ot(e,t)})));for(let{index:e,outcome:t}of a)i[e]=t}return i.filter(e=>e!==void 0)}function ct(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(`⚠️ ${D().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}=ct(e,r,o??[]),f=l===`native`&&i,{cache:p,scheduler:m}=await nt(c),h=await st(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})),_=h.flatMap(({tools:e})=>e),ee=h.flatMap(({diagnostics:e})=>e);if(l===`machine`)for(let t of h)for(let n of t.machineOutcomes)$e(e,n);let v=r.length,y=D();if(l===`native`&&d.length>0){let t=d.map(({name:e})=>e),n=y.bold(`${t.length} / ${v} ${L(`Command`,t.length)} Skipped:`);e.write(`⏭️ ${y.dim(n)} ${y.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=y.bold(`${t.length} / ${v} ${L(`Command`,t.length)} Succeeded:`);e.write(`✅ ${y.green(n)} ${y.green(t.join(`, `))}\n`)}if(n.length>0){let t=y.bold(`${n.length} / ${v} ${L(`Command`,n.length)} Failed:`);e.write(`❌ ${y.red(t)} ${y.red(n.join(`, `))}\n`)}}return{exitCode:+!g.every(({exitCode:e})=>e===0),report:l===`json`?Ee(_,ee):void 0}}async function lt(e){let t=await u({cwd:e});return t===void 0?void 0:s.join(s.dirname(t),`init`)}async function ut(e,t,n,a){let o=await u();if(o===void 0)throw Error("The `init` command must be used in a directory with a package.json file");let c=await lt(import.meta.dirname);if(c===void 0)return e.write(`Error: Could not locate the package containing this CLI.
|
|
5
|
+
`),1;let l=s.dirname(o),d=(t===`file`||t===`package`)&&n!==void 0&&a!==void 0;try{if(d){let n=Object.keys(a)[0],i=r.readJsonSync(o);if(t===`package`){e.write(`Merging: \nPackage config key "${n}" → "${l}" (Because --location is set to "package")\n`);let t=j(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 "${l}" (Because --location is set to "file")\n`),delete i[n],r.writeJSONSync(o,i,{spaces:` `}),await F(o))}if(!await r.pathExists(c))return 0;if((await r.readdir(c)).length===0)return e.write(`Source directory "${c}" is empty.\n`),0;e.write(`Adding initial configuration files from:\n"${c}" → "${l}"\n`),await r.copy(c,l,{async filter(a,o){let c=i.statSync(a).isFile(),l=i.existsSync(o);if(c){if(d&&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`)?Me(n,t):j(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 dt(e){let{commands:{fix:t,init:n,lint:r,printConfig:i},description:a,logColor:o,logPrefix:s,name:c,showSummary:l,verbose:u}=e;ye();let d=I(s,o);d.pipe(E());let m=f(p(process.argv)).scriptName(c).usage(`$0 <command>`,a);n!==void 0&&m.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 ut(e,r.at(1),n.configFile,n.configPackageJson)},name:`copyAndMergeInitFiles`},...n.commands??[]],void 0,void 0,r);process.exitCode=i}}),r!==void 0&&m.command({builder(e){let t=Ze(Xe(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=w(),{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(`${A(o)}\n`),process.exitCode=a}}),t!==void 0&&m.command({builder(e){let n=Ze(Xe(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=w(),{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(`${A(o)}\n`),process.exitCode=a}}),i!==void 0&&m.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}}),m.alias(`h`,`help`),m.version(he),m.alias(`v`,`version`),m.help(),m.wrap(process.stdout.isTTY?Math.min(120,m.terminalWidth()):0),await m.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=A(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.`},ft=/['\u{2019}\u{2018}]s$/v;async function pt(e=[`.`]){let t=await x().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 ce(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(ft,``)||t===r.href)}});return{errors:a.errors,filesChecked:a.files,unusedWords:i}}const mt=new Set([`.cjs`,`.cts`,`.js`,`.mjs`,`.mts`,`.ts`]);async function ht(e=[`**/*`]){let t=await x().searchForConfigFile(void 0);if(t===void 0)throw Error(`No CSpell configuration found.`);let n=S(t.url),r=[...t.settings.words??[]];if(r.length===0)return;let{errors:i,filesChecked:a,unusedWords:o}=await pt(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=gt([...new Set(c)]);return _t(l,r)?{configFilePath:n,removedWords:[],reordered:!1}:(await vt(t.url,l),{configFilePath:n,removedWords:[...s],reordered:!_t(l,c)})}function gt(e){return e.toSorted((e,t)=>{let n=e.toLowerCase().localeCompare(t.toLowerCase());return n===0?e.localeCompare(t):n})}function _t(e,t){return e.length===t.length&&e.every((e,n)=>e===t[n])}async function vt(e,t){let n=S(e),r=s.extname(n).toLowerCase();if(mt.has(r)){let e=await ae(n),r=se(e);r.words=t,await oe(e,n),await F(n);return}let i=ie(),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 yt(){let e=await x().searchForConfigFile(void 0);return e===void 0?void 0:S(e.url)}async function bt(){let e=await x().searchForConfigFile(void 0);if(e===void 0)throw Error(`No CSpell configuration found.`);let t=await re(e);return t.ignorePaths===void 0?``:Array.from(t.ignorePaths,e=>typeof e==`string`?e:e.glob).join(`,`)}const xt=/^(?<file>.+?):(?<line>\d+):(?<column>\d+) - (?<message>.+)$/v,St=/ fix: \((?<suggestion>[^\)]+)\)$/v;function Ct(e){let t=[],n=[];for(let r of k(`${e.stdout}\n${e.stderr}`)){let i=xt.exec(r);if(i?.groups===void 0){n.push(r);continue}let{column:a,file:o,line:s,message:c}=i.groups,l=St.exec(c??``),u=l?.groups?.suggestion;t.push({column:Number(a),file:O(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 wt(e,t){let{errors:n,filesChecked:r,unusedWords:i}=await pt(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 Tt(e){let{errors:t,filesChecked:n,unusedWords:r}=await pt(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 yt(),a=i===void 0?{}:{file:O(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 Et(e,t){let n=I(`[Words]`,`cyanBright`);n.pipe(e);let r=await ht(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 Dt(){let e=import.meta.resolve(`@kitschpatrol/cspell-config`),t=await u({cwd:s.dirname(S(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 ne(n,a.F_OK)}catch{throw Error(`Case Police dictionary file "${n}" does not exist.`)}return n}const Ot=/^(?<from>\S+) → (?<to>\S+)\s+(?<file>\S+):(?<line>\d+):(?<column>\d+)$/v;function kt(e){let t=[],n=[];for(let r of k(`${e.stdout}\n${e.stderr}`)){if(!r.includes(`→`))continue;let i=Ot.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:O(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 At(e){let t=await x().searchForConfigFile(void 0);if(t===void 0)throw Error(`No CSpell configuration found.`);e.write(`Found cspell readme configuration at "${S(t.url)}"\n`);let n=A(await re(t)).split(`
|
|
9
|
+
`);for(let t of n)e.write(`${t}\n`);return 0}const jt={commands:{fix:{async commands(){return[{collect:{parse:kt},logColor:`cyanBright`,logPrefix:`[Case Police]`,name:`case-police`,optionFlags:[`--fix`,`--dict`,await Dt(),`--ignore`,await bt()],outputFilter:e=>!e.includes(`→`),receivePositionalArguments:!0},{execute:Et,name:`words`},{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`cspell`},collect:{parse:Ct},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:Ct},name:`cspell`,optionFlags:[`--quiet`],receivePositionalArguments:!0},{collect:Tt,execute:wt,name:`unused-words`},{collect:{parse:kt},logColor:`cyanBright`,logPrefix:`[Case Police]`,name:`case-police`,optionFlags:[`--dict`,await Dt(),`--ignore`,await bt()],outputFilter:e=>!e.includes(`→`),receivePositionalArguments:!0}]},description:`Check for spelling mistakes. ${q.fileRun}`,positionalArgumentDefault:`**/*`,positionalArgumentMode:`optional`},printConfig:{commands:[{execute:At,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 Mt(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 Nt(e){let t;try{t=JSON.parse(e.stdout)}catch{return{diagnostics:[],unparsed:[...k(e.stdout),...k(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:O(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:k(e.stderr)}}const Pt={commands:{fix:{commands:[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`eslint`},collect:{optionFlags:[`--fix`,`--max-warnings`,`0`,`--format`,`json`],parse:Nt},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:Nt},name:`eslint`,optionFlags:[`--max-warnings`,`0`],receivePositionalArguments:!0}],description:`Lint your project with ESLint. ${q.fileRun}`,positionalArgumentDefault:`.`,positionalArgumentMode:`optional`},printConfig:{commands:[{execute:Mt,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},Ft={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`,`node-addon-api`,`node-gyp`,`prettier-plugin-packagejson`,`prettier-plugin-sh`,`prettier-plugin-tailwindcss`,`prettier-plugin-toml`,`remark-attribute-list`,`remark-directive`]},It={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 Lt(e){return Array.isArray(e)?e.flatMap(e=>Array.isArray(e)?e:[e]):[]}function Rt(e){let t;try{t=JSON.parse(e.stdout)}catch{return{diagnostics:[],unparsed:[...k(e.stdout),...k(e.stderr)]}}let n=[],r=t.issues??[];for(let t of r){let r=O(t.file,e.cwd);for(let[e,i]of Object.entries(t)){let t=It[e];if(t!==void 0)for(let a of Lt(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:k(e.stderr)}}function zt(){if(Pe()){let e=N(),t=P();if(e!==t){let n=s.relative(t,e);if(n!==``)return[`--workspace`,n.split(s.sep).join(`/`)]}}return[]}function Bt(){return{knip:Ft}}const Vt={commands:{init:{configFile:`knip.config.ts`,configPackageJson:Bt(),locationOptionFlag:!0},lint:{commands:[{collect:{optionFlags:[`--no-progress`,`--no-config-hints`,...zt(),`--reporter`,`json`],parse:Rt},cwdOverride:`workspace-root`,name:`knip`,optionFlags:[`--no-progress`,`--no-config-hints`,...zt()]}],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 Ht(){return(await K(`mdat`))?.filepath}async function Ut(e){let t=`mdat`,n=await K(t);n!==void 0&&e.write(`Found ${t} readme configuration at "${n.filepath}"\n`);let r=A(await le()).split(`
|
|
10
|
+
`);for(let t of r)e.write(`${t}\n`);return 0}async function Wt(e){let t=M(),n=await Ht(),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 Gt={commands:{fix:{commands:await Wt(`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 Wt(`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:Ut,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},Kt=/^\[warn\] (?<file>\S+)$/v,qt=/^\[error\] (?<message>.+)$/v;function Jt(e){let t=[],n=[];for(let r of k(`${e.stdout}\n${e.stderr}`)){let i=Kt.exec(r);if(i?.groups?.file!==void 0){t.push({file:O(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=qt.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 Yt=[`--log-level=warn`,`--plugin=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`,`--plugin=prettier-plugin-tailwindcss`,`--ignore-path=${Fe(`.gitignore`)??`.gitignore`}`,`--ignore-path=${Fe(`.prettierignore`)??`.prettierignore`}`],Xt={commands:{fix:{commands:[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`prettier`},collect:{parse:Jt},name:`prettier`,optionFlags:[...Yt,`--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:Jt},name:`prettier`,optionFlags:[...Yt,`--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},Zt={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},Qt=[/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],$t=[`node_modules/**`,`test/**`];function en(e){let t=e;for(let e of Qt)e.lastIndex=0,t=t.replace(e,e=>e.replaceAll(/\d/gv,`X`));return t}const tn=/(\d{4})\s*-\s*(\d{4})/v,nn=/(\d{4})/v;function rn(e,t){let n=en(e),r=tn,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=nn,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 an(e){let t=new Date().getFullYear(),n=await ue([`**/license.txt`,`**/license`,...$t.map(e=>`!${e}`)],{caseSensitiveMatch:!1,cwd:N(),followSymbolicLinks:!1,gitignore:!0}),r=[];for(let i of n)try{let n=await b.readFile(i,`utf8`),a=rn(n,t);a!==n&&(r.push(i),e&&await b.writeFile(i,a,`utf8`))}catch(e){console.error(`Failed to process ${i}:`,e)}return r}async function on(e,t=!1){let n=await an(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 sn(e){return on(e,!1)}async function cn(){let e=await an(!1);return{diagnostics:e.map(e=>({file:O(e,N()),message:`License file has an outdated copyright year`,severity:`error`,tool:`copyright-year`})),exitCode:+(e.length>0),unparsed:[]}}async function ln(e){return on(e,!0)}const un=`pnpm-lock.yaml`;function dn(e){let t=P(),n=s.resolve(e);for(;;){if(r.existsSync(s.join(n,un)))return n;if(n===t)break;let e=s.dirname(n);if(e===n)break;n=e}}function fn(e,t,n){let r=`${e}@${t}`;if(Object.hasOwn(n,r))return r;if(Object.hasOwn(n,t))return t}function pn(e,t){return e===void 0||e===``?t===void 0||t===``?void 0:t:t===void 0||t===``||de(e,t)?e:t}async function mn(e){let t=dn(e);if(t===void 0||t===``)throw Error(`${un} not found at or above "${e}".`);let n=s.join(t,un),r=await pe(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=fn(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=fe(c)?.version;e!==void 0&&e!==``&&(n===void 0||n===``||de(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===``||de(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=pn(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 hn(e){let t=e.devEngines;if(t?.runtime)return(Array.isArray(t.runtime)?t.runtime:[t.runtime]).find(e=>e.name===`node`)?.version}function gn(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 _n(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 vn(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=hn(i),c=await mn(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=C.minVersion(a),n=C.minVersion(l);t&&n&&C.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=C.minVersion(l),t=C.minVersion(a);if(e&&t)return C.gt(e,t)?l:a}return l??a})(),h=m!==void 0&&m!==``?C.minVersion(m):void 0,g=d!==void 0&&d!==``?C.minVersion(d):void 0,_=g&&h&&C.gt(g,h);if(d!==void 0&&_)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}"${J(f)}`),e&&gn(i,d);else{let t=C.minVersion(o);t&&C.lt(t,g)&&(p.push(`devEngines.runtime.version for node is "${o}" but all dependencies require at least "${d}"${J(f)}`),e&&gn(i,d))}else if(o!==void 0){let t=C.minVersion(o);t&&h&&C.lte(t,h)&&(p.push(`devEngines.runtime.version for node is redundant (engines.node already covers the requirement) — suggest removing`),e&&_n(i))}return e&&p.length>0&&(r.writeJsonSync(n,i,{spaces:` `}),await F(n)),{issues:p,packageJsonPath:n}}async function yn(e,t){let n=M(),r=0;for(let i of n){let{issues:n,packageJsonPath:a}=await vn(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 bn(){let e=M(),t=[];for(let n of e){let{issues:e,packageJsonPath:r}=await vn(!1,n);for(let n of e)t.push({file:O(r,process.cwd()),message:n,severity:`error`,tool:`node-version`})}return{diagnostics:t,exitCode:+(t.length>0),unparsed:[]}}async function xn(e){let t=A(await mn(N())).split(`
|
|
11
|
+
`);for(let n of t)e.write(`${n}\n`);return 0}async function Sn(e){return yn(e,!1)}async function Cn(e){return yn(e,!0)}const wn={commands:{fix:{commands:[{execute:ln,name:`copyright-year`},{execute:Cn,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:cn,execute:sn,name:`copyright-year`},{collect:bn,execute:Sn,name:`node-version`}],description:`Check the repo for common issues. ${q.packageRun} ${q.monorepoRun}`,positionalArgumentMode:`none`},printConfig:{commands:[{execute:xn,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},Y=[`--ignore-path`,Fe(`.gitignore`)??`.gitignore`,`--allow-empty-input`],Tn=`**/*.{${[`css`,`scss`,`sass`,`svelte`,`html`,`astro`,`tsx`,`jsx`,`php`,`vue`].join(`,`)}}`;function En(e){let t;try{t=JSON.parse(e.stderr)}catch{return{diagnostics:[],unparsed:[...k(e.stdout),...k(e.stderr)]}}let n=[];for(let r of t){let t=O(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:k(e.stdout)}}async function Dn(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=Ie(`package-dir`):(o=s.join(process.cwd(),c),e.write(`Showing config for file at "${o}"\n`));let l=A(await me.resolveConfig(o)).split(`
|
|
13
|
+
`);for(let t of l)e.write(`${t}\n`);return 0}const On={commands:{fix:{commands:[{cache:{flags:[`--cache`,`--cache-strategy`,`content`],name:`stylelint`},collect:{optionFlags:[...Y,`--fix`,`--formatter`,`json`],parse:En},name:`stylelint`,optionFlags:[...Y,`--fix`],receivePositionalArguments:!0}],description:`Fix your project with Stylelint. ${q.fileRun}`,positionalArgumentDefault:Tn,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:[...Y,`--formatter`,`json`],parse:En},name:`stylelint`,optionFlags:Y,receivePositionalArguments:!0}],description:`Lint your project with Stylelint. ${q.fileRun}`,positionalArgumentDefault:Tn,positionalArgumentMode:`optional`},printConfig:{commands:[{execute:Dn,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},kn=/^\s/v,An=/\berror\b|\bfailed\b|\bfailure\b/iv;function jn(e,t,n,r){return e.exitCode!==0&&t.every(({severity:e})=>e!==`error`)&&t.push({message:r.find(e=>An.test(e))??`${n} exited with code ${e.exitCode} without a parseable error.`,severity:`error`,tool:n}),{diagnostics:t,unparsed:r}}function Mn(e){return kn.test(e)}function X(e){return typeof e==`object`&&!!e}function Z(e){try{let t=JSON.parse(e);return typeof t==`string`?t:void 0}catch{return}}const Nn=/^(?<file>.+?):(?<line>\d+):(?<column>\d+) - (?<severity>error|warning|hint) (?<rule>[^:]+): (?<message>.*)$/v,Pn=/^(?:\d{2}:\d{2}:\d{2} )?(?:✘ )?\[(?<severity>ERROR|WARN)\](?: \[(?<label>[^\]]+)\])? (?<message>.*)$/v,Fn=/^\d{2}:\d{2}:\d{2}\s+\[(?!ERROR\]|WARN\])[^\]]+\]\s+/v,In=/^(?:Result \(\d+ files?\):|- \d+ (?:errors?|warnings?|hints?))$/v,Ln=/^(?:\d+\s.*|\s*[~^]+)$/v;function Rn(e){try{let t=JSON.parse(e);return!X(t)||typeof t.message!=`string`||t.level!==`debug`&&t.level!==`error`&&t.level!==`info`&&t.level!==`warn`?void 0:{...typeof t.label==`string`&&t.label.length>0&&{label:t.label},level:t.level,message:t.message}}catch{return}}function zn(e){if(e.level===`error`||e.level===`warn`)return{...e.label!==void 0&&{rule:e.label},message:e.message,severity:e.level===`error`?`error`:`warning`,tool:`astro`}}function Bn(e,t){let n=Nn.exec(e);if(n?.groups===void 0)return;let{column:r,file:i,line:a,message:o,rule:s,severity:c}=n.groups;return{column:Number(r),file:O(i??``,t),line:Number(a),message:o??``,rule:s?.trim()??`unknown`,severity:c===`error`?`error`:c===`hint`?`info`:`warning`,tool:`astro`}}function Vn(e){let t=Pn.exec(e);if(t?.groups===void 0)return;let{label:n,message:r,severity:i}=t.groups;return{...n!==void 0&&{rule:n},message:r??``,severity:i===`ERROR`?`error`:`warning`,tool:`astro`}}function Hn(e){let t=e.trimEnd();return Fn.test(t)||In.test(t)||t.startsWith(`Getting diagnostics for Astro files in `)}function Un(e){let t=[],n=[];for(let r of k(`${e.stdout}\n${e.stderr}`)){let i=Rn(r);if(i!==void 0){let e=zn(i);e!==void 0&&t.push(e);continue}let a=Bn(r,e.cwd)??Vn(r);if(a!==void 0){t.push(a);continue}if(Hn(r)||Ln.test(r))continue;let o=t.at(-1);if(o!==void 0&&Mn(r)){o.message+=`\n${r.trim()}`;continue}n.push(r)}return jn(e,t,`astro`,n)}const Wn=/^(?:Loading svelte-check in workspace: |Getting Svelte diagnostics\.\.\.|svelte-check found 0 errors and 0 warnings$)/v,Gn=/^\d+ (?:START "|COMPLETED \d+ FILES 0 ERRORS 0 WARNINGS 0 FILES_WITH_PROBLEMS$)/v,Kn=/^\d+ (?:START "|COMPLETED \d+ FILES \d+ ERRORS \d+ WARNINGS \d+ FILES_WITH_PROBLEMS$)/v,qn=/^\d+ (?<severity>ERROR|WARNING) (?<file>"(?:\\.|[^"\\])*") (?<line>\d+):(?<column>\d+) (?<message>"(?:\\.|[^"\\])*")$/v,Jn=/^\d+ FAILURE (?<message>.+)$/v,Yn=/^\d+\s/v;function Xn(e,t){let n=typeof e==`string`&&e.length>0?e:void 0,r=typeof t==`string`||typeof t==`number`?String(t):void 0;return n!==void 0&&r!==void 0?`${n}(${r})`:n??r}function Zn(e,t){let n=e.indexOf(`{`);if(!(n<=0||!Yn.test(e)))try{let r=JSON.parse(e.slice(n));if(!X(r)||r.type!==`ERROR`&&r.type!==`WARNING`||typeof r.filename!=`string`||typeof r.message!=`string`||!X(r.start)||typeof r.start.line!=`number`||typeof r.start.character!=`number`)return;let i=X(r.end)?r.end:void 0,a=Xn(r.source,r.code);return{column:r.start.character+1,...i!==void 0&&typeof i.character==`number`&&{endColumn:i.character+1},...i!==void 0&&typeof i.line==`number`&&{endLine:i.line+1},file:O(r.filename,t),line:r.start.line+1,message:r.message,...a!==void 0&&{rule:a},severity:r.type===`ERROR`?`error`:`warning`,tool:`svelte-check`}}catch{return}}function Qn(e,t){let n=qn.exec(e);if(n?.groups===void 0)return;let{column:r,file:i,line:a,message:o,severity:s}=n.groups,c=Z(i??``),l=Z(o??``);if(c!==void 0&&l!==void 0)return{column:Number(r),file:O(c,t),line:Number(a),message:l,severity:s===`ERROR`?`error`:`warning`,tool:`svelte-check`}}function $n(e){let t=Jn.exec(e);if(t?.groups===void 0)return;let n=t.groups.message??``;return{message:Z(n)??n,severity:`error`,tool:`svelte-check`}}function er(e){return Wn.test(e)||Gn.test(e)}function tr(e){let t=[],n=[];for(let r of k(`${e.stdout}\n${e.stderr}`)){let i=Zn(r,e.cwd)??Qn(r,e.cwd)??$n(r);if(i!==void 0){t.push(i);continue}!Kn.test(r)&&!er(r)&&n.push(r)}return jn(e,t,`svelte-check`,n)}const nr=/^(?<file>.+?)\((?<line>\d+),(?<column>\d+)\): (?<severity>error|warning) (?<code>TS\d+): (?<message>.*)$/v,rr=/^(?<severity>error|warning) (?<code>TS\d+): (?<message>.*)$/v;function ir(e){let t=[],n=[];for(let r of k(`${e.stdout}\n${e.stderr}`)){let i=nr.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:O(a??``,e.cwd),line:Number(o),message:s??``,rule:n,severity:c===`warning`?`warning`:`error`,tool:`tsc`});continue}let a=rr.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&&Mn(r)){o.message+=`\n${r.trim()}`;continue}n.push(r)}return jn(e,t,`tsc`,n)}async function ar(e){let t=await r.readJson(s.join(e,`package.json`));return new Set([...Object.keys(t.dependencies??{}),...Object.keys(t.devDependencies??{})])}function or(e,t=`package-dir`){let n=e.has(`@astrojs/check`),r=e.has(`svelte-check`);if(n||r){let e=[];if(n&&e.push({collect:{optionFlags:[`--json`],parse:Un},cwdOverride:t,name:`astro`,outputFilter:Hn,subcommands:[`check`]}),r){let r=n?[]:[`--tsconfig`,`./tsconfig.json`];e.push({collect:{optionFlags:[...r,`--output`,`machine-verbose`],parse:tr},cwdOverride:t,name:`svelte-check`,optionFlags:r,outputFilter:er})}return e}return[{collect:{parse:ir},cwdOverride:t,name:`tsc`,optionFlags:[`--noEmit`]}]}function sr(e){let t=e.some(({hasTypeScriptConfig:e})=>e);return e.flatMap(({dependencies:e,directory:n,hasTypeScriptConfig:r},i)=>{let a=e.has(`@astrojs/check`)||e.has(`svelte-check`);return r||a||!t&&i===0?or(e,n):[]})}async function cr(){let e=M();return sr(await Promise.all(e.map(async e=>{let[t,n]=await Promise.all([ar(e),r.pathExists(s.join(e,`tsconfig.json`))]);return{dependencies:t,directory:e,hasTypeScriptConfig:n}})))}const Q=[Pt,jt,Vt,Gt,Xt,Zt,wn,On,{commands:{init:{locationOptionFlag:!1},lint:{commands:cr,description:`Run type checking on your project. ${q.packageRun} ${q.monorepoRun}`,positionalArgumentMode:`none`,showResolvedCommands:!0},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}],lr={"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,showResolvedCommands:n.showResolvedCommands,stage:e===`fix`?lr[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 dt({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/dist/index.d.ts
CHANGED
|
@@ -2,8 +2,9 @@ import { FileType, FileType as FileType$1 } from "@kitschpatrol/prettier-config"
|
|
|
2
2
|
//#region src/api.d.ts
|
|
3
3
|
/**
|
|
4
4
|
* Fix a source string by running all shared-config tools in sequence: Mdat →
|
|
5
|
-
* ESLint → Stylelint → Prettier.
|
|
6
|
-
* understand
|
|
5
|
+
* ESLint → Stylelint → Prettier. Mdat only runs for Markdown file type hints.
|
|
6
|
+
* ESLint and Stylelint silently skip content they don't understand, while
|
|
7
|
+
* Prettier errors are propagated.
|
|
7
8
|
*
|
|
8
9
|
* @param source - The source code to fix.
|
|
9
10
|
* @param fileType - A file extension (e.g. `'ts'`, `'css'`, `'md'`) or virtual
|
|
@@ -14,8 +15,9 @@ import { FileType, FileType as FileType$1 } from "@kitschpatrol/prettier-config"
|
|
|
14
15
|
declare function fix(source: string, fileType?: FileType$1): Promise<string>;
|
|
15
16
|
/**
|
|
16
17
|
* Fix a file in place by running all shared-config tools in sequence: Mdat →
|
|
17
|
-
* ESLint → Stylelint → Prettier.
|
|
18
|
-
* understand
|
|
18
|
+
* ESLint → Stylelint → Prettier. Mdat only runs for Markdown files. ESLint and
|
|
19
|
+
* Stylelint silently skip files they don't understand, while Prettier errors
|
|
20
|
+
* are propagated.
|
|
19
21
|
*
|
|
20
22
|
* @param filePath - Path to the file to fix.
|
|
21
23
|
*/
|
package/dist/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{clearCache as e,fix as t,fixFile as n}from"@kitschpatrol/eslint-config";import{clearCache as r,fix as i,fixFile as a}from"@kitschpatrol/mdat-config";import{clearCache as o,fix as s,fixFile as c}from"@kitschpatrol/prettier-config";import{clearCache as l,fix as u,fixFile as d}from"@kitschpatrol/stylelint-config";
|
|
1
|
+
import{clearCache as e,fix as t,fixFile as n}from"@kitschpatrol/eslint-config";import{clearCache as r,fix as i,fixFile as a}from"@kitschpatrol/mdat-config";import{clearCache as o,fix as s,fixFile as c}from"@kitschpatrol/prettier-config";import{clearCache as l,fix as u,fixFile as d}from"@kitschpatrol/stylelint-config";import f from"node:path";const p=new Set([`markdown`,`md`]),m=/^\./v;function h(e){if(e===void 0)return!1;let t=f.extname(e),n=t===``?e:t;return p.has(n.replace(m,``).toLowerCase())}async function g(e,n){let r=e;h(n)&&(r=await i(r));try{r=await t(r,n)}catch{}try{r=await u(r,n)}catch{}return r=await s(r,n),r}async function _(e){h(e)&&await a(e);try{await n(e)}catch{}try{await d(e)}catch{}await c(e)}function v(){r(),e(),l(),o()}export{v as clearCache,g as fix,_ as fixFile};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kitschpatrol/shared-config",
|
|
3
|
-
"version": "8.
|
|
3
|
+
"version": "8.4.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",
|
|
@@ -72,19 +72,19 @@
|
|
|
72
72
|
"mdat": "^2.3.6",
|
|
73
73
|
"package-up": "^5.0.0",
|
|
74
74
|
"picocolors": "^1.1.1",
|
|
75
|
-
"prettier": "^3.9.
|
|
75
|
+
"prettier": "^3.9.6",
|
|
76
76
|
"semver": "^7.8.5",
|
|
77
|
-
"stylelint": "^17.14.
|
|
77
|
+
"stylelint": "^17.14.1",
|
|
78
78
|
"yargs": "^18.0.0",
|
|
79
|
-
"@kitschpatrol/cspell-config": "8.
|
|
80
|
-
"@kitschpatrol/eslint-config": "8.
|
|
81
|
-
"@kitschpatrol/
|
|
82
|
-
"@kitschpatrol/
|
|
83
|
-
"@kitschpatrol/prettier-config": "8.
|
|
84
|
-
"@kitschpatrol/
|
|
85
|
-
"@kitschpatrol/
|
|
86
|
-
"@kitschpatrol/
|
|
87
|
-
"@kitschpatrol/stylelint-config": "8.
|
|
79
|
+
"@kitschpatrol/cspell-config": "8.4.0",
|
|
80
|
+
"@kitschpatrol/eslint-config": "8.4.0",
|
|
81
|
+
"@kitschpatrol/remark-config": "8.4.0",
|
|
82
|
+
"@kitschpatrol/knip-config": "8.4.0",
|
|
83
|
+
"@kitschpatrol/prettier-config": "8.4.0",
|
|
84
|
+
"@kitschpatrol/mdat-config": "8.4.0",
|
|
85
|
+
"@kitschpatrol/repo-config": "8.4.0",
|
|
86
|
+
"@kitschpatrol/typescript-config": "8.4.0",
|
|
87
|
+
"@kitschpatrol/stylelint-config": "8.4.0"
|
|
88
88
|
},
|
|
89
89
|
"engines": {
|
|
90
90
|
"node": "^24.16.0 || >=26.3.0"
|
package/readme.md
CHANGED
|
@@ -330,7 +330,7 @@ Recall that the `@kitschpatrol/shared-config` package aggregates integration and
|
|
|
330
330
|
|
|
331
331
|
### API
|
|
332
332
|
|
|
333
|
-
The package also exports `fix`, `fixFile` functions that run
|
|
333
|
+
The package also exports `fix`, `fixFile` functions that run shared-config tools in sequence, matching the order of `ksc fix`: Mdat → ESLint → Stylelint → Prettier. Mdat is only applied to Markdown file type hints and paths. ESLint and Stylelint silently skip content they don't understand, while Prettier errors are propagated.
|
|
334
334
|
|
|
335
335
|
The CLI is preferred, but there are occasionally edge cases where it's handy to run a string or a generated file through the shared-config pipeline without leaving TypeScript.
|
|
336
336
|
|