@wasm-fmt/malva_fmt 0.1.17 → 0.2.0

package/README.md

@@ -1,65 +1,71 @@
-# malva_fmt
+[![Test](https://github.com/wasm-fmt/web_fmt/actions/workflows/test.yml/badge.svg)](https://github.com/wasm-fmt/web_fmt/actions/workflows/test.yml)
 
-CSS/SCSS/SASS/LESS formatter powered by WASM ported from [malva](https://github.com/g-plane/malva).
+# Install
 
-## Usage
+[![npm](https://img.shields.io/npm/v/@wasm-fmt/malva_fmt)](https://www.npmjs.com/package/@wasm-fmt/malva_fmt)
 
-### Node.js
-
-```js
-import init from "malva_fmt";
+```bash
+npm install @wasm-fmt/malva_fmt
+```
 
-const { format } = await init();
+[![jsr.io](https://jsr.io/badges/@fmt/malva-fmt)](https://jsr.io/@fmt/malva-fmt)
 
-const result = format(
-	".foo {\n  color: red;\n}",
-	"style.css",
-	{
-		indentStyle: "space",
-		indentWidth: 2,
-		lineWidth: 80,
-		lineEnding: "lf",
-	}
-);
+```bash
+npx jsr add @fmt/malva-fmt
 ```
 
-### Vite
+# Usage
+
+## Node.js / Deno / Bun / Bundler
 
-Add `"@wasm-fmt/malva-fmt"` to `optimizeDeps.exclude` in your vite config:
+```javascript
+import { format } from "@wasm-fmt/malva_fmt";
 
-```JSON
-{
-    "optimizeDeps": {
-        "exclude": ["@wasm-fmt/malva-fmt"]
-    }
-}
+const input = `.foo { color: red; }`;
+
+const formatted = format(input, "style.css");
+console.log(formatted);
 ```
 
-<details>
-<summary>
-If you cannot change the vite config, you can use another import entry
+## Web
+
+For web environments, you need to initialize WASM module manually:
 
-</summary>
+```javascript
+import init, { format } from "@wasm-fmt/malva_fmt/web";
 
-```js
-import init from "@wasm-fmt/malva-fmt/vite";
+await init();
 
-const { format } = await init();
+const input = `.foo { color: red; }`;
 
-const result = format(
-	".foo {\n  color: red;\n}",
-	"style.css",
-	{
-		indentStyle: "space",
-		indentWidth: 2,
-		lineWidth: 80,
-		lineEnding: "lf",
-	}
-);
+const formatted = format(input, "style.css");
+console.log(formatted);
 ```
 
-</details>
+### Vite
 
-## Configuration
+```JavaScript
+import init, { format } from "@wasm-fmt/malva_fmt/vite";
+
+await init();
+// ...
+```
+
+## Entry Points
+
+- `.` - Auto-detects environment (Node.js uses node, Webpack uses bundler, default is ESM)
+- `./node` - Node.js environment (no init required)
+- `./esm` - ESM environments like Deno (no init required)
+- `./bundler` - Bundlers like Webpack (no init required)
+- `./web` - Web browsers (requires manual init)
+- `./vite` - Vite bundler (requires manual init)
+
+# Configuration
 
 See [malva configuration docs](https://github.com/g-plane/malva/blob/main/docs/config.md) for all available options.
+
+# Credits
+
+Thanks to:
+
+- The [malva](https://github.com/g-plane/malva) project

package/layout_config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Layout configuration options shared across all formatters.
+ */
+export interface LayoutConfig {
+	/** Indentation style. Defaults to "space". */
+	indentStyle?: "tab" | "space";
+
+	/** Number of spaces per indentation level. Defaults to 2. */
+	indentWidth?: number;
+
+	/** Maximum line width before wrapping. Defaults to 80. */
+	lineWidth?: number;
+
+	/** Line ending style. Defaults to "lf". */
+	lineEnding?: "lf" | "crlf";
+}

package/malva_fmt.d.ts

@@ -1,54 +1,26 @@
+/**
+ * WASM formatter for CSS/SCSS/SASS/LESS using malva.
+ *
+ * @example
+ * ```ts
+ * import { format } from "@wasm-fmt/malva_fmt";
+ *
+ * const input = ".class { color: red; }";
+ * const output = format(input, "style.css");
+ * ```
+ *
+ * @module
+ */
+
+import type { Config } from "./options.d.ts";
+
 /* tslint:disable */
 /* eslint-disable */
 
-export interface Config extends LayoutConfig {
-	/**
-	 *  See {@link https://github.com/g-plane/malva/blob/main/docs/config.md}
-	 */
-	[other: string]: any;
-}
-
-
-interface LayoutConfig {
-	indentStyle?: "tab" | "space";
-	indentWidth?: number;
-	lineWidth?: number;
-	lineEnding?: "lf" | "crlf";
-}
-
-
-export function format(src: string, filename: string, config?: Config | null): string;
-
-export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
-
-export interface InitOutput {
-  readonly memory: WebAssembly.Memory;
-  readonly format: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-  readonly __wbindgen_export: (a: number, b: number) => number;
-  readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
-  readonly __wbindgen_export3: (a: number) => void;
-  readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
-  readonly __wbindgen_export4: (a: number, b: number, c: number) => void;
-}
-
-export type SyncInitInput = BufferSource | WebAssembly.Module;
-
 /**
-* Instantiates the given `module`, which can either be bytes or
-* a precompiled `WebAssembly.Module`.
-*
-* @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
-*
-* @returns {InitOutput}
-*/
-export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
-
-/**
-* If `module_or_path` is {RequestInfo} or {URL}, makes a request and
-* for everything else, calls `WebAssembly.instantiate` directly.
-*
-* @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
-*
-* @returns {Promise<InitOutput>}
-*/
-export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;
+ * Formats the given CSS/SCSS/Sass/Less code with the provided Configuration.
+ * @param src - The CSS/SCSS/Sass/Less code to format
+ * @param filename - The filename to determine the syntax (e.g., .css, .scss, .sass, .less)
+ * @param config - Optional formatter config
+ */
+export function format(src: string, filename: string, config?: Config | null): string;