@getkist/action-sass 1.0.5 → 1.0.9

package/dist/index.cjs

@@ -0,0 +1,311 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var fs = require('fs');
+var path = require('path');
+var postcss = require('postcss');
+var sass = require('sass');
+var autoprefixer = require('autoprefixer');
+var cssnano = require('cssnano');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+var postcss__default = /*#__PURE__*/_interopDefault(postcss);
+var sass__namespace = /*#__PURE__*/_interopNamespace(sass);
+var autoprefixer__default = /*#__PURE__*/_interopDefault(autoprefixer);
+var cssnano__default = /*#__PURE__*/_interopDefault(cssnano);
+
+// src/actions/StyleProcessingAction/StyleProcessingAction.ts
+
+// src/types/Action.ts
+var Action = class {
+  /**
+   * Gets the unique name of the action.
+   */
+  get name() {
+    return this.constructor.name;
+  }
+  /**
+   * Validates options before execution
+   * Override in subclasses for specific validation
+   */
+  validateOptions(_options) {
+    return true;
+  }
+  /**
+   * Provides a description of the action
+   */
+  describe() {
+    return `${this.name} action`;
+  }
+  /**
+   * Log an info message
+   */
+  logInfo(message) {
+    console.log(`[${this.name}] ${message}`);
+  }
+  /**
+   * Log an error message
+   */
+  logError(message, error) {
+    console.error(`[${this.name}] ERROR: ${message}`, error || "");
+  }
+  /**
+   * Log a debug message
+   */
+  logDebug(message) {
+    if (process.env.DEBUG) {
+      console.debug(`[${this.name}] DEBUG: ${message}`);
+    }
+  }
+  /**
+   * Log a warning message
+   */
+  logWarning(message) {
+    console.warn(`[${this.name}] WARNING: ${message}`);
+  }
+};
+var postcssConfigCompressed = {
+  plugins: [
+    autoprefixer__default.default,
+    cssnano__default.default({
+      preset: "default"
+    })
+  ]
+};
+var postcss_config_compressed_default = postcssConfigCompressed;
+var postcssConfigExpanded = {
+  plugins: [autoprefixer__default.default]
+};
+var postcss_config_expanded_default = postcssConfigExpanded;
+
+// src/actions/StyleProcessingAction/StyleProcessingAction.ts
+var StyleProcessingAction = class extends Action {
+  // Parameters
+  // ========================================================================
+  // Constructor
+  // ========================================================================
+  // Methods
+  // ========================================================================
+  /**
+   * Executes the style processing action.
+   * @param options - The options specific to style processing, including
+   * input/output file paths and style format.
+   * @returns A Promise that resolves when the styles are processed
+   * successfully, or rejects with an error if the action fails.
+   */
+  async execute(options) {
+    const inputFile = options.inputFile;
+    if (!inputFile) {
+      throw new Error("Missing required option: inputFile.");
+    }
+    if (options.outputs && options.outputs.length > 0) {
+      await this.executeMultiOutput(inputFile, options.outputs, options.sourceMapIncludeSources ?? true);
+      return;
+    }
+    await this.executeSingleOutput(options);
+  }
+  /**
+   * Executes multi-output mode: compiles SCSS for each unique style,
+   * then generates all specified output files.
+   */
+  async executeMultiOutput(inputFile, outputs, sourceMapIncludeSources) {
+    this.logInfo(
+      `Processing styles from ${inputFile} to ${outputs.length} outputs`
+    );
+    const expandedOutputs = outputs.filter((o) => o.style === "expanded");
+    const compressedOutputs = outputs.filter((o) => o.style === "compressed");
+    const compiledCache = /* @__PURE__ */ new Map();
+    for (const style of ["expanded", "compressed"]) {
+      const outputsForStyle = style === "expanded" ? expandedOutputs : compressedOutputs;
+      if (outputsForStyle.length === 0) continue;
+      const needsSourceMap = outputsForStyle.some((o) => o.sourceMap);
+      const result = await sass__namespace.compileAsync(inputFile, {
+        style,
+        importers: [new sass__namespace.NodePackageImporter()],
+        sourceMap: needsSourceMap,
+        sourceMapIncludeSources: needsSourceMap && sourceMapIncludeSources
+      });
+      compiledCache.set(style, {
+        css: result.css,
+        sourceMap: result.sourceMap
+      });
+    }
+    for (const output of outputs) {
+      const compiled = compiledCache.get(output.style);
+      const sourceMap = output.sourceMap ?? false;
+      try {
+        const outputDir = path__default.default.dirname(output.file);
+        await this.ensureDirectoryExists(outputDir);
+        const { css: processedCss, map: processedMap } = await this.processPostCSS(
+          compiled.css,
+          output.style,
+          sourceMap ? {
+            inputFile,
+            outputFile: output.file,
+            sassSourceMap: compiled.sourceMap
+          } : void 0
+        );
+        await fs.promises.writeFile(output.file, processedCss, "utf-8");
+        if (sourceMap && processedMap) {
+          const mapFile = `${output.file}.map`;
+          await fs.promises.writeFile(mapFile, processedMap.toString(), "utf-8");
+          this.logInfo(`  \u2192 ${output.file} (${output.style} + sourcemap)`);
+        } else {
+          this.logInfo(`  \u2192 ${output.file} (${output.style})`);
+        }
+      } catch (error) {
+        this.logError(`Error processing ${output.file}: ${error}`);
+        throw error;
+      }
+    }
+    this.logInfo(`Multi-output style processing complete`);
+  }
+  /**
+   * Executes single-output mode (legacy behavior).
+   */
+  async executeSingleOutput(options) {
+    const inputFile = options.inputFile;
+    const outputFile = options.outputFile;
+    const styleOption = options.styleOption;
+    const sourceMap = options.sourceMap ?? false;
+    const sourceMapIncludeSources = options.sourceMapIncludeSources ?? true;
+    if (!outputFile || !styleOption) {
+      throw new Error(
+        "Missing required options: outputFile or styleOption (or use 'outputs' for multi-output mode)."
+      );
+    }
+    this.logInfo(
+      `Processing styles from ${inputFile} to ${outputFile} with ${styleOption} style${sourceMap ? " + sourcemap" : ""}.`
+    );
+    try {
+      const outputDir = path__default.default.dirname(outputFile);
+      await this.ensureDirectoryExists(outputDir);
+      const result = await sass__namespace.compileAsync(inputFile, {
+        style: styleOption,
+        importers: [new sass__namespace.NodePackageImporter()],
+        sourceMap,
+        sourceMapIncludeSources: sourceMap && sourceMapIncludeSources
+      });
+      const { css: processedCss, map: processedMap } = await this.processPostCSS(
+        result.css,
+        styleOption,
+        sourceMap ? {
+          inputFile,
+          outputFile,
+          sassSourceMap: result.sourceMap
+        } : void 0
+      );
+      await fs.promises.writeFile(outputFile, processedCss, "utf-8");
+      if (sourceMap && processedMap) {
+        const mapFile = `${outputFile}.map`;
+        await fs.promises.writeFile(
+          mapFile,
+          processedMap.toString(),
+          "utf-8"
+        );
+        this.logInfo(`Sourcemap written to ${mapFile}`);
+      }
+      this.logInfo(
+        `Styles processed successfully from ${inputFile} to ${outputFile}.`
+      );
+    } catch (error) {
+      this.logError(
+        `Error processing styles from ${inputFile}: ${error}`
+      );
+      throw error;
+    }
+  }
+  /**
+   * Processes the given CSS with PostCSS based on the provided style option.
+   * @param css - The CSS string to process.
+   * @param styleOption - The style option, either "expanded" or "compressed".
+   * @param sourceMapOptions - Optional sourcemap configuration.
+   * @returns Object containing processed CSS string and optional sourcemap.
+   */
+  async processPostCSS(css, styleOption, sourceMapOptions) {
+    const config = styleOption === "expanded" ? postcss_config_expanded_default : postcss_config_compressed_default;
+    const postcssOptions = {
+      from: sourceMapOptions?.inputFile,
+      to: sourceMapOptions?.outputFile
+    };
+    if (sourceMapOptions) {
+      postcssOptions.map = {
+        inline: false,
+        annotation: `${path__default.default.basename(sourceMapOptions.outputFile)}.map`,
+        prev: sourceMapOptions.sassSourceMap ? JSON.stringify(sourceMapOptions.sassSourceMap) : false,
+        sourcesContent: true
+      };
+    } else {
+      postcssOptions.map = false;
+    }
+    const result = await postcss__default.default(config.plugins).process(css, postcssOptions);
+    return { css: result.css, map: result.map };
+  }
+  /**
+   * Ensures that the given directory exists, creating it if it does not.
+   * @param dirPath - The path of the directory to check and create.
+   */
+  async ensureDirectoryExists(dirPath) {
+    try {
+      await fs.promises.mkdir(dirPath, { recursive: true });
+    } catch (error) {
+      if (error instanceof Error) {
+        const nodeError = error;
+        if (nodeError.code !== "EEXIST") {
+          throw nodeError;
+        }
+      } else {
+        throw error;
+      }
+    }
+  }
+  /**
+   * Provides a description of the action.
+   * @returns A string description of the action.
+   */
+  describe() {
+    return "Processes SCSS files into CSS, applying PostCSS transformations for expanded or compressed outputs.";
+  }
+};
+
+// src/index.ts
+var plugin = {
+  version: "1.0.4",
+  description: "SASS/SCSS compilation with PostCSS processing for kist",
+  author: "kist",
+  repository: "https://github.com/getkist/kist-action-sass",
+  keywords: ["kist", "kist-action", "sass", "scss", "postcss", "css"],
+  registerActions() {
+    return {
+      StyleProcessingAction
+    };
+  }
+};
+var src_default = plugin;
+
+exports.Action = Action;
+exports.StyleProcessingAction = StyleProcessingAction;
+exports.default = src_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/Action.ts","../src/actions/StyleProcessingAction/postcss.config.compressed.ts","../src/actions/StyleProcessingAction/postcss.config.expanded.ts","../src/actions/StyleProcessingAction/StyleProcessingAction.ts","../src/index.ts"],"names":["autoprefixer","cssnano","sass","path","fs","postcss"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Base Action types for kist action plugins\n * These types match the kist Action interface for compatibility\n */\n\n/**\n * Action options type - a generic record of key-value pairs\n */\nexport type ActionOptionsType = Record<string, unknown>;\n\n/**\n * Abstract base class for all kist actions\n * Provides logging and execution interface\n */\nexport abstract class Action<T extends ActionOptionsType = ActionOptionsType> {\n    /**\n     * Gets the unique name of the action.\n     */\n    get name(): string {\n        return this.constructor.name;\n    }\n\n    /**\n     * Validates options before execution\n     * Override in subclasses for specific validation\n     */\n    validateOptions(_options: T): boolean {\n        return true;\n    }\n\n    /**\n     * Execute the action with given options\n     * Must be implemented by subclasses\n     */\n    abstract execute(options: T): Promise<void>;\n\n    /**\n     * Provides a description of the action\n     */\n    describe(): string {\n        return `${this.name} action`;\n    }\n\n    /**\n     * Log an info message\n     */\n    protected logInfo(message: string): void {\n        console.log(`[${this.name}] ${message}`);\n    }\n\n    /**\n     * Log an error message\n     */\n    protected logError(message: string, error?: unknown): void {\n        console.error(`[${this.name}] ERROR: ${message}`, error || \"\");\n    }\n\n    /**\n     * Log a debug message\n     */\n    protected logDebug(message: string): void {\n        if (process.env.DEBUG) {\n            console.debug(`[${this.name}] DEBUG: ${message}`);\n        }\n    }\n\n    /**\n     * Log a warning message\n     */\n    protected logWarning(message: string): void {\n        console.warn(`[${this.name}] WARNING: ${message}`);\n    }\n}\n\n/**\n * Plugin interface for kist action packages\n */\nexport interface ActionPlugin {\n    /** Plugin name */\n    name?: string;\n    /** Plugin version */\n    version: string;\n    /** Plugin description */\n    description?: string;\n    /** Plugin author */\n    author?: string;\n    /** Repository URL */\n    repository?: string;\n    /** Keywords */\n    keywords?: string[];\n    /** Map of action names to action classes */\n    actions?: Record<string, new () => Action>;\n    /** Register actions method */\n    registerActions?: () => Record<string, new () => Action>;\n}\n","// ============================================================================\n// Import\n// ============================================================================\n\nimport autoprefixer from \"autoprefixer\";\nimport cssnano from \"cssnano\";\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/**\n * Configuration object for PostCSS that includes plugins for optimization and compression\n * of CSS. This setup is typically used for production builds where minimized CSS is preferred\n * to reduce file size and improve loading times.\n */\nconst postcssConfigCompressed = {\n    plugins: [\n        autoprefixer,\n        cssnano({\n            preset: \"default\",\n        }),\n    ],\n};\n\n// ============================================================================\n// Export\n// ============================================================================\n\nexport default postcssConfigCompressed;\n","// ============================================================================\n// Import\n// ============================================================================\n\nimport autoprefixer from \"autoprefixer\";\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/**\n * Configuration object for PostCSS that focuses on generating expanded, readable CSS\n * for development environments. Includes plugins that enhance CSS handling like nesting,\n * variable support, and import inlining, alongside autoprefixer for browser compatibility.\n */\nconst postcssConfigExpanded = {\n    plugins: [autoprefixer],\n};\n\n// ============================================================================\n// Export\n// ============================================================================\n\nexport default postcssConfigExpanded;\n","// ============================================================================\n// Import\n// ============================================================================\n\nimport { promises as fs } from \"fs\";\nimport path from \"path\";\nimport postcss from \"postcss\";\nimport * as sass from \"sass\";\n\nimport { Action, ActionOptionsType } from \"../../types/Action.js\";\n\n// Assuming the PostCSS configurations are available at the given paths\nimport postcssConfigCompressed from \"./postcss.config.compressed.js\";\nimport postcssConfigExpanded from \"./postcss.config.expanded.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Single output configuration for multi-output mode.\n */\nexport interface StyleOutputConfig {\n    /** Output file path */\n    file: string;\n    /** CSS style: expanded or compressed */\n    style: \"expanded\" | \"compressed\";\n    /** Enable sourcemap for this output (default: false) */\n    sourceMap?: boolean;\n}\n\nexport interface StyleProcessingActionOptions extends ActionOptionsType {\n    /** Input SCSS/CSS file path */\n    inputFile: string;\n\n    /** Single output file path (mutually exclusive with outputs) */\n    outputFile?: string;\n    /** Single output style option (mutually exclusive with outputs) */\n    styleOption?: \"expanded\" | \"compressed\";\n\n    /**\n     * Multiple outputs from single input (mutually exclusive with outputFile/styleOption).\n     * Allows generating both expanded and compressed CSS from one source.\n     *\n     * @example\n     * ```yaml\n     * outputs:\n     *   - file: \"./dist/css/app.css\"\n     *     style: expanded\n     *     sourceMap: true\n     *   - file: \"./dist/css/app.min.css\"\n     *     style: compressed\n     * ```\n     */\n    outputs?: StyleOutputConfig[];\n\n    /** Enable sourcemap generation for single output mode (default: false) */\n    sourceMap?: boolean;\n    /** Include original source content in sourcemap (default: true when sourceMap enabled) */\n    sourceMapIncludeSources?: boolean;\n}\n\n// ============================================================================\n// Classes\n// ============================================================================\n\n/**\n * StyleProcessingAction is a step action responsible for processing styles,\n * including compiling SCSS and applying PostCSS transformations. It supports\n * expanded and compressed output styles based on the provided configuration.\n */\nexport class StyleProcessingAction extends Action {\n    // Parameters\n    // ========================================================================\n\n    // Constructor\n    // ========================================================================\n\n    // Methods\n    // ========================================================================\n\n    /**\n     * Executes the style processing action.\n     * @param options - The options specific to style processing, including\n     * input/output file paths and style format.\n     * @returns A Promise that resolves when the styles are processed\n     * successfully, or rejects with an error if the action fails.\n     */\n    async execute(options: StyleProcessingActionOptions): Promise<void> {\n        const inputFile = options.inputFile;\n\n        if (!inputFile) {\n            throw new Error(\"Missing required option: inputFile.\");\n        }\n\n        // Multi-output mode\n        if (options.outputs && options.outputs.length > 0) {\n            await this.executeMultiOutput(inputFile, options.outputs, options.sourceMapIncludeSources ?? true);\n            return;\n        }\n\n        // Single output mode (legacy)\n        await this.executeSingleOutput(options);\n    }\n\n    /**\n     * Executes multi-output mode: compiles SCSS for each unique style,\n     * then generates all specified output files.\n     */\n    private async executeMultiOutput(\n        inputFile: string,\n        outputs: StyleOutputConfig[],\n        sourceMapIncludeSources: boolean,\n    ): Promise<void> {\n        this.logInfo(\n            `Processing styles from ${inputFile} to ${outputs.length} outputs`,\n        );\n\n        // Group outputs by style to avoid redundant SCSS compilation\n        const expandedOutputs = outputs.filter((o) => o.style === \"expanded\");\n        const compressedOutputs = outputs.filter((o) => o.style === \"compressed\");\n\n        // Compile SCSS for each style variant needed\n        const compiledCache = new Map<\"expanded\" | \"compressed\", { css: string; sourceMap?: object }>();\n\n        for (const style of [\"expanded\", \"compressed\"] as const) {\n            const outputsForStyle = style === \"expanded\" ? expandedOutputs : compressedOutputs;\n            if (outputsForStyle.length === 0) continue;\n\n            const needsSourceMap = outputsForStyle.some((o) => o.sourceMap);\n            const result = await sass.compileAsync(inputFile, {\n                style,\n                importers: [new sass.NodePackageImporter()],\n                sourceMap: needsSourceMap,\n                sourceMapIncludeSources: needsSourceMap && sourceMapIncludeSources,\n            });\n            compiledCache.set(style, {\n                css: result.css,\n                sourceMap: result.sourceMap,\n            });\n        }\n\n        // Process each output\n        for (const output of outputs) {\n            const compiled = compiledCache.get(output.style)!;\n            const sourceMap = output.sourceMap ?? false;\n\n            try {\n                // Ensure output directory exists\n                const outputDir = path.dirname(output.file);\n                await this.ensureDirectoryExists(outputDir);\n\n                // Process with PostCSS\n                const { css: processedCss, map: processedMap } =\n                    await this.processPostCSS(\n                        compiled.css,\n                        output.style,\n                        sourceMap\n                            ? {\n                                  inputFile,\n                                  outputFile: output.file,\n                                  sassSourceMap: compiled.sourceMap,\n                              }\n                            : undefined,\n                    );\n\n                // Write CSS\n                await fs.writeFile(output.file, processedCss, \"utf-8\");\n\n                // Write sourcemap if enabled\n                if (sourceMap && processedMap) {\n                    const mapFile = `${output.file}.map`;\n                    await fs.writeFile(mapFile, processedMap.toString(), \"utf-8\");\n                    this.logInfo(`  → ${output.file} (${output.style} + sourcemap)`);\n                } else {\n                    this.logInfo(`  → ${output.file} (${output.style})`);\n                }\n            } catch (error) {\n                this.logError(`Error processing ${output.file}: ${error}`);\n                throw error;\n            }\n        }\n\n        this.logInfo(`Multi-output style processing complete`);\n    }\n\n    /**\n     * Executes single-output mode (legacy behavior).\n     */\n    private async executeSingleOutput(\n        options: StyleProcessingActionOptions,\n    ): Promise<void> {\n        const inputFile = options.inputFile;\n        const outputFile = options.outputFile;\n        const styleOption = options.styleOption;\n        const sourceMap = options.sourceMap ?? false;\n        const sourceMapIncludeSources = options.sourceMapIncludeSources ?? true;\n\n        if (!outputFile || !styleOption) {\n            throw new Error(\n                \"Missing required options: outputFile or styleOption (or use 'outputs' for multi-output mode).\",\n            );\n        }\n\n        this.logInfo(\n            `Processing styles from ${inputFile} to ${outputFile} with ${styleOption} style${sourceMap ? \" + sourcemap\" : \"\"}.`,\n        );\n\n        try {\n            // Ensure the output directory exists\n            const outputDir = path.dirname(outputFile);\n            await this.ensureDirectoryExists(outputDir);\n\n            // Compile SCSS to CSS\n            const result = await sass.compileAsync(inputFile, {\n                style: styleOption,\n                importers: [new sass.NodePackageImporter()],\n                sourceMap: sourceMap,\n                sourceMapIncludeSources: sourceMap && sourceMapIncludeSources,\n            });\n\n            // Process the compiled CSS with PostCSS\n            const { css: processedCss, map: processedMap } =\n                await this.processPostCSS(\n                    result.css,\n                    styleOption,\n                    sourceMap\n                        ? {\n                              inputFile,\n                              outputFile,\n                              sassSourceMap: result.sourceMap,\n                          }\n                        : undefined,\n                );\n\n            // Write the processed CSS to a file\n            await fs.writeFile(outputFile, processedCss, \"utf-8\");\n\n            // Write sourcemap if enabled\n            if (sourceMap && processedMap) {\n                const mapFile = `${outputFile}.map`;\n                await fs.writeFile(\n                    mapFile,\n                    processedMap.toString(),\n                    \"utf-8\",\n                );\n                this.logInfo(`Sourcemap written to ${mapFile}`);\n            }\n\n            this.logInfo(\n                `Styles processed successfully from ${inputFile} to ${outputFile}.`,\n            );\n        } catch (error) {\n            this.logError(\n                `Error processing styles from ${inputFile}: ${error}`,\n            );\n            throw error;\n        }\n    }\n\n    /**\n     * Processes the given CSS with PostCSS based on the provided style option.\n     * @param css - The CSS string to process.\n     * @param styleOption - The style option, either \"expanded\" or \"compressed\".\n     * @param sourceMapOptions - Optional sourcemap configuration.\n     * @returns Object containing processed CSS string and optional sourcemap.\n     */\n    private async processPostCSS(\n        css: string,\n        styleOption: \"expanded\" | \"compressed\",\n        sourceMapOptions?: {\n            inputFile: string;\n            outputFile: string;\n            sassSourceMap?: unknown;\n        },\n    ): Promise<{ css: string; map?: postcss.SourceMap }> {\n        const config =\n            styleOption === \"expanded\"\n                ? postcssConfigExpanded\n                : postcssConfigCompressed;\n\n        const postcssOptions: postcss.ProcessOptions = {\n            from: sourceMapOptions?.inputFile,\n            to: sourceMapOptions?.outputFile,\n        };\n\n        if (sourceMapOptions) {\n            postcssOptions.map = {\n                inline: false,\n                annotation: `${path.basename(sourceMapOptions.outputFile)}.map`,\n                prev: sourceMapOptions.sassSourceMap\n                    ? JSON.stringify(sourceMapOptions.sassSourceMap)\n                    : false,\n                sourcesContent: true,\n            };\n        } else {\n            postcssOptions.map = false;\n        }\n\n        const result = await postcss(config.plugins).process(css, postcssOptions);\n        return { css: result.css, map: result.map };\n    }\n\n    /**\n     * Ensures that the given directory exists, creating it if it does not.\n     * @param dirPath - The path of the directory to check and create.\n     */\n    private async ensureDirectoryExists(dirPath: string): Promise<void> {\n        try {\n            await fs.mkdir(dirPath, { recursive: true });\n        } catch (error) {\n            if (error instanceof Error) {\n                const nodeError = error as NodeJS.ErrnoException;\n                if (nodeError.code !== \"EEXIST\") {\n                    throw nodeError;\n                }\n            } else {\n                throw error;\n            }\n        }\n    }\n\n    /**\n     * Provides a description of the action.\n     * @returns A string description of the action.\n     */\n    describe(): string {\n        return \"Processes SCSS files into CSS, applying PostCSS transformations for expanded or compressed outputs.\";\n    }\n}\n","// ============================================================================\n// Export\n// ============================================================================\n\nexport { StyleProcessingAction } from \"./actions/StyleProcessingAction/index.js\";\nexport type { StyleProcessingActionOptions } from \"./actions/StyleProcessingAction/index.js\";\nexport { Action, ActionPlugin } from \"./types/Action.js\";\nexport type { ActionOptionsType } from \"./types/Action.js\";\n\n// ============================================================================\n// Plugin Definition\n// ============================================================================\n\nimport { ActionPlugin } from \"./types/Action.js\";\nimport { StyleProcessingAction } from \"./actions/StyleProcessingAction/index.js\";\n\nconst plugin: ActionPlugin = {\n    version: \"1.0.4\",\n    description: \"SASS/SCSS compilation with PostCSS processing for kist\",\n    author: \"kist\",\n    repository: \"https://github.com/getkist/kist-action-sass\",\n    keywords: [\"kist\", \"kist-action\", \"sass\", \"scss\", \"postcss\", \"css\"],\n    registerActions() {\n        return {\n            StyleProcessingAction,\n        };\n    },\n};\n\nexport default plugin;\n"]}

