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

package/lib/index.cjs

@@ -120,6 +120,24 @@ function normalizeConfig(config) {
 //#endregion
 //#region src/options.ts
 /**
+* Expand the `strict` convenience preset. When `strict` is truthy, fills the
+* strict bundle for any governed option left `undefined` — an explicitly set
+* option always wins. Modeled after `tsconfig`'s `strict`: it only *sets*
+* semantic options, it is not itself a mode. Sets the strictest value of each
+* governed axis (`equalityMode: 'exact'` is the no-coercion dialect).
+*
+* Returns a new object (never mutates the input); a no-op when `strict` is falsy.
+*/
+function applyStrictPreset(opts) {
+	if (!opts?.strict) return opts;
+	const filled = { ...opts };
+	filled.unitMode ??= "strict";
+	filled.equalityMode ??= "exact";
+	filled.leakyScope ??= false;
+	filled.allowOverloadedImport ??= false;
+	return filled;
+}
+/**
 * Map of file extensions to language keys
 */
 const extensionToLanguage = new Map([
@@ -162,7 +180,7 @@ function getMatchingOptions(options, filePath) {
 	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;
+		const { file, ...rest } = opt;
 		result = {
 			...result,
 			...rest
@@ -210,14 +228,15 @@ function getOptions(config = {}, params = {}) {
 		unitMode: compile.unitMode,
 		equalityMode: compile.equalityMode,
 		allowExtendSelectors: compile.allowExtendSelectors,
+		disableScriptModules: compile.disableScriptModules ?? compile.disablePluginRule,
 		paths: compile.searchPaths,
-		javascriptEnabled: compile.enableJavaScript,
 		...languageOptions,
 		...matchedInput,
 		...matchedOutput
 	};
 }
 //#endregion
+exports.applyStrictPreset = applyStrictPreset;
 exports.getOptions = getOptions;
 exports.loadConfig = loadConfig;
 exports.loadConfigFromPath = loadConfigFromPath;

package/lib/index.d.ts

@@ -1,423 +1,3 @@
-//#region src/types.d.ts
-/**
- * Math processing modes
- */
-type MathMode = 'always' | 'parens-division' | 'parens' | 'strict';
-/**
- * Unit conversion modes
- */
-type UnitMode = 'loose' | 'preserve' | 'strict';
-/**
- * Equality/coercion modes for guard comparisons.
- */
-type EqualityMode = 'coerce' | 'strict';
-type ExtendSelectorKind = 'simple' | 'basic' | 'pseudo' | 'complex' | 'compound';
-interface JavaScriptSandboxConfig {
-  /**
-   * Allow network access for script execution runtime.
-   * @default false
-   */
-  allowHttp?: boolean;
-  /**
-   * Optional host allowlist when `allowHttp` is enabled.
-   */
-  allowNetHosts?: string[];
-  /**
-   * Optional explicit filesystem root for script reads.
-   * If omitted, compiler resolves using entry/config roots.
-   */
-  jsReadRoot?: string;
-}
-type CompileJavaScriptOption = true | JavaScriptSandboxConfig;
-/**
- * Less compiler options
- * Based on less.js default-options.js and bin/lessc
- */
-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
-   * dedicated css compression.
-   * @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,
-   * less will look for it at the location(s) passed to this option.
-   * @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.
-   *
-   * Controls how @import statements for .less files are handled inside selector blocks (rulesets).
-   *
-   * Behavior:
-   * - @import at root level: Always processed
-   * - @import inside @-rules (@media, @supports, etc.): Processed (these are not selector blocks)
-   * - @import inside selector blocks (.class, #id, etc.): Behavior depends on this option
-   *
-   * Options:
-   * - `false` (default): All @import statements are processed regardless of context.
-   * - `true`: @import statements inside selector blocks are silently ignored and not output.
-   * - `'error'`: @import statements inside selector blocks will throw an error instead of being silently ignored.
-   *
-   * Note: Only affects .less file imports. CSS imports (url(...) or .css files) are
-   * always output as CSS @import statements regardless of this setting.
-   *
-   * @see https://github.com/less/less.js/issues/656
-   * @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
-   * that are left in the output css.
-   * @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.
-   * This option allows you to re-write URL's in imported files so that the
-   * URL is always relative to the base imported file
-   * @default false
-   */
-  rewriteUrls?: boolean | 'all' | 'local' | 'off';
-  /**
-   * How to process math operations
-   * - 'always': eagerly try to solve all operations
-   * - 'parens-division': require parens for division "/"
-   * - 'parens' or 'strict': require parens for all operations
-   * @default 'parens-division'
-   */
-  mathMode?: MathMode;
-  /**
-   * How to handle unit conversions in math operations
-   * - 'loose': Less's default 1.x-4.x behavior
-   * - 'preserve': Create calc() expressions for unit errors
-   * - 'strict': strict unit mode
-   * @default 'preserve'
-   */
-  unitMode?: UnitMode;
-  /**
-   * How to handle equality/coercion in guards and comparisons.
-   * - 'coerce': Less-compatible coercion behavior
-   * - 'strict': type-strict behavior
-   * @default 'coerce'
-   */
-  equalityMode?: EqualityMode;
-  /**
-   * @deprecated Use `mathMode` instead. This option maps to `mathMode` as follows:
-   * - 0 or 'always' → 'always'
-   * - 1 or 'parens-division' → 'parens-division'
-   * - 2 or 'parens' or 'strict' → 'parens'
-   * - 3 or 'strict-legacy' → 'parens' (removed, will default to 'strict)
-   * @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.
-   * If undefined, uses the `unitMode` value (defaults to 'preserve').
-   * @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
-   * is defined in the file.
-   * @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
-   */
-  sourceMap?: boolean | {
-    sourceMapFullFilename?: string;
-    sourceMapRootpath?: string;
-    sourceMapBasepath?: string;
-    sourceMapURL?: string;
-    sourceMapFileInline?: boolean;
-    outputSourceFiles?: boolean;
-    disableSourcemapAnnotation?: boolean;
-    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.
-   *
-   * Controls whether mixins and detached rulesets "leak" their inner rules.
-   * When true:
-   * - Mixins: Mixin and VarDeclaration nodes are 'public' and 'optional' respectively
-   * - Detached rulesets: Mixin and VarDeclaration nodes are 'public' and 'private' respectively
-   * When false:
-   * - Both mixins and detached rulesets: Mixin and VarDeclaration nodes are 'private'
-   * @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.
-   *
-   * Whether to bubble root-only at-rules (@font-face, @keyframes, etc.) to the root
-   * when they are nested inside rulesets. Modern CSS supports nesting these at-rules.
-   * @default true
-   */
-  bubbleRootAtRules?: boolean;
-}
-interface ScssOptions {
-  allowExtendSelectors?: ExtendSelectorKind[];
-  unitMode?: UnitMode;
-  equalityMode?: EqualityMode;
-  collapseNesting?: boolean;
-  [key: string]: any;
-}
-/**
- * Base interface for file-matching options
- */
-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
- */
-interface InputOptions extends FileMatchOptions {
-  mathMode?: MathMode;
-  unitMode?: UnitMode;
-  equalityMode?: EqualityMode;
-  allowExtendSelectors?: ExtendSelectorKind[];
-  searchPaths?: string[];
-  enableJavaScript?: boolean;
-  javascriptEnabled?: boolean;
-  paths?: string[];
-  globalVars?: Record<string, string> | null;
-  modifyVars?: Record<string, string> | null;
-  strictImports?: boolean | 'error';
-  rewriteUrls?: boolean | 'all' | 'local' | 'off';
-  rootpath?: string;
-  leakyRules?: boolean;
-  collapseNesting?: boolean;
-  bubbleRootAtRules?: boolean;
-  /** Allow additional language-specific options */
-  [key: string]: any;
-}
-/**
- * Output file options - can override output settings per output file
- */
-interface OutputOptions extends FileMatchOptions {
-  collapseNesting?: boolean;
-  compress?: boolean;
-  sourceMap?: boolean | {
-    sourceMapFullFilename?: string;
-    sourceMapRootpath?: string;
-    sourceMapBasepath?: string;
-    sourceMapURL?: string;
-    sourceMapFileInline?: boolean;
-    outputSourceFiles?: boolean;
-    disableSourcemapAnnotation?: boolean;
-    sourceMapOutputFilename?: string;
-    sourceMapFilename?: string;
-  };
-  /** Allow additional options */
-  [key: string]: any;
-}
-interface StylesConfig {
-  compile?: {
-    /**
-     * Plugins can be specified as:
-     * - Plugin instances (PluginInterface from @jesscss/core)
-     * - String keys (plugin names that get resolved elsewhere)
-     *
-     * @note - Using `any` here to avoid circular dependency with @jesscss/core.
-     *         The actual type is PluginInterface from @jesscss/core.
-     */
-    plugins?: Array<any | string>;
-    searchPaths?: string[];
-    enableJavaScript?: boolean;
-    javascript?: CompileJavaScriptOption;
-    mathMode?: MathMode;
-    unitMode?: UnitMode;
-    equalityMode?: EqualityMode;
-    allowExtendSelectors?: ExtendSelectorKind[];
-  };
-  /**
-   * Input file options. Can be a single object for defaults, or an array
-   * where entries can have a `file` property (path or glob) to match specific inputs.
-   * Entries without a `file` property serve as defaults.
-   */
-  input?: InputOptions | InputOptions[];
-  /**
-   * Output file options. Can be a single object for defaults, or an array
-   * where entries can have a `file` property (path or glob) to match specific outputs.
-   * Entries without a `file` property serve as defaults.
-   */
-  output?: OutputOptions | OutputOptions[];
-  language?: {
-    less?: LessOptions;
-    scss?: ScssOptions;
-    css?: Record<string, any>;
-    jess?: Record<string, any>;
-    [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 };
+export * from './types.js';
+export * from './loader.js';
+export * from './options.js';

package/lib/index.js

@@ -95,6 +95,24 @@ function normalizeConfig(config) {
 //#endregion
 //#region src/options.ts
 /**
+* Expand the `strict` convenience preset. When `strict` is truthy, fills the
+* strict bundle for any governed option left `undefined` — an explicitly set
+* option always wins. Modeled after `tsconfig`'s `strict`: it only *sets*
+* semantic options, it is not itself a mode. Sets the strictest value of each
+* governed axis (`equalityMode: 'exact'` is the no-coercion dialect).
+*
+* Returns a new object (never mutates the input); a no-op when `strict` is falsy.
+*/
+function applyStrictPreset(opts) {
+	if (!opts?.strict) return opts;
+	const filled = { ...opts };
+	filled.unitMode ??= "strict";
+	filled.equalityMode ??= "exact";
+	filled.leakyScope ??= false;
+	filled.allowOverloadedImport ??= false;
+	return filled;
+}
+/**
 * Map of file extensions to language keys
 */
 const extensionToLanguage = new Map([
@@ -137,7 +155,7 @@ function getMatchingOptions(options, filePath) {
 	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;
+		const { file, ...rest } = opt;
 		result = {
 			...result,
 			...rest
@@ -185,12 +203,12 @@ function getOptions(config = {}, params = {}) {
 		unitMode: compile.unitMode,
 		equalityMode: compile.equalityMode,
 		allowExtendSelectors: compile.allowExtendSelectors,
+		disableScriptModules: compile.disableScriptModules ?? compile.disablePluginRule,
 		paths: compile.searchPaths,
-		javascriptEnabled: compile.enableJavaScript,
 		...languageOptions,
 		...matchedInput,
 		...matchedOutput
 	};
 }
 //#endregion
-export { getOptions, loadConfig, loadConfigFromPath, loadConfigFromPathSync, loadConfigSync, loadConfigSyncWithMeta };
+export { applyStrictPreset, getOptions, loadConfig, loadConfigFromPath, loadConfigFromPathSync, loadConfigSync, loadConfigSyncWithMeta };

package/lib/loader.d.ts

@@ -0,0 +1,34 @@
+import type { StylesConfig } from './types.js';
+export 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
+ */
+export 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
+ */
+export declare function loadConfigSync(searchFrom?: string): StylesConfig;
+/**
+ * Load styles configuration with metadata (sync).
+ * Includes config file path when a config file is discovered.
+ */
+export 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
+ */
+export 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
+ */
+export declare function loadConfigFromPathSync(filePath: string): StylesConfig;

package/lib/options.d.ts

@@ -0,0 +1,70 @@
+import type { StylesConfig } from './types.js';
+/**
+ * Options bag the `strict` preset can expand. Any bag carrying a `strict` flag
+ * plus the semantic modes it governs.
+ */
+export interface StrictPresetOptions {
+    strict?: boolean;
+    unitMode?: 'loose' | 'preserve' | 'strict';
+    equalityMode?: 'less' | 'sass' | 'exact';
+    leakyScope?: boolean;
+    allowOverloadedImport?: boolean;
+}
+/**
+ * Expand the `strict` convenience preset. When `strict` is truthy, fills the
+ * strict bundle for any governed option left `undefined` — an explicitly set
+ * option always wins. Modeled after `tsconfig`'s `strict`: it only *sets*
+ * semantic options, it is not itself a mode. Sets the strictest value of each
+ * governed axis (`equalityMode: 'exact'` is the no-coercion dialect).
+ *
+ * Returns a new object (never mutates the input); a no-op when `strict` is falsy.
+ */
+export declare function applyStrictPreset<T extends StrictPresetOptions>(opts: T): T;
+/**
+ * Options for retrieving merged configuration
+ */
+export 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);
+ */
+export declare function getOptions(config?: StylesConfig, params?: GetOptionsParams): Record<string, any>;