@10up/build 1.0.0-alpha.1

package/dist/config.js

@@ -0,0 +1,230 @@
+/**
+ * Configuration loading for @10up/build
+ *
+ * This module handles loading and merging configuration from multiple sources:
+ * 1. Default configuration values
+ * 2. `package.json["10up-toolkit"]` field
+ * 3. Configuration files (buildfiles.config.js, postcss.config.js)
+ *
+ * @packageDocumentation
+ * @module config
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { fromProjectRoot, fromPackageRoot } from './utils/paths.js';
+/**
+ * Default paths configuration.
+ *
+ * These defaults follow the 10up-toolkit convention for WordPress
+ * theme and plugin development.
+ */
+const defaultPaths = {
+    blocksDir: './includes/blocks/',
+    distDir: './dist/',
+    srcDir: './assets/',
+    copyAssetsDir: './assets/',
+    blocksStyles: './assets/css/blocks/',
+    globalStylesDir: './assets/css/globals/',
+    globalMixinsDir: './assets/css/mixins/',
+};
+/**
+ * Default filenames configuration.
+ *
+ * Uses esbuild-style placeholders for output naming.
+ */
+const defaultFilenames = {
+    js: 'js/[name].js',
+    jsChunk: 'js/[name].[contenthash].chunk.js',
+    css: 'css/[name].css',
+    block: 'blocks/[name].js',
+    blockCSS: 'blocks/[name].css',
+};
+/**
+ * Default configuration values.
+ *
+ * These values are used when not overridden by user configuration.
+ * The configuration schema is designed to be compatible with
+ * 10up-toolkit's configuration format.
+ *
+ * @example
+ * ```typescript
+ * import { defaultConfig } from '@10up/build/config';
+ * console.log(defaultConfig.wpDependencyExternals); // true
+ * ```
+ */
+export const defaultConfig = {
+    // Entry points
+    entry: {},
+    moduleEntry: {},
+    // Paths
+    paths: defaultPaths,
+    // Output filenames
+    filenames: defaultFilenames,
+    // Features
+    useBlockAssets: false,
+    useScriptModules: false,
+    wpDependencyExternals: true,
+    loadBlockSpecificStyles: false,
+    // Development
+    hot: false,
+    devServerPort: 8887,
+    devURL: '',
+    // Build options
+    sourcemap: false,
+    publicPath: '/dist/',
+    // External namespaces for custom packages
+    externalNamespaces: {},
+};
+/**
+ * Load and merge configuration from all sources.
+ *
+ * Configuration is loaded in the following order (later sources override earlier):
+ * 1. Default configuration
+ * 2. `package.json["10up-toolkit"]` field
+ * 3. PostCSS configuration file detection
+ *
+ * @returns Merged build configuration
+ *
+ * @example
+ * ```typescript
+ * import { loadConfig } from '@10up/build';
+ *
+ * const config = loadConfig();
+ * console.log(config.paths.blocksDir); // "./includes/blocks/"
+ * ```
+ */
+export function loadConfig() {
+    const projectPackageJson = loadProjectPackageJson();
+    const toolkitConfig = (projectPackageJson?.['10up-toolkit'] || {});
+    // Deep merge paths
+    const paths = {
+        ...defaultPaths,
+        ...(toolkitConfig.paths || {}),
+    };
+    // Deep merge filenames
+    const filenames = {
+        ...defaultFilenames,
+        ...(toolkitConfig.filenames || {}),
+    };
+    // Merge all config
+    const config = {
+        ...defaultConfig,
+        ...toolkitConfig,
+        paths,
+        filenames,
+    };
+    // Load additional config files
+    config.postcss = loadPostcssConfig(config);
+    return config;
+}
+/**
+ * Load the project's package.json file.
+ *
+ * Reads and parses the package.json from the current working directory.
+ *
+ * @returns Parsed package.json content, or null if not found/invalid
+ *
+ * @internal
+ */
+function loadProjectPackageJson() {
+    const packageJsonPath = fromProjectRoot('package.json');
+    if (!existsSync(packageJsonPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load PostCSS configuration.
+ *
+ * Checks for a postcss.config.js in the project root.
+ * If not found, uses the default configuration with global styles and mixins.
+ *
+ * @param config - Current build configuration (for path resolution)
+ * @returns PostCSS configuration object
+ *
+ * @internal
+ */
+function loadPostcssConfig(config) {
+    // Check for project postcss.config.js
+    const projectPostcssPath = fromProjectRoot('postcss.config.js');
+    if (existsSync(projectPostcssPath)) {
+        return { configPath: projectPostcssPath };
+    }
+    // Use default postcss config
+    return {
+        configPath: fromPackageRoot('config/postcss.config.js'),
+        globalStylesDir: resolve(process.cwd(), config.paths.globalStylesDir),
+        globalMixinsDir: resolve(process.cwd(), config.paths.globalMixinsDir),
+    };
+}
+/**
+ * Check if a configuration file exists in the project root.
+ *
+ * @param filename - Name of the configuration file to check
+ * @returns True if the file exists
+ *
+ * @example
+ * ```typescript
+ * if (hasConfigFile('postcss.config.js')) {
+ *   console.log('Using custom PostCSS configuration');
+ * }
+ * ```
+ */
+export function hasConfigFile(filename) {
+    return existsSync(fromProjectRoot(filename));
+}
+/**
+ * Get the output directory path.
+ *
+ * Returns the absolute path to the dist directory where
+ * compiled assets will be written.
+ *
+ * @param config - Build configuration
+ * @returns Absolute path to the output directory
+ *
+ * @example
+ * ```typescript
+ * const outputDir = getOutputDir(config);
+ * console.log(outputDir); // "/path/to/project/dist"
+ * ```
+ */
+export function getOutputDir(config) {
+    return fromProjectRoot(config.paths.distDir);
+}
+/**
+ * Check if the build is running in production mode.
+ *
+ * Production mode is determined by `NODE_ENV=production`.
+ * In production mode:
+ * - Output is minified
+ * - Source maps are disabled (unless explicitly enabled)
+ * - Console output is optimized
+ *
+ * @returns True if NODE_ENV is "production"
+ *
+ * @example
+ * ```typescript
+ * if (isProduction()) {
+ *   console.log('Building for production...');
+ * }
+ * ```
+ */
+export function isProduction() {
+    return process.env.NODE_ENV === 'production';
+}
+/**
+ * Check if the build is running in watch mode.
+ *
+ * Watch mode is detected from command-line arguments.
+ *
+ * @returns True if --watch flag is present or command is "start"
+ */
+export function isWatchMode() {
+    return process.argv.includes('--watch') || process.argv.includes('start');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 10up-build - esbuild-powered WordPress build tool
+ *
+ * @packageDocumentation
+ */
+export { build } from './build.js';
+export { watch } from './watch.js';
+export { cli } from './cli.js';
+export { loadConfig, defaultConfig, isProduction, isWatchMode } from './config.js';
+export type { BuildConfig, PathsConfig, FilenamesConfig, ExternalNamespaceConfig, PostCSSConfig, DetectedEntries, BuildResult, WatchOptions, BlockMetadata, DependencyInfo, } from './types.js';
+export { detectEntries, getBlockSpecificStyles } from './utils/entry-detection.js';
+export { resolveExternal, isWpScriptPackage, wpPackageToHandle, wpPackageToGlobal, vendorExternals, } from './utils/externals.js';
+export { fromProjectRoot, fromPackageRoot, hasProjectFile, fileExists, getContentHash, getFileContentHash, normalizePath, } from './utils/paths.js';
+export { wpDependencyExtractionPlugin } from './plugins/wp-dependency-extraction.js';
+export { sassPlugin } from './plugins/sass-plugin.js';
+export { transformBlockJson, processBlockJsonFiles } from './plugins/block-json.js';
+export { copyStaticAssets } from './plugins/copy-assets.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;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGnF,YAAY,EACX,WAAW,EACX,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,eAAe,EACf,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,eAAe,EACf,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,aAAa,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * 10up-build - esbuild-powered WordPress build tool
+ *
+ * @packageDocumentation
+ */
+// Main exports
+export { build } from './build.js';
+export { watch } from './watch.js';
+export { cli } from './cli.js';
+export { loadConfig, defaultConfig, isProduction, isWatchMode } from './config.js';
+// Utility exports
+export { detectEntries, getBlockSpecificStyles } from './utils/entry-detection.js';
+export { resolveExternal, isWpScriptPackage, wpPackageToHandle, wpPackageToGlobal, vendorExternals, } from './utils/externals.js';
+export { fromProjectRoot, fromPackageRoot, hasProjectFile, fileExists, getContentHash, getFileContentHash, normalizePath, } from './utils/paths.js';
+// Plugin exports
+export { wpDependencyExtractionPlugin } from './plugins/wp-dependency-extraction.js';
+export { sassPlugin } from './plugins/sass-plugin.js';
+export { transformBlockJson, processBlockJsonFiles } from './plugins/block-json.js';
+export { copyStaticAssets } from './plugins/copy-assets.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":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgBnF,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,eAAe,EACf,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,aAAa,GACb,MAAM,kBAAkB,CAAC;AAE1B,iBAAiB;AACjB,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/plugins/block-json.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Block JSON Plugin for esbuild
+ *
+ * Transforms and copies block.json files to the output directory.
+ * - Converts .ts/.tsx references to .js
+ * - Converts .scss/.sass references to .css
+ * - Adds version hash for cache busting
+ */
+import type { BuildConfig } from '../types.js';
+/**
+ * Transform block.json content
+ */
+export declare function transformBlockJson(content: string, absoluteFilename: string): string;
+/**
+ * Copy and transform all block.json files to output directory
+ */
+export declare function processBlockJsonFiles(config: BuildConfig, outputDir: string): Promise<void>;
+//# sourceMappingURL=block-json.d.ts.map

package/dist/plugins/block-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-json.d.ts","sourceRoot":"","sources":["../../src/plugins/block-json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAkG9D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAgDpF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCjG"}

package/dist/plugins/block-json.js

@@ -0,0 +1,172 @@
+/**
+ * Block JSON Plugin for esbuild
+ *
+ * Transforms and copies block.json files to the output directory.
+ * - Converts .ts/.tsx references to .js
+ * - Converts .scss/.sass references to .css
+ * - Adds version hash for cache busting
+ */
+import { readFileSync, writeFileSync, mkdirSync, copyFileSync, existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import fastGlob from 'fast-glob';
+const glob = fastGlob.sync;
+import { normalizePath, getFileContentHash } from '../utils/paths.js';
+/**
+ * Asset keys for standard JavaScript files (IIFE format)
+ */
+const JS_ASSET_KEYS = [
+    'script',
+    'editorScript',
+    'viewScript',
+];
+/**
+ * Asset keys for ES module files (.mjs)
+ */
+const MODULE_ASSET_KEYS = ['scriptModule', 'viewScriptModule'];
+/**
+ * Asset keys for CSS files
+ */
+const CSS_ASSET_KEYS = ['style', 'editorStyle', 'viewStyle'];
+/**
+ * Transform TypeScript asset paths to JavaScript (.js)
+ */
+function transformTSAsset(asset) {
+    const transform = (filePath) => {
+        if (!filePath.startsWith('file:')) {
+            return filePath;
+        }
+        return filePath.replace(/\.tsx?$/, '.js').replace(/\.js$/, '.js');
+    };
+    return Array.isArray(asset) ? asset.map(transform) : transform(asset);
+}
+/**
+ * Transform TypeScript/JS asset paths to ES modules (.mjs)
+ */
+function transformModuleAsset(asset) {
+    const transform = (filePath) => {
+        if (!filePath.startsWith('file:')) {
+            return filePath;
+        }
+        // Convert .ts/.tsx/.js to .mjs
+        return filePath.replace(/\.(tsx?|js)$/, '.mjs');
+    };
+    return Array.isArray(asset) ? asset.map(transform) : transform(asset);
+}
+/**
+ * Transform SASS/SCSS asset paths to CSS
+ */
+function transformSassAsset(asset) {
+    const transform = (filePath) => {
+        if (!filePath.startsWith('file:')) {
+            return filePath;
+        }
+        return filePath.replace(/\.s[ac]ss$/, '.css');
+    };
+    return Array.isArray(asset) ? asset.map(transform) : transform(asset);
+}
+/**
+ * Calculate version hash from style files
+ */
+function calculateStyleVersion(metadata, blockDir) {
+    const styleArrays = [];
+    if (metadata.style)
+        styleArrays.push(metadata.style);
+    if (metadata.viewStyle)
+        styleArrays.push(metadata.viewStyle);
+    let combinedHash = '';
+    for (const styleField of styleArrays) {
+        const styles = Array.isArray(styleField) ? styleField : [styleField];
+        for (const rawStylePath of styles) {
+            if (!rawStylePath.startsWith('file:')) {
+                continue;
+            }
+            const stylePath = rawStylePath.replace('file:', '');
+            const absoluteStylePath = join(blockDir, stylePath);
+            if (existsSync(absoluteStylePath)) {
+                combinedHash += getFileContentHash(absoluteStylePath);
+            }
+        }
+    }
+    return combinedHash ? combinedHash.slice(0, 8) : '';
+}
+/**
+ * Transform block.json content
+ */
+export function transformBlockJson(content, absoluteFilename) {
+    if (!content || content.trim() === '') {
+        return content;
+    }
+    try {
+        const metadata = JSON.parse(content);
+        const blockDir = dirname(absoluteFilename);
+        const newMetadata = { ...metadata };
+        // Add version hash if not present and has file: style references
+        if (!metadata.version) {
+            const versionHash = calculateStyleVersion(metadata, blockDir);
+            if (versionHash) {
+                newMetadata.version = versionHash;
+            }
+        }
+        // Transform standard JS asset paths
+        for (const key of JS_ASSET_KEYS) {
+            const asset = metadata[key];
+            if (asset) {
+                newMetadata[key] = transformTSAsset(asset);
+            }
+        }
+        // Transform ES module asset paths (.mjs)
+        for (const key of MODULE_ASSET_KEYS) {
+            const asset = metadata[key];
+            if (asset) {
+                newMetadata[key] = transformModuleAsset(asset);
+            }
+        }
+        // Transform CSS asset paths
+        for (const key of CSS_ASSET_KEYS) {
+            const asset = metadata[key];
+            if (asset) {
+                newMetadata[key] = transformSassAsset(asset);
+            }
+        }
+        return JSON.stringify(newMetadata, null, '\t');
+    }
+    catch {
+        // Return original content if parsing fails
+        return content;
+    }
+}
+/**
+ * Copy and transform all block.json files to output directory
+ */
+export async function processBlockJsonFiles(config, outputDir) {
+    const blocksDir = resolve(process.cwd(), config.paths.blocksDir);
+    if (!existsSync(blocksDir)) {
+        return;
+    }
+    // Find all block.json files
+    const blockJsonFiles = glob(normalizePath(`${blocksDir}/**/block.json`), {
+        absolute: true,
+    });
+    for (const blockJsonPath of blockJsonFiles) {
+        // Calculate relative path from blocks directory
+        const relativePath = blockJsonPath.replace(blocksDir, '').replace(/^[/\\]/, '');
+        const outputPath = join(outputDir, 'blocks', relativePath);
+        // Ensure output directory exists
+        mkdirSync(dirname(outputPath), { recursive: true });
+        // Read, transform, and write
+        const content = readFileSync(blockJsonPath, 'utf8');
+        const transformed = transformBlockJson(content, blockJsonPath);
+        writeFileSync(outputPath, transformed, 'utf8');
+    }
+    // Also copy any PHP files from blocks directory
+    const phpFiles = glob(normalizePath(`${blocksDir}/**/*.php`), {
+        absolute: true,
+    });
+    for (const phpPath of phpFiles) {
+        const relativePath = phpPath.replace(blocksDir, '').replace(/^[/\\]/, '');
+        const outputPath = join(outputDir, 'blocks', relativePath);
+        mkdirSync(dirname(outputPath), { recursive: true });
+        copyFileSync(phpPath, outputPath);
+    }
+}
+//# sourceMappingURL=block-json.js.map

package/dist/plugins/block-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-json.js","sourceRoot":"","sources":["../../src/plugins/block-json.ts"],"names":[],"mappings":"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"}

package/dist/plugins/copy-assets.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copy Assets Plugin
+ *
+ * Copies static assets (images, fonts, etc.) to the output directory.
+ */
+import type { BuildConfig } from '../types.js';
+/**
+ * Copy static assets to output directory
+ */
+export declare function copyStaticAssets(config: BuildConfig, outputDir: string): Promise<number>;
+/**
+ * Check if a file is a static asset
+ */
+export declare function isAssetFile(filePath: string): boolean;
+//# sourceMappingURL=copy-assets.d.ts.map

package/dist/plugins/copy-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-assets.d.ts","sourceRoot":"","sources":["../../src/plugins/copy-assets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAqB/C;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B9F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrD"}

package/dist/plugins/copy-assets.js

@@ -0,0 +1,62 @@
+/**
+ * Copy Assets Plugin
+ *
+ * Copies static assets (images, fonts, etc.) to the output directory.
+ */
+import { copyFileSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import fastGlob from 'fast-glob';
+const glob = fastGlob.sync;
+import { normalizePath } from '../utils/paths.js';
+/**
+ * Asset file extensions to copy
+ */
+const ASSET_EXTENSIONS = [
+    'jpg',
+    'jpeg',
+    'png',
+    'gif',
+    'webp',
+    'avif',
+    'ico',
+    'svg',
+    'eot',
+    'ttf',
+    'woff',
+    'woff2',
+    'otf',
+];
+/**
+ * Copy static assets to output directory
+ */
+export async function copyStaticAssets(config, outputDir) {
+    const assetsDir = resolve(process.cwd(), config.paths.copyAssetsDir);
+    if (!existsSync(assetsDir)) {
+        return 0;
+    }
+    const pattern = `**/*.{${ASSET_EXTENSIONS.join(',')}}`;
+    const assetFiles = glob(normalizePath(`${assetsDir}/${pattern}`), {
+        absolute: true,
+        ignore: ['**/node_modules/**'],
+    });
+    let copiedCount = 0;
+    for (const assetPath of assetFiles) {
+        // Calculate relative path from assets directory
+        const relativePath = assetPath.replace(assetsDir, '').replace(/^[/\\]/, '');
+        const outputPath = join(outputDir, relativePath);
+        // Ensure output directory exists
+        mkdirSync(dirname(outputPath), { recursive: true });
+        // Copy file
+        copyFileSync(assetPath, outputPath);
+        copiedCount++;
+    }
+    return copiedCount;
+}
+/**
+ * Check if a file is a static asset
+ */
+export function isAssetFile(filePath) {
+    const ext = filePath.split('.').pop()?.toLowerCase();
+    return ext ? ASSET_EXTENSIONS.includes(ext) : false;
+}
+//# sourceMappingURL=copy-assets.js.map

package/dist/plugins/copy-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-assets.js","sourceRoot":"","sources":["../../src/plugins/copy-assets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;GAEG;AACH,MAAM,gBAAgB,GAAG;IACxB,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,OAAO;IACP,KAAK;CACL,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAmB,EAAE,SAAiB;IAC5E,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAErE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC;IACV,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC,EAAE;QACjE,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC,oBAAoB,CAAC;KAC9B,CAAC,CAAC;IAEH,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,gDAAgD;QAChD,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC5E,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAEjD,iCAAiC;QACjC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,YAAY;QACZ,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACpC,WAAW,EAAE,CAAC;IACf,CAAC;IAED,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IACrD,OAAO,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACrD,CAAC"}

package/dist/plugins/sass-plugin.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SASS/SCSS Plugin for esbuild
+ *
+ * Compiles SCSS files using the sass package,
+ * then processes with PostCSS and lightningcss.
+ */
+import type { Plugin } from 'esbuild';
+import type { BuildConfig } from '../types.js';
+/**
+ * Create the SASS plugin for esbuild
+ */
+export declare function sassPlugin(config: BuildConfig, isProduction: boolean): Plugin;
+/**
+ * Get file extension
+ */
+export declare function isStyleFile(filePath: string): boolean;
+//# sourceMappingURL=sass-plugin.d.ts.map

package/dist/plugins/sass-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sass-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/sass-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,OAAO,KAAK,EAAE,MAAM,EAA4B,MAAM,SAAS,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAY/C;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CA2E7E;AAqED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrD"}