@getkist/action-postcss 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+# @getkist/action-postcss
+
+PostCSS processing actions for kist with autoprefixer and cssnano support.
+
+## Installation
+
+```bash
+npm install @getkist/action-postcss
+```
+
+## Usage
+
+### As a kist plugin
+
+```yaml
+# kist.yml
+plugins:
+  - "@getkist/action-postcss"
+
+pipeline:
+  - action: PostCssAction
+    options:
+      inputPath: "dist/css/styles.css"
+      outputPath: "dist/css/styles.min.css"
+      autoprefixer: true
+      minify: true
+```
+
+### Standalone usage
+
+```typescript
+import { PostCssAction } from "@getkist/action-postcss";
+
+const action = new PostCssAction();
+await action.execute({
+  inputPath: "dist/css/styles.css",
+  outputPath: "dist/css/styles.min.css",
+  autoprefixer: true,
+  browsers: ["> 1%", "last 2 versions", "not dead"],
+  minify: true,
+  sourcemap: true
+});
+```
+
+## Actions
+
+### PostCssAction
+
+Processes CSS files using PostCSS with autoprefixer and cssnano support.
+
+#### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `inputPath` | `string` | *required* | Path to the input CSS file |
+| `outputPath` | `string` | *required* | Path where the processed CSS will be saved |
+| `autoprefixer` | `boolean` | `true` | Enable autoprefixer |
+| `browsers` | `string[]` | `["> 1%", "last 2 versions", "not dead"]` | Autoprefixer browser targets |
+| `minify` | `boolean` | `false` | Enable minification with cssnano |
+| `cssnanoPreset` | `"default" \| "lite" \| "advanced"` | `"default"` | cssnano preset |
+| `sourcemap` | `boolean` | `false` | Generate sourcemap |
+| `inlineSourcemap` | `boolean` | `false` | Inline sourcemap instead of external file |
+| `plugins` | `AcceptedPlugin[]` | `[]` | Additional PostCSS plugins |
+
+## Configuration Examples
+
+### Add vendor prefixes only
+
+```yaml
+- action: PostCssAction
+  options:
+    inputPath: "src/css/main.css"
+    outputPath: "dist/css/main.css"
+    autoprefixer: true
+    minify: false
+```
+
+### Minify CSS for production
+
+```yaml
+- action: PostCssAction
+  options:
+    inputPath: "dist/css/styles.css"
+    outputPath: "dist/css/styles.min.css"
+    autoprefixer: true
+    minify: true
+    cssnanoPreset: "advanced"
+```
+
+### Generate external sourcemap
+
+```yaml
+- action: PostCssAction
+  options:
+    inputPath: "src/css/app.css"
+    outputPath: "dist/css/app.css"
+    autoprefixer: true
+    minify: true
+    sourcemap: true
+    inlineSourcemap: false
+```
+
+### Custom browser targets
+
+```yaml
+- action: PostCssAction
+  options:
+    inputPath: "src/css/modern.css"
+    outputPath: "dist/css/modern.css"
+    autoprefixer: true
+    browsers:
+      - "last 1 Chrome version"
+      - "last 1 Firefox version"
+      - "last 1 Safari version"
+```
+
+### Use with custom PostCSS plugins
+
+```typescript
+import { PostCssAction } from "@getkist/action-postcss";
+import postcssNested from "postcss-nested";
+import postcssCustomProperties from "postcss-custom-properties";
+
+const action = new PostCssAction();
+await action.execute({
+  inputPath: "src/css/app.css",
+  outputPath: "dist/css/app.css",
+  plugins: [
+    postcssNested(),
+    postcssCustomProperties({ preserve: false })
+  ]
+});
+```
+
+## License
+
+MIT

package/dist/actions/PostCssAction/PostCssAction.d.ts