package/dist/{actions/StyleProcessingAction/StyleProcessingAction.d.ts → index.d.cts}

@@ -1,8 +1,77 @@
-import { Action, ActionOptionsType } from "../../types/Action.js";
+/**
+ * Base Action types for kist action plugins
+ * These types match the kist Action interface for compatibility
+ */
+/**
+ * Action options type - a generic record of key-value pairs
+ */
+type ActionOptionsType = Record<string, unknown>;
+/**
+ * Abstract base class for all kist actions
+ * Provides logging and execution interface
+ */
+declare abstract class Action<T extends ActionOptionsType = ActionOptionsType> {
+    /**
+     * Gets the unique name of the action.
+     */
+    get name(): string;
+    /**
+     * Validates options before execution
+     * Override in subclasses for specific validation
+     */
+    validateOptions(_options: T): boolean;
+    /**
+     * Execute the action with given options
+     * Must be implemented by subclasses
+     */
+    abstract execute(options: T): Promise<void>;
+    /**
+     * Provides a description of the action
+     */
+    describe(): string;
+    /**
+     * Log an info message
+     */
+    protected logInfo(message: string): void;
+    /**
+     * Log an error message
+     */
+    protected logError(message: string, error?: unknown): void;
+    /**
+     * Log a debug message
+     */
+    protected logDebug(message: string): void;
+    /**
+     * Log a warning message
+     */
+    protected logWarning(message: string): void;
+}
+/**
+ * Plugin interface for kist action packages
+ */
+interface ActionPlugin {
+    /** Plugin name */
+    name?: string;
+    /** Plugin version */
+    version: string;
+    /** Plugin description */
+    description?: string;
+    /** Plugin author */
+    author?: string;
+    /** Repository URL */
+    repository?: string;
+    /** Keywords */
+    keywords?: string[];
+    /** Map of action names to action classes */
+    actions?: Record<string, new () => Action>;
+    /** Register actions method */
+    registerActions?: () => Record<string, new () => Action>;
+}
+
 /**
  * Single output configuration for multi-output mode.
  */
