styles-config 2.0.0-alpha.5 → 2.0.0-alpha.6

package/lib/index.cjs

@@ -0,0 +1,226 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let cosmiconfig = require("cosmiconfig");
+let picomatch = require("picomatch");
+picomatch = __toESM(picomatch);
+let path = require("path");
+path = __toESM(path);
+//#region src/loader.ts
+const explorer = (0, cosmiconfig.cosmiconfig)("styles", {
+	searchPlaces: [
+		"styles.config.ts",
+		"styles.config.js",
+		"styles.config.mts",
+		"styles.config.mjs",
+		"styles.config.cjs",
+		"styles.config.cts"
+	],
+	loaders: {
+		".mts": cosmiconfig.defaultLoadersSync[".ts"],
+		".cts": cosmiconfig.defaultLoadersSync[".ts"],
+		".mjs": cosmiconfig.defaultLoadersSync[".js"],
+		".cjs": cosmiconfig.defaultLoadersSync[".cjs"]
+	}
+});
+const explorerSync = (0, cosmiconfig.cosmiconfigSync)("styles", {
+	searchPlaces: [
+		"styles.config.ts",
+		"styles.config.js",
+		"styles.config.mts",
+		"styles.config.mjs",
+		"styles.config.cjs",
+		"styles.config.cts"
+	],
+	loaders: {
+		".mts": cosmiconfig.defaultLoadersSync[".ts"],
+		".cts": cosmiconfig.defaultLoadersSync[".ts"],
+		".mjs": cosmiconfig.defaultLoadersSync[".js"],
+		".cjs": cosmiconfig.defaultLoadersSync[".cjs"]
+	}
+});
+/**
+* Load styles configuration from the file system (async)
+* @param searchFrom - Directory to search from (defaults to process.cwd())
+* @returns Configuration object or null if not found
+*/
+async function loadConfig(searchFrom) {
+	const result = await explorer.search(searchFrom);
+	return result?.config ? normalizeConfig(result.config) : null;
+}
+/**
+* Load styles configuration from the file system (sync)
+* @param searchFrom - Directory to search from (defaults to process.cwd())
+* @returns Configuration object or empty object if not found
+*/
+function loadConfigSync(searchFrom) {
+	const result = explorerSync.search(searchFrom);
+	return result?.config ? normalizeConfig(result.config) : {};
+}
+/**
+* Load styles configuration with metadata (sync).
+* Includes config file path when a config file is discovered.
+*/
+function loadConfigSyncWithMeta(searchFrom) {
+	const result = explorerSync.search(searchFrom);
+	return {
+		config: result?.config ? normalizeConfig(result.config) : {},
+		configFilePath: result?.filepath
+	};
+}
+/**
+* Load styles configuration from a specific file path (async)
+* @param filePath - Path to the config file
+* @returns Configuration object or null if not found
+*/
+async function loadConfigFromPath(filePath) {
+	const result = await explorer.load(filePath);
+	return result?.config ? normalizeConfig(result.config) : null;
+}
+/**
+* Load styles configuration from a specific file path (sync)
+* @param filePath - Path to the config file
+* @returns Configuration object or empty object if not found
+*/
+function loadConfigFromPathSync(filePath) {
+	const result = explorerSync.load(filePath);
+	return result?.config ? normalizeConfig(result.config) : {};
+}
+/**
+* Normalize config object - handle default exports and ensure proper type
+*/
+function isStylesConfig(value) {
+	return typeof value === "object" && value !== null;
+}
+function normalizeConfig(config) {
+	if (isStylesConfig(config) && "default" in config) return normalizeConfig(config.default);
+	if (isStylesConfig(config)) return config;
+	return {};
+}
+//#endregion
+//#region src/options.ts
+/**
+* Map of file extensions to language keys
+*/
+const extensionToLanguage = new Map([
+	[".less", "less"],
+	[".scss", "scss"],
+	[".sass", "scss"],
+	[".jess", "jess"],
+	[".css", "css"]
+]);
+/**
+* Infer language from a file path's extension
+*/
+function inferLanguage(filePath) {
+	if (!filePath) return;
+	const ext = path.default.extname(filePath).toLowerCase();
+	return extensionToLanguage.get(ext);
+}
+/**
+* Check if a file path matches a pattern (exact path, relative path, or glob)
+*/
+function matchesFile(pattern, filePath) {
+	if (!pattern || !filePath) return false;
+	const normalizedPattern = path.default.normalize(pattern);
+	const normalizedFile = path.default.normalize(filePath);
+	if (normalizedPattern === normalizedFile) return true;
+	if (path.default.basename(normalizedFile) === normalizedPattern) return true;
+	const isMatch = (0, picomatch.default)(pattern, { dot: true });
+	return isMatch(filePath) || isMatch(normalizedFile);
+}
+/**
+* Get matching options from an array of file-based options.
+* Returns merged options from:
+* 1. All entries without a `file` property (defaults)
+* 2. All entries whose `file` pattern matches the given path
+*
+* Later entries override earlier ones.
+*/
+function getMatchingOptions(options, filePath) {
+	if (!options) return {};
+	const optionsArray = Array.isArray(options) ? options : [options];
+	let result = {};
+	for (const opt of optionsArray) if (!opt.file || filePath && matchesFile(opt.file, filePath)) {
+		const { file: _file, ...rest } = opt;
+		result = {
+			...result,
+			...rest
+		};
+	}
+	return result;
+}
+/**
+* Get merged options by combining compile, language, input, and output settings.
+*
+* Merge priority (later wins):
+* 1. compile options (base)
+* 2. language-specific options (inferred from input extension or explicitly specified)
+* 3. matched input options (if input path provided and matches)
+* 4. matched output options (if output path provided and matches)
+*
+* @param config - The styles configuration object
+* @param params - Options specifying language, input file, and output file
+* @returns Merged options object
+*
+* @example
+* // Get Less options for a specific input/output (language inferred from .less extension)
+* const options = getOptions(config, {
+*   input: 'src/styles/main.less',
+*   output: 'dist/main.css'
+* });
+*
+* @example
+* // Explicitly specify language
+* const options = getOptions(config, { language: 'less' });
+*
+* @example
+* // Get base options without language-specific settings
+* const options = getOptions(config);
+*/
+function getOptions(config = {}, params = {}) {
+	const { input: inputFile, output: outputFile } = params;
+	const { compile = {}, input, output, language: languageConfig = {} } = config;
+	const language = params.language ?? inferLanguage(inputFile);
+	const languageOptions = language ? languageConfig[language] ?? {} : {};
+	const matchedInput = getMatchingOptions(input, inputFile);
+	const matchedOutput = getMatchingOptions(output, outputFile);
+	return {
+		mathMode: compile.mathMode,
+		unitMode: compile.unitMode,
+		equalityMode: compile.equalityMode,
+		allowExtendSelectors: compile.allowExtendSelectors,
+		paths: compile.searchPaths,
+		javascriptEnabled: compile.enableJavaScript,
+		...languageOptions,
+		...matchedInput,
+		...matchedOutput
+	};
+}
+//#endregion
+exports.getOptions = getOptions;
+exports.loadConfig = loadConfig;
+exports.loadConfigFromPath = loadConfigFromPath;
+exports.loadConfigFromPathSync = loadConfigFromPathSync;
+exports.loadConfigSync = loadConfigSync;
+exports.loadConfigSyncWithMeta = loadConfigSyncWithMeta;

