@zayne-labs/prettier-config 0.11.7 → 0.11.9

package/README.md

@@ -1,6 +1,14 @@
 # @zayne-labs/prettier-config
 
-Shared Prettier configuration for Zayne Labs projects.
+Shared Prettier configuration for Zayne Labs projects, featuring a modular factory system with automatic plugin detection and refined sorting logic.
+
+## Features
+
+- **Modular Factory**: Easily toggle features like Tailwind, Astro, and Import Sorting.
+- **Smart Import Sorting**: Distance-based sorting (URLs → Protocols → Packages → Aliases → Paths).
+- **Tailwind CSS v4 Ready**: Support for `tailwindStylesheet` and advanced class sorting.
+- **Auto-Installation**: Prompts to install missing plugins when needed.
+- **Deduplicated Configs**: Merges arrays (plugins, overrides) intelligently without duplicates.
 
 ## Installation
 
@@ -10,91 +18,84 @@ pnpm add -D @zayne-labs/prettier-config
 
 ## Usage
 
-The package exports three configurations:
-
-### Base Config
-
-Basic Prettier configuration without any plugins.
-
-```js
-import { baseConfig } from "@zayne-labs/prettier-config";
+The package exports a factory function `zayne` that combines disparate config segments.
 
-export default baseConfig;
-```
+```ts
+// prettier.config.js
+import { zayne } from "@zayne-labs/prettier-config";
 
-**Configuration in `baseConfig`:**
-
-```js
-export default {
-	experimentalOperatorPosition: "start",
-	experimentalTernaries: true,
-	jsxSingleQuote: false,
-	printWidth: 107,
-	singleQuote: false,
-	tabWidth: 3,
-	trailingComma: "es5",
-	useTabs: true,
-};
+export default zayne({
+	base: true, // Enabled by default
+	sortImports: true, // Enabled by default
+	tailwindcss: true,
+	astro: true,
+	// ...more to come
+});
 ```
 
-### Tailwind Config
-
-Extended base configuration with Tailwind CSS support. Includes plugins for class sorting, merging, and formatting.
+### Options
 
-```js
-import { configWithTailwind } from "@zayne-labs/prettier-config";
+The `zayne` factory accepts an options object as the first argument:
 
-export default configWithTailwind;
-```
+| Option        | Type                            | Default | Description                                    |
+| ------------- | ------------------------------- | ------- | ---------------------------------------------- |
+| `base`        | `boolean \| Config`             | `true`  | Opinionated base defaults.                     |
+| `sortImports` | `boolean \| OptionsSortImports` | `true`  | Enables `@ianvs/prettier-plugin-sort-imports`. |
+| `tailwindcss` | `boolean \| OptionsTailwindCss` | `false` | Enables Tailwind and ClassNames plugins.       |
+| `astro`       | `boolean \| OptionsAstro`       | `false` | Enables `prettier-plugin-astro`.               |
 
-**Plugins included:**
+### Default Import Sorting Rules
 
-- `prettier-plugin-tailwindcss` - Sorts Tailwind classes
-- `prettier-plugin-classnames` - Formats className strings
-- `prettier-plugin-merge` - Merges plugin functionality
+When `sortImports` is enabled (which it is by default), imports are organized by "distance" from the current file:
 
-**Default settings:**
+1. **User patterns**: Any custom patterns you pass via `importOrder` are prioritized at the top.
+2. **URLs**: Remote modules (e.g., `https://esm.sh/...`).
+3. **Protocols**: Built-ins and protocol imports (`node:`, `bun:`, `jsr:`, `npm:`).
+4. **Packages**: Third-party modules (e.g., `react`, `lodash`).
+5. **Aliases**: Local aliases like `@/`, `#`, `~`, `$`, `%`.
+6. **Paths**: Relative and absolute file paths (excluding CSS).
+7. **CSS**: Style files are always pushed to the absolute bottom.
 
-- Custom attributes: `classNames`, `classes`
-- Custom functions: `cnMerge`, `cnJoin`, `cn`, `tv`, `tw`
-- Tailwind stylesheet: `./tailwind.css`
+### Tailwind & ClassNames Support
 
-**Note:** You'll need to install the plugins separately:
+The Tailwind integration combines three plugins:
 
-```bash
-pnpm add -D prettier-plugin-tailwindcss prettier-plugin-classnames prettier-plugin-merge
-```
+- `prettier-plugin-tailwindcss`: Sorts classes.
+- `prettier-plugin-classnames`: Multi-line formatting & attribute support.
+- `prettier-plugin-merge`: Ensures plugins work together.
 
-### Astro Config
+**Configurable Options:**
 
-Extended base configuration with Astro support.
-
-```js
-import { configWithAstro } from "@zayne-labs/prettier-config";
-
-export default configWithAstro;
-```
-
-**Note:** You'll need to install the plugin separately:
-
-```bash
-pnpm add -D prettier-plugin-astro
-```
+- `customAttributes`: Additional attributes to sort classes in (e.g., `classNames`, `classes`).
+- `customFunctions`: Functions to sort classes in (e.g., `cn`, `tv`, `tw`).
+- `tailwindStylesheet`: Path to your CSS entry point (defaults to `./tailwind.css` for v4).
+- `endPosition`: Criterion for ending class names (`absolute` or `relative`).
+- `syntaxTransformation`: Auto-transform non-expression classes to expression syntax on wrap.
 
 ## Extending Configurations
 
-You can extend any configuration with your own options:
+The factory accepts any number of extra configuration objects as subsequent arguments:
+
+```ts
+import { zayne } from "@zayne-labs/prettier-config";
+
+export default zayne(
+	{
+		tailwindcss: true,
+	},
+	// Extra config objects to merge
+	{
+		printWidth: 120,
+		semi: true,
+	}
+);
+```
 
-```js
-import { baseConfig } from "@zayne-labs/prettier-config";
+## Plugin Auto-Installation
 
-export default {
-	...baseConfig,
-	printWidth: 120,
-	semi: true,
-};
-```
+This config won't bloat your `node_modules` with plugins you don't use. When you enable a feature (like `astro` or `tailwindcss` for instance), it checks if the required plugins are installed.
+If missing, it will prompt you in the terminal to auto-install them when you run `prettier --write .` cli command.
 
 ## License
 
-MIT © Zayne Labs
+MIT © [Zayne Labs](https://github.com/zayne-labs)

package/dist/constants/defaults.d.ts

@@ -0,0 +1,17 @@
+//#region src/constants/defaults.d.ts
+declare const getDefaultTailwindSettings: () => {
+  tailwindAttributes: ["classNames", "classes"];
+  tailwindFunctions: ["cnMerge", "cnJoin", "cn", "tv", "tw"];
+  tailwindStylesheet: "./tailwind.css";
+} & {
+  $inferUnion: "tailwindAttributes" | "tailwindFunctions" | "tailwindStylesheet";
+};
+declare const getDefaultImportSortingOrder: () => {
+  css: ".css$";
+  main: ["^https?://", "<BUILTIN_MODULES>", "^(bun|jsr|npm):", "<THIRD_PARTY_MODULES>", "^(@/|[#~$%])", "^(?!.*[.]css$)[./].*$"];
+} & {
+  $inferUnion: "css" | "main";
+};
+//#endregion
+export { getDefaultImportSortingOrder, getDefaultTailwindSettings };
+//# sourceMappingURL=defaults.d.ts.map

package/dist/constants/defaults.js

@@ -0,0 +1,3 @@
+import { n as getDefaultTailwindSettings, t as getDefaultImportSortingOrder } from "../defaults-DCbiIW5Q.js";
+
+export { getDefaultImportSortingOrder, getDefaultTailwindSettings };

package/dist/defaults-DCbiIW5Q.js

@@ -0,0 +1,33 @@
+import { defineEnumDeep } from "@zayne-labs/toolkit-type-helpers";
+
+//#region src/constants/defaults.ts
+const getDefaultTailwindSettings = () => {
+	return defineEnumDeep({
+		tailwindAttributes: ["classNames", "classes"],
+		tailwindFunctions: [
+			"cnMerge",
+			"cnJoin",
+			"cn",
+			"tv",
+			"tw"
+		],
+		tailwindStylesheet: "./tailwind.css"
+	});
+};
+const getDefaultImportSortingOrder = () => {
+	return defineEnumDeep({
+		css: ".css$",
+		main: [
+			"^https?://",
+			"<BUILTIN_MODULES>",
+			"^(bun|jsr|npm):",
+			"<THIRD_PARTY_MODULES>",
+			"^(@/|[#~$%])",
+			"^(?!.*[.]css$)[./].*$"
+		]
+	});
+};
+
+//#endregion
+export { getDefaultTailwindSettings as n, getDefaultImportSortingOrder as t };
+//# sourceMappingURL=defaults-DCbiIW5Q.js.map

package/dist/defaults-DCbiIW5Q.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults-DCbiIW5Q.js","names":[],"sources":["../src/constants/defaults.ts"],"sourcesContent":["import { defineEnumDeep } from \"@zayne-labs/toolkit-type-helpers\";\n\nexport const getDefaultTailwindSettings = () => {\n\treturn defineEnumDeep({\n\t\ttailwindAttributes: [\"classNames\", \"classes\"],\n\t\ttailwindFunctions: [\"cnMerge\", \"cnJoin\", \"cn\", \"tv\", \"tw\"],\n\t\ttailwindStylesheet: \"./tailwind.css\",\n\t});\n};\n\nexport const getDefaultImportSortingOrder = () => {\n\treturn defineEnumDeep({\n\t\t// CSS files (always last)\n\t\tcss: \".css$\",\n\n\t\tmain: [\n\t\t\t// URLs (e.g., https://example.org)\n\t\t\t\"^https?://\",\n\t\t\t// Protocol imports (node:, bun:, jsr:, npm:, etc.)\n\t\t\t\"<BUILTIN_MODULES>\",\n\t\t\t\"^(bun|jsr|npm):\",\n\t\t\t// Third-party packages\n\t\t\t\"<THIRD_PARTY_MODULES>\",\n\t\t\t// Aliases (@/, #, ~, $, %)\n\t\t\t\"^(@/|[#~$%])\",\n\t\t\t// Relative and absolute paths (excluding CSS)\n\t\t\t\"^(?!.*[.]css$)[./].*$\",\n\t\t],\n\t});\n};\n"],"mappings":";;;AAEA,MAAa,mCAAmC;AAC/C,QAAO,eAAe;EACrB,oBAAoB,CAAC,cAAc,UAAU;EAC7C,mBAAmB;GAAC;GAAW;GAAU;GAAM;GAAM;GAAK;EAC1D,oBAAoB;EACpB,CAAC;;AAGH,MAAa,qCAAqC;AACjD,QAAO,eAAe;EAErB,KAAK;EAEL,MAAM;GAEL;GAEA;GACA;GAEA;GAEA;GAEA;GACA;EACD,CAAC"}