-export interface StyleOutputConfig {
+interface StyleOutputConfig {
     /** Output file path */
     file: string;
     /** CSS style: expanded or compressed */
@@ -10,7 +79,7 @@ export interface StyleOutputConfig {
     /** Enable sourcemap for this output (default: false) */
     sourceMap?: boolean;
 }
-export interface StyleProcessingActionOptions extends ActionOptionsType {
+interface StyleProcessingActionOptions extends ActionOptionsType {
     /** Input SCSS/CSS file path */
     inputFile: string;
     /** Single output file path (mutually exclusive with outputs) */
@@ -42,7 +111,7 @@ export interface StyleProcessingActionOptions extends ActionOptionsType {
  * including compiling SCSS and applying PostCSS transformations. It supports
  * expanded and compressed output styles based on the provided configuration.
  */
-export declare class StyleProcessingAction extends Action {
+declare class StyleProcessingAction extends Action {
     /**
      * Executes the style processing action.
      * @param options - The options specific to style processing, including
@@ -79,4 +148,7 @@ export declare class StyleProcessingAction extends Action {
      */
     describe(): string;
 }
-//# sourceMappingURL=StyleProcessingAction.d.ts.map
+
+declare const plugin: ActionPlugin;
+
+export { Action, type ActionOptionsType, type ActionPlugin, StyleProcessingAction, type StyleProcessingActionOptions, plugin as default };

package/dist/index.d.ts

@@ -1,8 +1,154 @@
-export { StyleProcessingAction } from "./actions/StyleProcessingAction/index.js";
-export type { StyleProcessingActionOptions } from "./actions/StyleProcessingAction/index.js";
-export { Action, ActionPlugin } from "./types/Action.js";
-export type { ActionOptionsType } from "./types/Action.js";
-import { ActionPlugin } from "./types/Action.js";
+/**
+ * Base Action types for kist action plugins
+ * These types match the kist Action interface for compatibility
+ */
+/**
+ * Action options type - a generic record of key-value pairs
+ */
+type ActionOptionsType = Record<string, unknown>;
+/**
+ * Abstract base class for all kist actions
+ * Provides logging and execution interface
+ */
+declare abstract class Action<T extends ActionOptionsType = ActionOptionsType> {
+    /**
+     * Gets the unique name of the action.
+     */
+    get name(): string;
+    /**
+     * Validates options before execution
+     * Override in subclasses for specific validation
+     */
+    validateOptions(_options: T): boolean;
+    /**
+     * Execute the action with given options
+     * Must be implemented by subclasses
+     */
+    abstract execute(options: T): Promise<void>;
+    /**
+     * Provides a description of the action
+     */
+    describe(): string;
+    /**
+     * Log an info message
+     */
+    protected logInfo(message: string): void;
+    /**
+     * Log an error message
+     */
+    protected logError(message: string, error?: unknown): void;
+    /**
+     * Log a debug message
+     */
+    protected logDebug(message: string): void;
+    /**
+     * Log a warning message
+     */
+    protected logWarning(message: string): void;
+}
+/**
+ * Plugin interface for kist action packages
+ */
+interface ActionPlugin {
+    /** Plugin name */
+    name?: string;
+    /** Plugin version */
+    version: string;
+    /** Plugin description */
+    description?: string;
+    /** Plugin author */
+    author?: string;
+    /** Repository URL */
+    repository?: string;
+    /** Keywords */
+    keywords?: string[];
+    /** Map of action names to action classes */
+    actions?: Record<string, new () => Action>;
+    /** Register actions method */
+    registerActions?: () => Record<string, new () => Action>;
+}
+
+/**
+ * Single output configuration for multi-output mode.
+ */
+interface StyleOutputConfig {
+    /** Output file path */
+    file: string;
+    /** CSS style: expanded or compressed */
+    style: "expanded" | "compressed";
+    /** Enable sourcemap for this output (default: false) */
+    sourceMap?: boolean;
+}
+interface StyleProcessingActionOptions extends ActionOptionsType {
+    /** Input SCSS/CSS file path */
+    inputFile: string;
+    /** Single output file path (mutually exclusive with outputs) */
+    outputFile?: string;
+    /** Single output style option (mutually exclusive with outputs) */
+    styleOption?: "expanded" | "compressed";
+    /**
+     * Multiple outputs from single input (mutually exclusive with outputFile/styleOption).
+     * Allows generating both expanded and compressed CSS from one source.
+     *
+     * @example
+     * ```yaml
+     * outputs:
+     *   - file: "./dist/css/app.css"
+     *     style: expanded
+     *     sourceMap: true
+     *   - file: "./dist/css/app.min.css"
+     *     style: compressed
+     * ```
+     */
+    outputs?: StyleOutputConfig[];
+    /** Enable sourcemap generation for single output mode (default: false) */
+    sourceMap?: boolean;
+    /** Include original source content in sourcemap (default: true when sourceMap enabled) */
+    sourceMapIncludeSources?: boolean;
+}
+/**
+ * StyleProcessingAction is a step action responsible for processing styles,
+ * including compiling SCSS and applying PostCSS transformations. It supports
+ * expanded and compressed output styles based on the provided configuration.
+ */
+declare class StyleProcessingAction extends Action {
+    /**
+     * Executes the style processing action.
+     * @param options - The options specific to style processing, including
+     * input/output file paths and style format.
+     * @returns A Promise that resolves when the styles are processed
+     * successfully, or rejects with an error if the action fails.
+     */
+    execute(options: StyleProcessingActionOptions): Promise<void>;
+    /**
+     * Executes multi-output mode: compiles SCSS for each unique style,
+     * then generates all specified output files.
+     */
+    private executeMultiOutput;
+    /**
+     * Executes single-output mode (legacy behavior).
+     */
+    private executeSingleOutput;
+    /**
+     * Processes the given CSS with PostCSS based on the provided style option.
+     * @param css - The CSS string to process.
+     * @param styleOption - The style option, either "expanded" or "compressed".
+     * @param sourceMapOptions - Optional sourcemap configuration.
+     * @returns Object containing processed CSS string and optional sourcemap.
+     */
+    private processPostCSS;
+    /**
+     * Ensures that the given directory exists, creating it if it does not.
+     * @param dirPath - The path of the directory to check and create.
+     */
+    private ensureDirectoryExists;
+    /**
+     * Provides a description of the action.
+     * @returns A string description of the action.
+     */
+    describe(): string;
+}
+
 declare const plugin: ActionPlugin;
-export default plugin;
-//# sourceMappingURL=index.d.ts.map
+
+export { Action, type ActionOptionsType, type ActionPlugin, StyleProcessingAction, type StyleProcessingActionOptions, plugin as default };