@ecopages/postcss-processor 0.2.0-alpha.9 → 0.2.0-beta.0

package/src/presets/tailwind-v3.ts

@@ -1,72 +0,0 @@
-/**
- * Tailwind CSS v3 Preset for PostCSS Processor
- * @module @ecopages/postcss-processor/presets/tailwind-v3
- *
- * Requires: tailwindcss, postcss-import, autoprefixer, cssnano
- * Install: bun add tailwindcss postcss-import autoprefixer cssnano
- */
-
-import autoprefixer from 'autoprefixer';
-import browserslist from 'browserslist';
-import cssnano from 'cssnano';
-import type postcss from 'postcss';
-import postcssImport from 'postcss-import';
-import tailwindcss from 'tailwindcss';
-import tailwindcssNesting from 'tailwindcss/nesting/index.js';
-import type { PluginFactoryRecord, PostCssProcessorPluginConfig } from '../plugin.ts';
-
-type PluginsRecord = Record<string, postcss.AcceptedPlugin>;
-
-/**
- * Creates a PostCSS processor config preset for Tailwind CSS v3.
- *
- * Features:
- * - Uses classic Tailwind v3 plugin stack
- * - Includes postcss-import, tailwindcss/nesting, tailwindcss, autoprefixer, cssnano
- * - Returns both `plugins` for immediate use and `pluginFactories` so Ecopages
- *   can recreate fresh Tailwind/PostCSS plugin instances on dependency-driven rebuilds
- *
- * @example
- * ```typescript
- * import { postcssProcessorPlugin } from '@ecopages/postcss-processor';
- * import { tailwindV3Preset } from '@ecopages/postcss-processor/presets';
- *
- * // Basic usage
- * postcssProcessorPlugin(tailwindV3Preset())
- *
- * // Extend with additional plugins
- * const preset = tailwindV3Preset();
- * postcssProcessorPlugin({
- *   ...preset,
- *   plugins: { ...preset.plugins, myPlugin: myPlugin() },
- * })
- * ```
- */
-export function tailwindV3Preset(): PostCssProcessorPluginConfig {
-	// Check if browserslist config exists
-	const browserslistConfig = browserslist.loadConfig({ path: process.cwd() });
-	const autoprefixerOptions = browserslistConfig
-		? {}
-		: {
-				overrideBrowserslist: ['>0.3%', 'not ie 11', 'not dead', 'not op_mini all'],
-			};
-
-	const pluginFactories: PluginFactoryRecord = {
-		'postcss-import': () => postcssImport(),
-		'tailwindcss/nesting': () => tailwindcssNesting(),
-		tailwindcss: () => tailwindcss(),
-		autoprefixer: () => autoprefixer(autoprefixerOptions),
-		cssnano: () => cssnano(),
-	};
-
-	const plugins: PluginsRecord = Object.fromEntries(
-		Object.entries(pluginFactories).map(([name, factory]) => [name, factory()]),
-	) as PluginsRecord;
-
-	/**
-	 * Keep both forms:
-	 * - `plugins` are used immediately by the processor
-	 * - `pluginFactories` let the processor recreate fresh plugin instances later
-	 */
-	return { plugins, pluginFactories };
-}

package/src/presets/tailwind-v4.ts

