[2025-10-26] Array input to AbstractStage.runCustomScssDirSubStage

Author: maddimathon

dist/js/lib/03-stages/classes/CompileStage.d.ts

@@ -54,7 +54,7 @@ export declare class CompileStage extends AbstractStage<Stage.Args.Compile, Stag
      *
      * @since 0.2.0-alpha — Runs PostCSS if {@link Stage.Args.Compile.postCSS} is truthy.
      */
-    protected scss(): Promise<string[] | undefined>;
+    protected scss(): Promise<void>;
     /**
      * Compiles typescript to javascript.
      *

dist/js/lib/03-stages/classes/CompileStage.js

@@ -399,9 +399,9 @@ export declare abstract class AbstractStage<T_Args extends Stage.Args, T_SubStag
      *
      * @since 0.2.0-alpha.2 — Changed `postCSS` param to `opts` object param. Added returning output css filepaths. Improved some issues with the async compiling and sub-file finding.
      *
-     * @since 0.3.0-alpha.1.draft — Added `sassOpts` param.
+     * @since 0.3.0-alpha.1.draft — Added `sassOpts` param and allowed `subpath` to be an array.
      */
-    protected runCustomScssDirSubStage(subpath: string, distDir?: string, opts?: Partial<AbstractStage.runCustomScssDirSubStage.Opts>, logLevelBase?: number, sassOpts?: Stage.Compiler.Args.Sass): Promise<string[]>;
+    protected runCustomScssDirSubStage(subpath: string | string[], distDir?: string, opts?: Partial<AbstractStage.runCustomScssDirSubStage.Opts>, logLevelBase?: number, sassOpts?: Stage.Compiler.Args.Sass): Promise<string[]>;
     /**
      * Deprecated overload here for forward-compatibility.  Please use the
      * overload above instead.
@@ -410,7 +410,7 @@ export declare abstract class AbstractStage<T_Args extends Stage.Args, T_SubStag
      *             {@link AbstractStage.runCustomScssDirSubStage.Opts} object as
      *             the third param instead.
      */
-    protected runCustomScssDirSubStage(subpath: string, distDir?: string, postCSS?: boolean, logLevelBase?: number, sassOpts?: Stage.Compiler.Args.Sass): Promise<string[]>;
+    protected runCustomScssDirSubStage(subpath: string | string[], distDir?: string, postCSS?: boolean, logLevelBase?: number, sassOpts?: Stage.Compiler.Args.Sass): Promise<string[]>;
 }
 /**
  * Utilities for the {@link AbstractStage} class.
@@ -471,6 +471,13 @@ export declare namespace AbstractStage {
              * @default true
              */
             postCSS: boolean;
+            /**
+             * The base path for the source directory (used to rewrite the
+             * output path).
+             *
+             * @since 0.3.0-alpha.1.draft
+             */
+            srcDir?: string;
         }
     }
 }

dist/js/lib/03-stages/classes/abstract/AbstractStage.d.ts

@@ -217,6 +217,16 @@ export interface Stage<T_Args extends Stage.Args = Stage.Args, T_SubStage extend
  * @since 0.1.0-alpha
  */
 export declare namespace Stage {
+    /**
+     * Any stage class compatible with this package.
+     *
+     * These are all lowercase on purpose.
+     *
+     * @since 0.1.0-alpha
+     *
+     * @expand
+     */
+    type Name = "snapshot" | "compile" | "test" | "document" | "build" | "package" | "release";
     /**
      * An object with an instance of each stage's class.
      *
@@ -878,16 +888,6 @@ export declare namespace Stage {
             }
         }
     }
-    /**
-     * Any stage class compatible with this package.
-     *
-     * These are all lowercase on purpose.
-     *
-     * @since 0.1.0-alpha
-     *
-     * @expand
-     */
-    type Name = "snapshot" | "compile" | "test" | "document" | "build" | "package" | "release";
     /**
      * Default substage names.
      *