@@ -0,0 +1,53 @@
+import { AcceptedPlugin } from "postcss";
+import { Action, ActionOptionsType } from "../../types/Action.js";
+/**
+ * Options for the PostCssAction
+ */
+export interface PostCssActionOptions extends ActionOptionsType {
+    /** Path to the input CSS file */
+    inputPath: string;
+    /** Path where the processed CSS will be saved */
+    outputPath: string;
+    /** Enable autoprefixer (default: true) */
+    autoprefixer?: boolean;
+    /** Autoprefixer browser targets */
+    browsers?: string[];
+    /** Enable minification with cssnano (default: false) */
+    minify?: boolean;
+    /** cssnano preset (default: default) */
+    cssnanoPreset?: "default" | "lite" | "advanced";
+    /** Generate sourcemap (default: false) */
+    sourcemap?: boolean;
+    /** Inline sourcemap instead of external file (default: false) */
+    inlineSourcemap?: boolean;
+    /** Additional PostCSS plugins */
+    plugins?: AcceptedPlugin[];
+}
+/**
+ * PostCssAction handles CSS processing using PostCSS.
+ * Supports autoprefixer, cssnano minification, and custom plugins.
+ */
+export declare class PostCssAction extends Action<PostCssActionOptions> {
+    /**
+     * Validates the action options.
+     *
+     * @param options - The options to validate.
+     * @returns True if options are valid.
+     */
+    validateOptions(options: PostCssActionOptions): boolean;
+    /**
+     * Executes the PostCSS processing action.
+     *
+     * @param options - The options for CSS processing.
+     * @returns A Promise that resolves when processing completes.
+     * @throws {Error} If processing encounters an error.
+     */
+    execute(options: PostCssActionOptions): Promise<void>;
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe(): string;
+}
+//# sourceMappingURL=PostCssAction.d.ts.map

package/dist/actions/PostCssAction/PostCssAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostCssAction.d.ts","sourceRoot":"","sources":["../../../src/actions/PostCssAction/PostCssAction.ts"],"names":[],"mappings":"AAMA,OAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGlD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAMlE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC3D,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAChD,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAMD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,MAAM,CAAC,oBAAoB,CAAC;IAC3D;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO;IA2BvD;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6E3D;;;;OAIG;IACH,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/actions/PostCssAction/PostCssAction.js