package/dist/index.d.ts

@@ -1,171 +1,13 @@
-import { AnyString } from "@zayne-labs/toolkit-type-helpers";
-import { Config, Plugin } from "prettier";
+import { a as OptionsTailwindCss, i as OptionsSortImports, n as OptionsAstro, o as ResolvedPrettierConfig, r as OptionsPrettierConfig, t as ExtractOptions } from "./types-B17hDweL.js";
 
-//#region src/types.d.ts
-type RestOfAllowedPluginTypes = AnyString | Plugin | URL;
-type OptionsClassNames = {
-  /**
-   * List of additional attributes that enclose class names.
-   * The `class` and `className` attributes are always supported.
-   * @docs [prettier-plugin-classnames#custom-attributes](https://github.com/ony3000/prettier-plugin-classnames#custom-attributes)
-   */
-  customAttributes?: string[];
-  /**
-   * List of additional functions that enclose class names.
-   * The `classNames` function is always supported.
-   * @docs [prettier-plugin-classnames#custom-functions](https://github.com/ony3000/prettier-plugin-classnames#custom-functions)
-   */
-  customFunctions?: string[];
-  /**
-   * Criterion for ending the class name on each line when replacing with multi-line.
-   * @default "absolute"
-   * @docs [prettier-plugin-classnames#ending-position](https://github.com/ony3000/prettier-plugin-classnames#ending-position)
-   */
-  endPosition?: "absolute" | "relative";
-  /**
-   * Transforms non-expression class names into expression syntax if line wrapping occurs.
-   * Note: This transformation does not support reversible formatting.
-   * @default false
-   * @docs [prettier-plugin-classnames#syntax-transformation](https://github.com/ony3000/prettier-plugin-classnames#syntax-transformation)
-   */
-  syntaxTransformation?: boolean;
-};
-type OptionsTailwindCss = OptionsClassNames & {
-  plugins?: Array<"prettier-plugin-tailwindcss" | "prettier-plugin-classnames" | "prettier-plugin-merge" | RestOfAllowedPluginTypes>;
-  /**
-   * List of attributes to sort classes in. Supports regex patterns.
-   * @docs [prettier-plugin-tailwindcss#sorting-non-standard-attributes](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#sorting-non-standard-attributes)
-   */
-  tailwindAttributes?: string[];
-  /**
-   * Path to the Tailwind configuration file (v3).
-   * @docs [prettier-plugin-tailwindcss#specifying-your-tailwind-javascript-config-path-tailwind-css-v3](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#specifying-your-tailwind-javascript-config-path-tailwind-css-v3)
-   */
-  tailwindConfig?: `./${string}`;
-  /**
-   * List of functions or tagged templates to sort classes in. Supports regex patterns.
-   * @docs [prettier-plugin-tailwindcss#sorting-classes-in-function-calls](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#sorting-classes-in-function-calls)
-   */
-  tailwindFunctions?: string[];
-  /**
-   * Prevent automatic removal of duplicate classes.
-   * @docs [prettier-plugin-tailwindcss#preserving-duplicate-classes](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#preserving-duplicate-classes)
-   */
-  tailwindPreserveDuplicates?: boolean;
-  /**
-   * Prevent automatic removal of unnecessary whitespace.
-   * @docs [prettier-plugin-tailwindcss#preserving-whitespace](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#preserving-whitespace)
-   */
-  tailwindPreserveWhitespace?: boolean;
-  /**
-   * Path to the CSS entry point (Tailwind CSS v4+).
-   * @default "./tailwind.css"
-   * @docs [prettier-plugin-tailwindcss#specifying-your-tailwind-stylesheet-path-tailwind-css-v4](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#specifying-your-tailwind-stylesheet-path-tailwind-css-v4)
-   */
-  tailwindStylesheet?: `./${string}`;
-};
-type OptionsAstro = {
-  /**
-   * Enable automatic formatting of attributes to shorthand form (e.g., `<element {name} />`).
-   * @default false
-   * @docs [prettier-plugin-astro#astroallowshorthand](https://github.com/withastro/prettier-plugin-astro#astroallowshorthand)
-   */
-  astroAllowShorthand?: boolean;
-  /**
-   * Skip formatting of JavaScript frontmatter.
-   * @default false
-   * @docs [prettier-plugin-astro#astroskipfrontmatter](https://github.com/withastro/prettier-plugin-astro#astroskipfrontmatter)
-   */
-  astroSkipFrontmatter?: boolean;
-  overrides?: Array<
-  /**
-   * @docs [prettier-plugin-astro#recommended-configuration](https://github.com/withastro/prettier-plugin-astro#recommended-configuration)
-   */
-  {
-    files: "*.astro";
-    options: {
-      parser: "astro";
-    };
-  } | NonNullable<Config["overrides"]>[number]>;
-  plugins?: Array<"prettier-plugin-astro" | RestOfAllowedPluginTypes>;
-};
-type OptionsSortImports = {
-  /**
-   * Regex patterns to control import grouping and order.
-   * Supports special words: `<BUILTIN_MODULES>`, `<THIRD_PARTY_MODULES>`, `<TYPES>`.
-   * Use empty strings (`""`) to add blank lines between groups.
-   * @default ["<BUILTIN_MODULES>", "<THIRD_PARTY_MODULES>", "^[.]"]
-   * @docs [prettier-plugin-sort-imports#importorder](https://github.com/ianvs/prettier-plugin-sort-imports#importorder)
-   */
-  importOrder?: string[];
-  /**
-   * Enable case-sensitive sorting within import groups.
-   * @default false
-   * @docs [prettier-plugin-sort-imports#importordercasesensitive](https://github.com/ianvs/prettier-plugin-sort-imports#importordercasesensitive)
-   */
-  importOrderCaseSensitive?: boolean;
-  /**
-   * Babel parser plugins to understand file syntax (e.g., `["typescript", "jsx"]`).
-   * Pass plugin options as JSON: `["decorators", { "decoratorsBeforeExport": true }]`.
-   * @default ["typescript", "jsx"]
-   * @docs [prettier-plugin-sort-imports#importorderparserplugins](https://github.com/ianvs/prettier-plugin-sort-imports#importorderparserplugins)
-   */
-  importOrderParserPlugins?: string[];
-  /**
-   * Regex patterns for side-effect imports that are safe to reorder.
-   * By default, side-effect imports are not reordered. Use `^pattern$` for exact matches.
-   * @default []
-   * @docs [prettier-plugin-sort-imports#importordersafesideeffects](https://github.com/ianvs/prettier-plugin-sort-imports#importordersafesideeffects)
-   */
-  importOrderSafeSideEffects?: string[];
-  /**
-   * TypeScript version to enable modern import syntax features (e.g., mixed type/value imports).
-   * @default "1.0.0"
-   * @docs [prettier-plugin-sort-imports#importordertypescriptversion](https://github.com/ianvs/prettier-plugin-sort-imports#importordertypescriptversion)
-   */
-  importOrderTypeScriptVersion?: string;
-  plugins?: Array<"@ianvs/prettier-plugin-sort-imports" | RestOfAllowedPluginTypes>;
-};
-interface OptionsPrettierConfig {
-  /**
-   * Astro configuration
-   * @default false
-   * @docs [prettier-plugin-astro](https://github.com/withastro/prettier-plugin-astro#configuration)
-   */
-  astro?: boolean | OptionsAstro;
-  /**
-   * Base Prettier configuration with opinionated defaults.
-   * Includes settings for tabs, print width, quotes, trailing commas, and experimental features.
-   * @default true
-   */
-  base?: boolean | Config;
-  /**
-   * Sort imports configuration
-   * @default false
-   * @docs [prettier-plugin-sort-imports](https://github.com/ianvs/prettier-plugin-sort-imports#configuration)
-   */
-  sortImports?: boolean | OptionsSortImports;
-  /**
-   * Tailwind CSS configuration
-   * @default false
-   * @docs
-   *  - [prettier-plugin-tailwindcss](https://github.com/tailwindlabs/prettier-plugin-tailwindcss)
-   *  - [prettier-plugin-classnames](https://github.com/ony3000/prettier-plugin-classnames)
-   *  - [prettier-plugin-merge](https://github.com/ony3000/prettier-plugin-merge)
-   */
-  tailwindcss?: boolean | OptionsTailwindCss;
-}
-type ResolvedPrettierConfig = Config & OptionsAstro & OptionsSortImports & OptionsTailwindCss & Record<string, unknown>;
-type ExtractOptions<TUnion> = Extract<TUnion, object>;
-//#endregion
 //#region src/configs/astro.d.ts
