@crustkit/minify 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 crustkit
+
+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,92 @@
+# @crustkit/minify
+
+JS and CSS minification. Zero config, great defaults, typed to the bone.
+
+Built on [oxc](https://oxc.rs) (JS) and [Lightning CSS](https://lightningcss.dev) (CSS). Rust under the hood, npm on the surface.
+
+## Install
+
+```bash
+npm install @crustkit/minify
+```
+
+## Usage
+
+```ts
+import { minifyJs, minifyCss, minify } from '@crustkit/minify'
+
+// JS -- zero config
+const { code } = minifyJs('var x = 1 + 2; console.log(x)')
+// => 'console.log(3);'
+
+// CSS -- zero config
+const { code } = minifyCss('.foo { color: red; margin: 0px; }')
+// => '.foo{color:red;margin:0}'
+
+// Auto-detect from filename
+const result = minify(code, { filename: 'app.js' })
+const result = minify(code, { filename: 'style.css' })
+```
+
+### Source maps
+
+When you pass `sourceMap: true`, the return type narrows. TypeScript knows `map` is a `string`, not `string | null`.
+
+```ts
+const { code, map } = minifyJs(src, { sourceMap: true, filename: 'app.js' })
+//                                     ^-- map: string (guaranteed)
+```
+
+### JS options
+
+```ts
+minifyJs(code, {
+  mangle: true,       // shorten variable names (default: true)
+  compress: true,     // dead code elimination (default: true)
+  sourceMap: false,    // generate source map (default: false)
+  filename: 'app.js', // for source maps and error messages
+  module: true,        // treat as ES module
+})
+```
+
+### CSS options
+
+CSS functions only accept CSS options. Passing `mangle` or `compress` is a type error.
+
+```ts
+minifyCss(code, {
+  sourceMap: false,
+  filename: 'style.css',
+})
+
+minifyCss(code, { mangle: true })
+//                ^^^^^^ -- type error
+```
+
+### Terser drop-in
+
+Change one import. Everything else stays the same.
+
+```ts
+// before
+import { minify } from 'terser'
+
+// after
+import { terser as minify } from '@crustkit/minify'
+
+const result = await minify(code, {
+  compress: { drop_console: true },
+  mangle: true,
+})
+```
+
+Returns a Promise for API compatibility with terser. The work is synchronous in Rust.
+
+## What it does
+
+- **JS**: Parses with oxc, compresses (constant folding, dead code elimination, inlining), mangles variable names, generates source maps. Handles ES modules, CommonJS, JSX, TypeScript.
+- **CSS**: Parses with Lightning CSS, minifies whitespace, shortens values (`0px` to `0`), handles vendor prefixing, nesting, and modern CSS syntax.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,157 @@
+interface JsOptions {
+    /** Shorten variable names. @default true */
+    mangle?: boolean;
+    /** Dead code elimination & constant folding. @default true */
+    compress?: boolean;
+    /** Generate a source map. @default false */
+    sourceMap?: boolean;
+    /** Filename — used for source maps and error messages. */
+    filename?: string;
+    /**
+     * Treat as ES module.
+     * @default auto-detected from filename extension (.mjs = module)
+     */
+    module?: boolean;
+}
+interface CssOptions {
+    /** Generate a source map. @default false */
+    sourceMap?: boolean;
+    /** Filename — used for source maps and error messages. */
+    filename?: string;
+}
+interface MinifyResult {
+    /** The minified code. */
+    code: string;
+    /** Source map JSON string. Only present when `sourceMap: true`. */
+    map: string | null;
+}
+interface MinifyResultWithMap {
+    code: string;
+    /** Source map JSON string. Guaranteed present. */
+    map: string;
+}
+interface MinifyResultWithoutMap {
+    code: string;
+    map: null;
+}
+/**
+ * Minify JavaScript or TypeScript.
+ *
+ * @example
+ * ```ts
+ * import { minifyJs } from '@crustkit/minify'
+ *
+ * // Zero config
+ * const { code } = minifyJs('var x = 1 + 2; console.log(x)')
+ *
+ * // With source map — `map` is guaranteed string
+ * const { code, map } = minifyJs(src, { sourceMap: true, filename: 'app.js' })
+ *
+ * // Disable mangling
+ * const { code } = minifyJs(src, { mangle: false })
+ * ```
+ */
+declare function minifyJs(code: string, options: JsOptions & {
+    sourceMap: true;
+}): MinifyResultWithMap;
+declare function minifyJs(code: string, options?: JsOptions): MinifyResult;
+/**
+ * Minify CSS. Handles vendor prefixing, nesting, and modern syntax automatically.
+ *
+ * @example
+ * ```ts
+ * import { minifyCss } from '@crustkit/minify'
+ *
+ * const { code } = minifyCss('.foo { color: red; margin: 0px; }')
+ * // '.foo{color:red;margin:0}'
+ *
+ * const { code, map } = minifyCss(src, { sourceMap: true })
+ * ```
+ */
+declare function minifyCss(code: string, options: CssOptions & {
+    sourceMap: true;
+}): MinifyResultWithMap;
+declare function minifyCss(code: string, options?: CssOptions): MinifyResult;
+type MinifyOptions = (JsOptions & {
+    language?: 'js';
+}) | (CssOptions & {
+    language: 'css';
+});
+/**
+ * Minify code. Auto-detects language from `filename`, or set `language` explicitly.
+ *
+ * @example
+ * ```ts
+ * import { minify } from '@crustkit/minify'
+ *
+ * // Auto-detect from filename
+ * minify('var x = 1', { filename: 'app.js' })
+ * minify('.foo { color: red }', { filename: 'style.css' })
+ *
+ * // Explicit language
+ * minify(code, { language: 'js' })
+ * minify(code, { language: 'css' })
+ *
+ * // Default: JS
+ * minify('var x = 1 + 2; console.log(x)')
+ * ```
+ */
+declare function minify(code: string, options?: MinifyOptions): MinifyResult;
+interface TerserCompressOptions {
+    /** Number of compression passes. @default 1 */
+    passes?: number;
+    /** Remove `debugger` statements. @default true */
+    drop_debugger?: boolean;
+    /** Remove `console.*` calls. @default false */
+    drop_console?: boolean;
+    /** Remove unreachable code. @default true */
+    dead_code?: boolean;
+    /** Join consecutive var/let/const statements. @default true */
+    join_vars?: boolean;
+    /** Allow other compress options terser accepts. */
+    [key: string]: unknown;
+}
+interface TerserMangleOptions {
+    /** Mangle top-level names. @default false */
+    toplevel?: boolean;
+    /** Names to keep unmangled. */
+    reserved?: string[];
+    /** Allow other mangle options terser accepts. */
+    [key: string]: unknown;
+}
+interface TerserSourceMapOptions {
+    /** Source map URL to embed in the output. */
+    url?: string;
+    /** Original filename for source map. */
+    filename?: string;
+}
+interface TerserOptions {
+    compress?: boolean | TerserCompressOptions;
+    mangle?: boolean | TerserMangleOptions;
+    sourceMap?: boolean | TerserSourceMapOptions;
+    module?: boolean;
+    toplevel?: boolean;
+}
+interface TerserResult {
+    code: string;
+    map?: string;
+}
+/**
+ * Terser-compatible drop-in replacement.
+ *
+ * @example
+ * ```ts
+ * // Before:
+ * import { minify } from 'terser'
+ *
+ * // After — just change the import:
+ * import { terser as minify } from '@crustkit/minify'
+ *
+ * const result = await minify(code, { compress: true, mangle: true })
+ * ```
+ *
+ * Returns a Promise for API compatibility. The work is synchronous in Rust.
+ */
+declare function terser(code: string | Record<string, string>, options?: TerserOptions): Promise<TerserResult>;
+
+export { type CssOptions, type JsOptions, type MinifyOptions, type MinifyResult, type MinifyResultWithMap, type MinifyResultWithoutMap, type TerserCompressOptions, type TerserMangleOptions, type TerserOptions, type TerserResult, type TerserSourceMapOptions, minify, minifyCss, minifyJs, terser };

package/dist/index.d.ts

@@ -0,0 +1,157 @@
+interface JsOptions {
+    /** Shorten variable names. @default true */
+    mangle?: boolean;
+    /** Dead code elimination & constant folding. @default true */
+    compress?: boolean;
+    /** Generate a source map. @default false */
+    sourceMap?: boolean;
+    /** Filename — used for source maps and error messages. */
+    filename?: string;
+    /**
+     * Treat as ES module.
+     * @default auto-detected from filename extension (.mjs = module)
+     */
+    module?: boolean;
+}
+interface CssOptions {
+    /** Generate a source map. @default false */
+    sourceMap?: boolean;
+    /** Filename — used for source maps and error messages. */
+    filename?: string;
+}
+interface MinifyResult {
+    /** The minified code. */
+    code: string;
+    /** Source map JSON string. Only present when `sourceMap: true`. */
+    map: string | null;
+}
+interface MinifyResultWithMap {
+    code: string;
+    /** Source map JSON string. Guaranteed present. */
+    map: string;
+}
+interface MinifyResultWithoutMap {
+    code: string;
+    map: null;
+}
+/**
+ * Minify JavaScript or TypeScript.
+ *
+ * @example
+ * ```ts
+ * import { minifyJs } from '@crustkit/minify'
+ *
+ * // Zero config
+ * const { code } = minifyJs('var x = 1 + 2; console.log(x)')
+ *
+ * // With source map — `map` is guaranteed string
+ * const { code, map } = minifyJs(src, { sourceMap: true, filename: 'app.js' })
+ *
+ * // Disable mangling
+ * const { code } = minifyJs(src, { mangle: false })
+ * ```
+ */
+declare function minifyJs(code: string, options: JsOptions & {
+    sourceMap: true;
+}): MinifyResultWithMap;
+declare function minifyJs(code: string, options?: JsOptions): MinifyResult;
+/**
+ * Minify CSS. Handles vendor prefixing, nesting, and modern syntax automatically.
+ *
+ * @example
+ * ```ts
+ * import { minifyCss } from '@crustkit/minify'
+ *
+ * const { code } = minifyCss('.foo { color: red; margin: 0px; }')
+ * // '.foo{color:red;margin:0}'
+ *
+ * const { code, map } = minifyCss(src, { sourceMap: true })
+ * ```
+ */
+declare function minifyCss(code: string, options: CssOptions & {
+    sourceMap: true;
+}): MinifyResultWithMap;
+declare function minifyCss(code: string, options?: CssOptions): MinifyResult;
+type MinifyOptions = (JsOptions & {
+    language?: 'js';
+}) | (CssOptions & {
+    language: 'css';
+});
+/**
+ * Minify code. Auto-detects language from `filename`, or set `language` explicitly.
+ *
+ * @example
+ * ```ts
+ * import { minify } from '@crustkit/minify'
+ *
+ * // Auto-detect from filename
+ * minify('var x = 1', { filename: 'app.js' })
+ * minify('.foo { color: red }', { filename: 'style.css' })
+ *
+ * // Explicit language
+ * minify(code, { language: 'js' })
+ * minify(code, { language: 'css' })
+ *
+ * // Default: JS
+ * minify('var x = 1 + 2; console.log(x)')
+ * ```
+ */
+declare function minify(code: string, options?: MinifyOptions): MinifyResult;
+interface TerserCompressOptions {
+    /** Number of compression passes. @default 1 */
+    passes?: number;
+    /** Remove `debugger` statements. @default true */
+    drop_debugger?: boolean;
+    /** Remove `console.*` calls. @default false */
+    drop_console?: boolean;
+    /** Remove unreachable code. @default true */
+    dead_code?: boolean;
+    /** Join consecutive var/let/const statements. @default true */
+    join_vars?: boolean;
+    /** Allow other compress options terser accepts. */
+    [key: string]: unknown;
+}
+interface TerserMangleOptions {
+    /** Mangle top-level names. @default false */
+    toplevel?: boolean;
+    /** Names to keep unmangled. */
+    reserved?: string[];
+    /** Allow other mangle options terser accepts. */
+    [key: string]: unknown;
+}
+interface TerserSourceMapOptions {
+    /** Source map URL to embed in the output. */
+    url?: string;
+    /** Original filename for source map. */
+    filename?: string;
+}
+interface TerserOptions {
+    compress?: boolean | TerserCompressOptions;
+    mangle?: boolean | TerserMangleOptions;
+    sourceMap?: boolean | TerserSourceMapOptions;
+    module?: boolean;
+    toplevel?: boolean;
+}
+interface TerserResult {
+    code: string;
+    map?: string;
+}
+/**
+ * Terser-compatible drop-in replacement.
+ *
+ * @example
+ * ```ts
+ * // Before:
+ * import { minify } from 'terser'
+ *
+ * // After — just change the import:
+ * import { terser as minify } from '@crustkit/minify'
+ *
+ * const result = await minify(code, { compress: true, mangle: true })
+ * ```
+ *
+ * Returns a Promise for API compatibility. The work is synchronous in Rust.
+ */
+declare function terser(code: string | Record<string, string>, options?: TerserOptions): Promise<TerserResult>;
+
+export { type CssOptions, type JsOptions, type MinifyOptions, type MinifyResult, type MinifyResultWithMap, type MinifyResultWithoutMap, type TerserCompressOptions, type TerserMangleOptions, type TerserOptions, type TerserResult, type TerserSourceMapOptions, minify, minifyCss, minifyJs, terser };