@@ -0,0 +1,121 @@
+// ============================================================================
+// Import
+// ============================================================================
+import { promises as fs } from "fs";
+import path from "path";
+import postcss from "postcss";
+import autoprefixer from "autoprefixer";
+import cssnano from "cssnano";
+import { Action } from "../../types/Action.js";
+// ============================================================================
+// Classes
+// ============================================================================
+/**
+ * PostCssAction handles CSS processing using PostCSS.
+ * Supports autoprefixer, cssnano minification, and custom plugins.
+ */
+export class PostCssAction extends Action {
+    /**
+     * Validates the action options.
+     *
+     * @param options - The options to validate.
+     * @returns True if options are valid.
+     */
+    validateOptions(options) {
+        if (!options.inputPath || typeof options.inputPath !== "string") {
+            this.logError("Invalid options: 'inputPath' is required and must be a string.");
+            return false;
+        }
+        if (!options.outputPath || typeof options.outputPath !== "string") {
+            this.logError("Invalid options: 'outputPath' is required and must be a string.");
+            return false;
+        }
+        if (options.autoprefixer !== undefined && typeof options.autoprefixer !== "boolean") {
+            this.logError("Invalid options: 'autoprefixer' must be a boolean.");
+            return false;
+        }
+        if (options.minify !== undefined && typeof options.minify !== "boolean") {
+            this.logError("Invalid options: 'minify' must be a boolean.");
+            return false;
+        }
+        if (options.cssnanoPreset !== undefined) {
+            const validPresets = ["default", "lite", "advanced"];
+            if (!validPresets.includes(options.cssnanoPreset)) {
+                this.logError(`Invalid options: 'cssnanoPreset' must be one of: ${validPresets.join(", ")}`);
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Executes the PostCSS processing action.
+     *
+     * @param options - The options for CSS processing.
+     * @returns A Promise that resolves when processing completes.
+     * @throws {Error} If processing encounters an error.
+     */
+    async execute(options) {
+        if (!this.validateOptions(options)) {
+            throw new Error("Invalid options provided to PostCssAction.");
+        }
+        const { inputPath, outputPath, autoprefixer: useAutoprefixer = true, browsers = ["> 1%", "last 2 versions", "not dead"], minify = false, cssnanoPreset = "default", sourcemap = false, inlineSourcemap = false, plugins: customPlugins = [], } = options;
+        this.logInfo(`Processing CSS: ${inputPath} → ${outputPath}`);
+        try {
+            const resolvedInputPath = path.resolve(inputPath);
+            const resolvedOutputPath = path.resolve(outputPath);
+            // Read input CSS
+            const inputCss = await fs.readFile(resolvedInputPath, "utf8");
+            // Build plugin list
+            const plugins = [];
+            if (useAutoprefixer) {
+                plugins.push(autoprefixer({ overrideBrowserslist: browsers }));
+            }
+            if (minify) {
+                plugins.push(cssnano({ preset: cssnanoPreset }));
+            }
+            // Add custom plugins
+            plugins.push(...customPlugins);
+            // Process with PostCSS
+            const result = await postcss(plugins).process(inputCss, {
+                from: resolvedInputPath,
+                to: resolvedOutputPath,
+                map: sourcemap ? { inline: inlineSourcemap } : false,
+            });
+            // Ensure output directory exists
+            const outputDir = path.dirname(resolvedOutputPath);
+            await fs.mkdir(outputDir, { recursive: true });
+            // Write output CSS
+            await fs.writeFile(resolvedOutputPath, result.css, "utf8");
+            // Write sourcemap if external
+            if (sourcemap && !inlineSourcemap && result.map) {
+                await fs.writeFile(`${resolvedOutputPath}.map`, result.map.toString(), "utf8");
+                this.logDebug(`Sourcemap written to ${resolvedOutputPath}.map`);
+            }
+            // Log warnings
+            for (const warning of result.warnings()) {
+                this.logWarning(`${warning.plugin}: ${warning.text}`);
+            }
+            const features = [];
+            if (useAutoprefixer)
+                features.push("autoprefixer");
+            if (minify)
+                features.push("minify");
+            if (sourcemap)
+                features.push("sourcemap");
+            this.logInfo(`CSS processing completed: ${outputPath} (${features.join(", ") || "no transforms"})`);
+        }
+        catch (error) {
+            this.logError("PostCSS processing failed.", error);
+            throw error;
+        }
+    }
+    /**
+     * Provides a description of the action.
+     *
+     * @returns A string description of the action.
+     */
+    describe() {
+        return "Processes CSS files using PostCSS with autoprefixer and cssnano support.";
+    }
+}
+//# sourceMappingURL=PostCssAction.js.map

package/dist/actions/PostCssAction/PostCssAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostCssAction.js","sourceRoot":"","sources":["../../../src/actions/PostCssAction/PostCssAction.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,OAA2B,MAAM,SAAS,CAAC;AAClD,OAAO,YAAY,MAAM,cAAc,CAAC;AACxC,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAqB,MAAM,uBAAuB,CAAC;AA8BlE,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,MAA4B;IAC3D;;;;;OAKG;IACH,eAAe,CAAC,OAA6B;QACzC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9D,IAAI,CAAC,QAAQ,CAAC,gEAAgE,CAAC,CAAC;YAChF,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAChE,IAAI,CAAC,QAAQ,CAAC,iEAAiE,CAAC,CAAC;YACjF,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAClF,IAAI,CAAC,QAAQ,CAAC,oDAAoD,CAAC,CAAC;YACpE,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACtE,IAAI,CAAC,QAAQ,CAAC,8CAA8C,CAAC,CAAC;YAC9D,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YACrD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,QAAQ,CAAC,oDAAoD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC7F,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,OAA6B;QACvC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,EACF,SAAS,EACT,UAAU,EACV,YAAY,EAAE,eAAe,GAAG,IAAI,EACpC,QAAQ,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,CAAC,EAClD,MAAM,GAAG,KAAK,EACd,aAAa,GAAG,SAAS,EACzB,SAAS,GAAG,KAAK,EACjB,eAAe,GAAG,KAAK,EACvB,OAAO,EAAE,aAAa,GAAG,EAAE,GAC9B,GAAG,OAAO,CAAC;QAEZ,IAAI,CAAC,OAAO,CAAC,mBAAmB,SAAS,MAAM,UAAU,EAAE,CAAC,CAAC;QAE7D,IAAI,CAAC;YACD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAEpD,iBAAiB;YACjB,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;YAE9D,oBAAoB;YACpB,MAAM,OAAO,GAAqB,EAAE,CAAC;YAErC,IAAI,eAAe,EAAE,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACT,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;YACrD,CAAC;YAED,qBAAqB;YACrB,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;YAE/B,uBAAuB;YACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE;gBACpD,IAAI,EAAE,iBAAiB;gBACvB,EAAE,EAAE,kBAAkB;gBACtB,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,KAAK;aACvD,CAAC,CAAC;YAEH,iCAAiC;YACjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;YACnD,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE/C,mBAAmB;YACnB,MAAM,EAAE,CAAC,SAAS,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAE3D,8BAA8B;YAC9B,IAAI,SAAS,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;gBAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,kBAAkB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;gBAC/E,IAAI,CAAC,QAAQ,CAAC,wBAAwB,kBAAkB,MAAM,CAAC,CAAC;YACpE,CAAC;YAED,eAAe;YACf,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACtC,IAAI,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC;YAED,MAAM,QAAQ,GAAG,EAAE,CAAC;YACpB,IAAI,eAAe;gBAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnD,IAAI,MAAM;gBAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,SAAS;gBAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAE1C,IAAI,CAAC,OAAO,CAAC,6BAA6B,UAAU,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,GAAG,CAAC,CAAC;QACxG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACJ,OAAO,0EAA0E,CAAC;IACtF,CAAC;CACJ"}

package/dist/actions/PostCssAction/index.d.ts

@@ -0,0 +1,3 @@
+import { PostCssAction, PostCssActionOptions } from "./PostCssAction.js";
+export { PostCssAction, PostCssActionOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/PostCssAction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/PostCssAction/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAMzE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/actions/PostCssAction/index.js

@@ -0,0 +1,9 @@
+// ============================================================================
+// Import
+// ============================================================================
+import { PostCssAction } from "./PostCssAction.js";
+// ============================================================================
+// Export
+// ============================================================================
+export { PostCssAction };
+//# sourceMappingURL=index.js.map

package/dist/actions/PostCssAction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/PostCssAction/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAwB,MAAM,oBAAoB,CAAC;AAEzE,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAwB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { ActionPlugin } from "./types/Action.js";
+import { PostCssAction } from "./actions/PostCssAction/index.js";
+declare const plugin: ActionPlugin;
+export default plugin;
+export type { PostCssActionOptions } from "./actions/PostCssAction/index.js";
+export { PostCssAction };
+export { Action, ActionPlugin, ActionOptionsType } from "./types/Action.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,QAAA,MAAM,MAAM,EAAE,YAIb,CAAC;AAEF,eAAe,MAAM,CAAC;AACtB,YAAY,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+import { PostCssAction } from "./actions/PostCssAction/index.js";
+const plugin = {
+    name: "@getkist/action-postcss",
+    version: "1.0.0",
+    actions: { PostCssAction },
+};
+export default plugin;
+export { PostCssAction };
+export { Action } from "./types/Action.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,MAAM,MAAM,GAAiB;IACzB,IAAI,EAAE,yBAAyB;IAC/B,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,EAAE,aAAa,EAAE;CAC7B,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,OAAO,EAAE,MAAM,EAAmC,MAAM,mBAAmB,CAAC"}

package/dist/types/Action.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 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
+ */
+export type ActionOptionsType = Record<string, unknown>;
+/**
+ * Abstract base class for all kist actions
+ * Provides logging and execution interface
+ */
+export 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
+ */
+export interface ActionPlugin {
+    /** Plugin name */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Map of action names to action classes */
+    actions: Record<string, new () => Action>;
+}
+//# sourceMappingURL=Action.d.ts.map

package/dist/types/Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../src/types/Action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;;GAGG;AACH,8BAAsB,MAAM,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IACxE;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,GAAG,OAAO;IAIrC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAI1D;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMzC;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG9C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,MAAM,CAAC,CAAC;CAC7C"}

package/dist/types/Action.js

@@ -0,0 +1,56 @@
+/**
+ * Base Action types for kist action plugins
+ * These types match the kist Action interface for compatibility
+ */
+/**
+ * Abstract base class for all kist actions
+ * Provides logging and execution interface
+ */
+export class Action {
+    /**
+     * 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}`);
+    }
+}
+//# sourceMappingURL=Action.js.map

package/dist/types/Action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.js","sourceRoot":"","sources":["../../src/types/Action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;GAGG;AACH,MAAM,OAAgB,MAAM;IACxB;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,QAAW;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAQD;;OAEG;IACH,QAAQ;QACJ,OAAO,GAAG,IAAI,CAAC,IAAI,SAAS,CAAC;IACjC,CAAC;IAED;;OAEG;IACO,OAAO,CAAC,OAAe;QAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACO,QAAQ,CAAC,OAAe,EAAE,KAAe;QAC/C,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,YAAY,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACO,QAAQ,CAAC,OAAe;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,YAAY,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;IAED;;OAEG;IACO,UAAU,CAAC,OAAe;QAChC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,cAAc,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@getkist/action-postcss",
+  "version": "1.0.1",
+  "description": "PostCSS processing actions for kist",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "keywords": [
+    "kist",
+    "kist-action",
+    "postcss",
+    "css",
+    "autoprefixer",
+    "cssnano",
+    "minify"
+  ],
+  "author": "kist",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getkist/kist-action-postcss.git"
+  },
+  "bugs": {
+    "url": "https://github.com/getkist/kist-action-postcss/issues"
+  },
+  "homepage": "https://github.com/getkist/kist-action-postcss#readme",
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+    "test:watch": "NODE_OPTIONS='--experimental-vm-modules' jest --watch",
+    "test:coverage": "NODE_OPTIONS='--experimental-vm-modules' jest --coverage",
+    "test:unit": "NODE_OPTIONS='--experimental-vm-modules' jest --testPathPatterns=\\.test\\.ts$",
+    "test:integration": "NODE_OPTIONS='--experimental-vm-modules' jest --testPathPatterns=\\.integration\\.test\\.ts$",
+    "lint": "eslint 'src/**/*.ts'",
+    "lint:fix": "eslint 'src/**/*.ts' --fix",
+    "format": "prettier --write 'src/**/*.ts'",
+    "docs": "typedoc",
+    "docs:watch": "typedoc --watch",
+    "clean": "rm -rf dist docs/api coverage",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "peerDependencies": {
+    "kist": ">=0.1.58"
+  },
+  "dependencies": {
+    "postcss": "^8.4.0",
+    "autoprefixer": "^10.4.0",
+    "cssnano": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "30.0.0",
+    "@types/node": "25.2.2",
+    "@typescript-eslint/eslint-plugin": "8.54.0",
+    "@typescript-eslint/parser": "8.54.0",
+    "eslint": "10.0.0",
+    "jest": "30.2.0",
+    "ts-jest": "^29.4.6",
+    "typedoc": "^0.28.0",
+    "typedoc-plugin-markdown": "^4.10.0",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false
+}