Configs Reference

License NPM Version Open Issues

⚙️ Shared project configuration files for linting, formatting, documentation and so on.

Configurations

🦋 changelog.cjs — Changesets changelog functions.
🚨 eslint.config.js — JavaScript and TypeScript linting.
✨ prettier.config.js — Code formatting.
🎨 stylelint.config.js — CSS linting.
🏷️ typescript.config.json — TypeScript configuration (strict).
📖 typedoc.config.json — Documentation configuration.

Usage

All this configurations are setup automatically by @lou.codes/create-package when creating a new package.

For manual setup of each file, use the examples below:

1
{
2
	"$schema": "https://raw.githubusercontent.com/changesets/changesets/main/packages/config/schema.json",
3
	"changelog": "@lou.codes/configs/changelog.cjs",
4
	"commit": false,
5
	"access": "restricted",
6
	"baseBranch": "main",
7
	"updateInternalDependencies": "patch"
8
}

1
export { default } from "@lou.codes/configs/eslint.config.js";

1
export { default } from "@lou.codes/configs/prettier.config.js";

1
export { default } from "@lou.codes/configs/stylelint.config.js";

1
{
2
	"extends": "@lou.codes/configs/typescript.config.json"
3
}

1
{
2
	"$schema": "https://typedoc.org/schema.json",
3
	"cname": "PUBLIC DOMAIN",
4
	"entryPoints": ["./lib"],
5
	"extends": ["@lou.codes/configs/typedoc.config.json"],
6
	"name": "PACKAGE NAME"
7
}

Useful links

⏳ Changelog: List of changes between versions.

Variables

eslintConfig

1
const eslintConfig: readonly [
2
	object,
3
	object,
4
	object,
5
	object,
6
	object,
7
	object,
8
	object,
9
	object,
10
];

typedocConfig

1
typedocConfig: object;

Type declaration

Member	Type	Value
`$schema`	`string`	”https://typedoc.org/schema.json”
`disableSources`	`boolean`	true
`entryPoints`	`string`[]	…
`extends`	`string`[]	…

typescriptConfig

1
typescriptConfig: object;

Type declaration

Member	Type	Value
`$schema`	`string`	”https://json.schemastore.org/tsconfig”
`compilerOptions`	`object`	…
`compilerOptions.allowJs`	`boolean`	true
`compilerOptions.checkJs`	`boolean`	true
`compilerOptions.declaration`	`boolean`	true
`compilerOptions.exactOptionalPropertyTypes`	`boolean`	true
`compilerOptions.forceConsistentCasingInFileNames`	`boolean`	true
`compilerOptions.jsx`	`string`	”react-jsx”
`compilerOptions.module`	`string`	”NodeNext”
`compilerOptions.moduleResolution`	`string`	”NodeNext”
`compilerOptions.newLine`	`string`	”LF”
`compilerOptions.noEmitOnError`	`boolean`	true
`compilerOptions.noFallthroughCasesInSwitch`	`boolean`	true
`compilerOptions.noImplicitOverride`	`boolean`	true
`compilerOptions.noImplicitReturns`	`boolean`	true
`compilerOptions.noUncheckedIndexedAccess`	`boolean`	true
`compilerOptions.noUnusedLocals`	`boolean`	true
`compilerOptions.noUnusedParameters`	`boolean`	true
`compilerOptions.preserveSymlinks`	`boolean`	true
`compilerOptions.resolveJsonModule`	`boolean`	true
`compilerOptions.skipLibCheck`	`boolean`	true
`compilerOptions.strict`	`boolean`	true
`compilerOptions.target`	`string`	”ESNext”
`compilerOptions.verbatimModuleSyntax`	`boolean`	true

Namespace: changesetsConfig

Functions

getDependencyReleaseLine()

1
function getDependencyReleaseLine(
2
	_changesets: NewChangesetWithCommit[],
3
	dependenciesUpdated: ModCompWithPackage[],
4
): Promise<string>;

Parameters

Parameter	Type
`_changesets`	`NewChangesetWithCommit`[]
`dependenciesUpdated`	`ModCompWithPackage`[]

Returns

Promise<string>

getReleaseLine()

1
function getReleaseLine(
2
	__namedParameters: NewChangesetWithCommit,
3
): Promise<string>;

Parameters

Parameter	Type
`__namedParameters`	`NewChangesetWithCommit`

Returns

Promise<string>

Namespace: prettierConfig

Variables