-declare const astro: (options: ExtractOptions<OptionsPrettierConfig["astro"]>) => typeof options;
+declare const astro: (options: ExtractOptions<OptionsPrettierConfig["astro"]>) => Promise<typeof options>;
 //#endregion
 //#region src/configs/base.d.ts
 declare const base: (options: ExtractOptions<OptionsPrettierConfig["base"]>) => typeof options;
 //#endregion
 //#region src/configs/tailwindcss.d.ts
-declare const tailwindcss: (options: ExtractOptions<OptionsPrettierConfig["tailwindcss"]>) => typeof options;
+declare const tailwindcss: (options: ExtractOptions<OptionsPrettierConfig["tailwindcss"]>) => Promise<typeof options>;
 //#endregion
 //#region src/factory.d.ts
 /**
@@ -186,12 +28,12 @@ declare const tailwindcss: (options: ExtractOptions<OptionsPrettierConfig["tailw
  *   },
  *     // Extra config to merge (optional)
  *   {
- *     semi: false,
+ *     useTabs: false,
  *   }
  * );
  * ```
  */
-declare const zayne: (options?: OptionsPrettierConfig, ...extraConfigs: ResolvedPrettierConfig[]) => ResolvedPrettierConfig;
+declare const zayne: (options?: OptionsPrettierConfig, ...extraConfigs: ResolvedPrettierConfig[]) => Promise<ResolvedPrettierConfig>;
 //#endregion
 export { ExtractOptions, OptionsAstro, OptionsPrettierConfig, OptionsSortImports, OptionsTailwindCss, ResolvedPrettierConfig, astro, base, tailwindcss, zayne };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,14 +1,17 @@
-import { isArray, isObject } from "@zayne-labs/toolkit-type-helpers";
+import { a as resolveOptions, n as ensurePackages, t as combineConfigs } from "./utils-CEqE7-_1.js";
+import { n as getDefaultTailwindSettings, t as getDefaultImportSortingOrder } from "./defaults-DCbiIW5Q.js";
 
 //#region src/configs/astro.ts