@@ -1,122 +0,0 @@
-/**
- * Tailwind CSS v4 Preset for PostCSS Processor
- * @module @ecopages/postcss-processor/presets/tailwind-v4
- *
- * Requires: @tailwindcss/postcss, cssnano
- * Install: bun add @tailwindcss/postcss cssnano
- */
-
-import tailwindcss from '@tailwindcss/postcss';
-import autoprefixer from 'autoprefixer';
-import browserslist from 'browserslist';
-import cssnano from 'cssnano';
-import path from 'node:path';
-import postcssImport from 'postcss-import';
-import postcssNested from 'postcss-nested';
-import type { PluginFactoryRecord, PostCssProcessorPluginConfig } from '../plugin.ts';
-
-/**
- * Options for Tailwind v4 preset
- */
-export interface TailwindV4PresetOptions {
-	/**
-	 * Absolute path to the main Tailwind CSS file containing `@import "tailwindcss"`.
-	 * Used to calculate relative @reference paths for CSS files using @apply.
-	 */
-	referencePath: string;
-}
-
-/**
- * Creates a PostCSS processor config preset for Tailwind CSS v4.
- *
- * Features:
- * - Uses `@tailwindcss/postcss` plugin (v4)
- * - Automatically injects `@reference` headers for `@apply` support
- * - Includes cssnano for CSS minification
- * - Returns both `plugins` for immediate use and `pluginFactories` so Ecopages
- *   can recreate fresh Tailwind/PostCSS plugin instances on dependency-driven rebuilds
- *
- * @example
- * ```typescript
- * import { postcssProcessorPlugin } from '@ecopages/postcss-processor';
- * import { tailwindV4Preset } from '@ecopages/postcss-processor/presets';
- *
- * // Basic usage
- * postcssProcessorPlugin(tailwindV4Preset({
- *   referencePath: path.resolve(import.meta.dir, 'src/styles/tailwind.css'),
- * }))
- *
- * // Extend with additional plugins
- * const preset = tailwindV4Preset({ referencePath });
- * postcssProcessorPlugin({
- *   ...preset,
- *   plugins: { ...preset.plugins, myPlugin: myPlugin() },
- * })
- * ```
- */
-export function tailwindV4Preset(options: TailwindV4PresetOptions): PostCssProcessorPluginConfig {
-	const { referencePath } = options;
-
-	// Check if browserslist config exists
-	const browserslistConfig = browserslist.loadConfig({ path: process.cwd() });
-	const autoprefixerOptions = browserslistConfig
-		? {}
-		: {
-				overrideBrowserslist: ['>0.3%', 'not ie 11', 'not dead', 'not op_mini all'],
-			};
-
-	const pluginFactories: PluginFactoryRecord = {
-		'postcss-import': () => postcssImport(),
-		'postcss-nested': () => postcssNested(),
-		'@tailwindcss/postcss': () => tailwindcss({ optimize: false }),
-		autoprefixer: () => autoprefixer(autoprefixerOptions),
-		cssnano: () => cssnano(),
-	};
-
-	return {
-		/**
-		 * Instantiate the initial plugin list for the active processor instance.
-		 * Fresh instances can later be recreated from `pluginFactories`.
-		 */
-		plugins: Object.fromEntries(Object.entries(pluginFactories).map(([name, factory]) => [name, factory()])),
-		pluginFactories,
-		transformInput: async (contents: string | Buffer, filePath: string): Promise<string> => {
-			const css = contents instanceof Buffer ? contents.toString('utf-8') : (contents as string);
-			const normalizedFilePath = path.resolve(filePath);
-			const normalizedReferencePath = path.resolve(referencePath);
-
-			/** Skip transformation for the main tailwind entry file */
-			if (normalizedFilePath === normalizedReferencePath) {
-				return css;
-			}
-
-			/** Skip if file already has an @reference directive */
-			if (/^\s*@reference\s+/m.test(css)) {
-				return css;
-			}
-
-			const relativePath = path.relative(path.dirname(filePath), referencePath);
-
-			/** Skip if file already imports the referencePath */
-			if (css.includes(`@import '${relativePath}'`) || css.includes(`@import "${relativePath}"`)) {
-				return css;
-			}
-
-			/**
-			 * Replace `@import 'tailwindcss'` with an import to the referencePath.
-			 * This ensures custom theme variables are available for @apply directives.
-			 */
-			const tailwindImportPattern = /^@import\s+['"]tailwindcss(?:\/[^'"]*)?['"];?\s*$/m;
-			if (tailwindImportPattern.test(css)) {
-				return css.replace(tailwindImportPattern, `@import '${relativePath}';`);
-			}
-
-			/** If file uses @apply but has no tailwind import, add @reference */
-			if (css.includes('@apply')) {
-				return `@reference "${relativePath}";\n\n${css}`;
-			}
-
-			return css;
-		},
-	};
-}

package/src/runtime/css-loader-plugin.ts

@@ -1,37 +0,0 @@
-import type { EcoBuildPlugin } from '@ecopages/core/build/build-types';
-
-import { getFileAsBuffer } from '../postcss-processor';
-import type { CssTransform } from './css-runtime-contract';
-
-type CssLoaderOptions = {
-	name: string;
-	filter: RegExp;
-	transform: CssTransform;
-};
-
-export const createCssLoaderPlugin = ({ name, filter, transform }: CssLoaderOptions): EcoBuildPlugin => ({
-	name,
-	setup(build) {
-		build.onLoad({ filter }, (args) => {
-			const rawFile = getFileAsBuffer(args.path);
-			const css = transform({
-				contents: rawFile,
-				filePath: args.path,
-			});
-
-			if (css instanceof Promise) {
-				return css.then((resolved) => ({
-					exports: { default: resolved },
-					loader: 'object' as const,
-				}));
-			}
-
-			return {
-				exports: {
-					default: css as string,
-				},
-				loader: 'object' as const,
-			};
-		});
-	},
-});

package/src/runtime/css-loader.bun.ts

@@ -1,30 +0,0 @@
-import type { EcoBuildPlugin } from '@ecopages/core/build/build-types';
-
-import { getFileAsBuffer } from '../postcss-processor';
-import type { CssTransform } from './css-runtime-contract';
-
-type BunCssLoaderOptions = {
-	name: string;
-	filter: RegExp;
-	transform: CssTransform;
-};
-
-export const createBunCssLoaderPlugin = ({ name, filter, transform }: BunCssLoaderOptions): EcoBuildPlugin => ({
-	name,
-	setup(build) {
-		build.onLoad({ filter }, async (args) => {
-			const rawFile = await getFileAsBuffer(args.path);
-			const css = await transform({
-				contents: rawFile,
-				filePath: args.path,
-			});
-
-			return {
-				exports: {
-					default: css,
-				},
-				loader: 'object',
-			};
-		});
-	},
-});

package/src/runtime/css-runtime-contract.ts

@@ -1,6 +0,0 @@
-export type CssTransformInput = {
-	contents: string | Buffer;
-	filePath: string;
-};
-
-export type CssTransform = (input: CssTransformInput) => string | Promise<string>;