arrowParens

1
arrowParens: "avoid";

bracketSameLine

1
bracketSameLine: false;

bracketSpacing

1
bracketSpacing: true;

embeddedLanguageFormatting

1
embeddedLanguageFormatting: "auto";

endOfLine

1
endOfLine: "lf";

experimentalTernaries

1
experimentalTernaries: true;

htmlWhitespaceSensitivity

1
htmlWhitespaceSensitivity: "strict";

jsxSingleQuote

1
jsxSingleQuote: false;

printWidth

1
printWidth: 80;

proseWrap

1
proseWrap: "always";

quoteProps

1
quoteProps: "as-needed";

semi

1
semi: true;

singleAttributePerLine

1
singleAttributePerLine: false;

singleQuote

1
singleQuote: false;

tabWidth

1
tabWidth: 4;

trailingComma

1
trailingComma: "all";

useTabs

1
useTabs: true;

vueIndentScriptAndStyle

1
vueIndentScriptAndStyle: true;

Namespace: stylelintConfig

Variables

defaultSeverity

1
defaultSeverity: "error";

extends

1
extends: ["stylelint-prettier/recommended"];

plugins

1
plugins: [Plugin];

rules

1
rules: object;

Type declaration

Member	Type	Description
`alpha-value-notation`	`"number"`	Alpha-values must always use the number notation. See alpha-value-notation
`at-rule-empty-line-before`	readonly [`"always"`, `object`]	There must always be an empty line before at-rules. See at-rule-empty-line-before
`color-function-notation`	`"modern"`	Applicable color-functions must always use modern notation. See color-function-notation
`color-hex-length`	`"short"`	Specify short notation for hex colors. See color-hex-length
`color-named`	`"never"`	Colors must never be named. See color-named
`custom-property-pattern`	`"^[a-z][a-z0-9-]*$"`	Specify a pattern for custom properties. See custom-property-pattern
`declaration-no-important`	`true`	Disallow !important within declarations. See declaration-no-important
`declaration-property-value-no-unknown`	`true`	Disallow unknown values for properties within declarations. See declaration-property-value-no-unknown
`font-weight-notation`	`"numeric"`	Font weight values must always be numbers. See font-weight-notation
`function-name-case`	`"lower"`	Specify lowercase for function names. See function-name-case
`function-url-no-scheme-relative`	`true`	Disallow scheme-relative urls. See function-url-no-scheme-relative
`function-url-quotes`	`"always"`	Disallow quotes for urls. See function-url-quotes
`function-url-scheme-allowed-list`	readonly [`"data"`, `"/^http/"`]	Specify a list of allowed URL schemes. See function-url-scheme-allowed-list
`hue-degree-notation`	`"angle"`	Degree hues must always use angle notation. See hue-degree-notation
`import-notation`	`"url"`	`@import` rules must always use URL notation. See import-notation
`keyframe-selector-notation`	`"keyword"`	Keyframe selectors must always use the keyword notation. See keyframe-selector-notation
`keyframes-name-pattern`	`"^[a-z][a-z0-9-]*$"`	Specify a pattern for keyframe names. See keyframes-name-pattern
`length-zero-no-unit`	`true`	Disallow units for zero lengths. See length-zero-no-unit
`media-feature-range-notation`	`"context"`	Media feature ranges must always use context notation. See media-feature-range-notation
`order/properties-alphabetical-order`	`true`	Keep properties in alphabetical order. See order/properties-alphabetical-order
`rule-empty-line-before`	readonly [`"always"`, `object`]	There must always be an empty line before rules. See rule-empty-line-before
`selector-attribute-quotes`	`"always"`	Attribute values must never be quoted. See selector-attribute-quotes
`selector-max-id`	`1`	Limit the number of ID selectors in a selector. See selector-max-id
`selector-not-notation`	`"complex"`	Specify complex notation for :not () pseudo-class selectors. See selector-not-notation
`selector-pseudo-element-colon-notation`	`"double"`	Applicable pseudo-elements must always use the double colon notation. See selector-pseudo-element-colon-notation
`selector-type-case`	`"lower"`	Specify lowercase for type selectors. See selector-type-case
`shorthand-property-no-redundant-values`	`true`	Disallow redundant values within shorthand properties. See shorthand-property-no-redundant-values
`value-keyword-case`	readonly [`"lower"`, `object`]	Specify lowercase for keywords values (camel for SVG keywords). See value-keyword-case