-const astro = (options) => {
+const astro = async (options) => {
+	const necessaryPlugins = ["prettier-plugin-astro"];
+	await ensurePackages(necessaryPlugins);
 	return {
 		...options,
 		overrides: [{
 			files: "*.astro",
 			options: { parser: "astro" }
 		}, ...options.overrides ?? []],
-		plugins: ["prettier-plugin-astro", ...options.plugins ?? []]
+		plugins: [...necessaryPlugins, ...options.plugins ?? []]
 	};
 };
 
@@ -30,87 +33,46 @@ const base = (options) => {
 
 //#endregion
 //#region src/configs/tailwindcss.ts
-const tailwindcss = (options) => {
+const tailwindcss = async (options) => {
+	const necessaryPlugins = {
+		first: ["prettier-plugin-tailwindcss", "prettier-plugin-classnames"],
+		last: ["prettier-plugin-merge"]
+	};
+	await ensurePackages([...necessaryPlugins.first, ...necessaryPlugins.last]);
+	const tailwindSettings = getDefaultTailwindSettings();
 	return {
-		tailwindStylesheet: "./tailwind.css",
+		tailwindStylesheet: tailwindSettings.tailwindStylesheet,
 		...options,
-		customAttributes: [
-			"classNames",
-			"classes",
-			...options.customAttributes ?? []
-		],
-		customFunctions: [
-			"cnMerge",
-			"cnJoin",
-			"cn",
-			"tv",
-			"tw",
-			...options.customFunctions ?? []
-		],
+		customAttributes: [...tailwindSettings.tailwindAttributes, ...options.customAttributes ?? []],
+		customFunctions: [...tailwindSettings.tailwindFunctions, ...options.customFunctions ?? []],
 		plugins: [
-			"prettier-plugin-tailwindcss",
-			"prettier-plugin-classnames",
+			...necessaryPlugins.first,
 			...options.plugins ?? [],
-			"prettier-plugin-merge"
+			...necessaryPlugins.last
 		],
-		tailwindAttributes: [
-			"classNames",
-			"classes",
-			...options.tailwindAttributes ?? []
-		],
-		tailwindFunctions: [
-			"cnMerge",
-			"cnJoin",
-			"cn",
-			"tv",
-			"tw",
-			...options.tailwindFunctions ?? []
-		]
+		tailwindAttributes: [...tailwindSettings.tailwindAttributes, ...options.tailwindAttributes ?? []],
+		tailwindFunctions: [...tailwindSettings.tailwindFunctions, ...options.tailwindFunctions ?? []]
 	};
 };
 
 //#endregion
 //#region src/configs/sort.ts
-const sortImports = (options) => {
+const sortImports = async (options) => {
+	const necessaryPlugins = ["@ianvs/prettier-plugin-sort-imports"];
+	await ensurePackages(necessaryPlugins);
+	const sortingOrder = getDefaultImportSortingOrder();
 	return {
 		...options,
 		importOrder: [
-			"^https?://",
-			"<BUILTIN_MODULES>",
-			"^(bun|jsr|npm):",
-			"<THIRD_PARTY_MODULES>",
-			"^(@/|[#~$%])",
-			"^(?!.*[.]css$)[./].*$",
+			...sortingOrder.main,
 			...options.importOrder ?? [],
-			".css$"
+			sortingOrder.css
 		],
-		importOrderSafeSideEffects: [".css$", ...options.importOrderSafeSideEffects ?? []],
-		plugins: ["@ianvs/prettier-plugin-sort-imports", ...options.plugins ?? []]
+		importOrderSafeSideEffects: [sortingOrder.css, ...options.importOrderSafeSideEffects ?? []],
+		plugins: [...necessaryPlugins, ...options.plugins ?? []]
 	};
 };
 
-//#endregion
-//#region src/utils.ts
-/**
-* @description Resolves a boolean or object option to an object.
-* If the option is an object, it returns it as-is. Otherwise, returns an empty object.
-*/
-const resolveOptions = (option) => {
-	return isObject(option) ? option : {};
-};
-/**
-* @description Merges two Prettier configurations.
-* Array values (like `plugins` or `overrides`) are concatenated, while other values from the latter config overwrite the former.
-*/
-const mergeTwoConfigs = (formerConfig, latterConfig) => {
-	const configAccumulator = { ...formerConfig };
-	for (const [latterConfigKey, latterConfigValue] of Object.entries(latterConfig)) {
-		const accumulatedConfigValue = configAccumulator[latterConfigKey];
-		configAccumulator[latterConfigKey] = isArray(latterConfigValue) && isArray(accumulatedConfigValue) ? [...accumulatedConfigValue, ...latterConfigValue] : latterConfigValue;
-	}
-	return configAccumulator;
-};
-
 //#endregion
 //#region src/factory.ts
 /**
@@ -131,28 +93,21 @@ const mergeTwoConfigs = (formerConfig, latterConfig) => {
 *   },
 *     // Extra config to merge (optional)
 *   {
-*     semi: false,
+*     useTabs: false,
 *   }
 * );
 * ```
 */
-const zayne = (options = {}, ...extraConfigs) => {
-	const { astro: enabledAstro = false, base: enabledBase = true, sortImports: enabledSortImports = false, tailwindcss: enabledTailwindcss = false } = options;
-	const configArray = [
+const zayne = async (options = {}, ...extraConfigs) => {
+	const { astro: enabledAstro = false, base: enabledBase = true, sortImports: enabledSortImports = true, tailwindcss: enabledTailwindcss = false } = options;
+	return await combineConfigs([
 		enabledBase ? base(resolveOptions(enabledBase)) : void 0,
 		enabledAstro ? astro(resolveOptions(enabledAstro)) : void 0,
 		enabledSortImports ? sortImports(resolveOptions(enabledSortImports)) : void 0,
 		...extraConfigs,
 		enabledTailwindcss ? tailwindcss(resolveOptions(enabledTailwindcss)) : void 0
-	];
-	let resolvedConfig = {};
-	for (const config of configArray) {
-		if (!config) continue;
-		resolvedConfig = mergeTwoConfigs(resolvedConfig, config);
-	}
-	return resolvedConfig;
+	]);
 };
-zayne({}, {});
 
 //#endregion
 export { astro, base, tailwindcss, zayne };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["configAccumulator: ResolvedPrettierConfig","configArray: Array<ResolvedPrettierConfig | undefined>","resolvedConfig: ResolvedPrettierConfig"],"sources":["../src/configs/astro.ts","../src/configs/base.ts","../src/configs/tailwindcss.ts","../src/configs/sort.ts","../src/utils.ts","../src/factory.ts"],"sourcesContent":["import type { ExtractOptions, OptionsPrettierConfig } from \"@/types\";\n\nexport const astro = (options: ExtractOptions<OptionsPrettierConfig[\"astro\"]>): typeof options => {\n\treturn {\n\t\t...options,\n\n\t\toverrides: [\n\t\t\t{\n\t\t\t\tfiles: \"*.astro\",\n\t\t\t\toptions: { parser: \"astro\" },\n\t\t\t},\n\t\t\t...(options.overrides ?? []),\n\t\t],\n\t\tplugins: [\"prettier-plugin-astro\", ...(options.plugins ?? [])],\n\t};\n};\n","import type { ExtractOptions, OptionsPrettierConfig } from \"@/types\";\n\nexport const base = (options: ExtractOptions<OptionsPrettierConfig[\"base\"]>): typeof options => {\n\treturn {\n\t\texperimentalOperatorPosition: \"start\",\n\t\texperimentalTernaries: true,\n\t\tjsxSingleQuote: false,\n\t\tprintWidth: 107,\n\t\tsingleQuote: false,\n\t\ttabWidth: 3,\n\t\ttrailingComma: \"es5\",\n\t\tuseTabs: true,\n\n\t\t...options,\n\t};\n};\n","import type { ExtractOptions, OptionsPrettierConfig } from \"@/types\";\n\nexport const tailwindcss = (\n\toptions: ExtractOptions<OptionsPrettierConfig[\"tailwindcss\"]>\n): typeof options => {\n\treturn {\n\t\ttailwindStylesheet: \"./tailwind.css\",\n\n\t\t...options,\n\n\t\tcustomAttributes: [\"classNames\", \"classes\", ...(options.customAttributes ?? [])],\n\t\tcustomFunctions: [\"cnMerge\", \"cnJoin\", \"cn\", \"tv\", \"tw\", ...(options.customFunctions ?? [])],\n\t\tplugins: [\n\t\t\t\"prettier-plugin-tailwindcss\",\n\t\t\t\"prettier-plugin-classnames\",\n\n\t\t\t...(options.plugins ?? []),\n\n\t\t\t/**\n\t\t\t * This plugin must always come last\n\t\t\t * @see https://github.com/ony3000/prettier-plugin-merge#why-prettier-plugin-merge\n\t\t\t */\n\t\t\t\"prettier-plugin-merge\",\n\t\t],\n\t\ttailwindAttributes: [\"classNames\", \"classes\", ...(options.tailwindAttributes ?? [])],\n\t\ttailwindFunctions: [\"cnMerge\", \"cnJoin\", \"cn\", \"tv\", \"tw\", ...(options.tailwindFunctions ?? [])],\n\t};\n};\n","import type { ExtractOptions, OptionsPrettierConfig } from \"@/types\";\n\nexport const sortImports = (\n\toptions: ExtractOptions<OptionsPrettierConfig[\"sortImports\"]>\n): typeof options => {\n\treturn {\n\t\t...options,\n\n\t\timportOrder: [\n\t\t\t// URLs (e.g., https://example.org)\n\t\t\t\"^https?://\",\n\t\t\t// Protocol imports (node:, bun:, jsr:, npm:, etc.)\n\t\t\t\"<BUILTIN_MODULES>\",\n\t\t\t\"^(bun|jsr|npm):\",\n\t\t\t// Third-party packages\n\t\t\t\"<THIRD_PARTY_MODULES>\",\n\t\t\t// Aliases (@/, #, ~, $, %)\n\t\t\t\"^(@/|[#~$%])\",\n\t\t\t// Relative and absolute paths (excluding CSS)\n\t\t\t\"^(?!.*[.]css$)[./].*$\",\n\n\t\t\t...(options.importOrder ?? []),\n\n\t\t\t// CSS files (always last)\n\t\t\t\".css$\",\n\t\t],\n\t\timportOrderSafeSideEffects: [\".css$\", ...(options.importOrderSafeSideEffects ?? [])],\n\n\t\tplugins: [\"@ianvs/prettier-plugin-sort-imports\", ...(options.plugins ?? [])],\n\t};\n};\n","import { isArray, isObject } from \"@zayne-labs/toolkit-type-helpers\";\nimport type { ResolvedPrettierConfig } from \"./types\";\n\n/**\n * @description Resolves a boolean or object option to an object.\n * If the option is an object, it returns it as-is. Otherwise, returns an empty object.\n */\nexport const resolveOptions = <TObject>(option: boolean | TObject | undefined) => {\n\treturn isObject(option) ? option : ({} as TObject);\n};\n\n/**\n * @description Merges two Prettier configurations.\n * Array values (like `plugins` or `overrides`) are concatenated, while other values from the latter config overwrite the former.\n */\nexport const mergeTwoConfigs = (\n\tformerConfig: ResolvedPrettierConfig,\n\tlatterConfig: ResolvedPrettierConfig\n): ResolvedPrettierConfig => {\n\tconst configAccumulator: ResolvedPrettierConfig = {\n\t\t...formerConfig,\n\t};\n\n\tfor (const [latterConfigKey, latterConfigValue] of Object.entries(latterConfig)) {\n\t\tconst accumulatedConfigValue = configAccumulator[latterConfigKey];\n\n\t\tconfigAccumulator[latterConfigKey] =\n\t\t\tisArray(latterConfigValue) && isArray(accumulatedConfigValue) ?\n\t\t\t\t[...accumulatedConfigValue, ...latterConfigValue]\n\t\t\t:\tlatterConfigValue;\n\t}\n\n\treturn configAccumulator;\n};\n","import { astro, base, tailwindcss } from \"./configs\";\nimport { sortImports } from \"./configs/sort\";\nimport type { OptionsPrettierConfig, ResolvedPrettierConfig } from \"./types\";\nimport { mergeTwoConfigs, resolveOptions } from \"./utils\";\n\n/**\n * @description Factory function for creating a customized Prettier configuration.\n * Combines base, Astro, and Tailwind CSS configurations based on the provided options.\n * Any Array values (like `plugins` and `overrides`) are merged, while other values are overwritten.\n *\n * @example\n * ```ts\n * // prettier.config.ts\n * import { zayne } from \"@zayne-labs/prettier-config\";\n *\n * export default zayne(\n *   {\n *     base: true,\n *     tailwindcss: { tailwindStylesheet: \"./src/styles.css\" },\n *     astro: true,\n *   },\n *     // Extra config to merge (optional)\n *   {\n *     semi: false,\n *   }\n * );\n * ```\n */\nexport const zayne = (options: OptionsPrettierConfig = {}, ...extraConfigs: ResolvedPrettierConfig[]) => {\n\tconst {\n\t\tastro: enabledAstro = false,\n\t\tbase: enabledBase = true,\n\t\tsortImports: enabledSortImports = false,\n\t\ttailwindcss: enabledTailwindcss = false,\n\t} = options;\n\n\tconst configArray: Array<ResolvedPrettierConfig | undefined> = [\n\t\tenabledBase ? base(resolveOptions(enabledBase)) : undefined,\n\t\tenabledAstro ? astro(resolveOptions(enabledAstro)) : undefined,\n\t\tenabledSortImports ? sortImports(resolveOptions(enabledSortImports)) : undefined,\n\n\t\t...extraConfigs,\n\n\t\t/**\n\t\t * Tailwind plugin most always be the last one to avoid conflicts\n\t\t * @see https://github.com/tailwindlabs/prettier-plugin-tailwindcss#compatibility-with-other-prettier-plugins\n\t\t */\n\t\tenabledTailwindcss ? tailwindcss(resolveOptions(enabledTailwindcss)) : undefined,\n\t];\n\n\tlet resolvedConfig: ResolvedPrettierConfig = {};\n\n\tfor (const config of configArray) {\n\t\tif (!config) continue;\n\n\t\tresolvedConfig = mergeTwoConfigs(resolvedConfig, config);\n\t}\n\n\treturn resolvedConfig;\n};\n\nzayne({}, {});\n"],"mappings":";;;AAEA,MAAa,SAAS,YAA4E;AACjG,QAAO;EACN,GAAG;EAEH,WAAW,CACV;GACC,OAAO;GACP,SAAS,EAAE,QAAQ,SAAS;GAC5B,EACD,GAAI,QAAQ,aAAa,EAAE,CAC3B;EACD,SAAS,CAAC,yBAAyB,GAAI,QAAQ,WAAW,EAAE,CAAE;EAC9D;;;;;ACZF,MAAa,QAAQ,YAA2E;AAC/F,QAAO;EACN,8BAA8B;EAC9B,uBAAuB;EACvB,gBAAgB;EAChB,YAAY;EACZ,aAAa;EACb,UAAU;EACV,eAAe;EACf,SAAS;EAET,GAAG;EACH;;;;;ACZF,MAAa,eACZ,YACoB;AACpB,QAAO;EACN,oBAAoB;EAEpB,GAAG;EAEH,kBAAkB;GAAC;GAAc;GAAW,GAAI,QAAQ,oBAAoB,EAAE;GAAE;EAChF,iBAAiB;GAAC;GAAW;GAAU;GAAM;GAAM;GAAM,GAAI,QAAQ,mBAAmB,EAAE;GAAE;EAC5F,SAAS;GACR;GACA;GAEA,GAAI,QAAQ,WAAW,EAAE;GAMzB;GACA;EACD,oBAAoB;GAAC;GAAc;GAAW,GAAI,QAAQ,sBAAsB,EAAE;GAAE;EACpF,mBAAmB;GAAC;GAAW;GAAU;GAAM;GAAM;GAAM,GAAI,QAAQ,qBAAqB,EAAE;GAAE;EAChG;;;;;ACxBF,MAAa,eACZ,YACoB;AACpB,QAAO;EACN,GAAG;EAEH,aAAa;GAEZ;GAEA;GACA;GAEA;GAEA;GAEA;GAEA,GAAI,QAAQ,eAAe,EAAE;GAG7B;GACA;EACD,4BAA4B,CAAC,SAAS,GAAI,QAAQ,8BAA8B,EAAE,CAAE;EAEpF,SAAS,CAAC,uCAAuC,GAAI,QAAQ,WAAW,EAAE,CAAE;EAC5E;;;;;;;;;ACtBF,MAAa,kBAA2B,WAA0C;AACjF,QAAO,SAAS,OAAO,GAAG,SAAU,EAAE;;;;;;AAOvC,MAAa,mBACZ,cACA,iBAC4B;CAC5B,MAAMA,oBAA4C,EACjD,GAAG,cACH;AAED,MAAK,MAAM,CAAC,iBAAiB,sBAAsB,OAAO,QAAQ,aAAa,EAAE;EAChF,MAAM,yBAAyB,kBAAkB;AAEjD,oBAAkB,mBACjB,QAAQ,kBAAkB,IAAI,QAAQ,uBAAuB,GAC5D,CAAC,GAAG,wBAAwB,GAAG,kBAAkB,GAChD;;AAGJ,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACJR,MAAa,SAAS,UAAiC,EAAE,EAAE,GAAG,iBAA2C;CACxG,MAAM,EACL,OAAO,eAAe,OACtB,MAAM,cAAc,MACpB,aAAa,qBAAqB,OAClC,aAAa,qBAAqB,UAC/B;CAEJ,MAAMC,cAAyD;EAC9D,cAAc,KAAK,eAAe,YAAY,CAAC,GAAG;EAClD,eAAe,MAAM,eAAe,aAAa,CAAC,GAAG;EACrD,qBAAqB,YAAY,eAAe,mBAAmB,CAAC,GAAG;EAEvE,GAAG;EAMH,qBAAqB,YAAY,eAAe,mBAAmB,CAAC,GAAG;EACvE;CAED,IAAIC,iBAAyC,EAAE;AAE/C,MAAK,MAAM,UAAU,aAAa;AACjC,MAAI,CAAC,OAAQ;AAEb,mBAAiB,gBAAgB,gBAAgB,OAAO;;AAGzD,QAAO;;AAGR,MAAM,EAAE,EAAE,EAAE,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/configs/astro.ts","../src/configs/base.ts","../src/configs/tailwindcss.ts","../src/configs/sort.ts","../src/factory.ts"],"sourcesContent":["import type { ExtractOptions, OptionsPrettierConfig } from \"@/types\";\nimport { ensurePackages } from \"@/utils\";\n\nexport const astro = async (\n\toptions: ExtractOptions<OptionsPrettierConfig[\"astro\"]>\n): Promise<typeof options> => {\n\tconst necessaryPlugins = [\"prettier-plugin-astro\"];\n\n\tawait ensurePackages(necessaryPlugins);\n\n\treturn {\n\t\t...options,\n\n\t\toverrides: [\n\t\t\t{\n\t\t\t\tfiles: \"*.astro\",\n\t\t\t\toptions: { parser: \"astro\" },\n\t\t\t},\n\t\t\t...(options.overrides ?? []),\n\t\t],\n\n\t\tplugins: [...necessaryPlugins, ...(options.plugins ?? [])],\n\t};\n};\n","import type { ExtractOptions, OptionsPrettierConfig } from \"@/types\";\n\nexport const base = (options: ExtractOptions<OptionsPrettierConfig[\"base\"]>): typeof options => {\n\treturn {\n\t\texperimentalOperatorPosition: \"start\",\n\t\texperimentalTernaries: true,\n\t\tjsxSingleQuote: false,\n\t\tprintWidth: 107,\n\t\tsingleQuote: false,\n\t\ttabWidth: 3,\n\t\ttrailingComma: \"es5\",\n\t\tuseTabs: true,\n\n\t\t...options,\n\t};\n};\n","import { getDefaultTailwindSettings } from \"@/constants/defaults\";\nimport type { ExtractOptions, OptionsPrettierConfig } from \"@/types\";\nimport { ensurePackages } from \"@/utils\";\n\nexport const tailwindcss = async (\n\toptions: ExtractOptions<OptionsPrettierConfig[\"tailwindcss\"]>\n): Promise<typeof options> => {\n\tconst necessaryPlugins = {\n\t\tfirst: [\"prettier-plugin-tailwindcss\", \"prettier-plugin-classnames\"],\n\t\tlast: [\"prettier-plugin-merge\"],\n\t} as const;\n\n\tawait ensurePackages([...necessaryPlugins.first, ...necessaryPlugins.last]);\n\n\tconst tailwindSettings = getDefaultTailwindSettings();\n\n\treturn {\n\t\ttailwindStylesheet: tailwindSettings.tailwindStylesheet,\n\n\t\t...options,\n\n\t\tcustomAttributes: [...tailwindSettings.tailwindAttributes, ...(options.customAttributes ?? [])],\n\t\tcustomFunctions: [...tailwindSettings.tailwindFunctions, ...(options.customFunctions ?? [])],\n\n\t\tplugins: [\n\t\t\t...necessaryPlugins.first,\n\n\t\t\t...(options.plugins ?? []),\n\n\t\t\t/**\n\t\t\t * The 'merge' plugin must always come last\n\t\t\t * @see https://github.com/ony3000/prettier-plugin-merge#why-prettier-plugin-merge\n\t\t\t */\n\t\t\t...necessaryPlugins.last,\n\t\t],\n\n\t\ttailwindAttributes: [...tailwindSettings.tailwindAttributes, ...(options.tailwindAttributes ?? [])],\n\t\ttailwindFunctions: [...tailwindSettings.tailwindFunctions, ...(options.tailwindFunctions ?? [])],\n\t};\n};\n","import { getDefaultImportSortingOrder } from \"@/constants/defaults\";\nimport type { ExtractOptions, OptionsPrettierConfig } from \"@/types\";\nimport { ensurePackages } from \"@/utils\";\n\nexport const sortImports = async (\n\toptions: ExtractOptions<OptionsPrettierConfig[\"sortImports\"]>\n): Promise<typeof options> => {\n\tconst necessaryPlugins = [\"@ianvs/prettier-plugin-sort-imports\"];\n\n\tawait ensurePackages(necessaryPlugins);\n\n\tconst sortingOrder = getDefaultImportSortingOrder();\n\n\treturn {\n\t\t...options,\n\n\t\timportOrder: [...sortingOrder.main, ...(options.importOrder ?? []), sortingOrder.css],\n\t\timportOrderSafeSideEffects: [sortingOrder.css, ...(options.importOrderSafeSideEffects ?? [])],\n\n\t\tplugins: [...necessaryPlugins, ...(options.plugins ?? [])],\n\t};\n};\n","import type { Awaitable } from \"@zayne-labs/toolkit-type-helpers\";\nimport { astro, base, tailwindcss } from \"./configs\";\nimport { sortImports } from \"./configs/sort\";\nimport type { OptionsPrettierConfig, ResolvedPrettierConfig } from \"./types\";\nimport { combineConfigs, resolveOptions } from \"./utils\";\n\n/**\n * @description Factory function for creating a customized Prettier configuration.\n * Combines base, Astro, and Tailwind CSS configurations based on the provided options.\n * Any Array values (like `plugins` and `overrides`) are merged, while other values are overwritten.\n *\n * @example\n * ```ts\n * // prettier.config.ts\n * import { zayne } from \"@zayne-labs/prettier-config\";\n *\n * export default zayne(\n *   {\n *     base: true,\n *     tailwindcss: { tailwindStylesheet: \"./src/styles.css\" },\n *     astro: true,\n *   },\n *     // Extra config to merge (optional)\n *   {\n *     useTabs: false,\n *   }\n * );\n * ```\n */\nexport const zayne = async (\n\toptions: OptionsPrettierConfig = {},\n\t...extraConfigs: ResolvedPrettierConfig[]\n) => {\n\tconst {\n\t\tastro: enabledAstro = false,\n\t\tbase: enabledBase = true,\n\t\tsortImports: enabledSortImports = true,\n\t\ttailwindcss: enabledTailwindcss = false,\n\t} = options;\n\n\tconst configArray: Array<Awaitable<ResolvedPrettierConfig | undefined>> = [\n\t\tenabledBase ? base(resolveOptions(enabledBase)) : undefined,\n\t\tenabledAstro ? astro(resolveOptions(enabledAstro)) : undefined,\n\t\tenabledSortImports ? sortImports(resolveOptions(enabledSortImports)) : undefined,\n\n\t\t...extraConfigs,\n\n\t\t/**\n\t\t * Tailwind plugin most always be the last one to avoid conflicts\n\t\t * @see https://github.com/tailwindlabs/prettier-plugin-tailwindcss#compatibility-with-other-prettier-plugins\n\t\t */\n\t\tenabledTailwindcss ? tailwindcss(resolveOptions(enabledTailwindcss)) : undefined,\n\t];\n\n\tconst accumulatedConfig = await combineConfigs(configArray);\n\n\treturn accumulatedConfig;\n};\n"],"mappings":";;;;AAGA,MAAa,QAAQ,OACpB,YAC6B;CAC7B,MAAM,mBAAmB,CAAC,wBAAwB;AAElD,OAAM,eAAe,iBAAiB;AAEtC,QAAO;EACN,GAAG;EAEH,WAAW,CACV;GACC,OAAO;GACP,SAAS,EAAE,QAAQ,SAAS;GAC5B,EACD,GAAI,QAAQ,aAAa,EAAE,CAC3B;EAED,SAAS,CAAC,GAAG,kBAAkB,GAAI,QAAQ,WAAW,EAAE,CAAE;EAC1D;;;;;ACpBF,MAAa,QAAQ,YAA2E;AAC/F,QAAO;EACN,8BAA8B;EAC9B,uBAAuB;EACvB,gBAAgB;EAChB,YAAY;EACZ,aAAa;EACb,UAAU;EACV,eAAe;EACf,SAAS;EAET,GAAG;EACH;;;;;ACVF,MAAa,cAAc,OAC1B,YAC6B;CAC7B,MAAM,mBAAmB;EACxB,OAAO,CAAC,+BAA+B,6BAA6B;EACpE,MAAM,CAAC,wBAAwB;EAC/B;AAED,OAAM,eAAe,CAAC,GAAG,iBAAiB,OAAO,GAAG,iBAAiB,KAAK,CAAC;CAE3E,MAAM,mBAAmB,4BAA4B;AAErD,QAAO;EACN,oBAAoB,iBAAiB;EAErC,GAAG;EAEH,kBAAkB,CAAC,GAAG,iBAAiB,oBAAoB,GAAI,QAAQ,oBAAoB,EAAE,CAAE;EAC/F,iBAAiB,CAAC,GAAG,iBAAiB,mBAAmB,GAAI,QAAQ,mBAAmB,EAAE,CAAE;EAE5F,SAAS;GACR,GAAG,iBAAiB;GAEpB,GAAI,QAAQ,WAAW,EAAE;GAMzB,GAAG,iBAAiB;GACpB;EAED,oBAAoB,CAAC,GAAG,iBAAiB,oBAAoB,GAAI,QAAQ,sBAAsB,EAAE,CAAE;EACnG,mBAAmB,CAAC,GAAG,iBAAiB,mBAAmB,GAAI,QAAQ,qBAAqB,EAAE,CAAE;EAChG;;;;;AClCF,MAAa,cAAc,OAC1B,YAC6B;CAC7B,MAAM,mBAAmB,CAAC,sCAAsC;AAEhE,OAAM,eAAe,iBAAiB;CAEtC,MAAM,eAAe,8BAA8B;AAEnD,QAAO;EACN,GAAG;EAEH,aAAa;GAAC,GAAG,aAAa;GAAM,GAAI,QAAQ,eAAe,EAAE;GAAG,aAAa;GAAI;EACrF,4BAA4B,CAAC,aAAa,KAAK,GAAI,QAAQ,8BAA8B,EAAE,CAAE;EAE7F,SAAS,CAAC,GAAG,kBAAkB,GAAI,QAAQ,WAAW,EAAE,CAAE;EAC1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACSF,MAAa,QAAQ,OACpB,UAAiC,EAAE,EACnC,GAAG,iBACC;CACJ,MAAM,EACL,OAAO,eAAe,OACtB,MAAM,cAAc,MACpB,aAAa,qBAAqB,MAClC,aAAa,qBAAqB,UAC/B;AAkBJ,QAF0B,MAAM,eAd0C;EACzE,cAAc,KAAK,eAAe,YAAY,CAAC,GAAG;EAClD,eAAe,MAAM,eAAe,aAAa,CAAC,GAAG;EACrD,qBAAqB,YAAY,eAAe,mBAAmB,CAAC,GAAG;EAEvE,GAAG;EAMH,qBAAqB,YAAY,eAAe,mBAAmB,CAAC,GAAG;EACvE,CAE0D"}

package/dist/types-B17hDweL.d.ts

@@ -0,0 +1,177 @@
+import { AnyString } from "@zayne-labs/toolkit-type-helpers";
+import { Config, Plugin } from "prettier";
+
+//#region src/types.d.ts
+type RestOfAllowedPluginTypes = AnyString | Plugin | URL;
+type OptionsClassNames = {
+  /**
+   * List of additional attributes that enclose class names.
+   * The `class` and `className` attributes are always supported.
+   * @docs [prettier-plugin-classnames#custom-attributes](https://github.com/ony3000/prettier-plugin-classnames#custom-attributes)
+   */
+  customAttributes?: string[];
+  /**
+   * List of additional functions that enclose class names.
+   * The `classNames` function is always supported.
+   * @docs [prettier-plugin-classnames#custom-functions](https://github.com/ony3000/prettier-plugin-classnames#custom-functions)
+   */
+  customFunctions?: string[];
+  /**
+   * Criterion for ending the class name on each line when replacing with multi-line.
+   * @default "absolute"
+   * @docs [prettier-plugin-classnames#ending-position](https://github.com/ony3000/prettier-plugin-classnames#ending-position)
+   */
+  endPosition?: "absolute" | "relative";
+  /**
+   * Transforms non-expression class names into expression syntax if line wrapping occurs.
+   * Note: This transformation does not support reversible formatting.
+   * @default false
+   * @docs [prettier-plugin-classnames#syntax-transformation](https://github.com/ony3000/prettier-plugin-classnames#syntax-transformation)
+   */
+  syntaxTransformation?: boolean;
+};
+type OptionsTailwindCss = OptionsClassNames & {
+  plugins?: Array<"prettier-plugin-tailwindcss" | "prettier-plugin-classnames" | "prettier-plugin-merge" | RestOfAllowedPluginTypes>;
+  /**
+   * List of attributes to sort classes in. Supports regex patterns.
+   * @docs [prettier-plugin-tailwindcss#sorting-non-standard-attributes](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#sorting-non-standard-attributes)
+   */
+  tailwindAttributes?: string[];
+  /**
+   * Path to the Tailwind configuration file (v3).
+   * @docs [prettier-plugin-tailwindcss#specifying-your-tailwind-javascript-config-path-tailwind-css-v3](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#specifying-your-tailwind-javascript-config-path-tailwind-css-v3)
+   */
+  tailwindConfig?: `./${string}`;
+  /**
+   * List of functions or tagged templates to sort classes in. Supports regex patterns.
+   * @docs [prettier-plugin-tailwindcss#sorting-classes-in-function-calls](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#sorting-classes-in-function-calls)
+   */
+  tailwindFunctions?: string[];
+  /**
+   * Prevent automatic removal of duplicate classes.
+   * @docs [prettier-plugin-tailwindcss#preserving-duplicate-classes](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#preserving-duplicate-classes)
+   */
+  tailwindPreserveDuplicates?: boolean;
+  /**
+   * Prevent automatic removal of unnecessary whitespace.
+   * @docs [prettier-plugin-tailwindcss#preserving-whitespace](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#preserving-whitespace)
+   */
+  tailwindPreserveWhitespace?: boolean;
+  /**
+   * Path to the CSS entry point (Tailwind CSS v4+).
+   * @default "./tailwind.css"
+   * @docs [prettier-plugin-tailwindcss#specifying-your-tailwind-stylesheet-path-tailwind-css-v4](https://github.com/tailwindlabs/prettier-plugin-tailwindcss#specifying-your-tailwind-stylesheet-path-tailwind-css-v4)
+   */
+  tailwindStylesheet?: `./${string}`;
+};
+type OptionsAstro = {
+  /**
+   * Enable automatic formatting of attributes to shorthand form (e.g., `<element {name} />`).
+   * @default false
+   * @docs [prettier-plugin-astro#astroallowshorthand](https://github.com/withastro/prettier-plugin-astro#astroallowshorthand)
+   */
+  astroAllowShorthand?: boolean;
+  /**
+   * Skip formatting of JavaScript frontmatter.
+   * @default false
+   * @docs [prettier-plugin-astro#astroskipfrontmatter](https://github.com/withastro/prettier-plugin-astro#astroskipfrontmatter)
+   */
+  astroSkipFrontmatter?: boolean;
+  overrides?: Array<
+  /**
+   * @docs [prettier-plugin-astro#recommended-configuration](https://github.com/withastro/prettier-plugin-astro#recommended-configuration)
+   */
+  {
+    files: "*.astro";
+    options: {
+      parser: "astro";
+    };
+  } | NonNullable<Config["overrides"]>[number]>;
+  plugins?: Array<"prettier-plugin-astro" | RestOfAllowedPluginTypes>;
+};
+type OptionsSortImports = {
+  /**
+   * Regex patterns to control import grouping and order.
+   * Supports special words: `<BUILTIN_MODULES>`, `<THIRD_PARTY_MODULES>`, `<TYPES>`.
+   * Use empty strings (`""`) to add blank lines between groups.
+   * @default ["^https?://", "<BUILTIN_MODULES>", "^(bun|jsr|npm):", "<THIRD_PARTY_MODULES>", "^(@/|[#~$%])", "^(?!.*[.]css$)[./].*$", ".css$"]
+   * @docs [prettier-plugin-sort-imports#importorder](https://github.com/ianvs/prettier-plugin-sort-imports#importorder)
+   */
+  importOrder?: string[];
+  /**
+   * Enable case-sensitive sorting within import groups.
+   * @default false
+   * @docs [prettier-plugin-sort-imports#importordercasesensitive](https://github.com/ianvs/prettier-plugin-sort-imports#importordercasesensitive)
+   */
+  importOrderCaseSensitive?: boolean;
+  /**
+   * Babel parser plugins to understand file syntax (e.g., `["typescript", "jsx"]`).
+   * Pass plugin options as JSON: `["decorators", { "decoratorsBeforeExport": true }]`.
+   * @default ["typescript", "jsx"]
+   * @docs [prettier-plugin-sort-imports#importorderparserplugins](https://github.com/ianvs/prettier-plugin-sort-imports#importorderparserplugins)
+   */
+  importOrderParserPlugins?: string[];
+  /**
+   * Regex patterns for side-effect imports that are safe to reorder.
+   * By default, side-effect imports are not reordered. Use `^pattern$` for exact matches.
+   * @default [".css$"]
+   * @docs [prettier-plugin-sort-imports#importordersafesideeffects](https://github.com/ianvs/prettier-plugin-sort-imports#importordersafesideeffects)
+   */
+  importOrderSafeSideEffects?: string[];
+  /**
+   * TypeScript version to enable modern import syntax features (e.g., mixed type/value imports).
+   * @default "1.0.0"
+   * @docs [prettier-plugin-sort-imports#importordertypescriptversion](https://github.com/ianvs/prettier-plugin-sort-imports#importordertypescriptversion)
+   */
+  importOrderTypeScriptVersion?: string;
+  plugins?: Array<"@ianvs/prettier-plugin-sort-imports" | RestOfAllowedPluginTypes>;
+};
+interface OptionsPrettierConfig {
+  /**
+   * Astro configuration
+   *
+   *   Requires installing:
+   * - `prettier-plugin-astro`
+   *
+   * @default false
+   * @docs [prettier-plugin-astro](https://github.com/withastro/prettier-plugin-astro#configuration)
+   */
+  astro?: boolean | OptionsAstro;
+  /**
+   * Base Prettier configuration with opinionated defaults.
+   * Includes settings for tabs, print width, quotes, trailing commas, and experimental features.
+   *
+   * @default true
+   */
+  base?: boolean | Config;
+  /**
+   * Sort imports configuration
+   *
+   *   Requires installing:
+   * - `prettier-plugin-sort-imports`
+   *
+   * @default true
+   * @docs [prettier-plugin-sort-imports](https://github.com/ianvs/prettier-plugin-sort-imports#configuration)
+   */
+  sortImports?: boolean | OptionsSortImports;
+  /**
+   * Tailwind CSS configuration
+   *
+   *   Requires installing:
+   * - `prettier-plugin-tailwindcss`
+   * - `prettier-plugin-classnames`
+   * - `prettier-plugin-merge`
+   *
+   * @default false
+   * @docs
+   *  - [prettier-plugin-tailwindcss](https://github.com/tailwindlabs/prettier-plugin-tailwindcss)
+   *  - [prettier-plugin-classnames](https://github.com/ony3000/prettier-plugin-classnames)
+   *  - [prettier-plugin-merge](https://github.com/ony3000/prettier-plugin-merge)
+   */
+  tailwindcss?: boolean | OptionsTailwindCss;
+}
+type ResolvedPrettierConfig = Config & OptionsAstro & OptionsSortImports & OptionsTailwindCss & Record<string, unknown>;
+type ExtractOptions<TUnion> = Extract<TUnion, object>;
+//#endregion
+export { OptionsTailwindCss as a, OptionsSortImports as i, OptionsAstro as n, ResolvedPrettierConfig as o, OptionsPrettierConfig as r, ExtractOptions as t };
+//# sourceMappingURL=types-B17hDweL.d.ts.map

package/dist/utils-CEqE7-_1.js

@@ -0,0 +1,55 @@
+import { fileURLToPath } from "node:url";
+import { isArray, isObject } from "@zayne-labs/toolkit-type-helpers";
+import { isPackageExists } from "local-pkg";
+
+//#region src/utils.ts
+/**
+* @description Resolves a boolean or object option to an object.
+* If the option is an object, it returns it as-is. Otherwise, returns an empty object.
+*/
+const resolveOptions = (option) => {
+	return isObject(option) ? option : {};
+};
+/**
+* @description Merges two Prettier configurations.
+* Array values (like `plugins` or `overrides`) are concatenated, while other values from the latter config overwrite the former.
+*/
+const mergeTwoConfigs = (formerConfig, latterConfig) => {
+	const configAccumulator = { ...formerConfig };
+	for (const [latterConfigKey, latterConfigValue] of Object.entries(latterConfig)) {
+		const accumulatedConfigValue = configAccumulator[latterConfigKey];
+		configAccumulator[latterConfigKey] = isArray(latterConfigValue) && isArray(accumulatedConfigValue) ? [...accumulatedConfigValue, ...latterConfigValue] : latterConfigValue;
+	}
+	return configAccumulator;
+};
+const combineConfigs = async (configArray) => {
+	const resolvedConfigArray = await Promise.all(configArray);
+	let accumulatedConfig = {};
+	for (const config of resolvedConfigArray) {
+		if (!config) continue;
+		accumulatedConfig = mergeTwoConfigs(accumulatedConfig, config);
+	}
+	return accumulatedConfig;
+};
+const scopeUrl = fileURLToPath(new URL(".", import.meta.url));
+const isCwdInScope = isPackageExists("@zayne-labs/prettier-config");
+const isPackageInScope = (name) => isPackageExists(name, { paths: [scopeUrl] });
+/**
+* @description
+* - Ensures that packages are installed in the current scope.
+* - If they are not installed, and the user is in a TTY, and the user is not in a CI environment,
+* and the user is in the same scope as this package, then prompt the user to
+* install the packages.
+*
+* @param packages - The packages to ensure are installed.
+*/
+const ensurePackages = async (packages) => {
+	if (process.env.CI || !process.stdout.isTTY || !isCwdInScope) return;
+	const nonExistingPackages = packages.filter((pkg) => pkg && !isPackageInScope(pkg));
+	if (nonExistingPackages.length === 0) return;
+	if (await (await import("@clack/prompts")).confirm({ message: `${nonExistingPackages.length === 1 ? "Package is" : "Packages are"} required for this config: ${nonExistingPackages.join(", ")}. Do you want to install them?` })) await (await import("@antfu/install-pkg")).installPackage(nonExistingPackages, { dev: true });
+};
+
+//#endregion
+export { resolveOptions as a, mergeTwoConfigs as i, ensurePackages as n, isPackageInScope as r, combineConfigs as t };
+//# sourceMappingURL=utils-CEqE7-_1.js.map

package/dist/utils-CEqE7-_1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-CEqE7-_1.js","names":["configAccumulator: ResolvedPrettierConfig","accumulatedConfig: ResolvedPrettierConfig"],"sources":["../src/utils.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { isArray, isObject, type Awaitable } from \"@zayne-labs/toolkit-type-helpers\";\nimport { isPackageExists } from \"local-pkg\";\nimport type { ResolvedPrettierConfig } from \"./types\";\n\n/**\n * @description Resolves a boolean or object option to an object.\n * If the option is an object, it returns it as-is. Otherwise, returns an empty object.\n */\nexport const resolveOptions = <TObject>(option: boolean | TObject | undefined) => {\n\treturn isObject(option) ? option : ({} as TObject);\n};\n\n/**\n * @description Merges two Prettier configurations.\n * Array values (like `plugins` or `overrides`) are concatenated, while other values from the latter config overwrite the former.\n */\nexport const mergeTwoConfigs = (\n\tformerConfig: ResolvedPrettierConfig,\n\tlatterConfig: ResolvedPrettierConfig\n): ResolvedPrettierConfig => {\n\tconst configAccumulator: ResolvedPrettierConfig = {\n\t\t...formerConfig,\n\t};\n\n\tfor (const [latterConfigKey, latterConfigValue] of Object.entries(latterConfig)) {\n\t\tconst accumulatedConfigValue = configAccumulator[latterConfigKey];\n\n\t\tconfigAccumulator[latterConfigKey] =\n\t\t\tisArray(latterConfigValue) && isArray(accumulatedConfigValue) ?\n\t\t\t\t[...accumulatedConfigValue, ...latterConfigValue]\n\t\t\t:\tlatterConfigValue;\n\t}\n\n\treturn configAccumulator;\n};\n\nexport const combineConfigs = async (\n\tconfigArray: Array<Awaitable<ResolvedPrettierConfig | undefined>>\n): Promise<ResolvedPrettierConfig> => {\n\t// eslint-disable-next-line ts-eslint/await-thenable -- Ignore\n\tconst resolvedConfigArray = await Promise.all(configArray);\n\n\tlet accumulatedConfig: ResolvedPrettierConfig = {};\n\n\tfor (const config of resolvedConfigArray) {\n\t\tif (!config) continue;\n\n\t\taccumulatedConfig = mergeTwoConfigs(accumulatedConfig, config);\n\t}\n\n\treturn accumulatedConfig;\n};\n\nconst scopeUrl = fileURLToPath(new URL(\".\", import.meta.url));\nconst isCwdInScope = isPackageExists(\"@zayne-labs/prettier-config\");\n\nexport const isPackageInScope = (name: string): boolean => isPackageExists(name, { paths: [scopeUrl] });\n\n/**\n * @description\n * - Ensures that packages are installed in the current scope.\n * - If they are not installed, and the user is in a TTY, and the user is not in a CI environment,\n * and the user is in the same scope as this package, then prompt the user to\n * install the packages.\n *\n * @param packages - The packages to ensure are installed.\n */\nexport const ensurePackages = async (packages: Array<string | undefined>): Promise<void> => {\n\tif (process.env.CI || !process.stdout.isTTY || !isCwdInScope) return;\n\n\tconst nonExistingPackages = packages.filter((pkg) => pkg && !isPackageInScope(pkg));\n\n\tif (nonExistingPackages.length === 0) return;\n\n\tconst clackPrompt = await import(\"@clack/prompts\");\n\n\tconst result = await clackPrompt.confirm({\n\t\tmessage: `${nonExistingPackages.length === 1 ? \"Package is\" : \"Packages are\"} required for this config: ${nonExistingPackages.join(\", \")}. Do you want to install them?`,\n\t});\n\n\tif (result) {\n\t\tconst antfuPkg = await import(\"@antfu/install-pkg\");\n\n\t\tawait antfuPkg.installPackage(nonExistingPackages as string[], { dev: true });\n\t}\n};\n"],"mappings":";;;;;;;;;AASA,MAAa,kBAA2B,WAA0C;AACjF,QAAO,SAAS,OAAO,GAAG,SAAU,EAAE;;;;;;AAOvC,MAAa,mBACZ,cACA,iBAC4B;CAC5B,MAAMA,oBAA4C,EACjD,GAAG,cACH;AAED,MAAK,MAAM,CAAC,iBAAiB,sBAAsB,OAAO,QAAQ,aAAa,EAAE;EAChF,MAAM,yBAAyB,kBAAkB;AAEjD,oBAAkB,mBACjB,QAAQ,kBAAkB,IAAI,QAAQ,uBAAuB,GAC5D,CAAC,GAAG,wBAAwB,GAAG,kBAAkB,GAChD;;AAGJ,QAAO;;AAGR,MAAa,iBAAiB,OAC7B,gBACqC;CAErC,MAAM,sBAAsB,MAAM,QAAQ,IAAI,YAAY;CAE1D,IAAIC,oBAA4C,EAAE;AAElD,MAAK,MAAM,UAAU,qBAAqB;AACzC,MAAI,CAAC,OAAQ;AAEb,sBAAoB,gBAAgB,mBAAmB,OAAO;;AAG/D,QAAO;;AAGR,MAAM,WAAW,cAAc,IAAI,IAAI,KAAK,OAAO,KAAK,IAAI,CAAC;AAC7D,MAAM,eAAe,gBAAgB,8BAA8B;AAEnE,MAAa,oBAAoB,SAA0B,gBAAgB,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;;;;;;;;;;AAWvG,MAAa,iBAAiB,OAAO,aAAuD;AAC3F,KAAI,QAAQ,IAAI,MAAM,CAAC,QAAQ,OAAO,SAAS,CAAC,aAAc;CAE9D,MAAM,sBAAsB,SAAS,QAAQ,QAAQ,OAAO,CAAC,iBAAiB,IAAI,CAAC;AAEnF,KAAI,oBAAoB,WAAW,EAAG;AAQtC,KAJe,OAFK,MAAM,OAAO,mBAEA,QAAQ,EACxC,SAAS,GAAG,oBAAoB,WAAW,IAAI,eAAe,eAAe,6BAA6B,oBAAoB,KAAK,KAAK,CAAC,iCACzI,CAAC,CAKD,QAFiB,MAAM,OAAO,uBAEf,eAAe,qBAAiC,EAAE,KAAK,MAAM,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,30 @@
+import { o as ResolvedPrettierConfig } from "./types-B17hDweL.js";
+import { Awaitable } from "@zayne-labs/toolkit-type-helpers";
+
+//#region src/utils.d.ts
+
+/**
+ * @description Resolves a boolean or object option to an object.
+ * If the option is an object, it returns it as-is. Otherwise, returns an empty object.
+ */
+declare const resolveOptions: <TObject>(option: boolean | TObject | undefined) => TObject;
+/**
+ * @description Merges two Prettier configurations.
+ * Array values (like `plugins` or `overrides`) are concatenated, while other values from the latter config overwrite the former.
+ */
+declare const mergeTwoConfigs: (formerConfig: ResolvedPrettierConfig, latterConfig: ResolvedPrettierConfig) => ResolvedPrettierConfig;
+declare const combineConfigs: (configArray: Array<Awaitable<ResolvedPrettierConfig | undefined>>) => Promise<ResolvedPrettierConfig>;
+declare const isPackageInScope: (name: string) => boolean;
+/**
+ * @description
+ * - Ensures that packages are installed in the current scope.
+ * - If they are not installed, and the user is in a TTY, and the user is not in a CI environment,
+ * and the user is in the same scope as this package, then prompt the user to
+ * install the packages.
+ *
+ * @param packages - The packages to ensure are installed.
+ */
+declare const ensurePackages: (packages: Array<string | undefined>) => Promise<void>;
+//#endregion
+export { combineConfigs, ensurePackages, isPackageInScope, mergeTwoConfigs, resolveOptions };
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -0,0 +1,3 @@
+import { a as resolveOptions, i as mergeTwoConfigs, n as ensurePackages, r as isPackageInScope, t as combineConfigs } from "./utils-CEqE7-_1.js";
+
+export { combineConfigs, ensurePackages, isPackageInScope, mergeTwoConfigs, resolveOptions };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zayne-labs/prettier-config",
   "type": "module",
-  "version": "0.11.7",
+  "version": "0.11.9",
   "description": "Zayne Labs' Prettier config",
   "author": "Ryan Zayne",
   "license": "MIT",
@@ -20,7 +20,9 @@
   ],
   "sideEffects": false,
   "exports": {
-    ".": "./dist/index.js"
+    ".": "./dist/index.js",
+    "./utils": "./dist/utils.js",
+    "./constants/*": "./dist/constants/*.js"
   },
   "files": [
     "dist"
@@ -28,19 +30,47 @@
   "engines": {
     "node": ">=18.x"
   },
+  "peerDependencies": {
+    "prettier": "3.x.x",
+    "prettier-plugin-astro": "0.x.x",
+    "prettier-plugin-classnames": "0.x.x",
+    "prettier-plugin-merge": "0.x.x",
+    "prettier-plugin-tailwindcss": "0.x.x"
+  },
+  "peerDependenciesMeta": {
+    "prettier-plugin-astro": {
+      "optional": true
+    },
+    "prettier-plugin-classnames": {
+      "optional": true
+    },
+    "prettier-plugin-merge": {
+      "optional": true
+    },
+    "prettier-plugin-tailwindcss": {
+      "optional": true
+    }
+  },
   "dependencies": {
-    "@zayne-labs/toolkit-type-helpers": "^0.12.17"
+    "@antfu/install-pkg": "1.1.0",
+    "@clack/prompts": "0.11.0",
+    "@ianvs/prettier-plugin-sort-imports": "4.x.x",
+    "@zayne-labs/toolkit-type-helpers": "0.12.17",
+    "local-pkg": "1.1.2"
   },
   "devDependencies": {
-    "@arethetypeswrong/cli": "^0.18.2",
-    "@changesets/cli": "^2.29.8",
-    "@total-typescript/ts-reset": "^0.6.1",
-    "concurrently": "^9.2.1",
-    "cross-env": "^10.1.0",
-    "publint": "^0.3.16",
-    "tsdown": "^0.18.2",
+    "@total-typescript/ts-reset": "0.6.1",
+    "concurrently": "9.2.1",
+    "cross-env": "10.1.0",
+    "prettier": "3.7.4",
+    "prettier-plugin-astro": "0.14.1",
+    "prettier-plugin-classnames": "0.8.6",
+    "prettier-plugin-merge": "0.8.0",
+    "prettier-plugin-tailwindcss": "0.7.2",
+    "publint": "0.3.16",
+    "tsdown": "0.18.2",
     "typescript": "5.9.3",
-    "@zayne-labs/tsconfig": "0.11.7"
+    "@zayne-labs/tsconfig": "0.11.9"
   },
   "publishConfig": {
     "access": "public",