package/{src/types.ts → lib/index.d.cts}

@@ -1,19 +1,18 @@
+//#region src/types.d.ts
 /**
  * Math processing modes
  */
-export type MathMode = 'always' | 'parens-division' | 'parens' | 'strict';
-
+type MathMode = 'always' | 'parens-division' | 'parens' | 'strict';
 /**
  * Unit conversion modes
  */
-export type UnitMode = 'loose' | 'preserve' | 'strict';
-
+type UnitMode = 'loose' | 'preserve' | 'strict';
 /**
  * Equality/coercion modes for guard comparisons.
  */
-export type EqualityMode = 'coerce' | 'strict';
-
-export interface JavaScriptSandboxConfig {
+type EqualityMode = 'coerce' | 'strict';
+type ExtendSelectorKind = 'simple' | 'basic' | 'pseudo' | 'complex' | 'compound';
+interface JavaScriptSandboxConfig {
   /**
    * Allow network access for script execution runtime.
    * @default false
@@ -29,26 +28,27 @@ export interface JavaScriptSandboxConfig {
    */
   jsReadRoot?: string;
 }
-
-export type CompileJavaScriptOption = true | JavaScriptSandboxConfig;
-
+type CompileJavaScriptOption = true | JavaScriptSandboxConfig;
 /**
  * Less compiler options
  * Based on less.js default-options.js and bin/lessc
  */
-export interface LessOptions {
+interface LessOptions {
+  /**
+   * Restrict which selector shapes are allowed in extend targets.
+   * When set, any other selector kind is a parse error.
+   */
+  allowExtendSelectors?: ExtendSelectorKind[];
   /**
    * Inline Javascript - @plugin still allowed
    * @default false
    */
   javascriptEnabled?: boolean;
-
   /**
    * Outputs a makefile import dependency list to stdout.
    * @default false
    */
   depends?: boolean;
-
   /**
    * @deprecated Compress using less built-in compression.
    * This does an okay job but does not utilise all the tricks of
@@ -56,13 +56,11 @@ export interface LessOptions {
    * @default false
    */
   compress?: boolean;
-
   /**
    * Runs the less parser and just reports errors without any output.
    * @default false
    */
   lint?: boolean;
-
   /**
    * Sets available include paths.
    * If the file in an @import rule does not exist at that exact location,
@@ -70,13 +68,11 @@ export interface LessOptions {
    * @default []
    */
   paths?: string[];
-
   /**
    * Color output in the terminal
    * @default true
    */
   color?: boolean;
-
   /**
    * @deprecated This option has confusing behavior and may be removed in a future version.
    *
@@ -99,13 +95,11 @@ export interface LessOptions {
    * @default false
    */
   strictImports?: boolean | 'error';
-
   /**
    * Allow Imports from Insecure HTTPS Hosts
    * @default false
    */
   insecure?: boolean;
-
   /**
    * Allows you to add a path to every generated import and url in your css.
    * This does not affect less import statements that are processed, just ones
@@ -113,7 +107,6 @@ export interface LessOptions {
    * @default ''
    */
   rootpath?: string;
-
   /**
    * By default URLs are kept as-is, so if you import a file in a sub-directory
    * that references an image, exactly the same URL will be output in the css.
@@ -122,7 +115,6 @@ export interface LessOptions {
    * @default false
    */
   rewriteUrls?: boolean | 'all' | 'local' | 'off';
-
   /**
    * How to process math operations
    * - 'always': eagerly try to solve all operations
@@ -131,7 +123,6 @@ export interface LessOptions {
    * @default 'parens-division'
    */
   mathMode?: MathMode;
-
   /**
    * How to handle unit conversions in math operations
    * - 'loose': Less's default 1.x-4.x behavior
@@ -140,7 +131,6 @@ export interface LessOptions {
    * @default 'preserve'
    */
   unitMode?: UnitMode;
-
   /**
    * How to handle equality/coercion in guards and comparisons.
    * - 'coerce': Less-compatible coercion behavior
@@ -148,7 +138,6 @@ export interface LessOptions {
    * @default 'coerce'
    */
   equalityMode?: EqualityMode;
-
   /**
    * @deprecated Use `mathMode` instead. This option maps to `mathMode` as follows:
    * - 0 or 'always' → 'always'
@@ -158,7 +147,6 @@ export interface LessOptions {
    * @default undefined (uses mathMode if provided, otherwise 'parens-division')
    */
   math?: 0 | 1 | 2 | 3 | MathMode | 'strict-legacy';
-
   /**
    * @deprecated Use `unitMode` instead. If `true`, sets `unitMode` to 'strict'.
    * If `false`, sets the unitMode to 'loose.
@@ -166,7 +154,6 @@ export interface LessOptions {
    * @default false
    */
   strictUnits?: boolean;
-
   /**
    * Effectively the declaration is put at the top of your base Less file,
    * meaning it can be used but it also can be overridden if this variable
@@ -174,27 +161,23 @@ export interface LessOptions {
    * @default null
    */
   globalVars?: Record<string, string> | null;
-
   /**
    * As opposed to the global variable option, this puts the declaration at the
    * end of your base file, meaning it will override anything defined in your Less file.
    * @default null
    */
   modifyVars?: Record<string, string> | null;
-
   /**
    * This option allows you to specify a argument to go on to every URL.
    * @default ''
    */
   urlArgs?: string;
-
   /**
    * @removed The dumpLineNumbers option is not useful nor supported in browsers. Use sourcemaps instead.
    *
    * @default undefined
    */
   dumpLineNumbers?: string;
-
   /**
    * Source map options
    * @default undefined
@@ -210,25 +193,21 @@ export interface LessOptions {
     sourceMapOutputFilename?: string;
     sourceMapFilename?: string;
   };
-
   /**
    * Verbose output
    * @default false
    */
   verbose?: boolean;
-
   /**
    * Silent mode (suppress errors)
    * @default false
    */
   silent?: boolean;
-
   /**
    * Quiet mode (suppress warnings)
    * @default false
    */
   quiet?: boolean;
-
   /**
    * @deprecated This is legacy Less behavior.
    *
@@ -241,14 +220,12 @@ export interface LessOptions {
    * @default true
    */
   leakyRules?: boolean;
-
   /**
    * Whether to collapse nested selectors (Less 1.x-4.x style flattening)
    * When true, nested selectors like `.parent { .child { } }` are flattened to `.parent .child { }`
    * @default false
    */
   collapseNesting?: boolean;
-
   /**
    * @deprecated This is legacy Less behavior.
    *
@@ -258,30 +235,33 @@ export interface LessOptions {
    */
   bubbleRootAtRules?: boolean;
 }
-
+interface ScssOptions {
+  allowExtendSelectors?: ExtendSelectorKind[];
+  unitMode?: UnitMode;
+  equalityMode?: EqualityMode;
+  collapseNesting?: boolean;
+  [key: string]: any;
+}
 /**
  * Base interface for file-matching options
  */
-export interface FileMatchOptions {
+interface FileMatchOptions {
   /**
    * File path, relative path, or glob pattern for matching.
    * If omitted, the options serve as defaults.
    */
   file?: string;
 }
-
 /**
  * Input file options - can override compile and language settings per input file
  */
-export interface InputOptions extends FileMatchOptions {
-  // Compile-level options that can be overridden per-input
+interface InputOptions extends FileMatchOptions {
   mathMode?: MathMode;
   unitMode?: UnitMode;
   equalityMode?: EqualityMode;
+  allowExtendSelectors?: ExtendSelectorKind[];
   searchPaths?: string[];
   enableJavaScript?: boolean;
-
-  // Less-specific options that can be overridden per-input
   javascriptEnabled?: boolean;
   paths?: string[];
   globalVars?: Record<string, string> | null;
@@ -292,15 +272,13 @@ export interface InputOptions extends FileMatchOptions {
   leakyRules?: boolean;
   collapseNesting?: boolean;
   bubbleRootAtRules?: boolean;
-
   /** Allow additional language-specific options */
   [key: string]: any;
 }
-
 /**
  * Output file options - can override output settings per output file
  */
-export interface OutputOptions extends FileMatchOptions {
+interface OutputOptions extends FileMatchOptions {
   collapseNesting?: boolean;
   compress?: boolean;
   sourceMap?: boolean | {
@@ -314,12 +292,10 @@ export interface OutputOptions extends FileMatchOptions {
     sourceMapOutputFilename?: string;
     sourceMapFilename?: string;
   };
-
   /** Allow additional options */
   [key: string]: any;
 }
-
-export interface StylesConfig {
+interface StylesConfig {
   compile?: {
     /**
      * Plugins can be specified as:
@@ -336,6 +312,7 @@ export interface StylesConfig {
     mathMode?: MathMode;
     unitMode?: UnitMode;
     equalityMode?: EqualityMode;
+    allowExtendSelectors?: ExtendSelectorKind[];
   };
   /**
    * Input file options. Can be a single object for defaults, or an array
@@ -351,9 +328,96 @@ export interface StylesConfig {
   output?: OutputOptions | OutputOptions[];
   language?: {
     less?: LessOptions;
-    scss?: Record<string, any>;
+    scss?: ScssOptions;
     css?: Record<string, any>;
     jess?: Record<string, any>;
-    [key: string]: LessOptions | Record<string, any> | undefined;
+    [key: string]: LessOptions | ScssOptions | Record<string, any> | undefined;
   };
 }
+//#endregion
+//#region src/loader.d.ts
+interface LoadedConfigMeta {
+  config: StylesConfig;
+  configFilePath?: string;
+}
+/**
+ * Load styles configuration from the file system (async)
+ * @param searchFrom - Directory to search from (defaults to process.cwd())
+ * @returns Configuration object or null if not found
+ */
+declare function loadConfig(searchFrom?: string): Promise<StylesConfig | null>;
+/**
+ * Load styles configuration from the file system (sync)
+ * @param searchFrom - Directory to search from (defaults to process.cwd())
+ * @returns Configuration object or empty object if not found
+ */
+declare function loadConfigSync(searchFrom?: string): StylesConfig;
+/**
+ * Load styles configuration with metadata (sync).
+ * Includes config file path when a config file is discovered.
+ */
+declare function loadConfigSyncWithMeta(searchFrom?: string): LoadedConfigMeta;
+/**
+ * Load styles configuration from a specific file path (async)
+ * @param filePath - Path to the config file
+ * @returns Configuration object or null if not found
+ */
+declare function loadConfigFromPath(filePath: string): Promise<StylesConfig | null>;
+/**
+ * Load styles configuration from a specific file path (sync)
+ * @param filePath - Path to the config file
+ * @returns Configuration object or empty object if not found
+ */
+declare function loadConfigFromPathSync(filePath: string): StylesConfig;
+//#endregion
+//#region src/options.d.ts
+/**
+ * Options for retrieving merged configuration
+ */
+interface GetOptionsParams {
+  /**
+   * Language key to get options for (e.g., 'less', 'scss', 'jess').
+   * If omitted but `input` is provided, language is inferred from the file extension.
+   */
+  language?: string;
+  /**
+   * Input file path to match against input options.
+   * Also used to infer language if `language` is not specified.
+   */
+  input?: string;
+  /**
+   * Output file path to match against output options
+   */
+  output?: string;
+}
+/**
+ * Get merged options by combining compile, language, input, and output settings.
+ *
+ * Merge priority (later wins):
+ * 1. compile options (base)
+ * 2. language-specific options (inferred from input extension or explicitly specified)
+ * 3. matched input options (if input path provided and matches)
+ * 4. matched output options (if output path provided and matches)
+ *
+ * @param config - The styles configuration object
+ * @param params - Options specifying language, input file, and output file
+ * @returns Merged options object
+ *
+ * @example
+ * // Get Less options for a specific input/output (language inferred from .less extension)
+ * const options = getOptions(config, {
+ *   input: 'src/styles/main.less',
+ *   output: 'dist/main.css'
+ * });
+ *
+ * @example
+ * // Explicitly specify language
+ * const options = getOptions(config, { language: 'less' });
+ *
+ * @example
+ * // Get base options without language-specific settings
+ * const options = getOptions(config);
+ */
+declare function getOptions(config?: StylesConfig, params?: GetOptionsParams): Record<string, any>;
+//#endregion
+export { CompileJavaScriptOption, EqualityMode, ExtendSelectorKind, FileMatchOptions, GetOptionsParams, InputOptions, JavaScriptSandboxConfig, LessOptions, LoadedConfigMeta, MathMode, OutputOptions, ScssOptions, StylesConfig, UnitMode, getOptions, loadConfig, loadConfigFromPath, loadConfigFromPathSync, loadConfigSync, loadConfigSyncWithMeta };