routie dev init since i didn't adhere to any proper guidance up until now

frontend/node_modules/eslint-plugin-unicorn/rules/text-encoding-identifier-case.js

@@ -0,0 +1,148 @@
+import {replaceStringRaw} from './fix/index.js';
+import {isMethodCall, isNewExpression} from './ast/index.js';
+
+const MESSAGE_ID_ERROR = 'text-encoding-identifier/error';
+const MESSAGE_ID_SUGGESTION = 'text-encoding-identifier/suggestion';
+const messages = {
+	[MESSAGE_ID_ERROR]: 'Prefer `{{replacement}}` over `{{value}}`.',
+	[MESSAGE_ID_SUGGESTION]: 'Replace `{{value}}` with `{{replacement}}`.',
+};
+
+const getReplacement = (encoding, withDash) => {
+	switch (encoding.toLowerCase()) {
+		// eslint-disable-next-line unicorn/text-encoding-identifier-case
+		case 'utf-8':
+		case 'utf8': {
+			// eslint-disable-next-line unicorn/text-encoding-identifier-case
+			return withDash ? 'utf-8' : 'utf8';
+		}
+
+		case 'ascii': {
+			return 'ascii';
+		}
+		// No default
+	}
+};
+
+// `fs.{readFile,readFileSync}()`
+const isFsReadFileEncoding = node =>
+	isMethodCall(node.parent, {
+		methods: ['readFile', 'readFileSync'],
+		optionalCall: false,
+		optionalMember: false,
+	})
+	&& node.parent.arguments[1] === node
+	&& node.parent.arguments[0].type !== 'SpreadElement';
+
+const isJsxElementAttributes = (node, {element, attributes}) =>
+	node.parent.type === 'JSXAttribute'
+	&& node.parent.value === node
+	&& node.parent.name.type === 'JSXIdentifier'
+	&& attributes.includes(node.parent.name.name.toLowerCase())
+	&& node.parent.parent.type === 'JSXOpeningElement'
+	&& node.parent.parent.attributes.includes(node.parent)
+	&& node.parent.parent.name.type === 'JSXIdentifier'
+	&& node.parent.parent.name.name.toLowerCase() === element;
+
+const shouldEnforceDash = node =>
+	isJsxElementAttributes(node, {element: 'meta', attributes: ['charset']})
+	|| isJsxElementAttributes(node, {element: 'form', attributes: ['acceptCharset', 'accept-charset'].map(attribute => attribute.toLowerCase())})
+	|| (isNewExpression(node.parent, {name: 'TextDecoder'}) && node.parent.arguments[0] === node);
+
+const getStringLiteralValue = node => {
+	if (node.type === 'Literal') {
+		if (typeof node.value !== 'string') {
+			return;
+		}
+
+		return node.raw.slice(1, -1);
+	}
+
+	if (
+		node.type === 'TemplateLiteral'
+		&& node.parent.type !== 'TaggedTemplateExpression'
+		&& node.expressions.length === 0
+		&& node.quasis.length === 1
+	) {
+		return node.quasis[0].value.raw;
+	}
+};
+
+/** @param {import('eslint').Rule.RuleContext} context */
+const create = context => {
+	const options = context.options[0];
+
+	context.on(['Literal', 'TemplateLiteral'], node => {
+		const value = getStringLiteralValue(node);
+		if (!value) {
+			return;
+		}
+
+		const withDash = options.withDash || shouldEnforceDash(node);
+
+		const replacement = getReplacement(value, withDash);
+		if (!replacement || replacement === value) {
+			return;
+		}
+
+		/** @param {import('eslint').Rule.RuleFixer} fixer */
+		const fix = fixer => replaceStringRaw(node, replacement, context, fixer);
+
+		const problem = {
+			node,
+			messageId: MESSAGE_ID_ERROR,
+			data: {
+				value,
+				replacement,
+			},
+		};
+
+		if (isFsReadFileEncoding(node)) {
+			problem.fix = fix;
+			return problem;
+		}
+
+		problem.suggest = [
+			{
+				messageId: MESSAGE_ID_SUGGESTION,
+				fix: fixer => replaceStringRaw(node, replacement, context, fixer),
+			},
+		];
+
+		return problem;
+	});
+};
+
+const schema = [
+	{
+		type: 'object',
+		additionalProperties: false,
+		properties: {
+			withDash: {
+				type: 'boolean',
+				description: 'Whether to prefer identifiers with a dash, like `utf-8` instead of `utf8`.',
+			},
+		},
+	},
+];
+
+/** @type {import('eslint').Rule.RuleModule} */
+const config = {
+	create,
+	meta: {
+		type: 'suggestion',
+		docs: {
+			description: 'Enforce consistent case for text encoding identifiers.',
+			recommended: 'unopinionated',
+		},
+		fixable: 'code',
+		hasSuggestions: true,
+		schema,
+		defaultOptions: [{
+			withDash: false,
+		}],
+		messages,
+	},
+};
+
+export default config;