@lyliya/stylelint-value-no-unknown-custom-properties/src/lib/get-custom-properties-from-imports.mjs

A stylelint rule to disallow usage of unknown custom properties

import fs from 'node:fs/promises';
import path from 'node:path';
import postcss from 'postcss';
import getCustomPropertiesFromRoot from './get-custom-properties-from-root.mjs';

/* Get Custom Properties from CSS File
/* ========================================================================== */

async function getCustomPropertiesFromCSSFile(from, resolver) {
	const css = await fs.readFile(from, 'utf-8');
	const root = postcss.parse(css, { from });

	return await getCustomPropertiesFromRoot(root, resolver);
}

/* Get Custom Properties from Object
/* ========================================================================== */

function getCustomPropertiesFromObject(object) {
	return Object.assign(
		{},
		Object( object ).customProperties,
		Object( object )[ 'custom-properties' ],
	);
}

/* Get Custom Properties from JSON file
/* ========================================================================== */

async function getCustomPropertiesFromJSONFile(from) {
	const object = await readJSON(from);

	return getCustomPropertiesFromObject(object);
}

/* Get Custom Properties from JS file
/* ========================================================================== */

async function getCustomPropertiesFromJSFile(from) {
	const object = await import(from);
	if ('default' in object) {
		return getCustomPropertiesFromObject(object.default);
	}

	return getCustomPropertiesFromObject(object);
}

/* Get Custom Properties from Sources
/* ========================================================================== */

export default function getCustomPropertiesFromSources(sources, resolver) {
	return sources.map(source => {
		if (source instanceof Promise) {
			return source;
		} else if (source instanceof Function) {
			return source();
		}

		// read the source as an object
		const opts = source === Object(source) ? source : { from: String(source) };

		// skip objects with Custom Properties
		if (opts.customProperties || opts['custom-properties']) {
			return opts;
		}

		// source pathname
		const from = path.resolve(String(opts.from || ''));

		// type of file being read from
		const type = (opts.type || path.extname(from).slice(1)).toLowerCase();

		return { type, from };
	}).reduce(async (customProperties, source) => {
		const { type, from } = await source;

		if (type === 'css') {
			return Object.assign(await customProperties, await getCustomPropertiesFromCSSFile(from, resolver));
		}

		if (type === 'js' || type === 'mjs' || type === 'cjs') {
			return Object.assign(await customProperties, await getCustomPropertiesFromJSFile(from));
		}

		if (type === 'json') {
			return Object.assign(await customProperties, await getCustomPropertiesFromJSONFile(from));
		}

		return Object.assign(await customProperties, await getCustomPropertiesFromObject(await source));
	}, {});
}

/* Promise-ified utilities
/* ========================================================================== */
const readJSON = async from => JSON.parse(await fs.readFile(from, 'utf-8'));