@zayne-labs/prettier-config 0.11.5 → 0.11.7

package/README.md

@@ -17,7 +17,7 @@ The package exports three configurations:
 Basic Prettier configuration without any plugins.
 
 ```js
-import { baseConfig } from '@zayne-labs/prettier-config';
+import { baseConfig } from "@zayne-labs/prettier-config";
 
 export default baseConfig;
 ```
@@ -26,15 +26,15 @@ export default baseConfig;
 
 ```js
 export default {
-  experimentalOperatorPosition: "start",
-  experimentalTernaries: true,
-  jsxSingleQuote: false,
-  printWidth: 107,
-  singleQuote: false,
-  tabWidth: 3,
-  trailingComma: "es5",
-  useTabs: true
-}
+	experimentalOperatorPosition: "start",
+	experimentalTernaries: true,
+	jsxSingleQuote: false,
+	printWidth: 107,
+	singleQuote: false,
+	tabWidth: 3,
+	trailingComma: "es5",
+	useTabs: true,
+};
 ```
 
 ### Tailwind Config
@@ -42,7 +42,7 @@ export default {
 Extended base configuration with Tailwind CSS support. Includes plugins for class sorting, merging, and formatting.
 
 ```js
-import { configWithTailwind } from '@zayne-labs/prettier-config';
+import { configWithTailwind } from "@zayne-labs/prettier-config";
 
 export default configWithTailwind;
 ```
@@ -70,7 +70,7 @@ pnpm add -D prettier-plugin-tailwindcss prettier-plugin-classnames prettier-plug
 Extended base configuration with Astro support.
 
 ```js
-import { configWithAstro } from '@zayne-labs/prettier-config';
+import { configWithAstro } from "@zayne-labs/prettier-config";
 
 export default configWithAstro;
 ```
@@ -86,12 +86,12 @@ pnpm add -D prettier-plugin-astro
 You can extend any configuration with your own options:
 
 ```js
-import { baseConfig } from '@zayne-labs/prettier-config';
+import { baseConfig } from "@zayne-labs/prettier-config";
 
 export default {
-  ...baseConfig,
-  printWidth: 120,
-  semi: true,
+	...baseConfig,
+	printWidth: 120,
+	semi: true,
 };
 ```
 

package/dist/index.d.ts

@@ -1,97 +1,197 @@
 import { AnyString } from "@zayne-labs/toolkit-type-helpers";
-import { Config } from "prettier";
+import { Config, Plugin } from "prettier";
 
-//#region src/configs.d.ts
-declare const baseConfig: {
-  experimentalOperatorPosition: "start";
-  experimentalTernaries: true;
-  jsxSingleQuote: false;
-  printWidth: 107;
-  singleQuote: false;
-  tabWidth: 3;
-  trailingComma: "es5";
-  useTabs: true;
-} & {
-  $inferUnion: "singleQuote" | "jsxSingleQuote" | "trailingComma" | "experimentalOperatorPosition" | "experimentalTernaries" | "printWidth" | "tabWidth" | "useTabs";
-};
-type ConfigWithTailwind = Omit<Config, "plugins"> & {
+//#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";
-  plugins?: Array<"prettier-plugin-tailwindcss" | "prettier-plugin-classnames" | "prettier-plugin-merge" | AnyString>;
+  /**
+   * 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}`;
 };
-/**
- * @description Prettier configuration with Tailwind CSS support.
- *
- * @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)
- */
-declare const configWithTailwind: {
-  customAttributes: ["classNames", "classes"];
-  customFunctions: ["cnMerge", "cnJoin", "cn", "tv", "tw"];
-  plugins: ["prettier-plugin-tailwindcss", "prettier-plugin-classnames", "prettier-plugin-merge"];
-  tailwindAttributes: ["classNames", "classes"];
-  tailwindFunctions: ["cnMerge", "cnJoin", "cn", "tv", "tw"];
-  tailwindStylesheet: "./tailwind.css";
-  experimentalOperatorPosition: "start";
-  experimentalTernaries: true;
-  jsxSingleQuote: false;
-  printWidth: 107;
-  singleQuote: false;
-  tabWidth: 3;
-  trailingComma: "es5";
-  useTabs: true;
-  $inferUnion: "singleQuote" | "jsxSingleQuote" | "trailingComma" | "experimentalOperatorPosition" | "experimentalTernaries" | "printWidth" | "tabWidth" | "useTabs";
-} & {
-  $inferUnion: "singleQuote" | "jsxSingleQuote" | "trailingComma" | "plugins" | "experimentalOperatorPosition" | "experimentalTernaries" | "printWidth" | "tabWidth" | "useTabs" | "$inferUnion" | "customAttributes" | "customFunctions" | "tailwindAttributes" | "tailwindFunctions" | "tailwindStylesheet";
-};
-type ConfigWithAstro = Omit<Config, "plugins"> & {
+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;
-  plugins?: Array<"prettier-plugin-astro" | AnyString>;
-};
-/**
- * @description Prettier configuration with Astro support.
- *
- * @docs [prettier-plugin-astro](https://github.com/withastro/prettier-plugin-astro#configuration)
- */
-declare const configWithAstro: {
-  overrides: [{
+  overrides?: Array<
+  /**
+   * @docs [prettier-plugin-astro#recommended-configuration](https://github.com/withastro/prettier-plugin-astro#recommended-configuration)
+   */
+  {
     files: "*.astro";
     options: {
       parser: "astro";
     };
-  }];
-  plugins: ["prettier-plugin-astro"];
-  experimentalOperatorPosition: "start";
-  experimentalTernaries: true;
-  jsxSingleQuote: false;
-  printWidth: 107;
-  singleQuote: false;
-  tabWidth: 3;
-  trailingComma: "es5";
-  useTabs: true;
-  $inferUnion: "singleQuote" | "jsxSingleQuote" | "trailingComma" | "experimentalOperatorPosition" | "experimentalTernaries" | "printWidth" | "tabWidth" | "useTabs";
-} & {
-  $inferUnion: "singleQuote" | "jsxSingleQuote" | "trailingComma" | "plugins" | "experimentalOperatorPosition" | "experimentalTernaries" | "printWidth" | "tabWidth" | "useTabs" | "$inferUnion" | "overrides";
+  } | 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;
+//#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;
+//#endregion
+//#region src/factory.d.ts
+/**
+ * @description Factory function for creating a customized Prettier configuration.
+ * Combines base, Astro, and Tailwind CSS configurations based on the provided options.
+ * Any Array values (like `plugins` and `overrides`) are merged, while other values are overwritten.
+ *
+ * @example
+ * ```ts
+ * // prettier.config.ts
+ * import { zayne } from "@zayne-labs/prettier-config";
+ *
+ * export default zayne(
+ *   {
+ *     base: true,
+ *     tailwindcss: { tailwindStylesheet: "./src/styles.css" },
+ *     astro: true,
+ *   },
+ *     // Extra config to merge (optional)
+ *   {
+ *     semi: false,
+ *   }
+ * );
+ * ```
+ */
+declare const zayne: (options?: OptionsPrettierConfig, ...extraConfigs: ResolvedPrettierConfig[]) => ResolvedPrettierConfig;
 //#endregion
-export { ConfigWithAstro, ConfigWithTailwind, baseConfig, configWithAstro, configWithTailwind };
+export { ExtractOptions, OptionsAstro, OptionsPrettierConfig, OptionsSortImports, OptionsTailwindCss, ResolvedPrettierConfig, astro, base, tailwindcss, zayne };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,63 +1,159 @@
-import { defineEnum, defineEnumDeep } from "@zayne-labs/toolkit-type-helpers";
+import { isArray, isObject } from "@zayne-labs/toolkit-type-helpers";
 
-//#region src/configs.ts
-const baseConfig = defineEnum({
-	experimentalOperatorPosition: "start",
-	experimentalTernaries: true,
-	jsxSingleQuote: false,
-	printWidth: 107,
-	singleQuote: false,
-	tabWidth: 3,
-	trailingComma: "es5",
-	useTabs: true
-});
+//#region src/configs/astro.ts
+const astro = (options) => {
+	return {
+		...options,
+		overrides: [{
+			files: "*.astro",
+			options: { parser: "astro" }
+		}, ...options.overrides ?? []],
+		plugins: ["prettier-plugin-astro", ...options.plugins ?? []]
+	};
+};
+
+//#endregion
+//#region src/configs/base.ts
+const base = (options) => {
+	return {
+		experimentalOperatorPosition: "start",
+		experimentalTernaries: true,
+		jsxSingleQuote: false,
+		printWidth: 107,
+		singleQuote: false,
+		tabWidth: 3,
+		trailingComma: "es5",
+		useTabs: true,
+		...options
+	};
+};
+
+//#endregion
+//#region src/configs/tailwindcss.ts
+const tailwindcss = (options) => {
+	return {
+		tailwindStylesheet: "./tailwind.css",
+		...options,
+		customAttributes: [
+			"classNames",
+			"classes",
+			...options.customAttributes ?? []
+		],
+		customFunctions: [
+			"cnMerge",
+			"cnJoin",
+			"cn",
+			"tv",
+			"tw",
+			...options.customFunctions ?? []
+		],
+		plugins: [
+			"prettier-plugin-tailwindcss",
+			"prettier-plugin-classnames",
+			...options.plugins ?? [],
+			"prettier-plugin-merge"
+		],
+		tailwindAttributes: [
+			"classNames",
+			"classes",
+			...options.tailwindAttributes ?? []
+		],
+		tailwindFunctions: [
+			"cnMerge",
+			"cnJoin",
+			"cn",
+			"tv",
+			"tw",
+			...options.tailwindFunctions ?? []
+		]
+	};
+};
+
+//#endregion
+//#region src/configs/sort.ts
+const sortImports = (options) => {
+	return {
+		...options,
+		importOrder: [
+			"^https?://",
+			"<BUILTIN_MODULES>",
+			"^(bun|jsr|npm):",
+			"<THIRD_PARTY_MODULES>",
+			"^(@/|[#~$%])",
+			"^(?!.*[.]css$)[./].*$",
+			...options.importOrder ?? [],
+			".css$"
+		],
+		importOrderSafeSideEffects: [".css$", ...options.importOrderSafeSideEffects ?? []],
+		plugins: ["@ianvs/prettier-plugin-sort-imports", ...options.plugins ?? []]
+	};
+};
+
+//#endregion
+//#region src/utils.ts
 /**
-* @description Prettier configuration with Tailwind CSS support.
-*
-* @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)
+* @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 configWithTailwind = defineEnumDeep({
-	...baseConfig,
-	customAttributes: ["classNames", "classes"],
-	customFunctions: [
-		"cnMerge",
-		"cnJoin",
-		"cn",
-		"tv",
-		"tw"
-	],
-	plugins: [
-		"prettier-plugin-tailwindcss",
-		"prettier-plugin-classnames",
-		"prettier-plugin-merge"
-	],
-	tailwindAttributes: ["classNames", "classes"],
-	tailwindFunctions: [
-		"cnMerge",
-		"cnJoin",
-		"cn",
-		"tv",
-		"tw"
-	],
-	tailwindStylesheet: "./tailwind.css"
-});
+const resolveOptions = (option) => {
+	return isObject(option) ? option : {};
+};
 /**
-* @description Prettier configuration with Astro support.
+* @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
+/**
+* @description Factory function for creating a customized Prettier configuration.
+* Combines base, Astro, and Tailwind CSS configurations based on the provided options.
+* Any Array values (like `plugins` and `overrides`) are merged, while other values are overwritten.
+*
+* @example
+* ```ts
+* // prettier.config.ts
+* import { zayne } from "@zayne-labs/prettier-config";
 *
-* @docs [prettier-plugin-astro](https://github.com/withastro/prettier-plugin-astro#configuration)
+* export default zayne(
+*   {
+*     base: true,
+*     tailwindcss: { tailwindStylesheet: "./src/styles.css" },
+*     astro: true,
+*   },
+*     // Extra config to merge (optional)
+*   {
+*     semi: false,
+*   }
+* );
+* ```
 */
-const configWithAstro = defineEnumDeep({
-	...baseConfig,
-	overrides: [{
-		files: "*.astro",
-		options: { parser: "astro" }
-	}],
-	plugins: ["prettier-plugin-astro"]
-});
+const zayne = (options = {}, ...extraConfigs) => {
+	const { astro: enabledAstro = false, base: enabledBase = true, sortImports: enabledSortImports = false, tailwindcss: enabledTailwindcss = false } = options;
+	const configArray = [
+		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 { baseConfig, configWithAstro, configWithTailwind };
+export { astro, base, tailwindcss, zayne };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/configs.ts"],"sourcesContent":["import { type AnyString, defineEnum, defineEnumDeep } from \"@zayne-labs/toolkit-type-helpers\";\nimport type { Config } from \"prettier\";\n\nexport const baseConfig = defineEnum({\n\texperimentalOperatorPosition: \"start\",\n\texperimentalTernaries: true,\n\tjsxSingleQuote: false,\n\tprintWidth: 107,\n\tsingleQuote: false,\n\ttabWidth: 3,\n\ttrailingComma: \"es5\",\n\tuseTabs: true,\n}) satisfies Config;\n\nexport type ConfigWithTailwind = Omit<Config, \"plugins\"> & {\n\t/**\n\t * @docs [prettier-plugin-classnames#custom-attributes](https://github.com/ony3000/prettier-plugin-classnames#custom-attributes)\n\t */\n\tcustomAttributes?: string[];\n\t/**\n\t * @docs [prettier-plugin-classnames#custom-functions](https://github.com/ony3000/prettier-plugin-classnames#custom-functions)\n\t */\n\tcustomFunctions?: string[];\n\t/**\n\t * @docs [prettier-plugin-classnames#ending-position](https://github.com/ony3000/prettier-plugin-classnames#ending-position)\n\t */\n\tendPosition?: \"absolute\" | \"relative\";\n\tplugins?: Array<\n\t\t// eslint-disable-next-line perfectionist/sort-union-types -- prettier-plugin-tailwindcss should come before prettier-plugin-classnames\n\t\t\"prettier-plugin-tailwindcss\" | \"prettier-plugin-classnames\" | \"prettier-plugin-merge\" | AnyString\n\t>;\n\ttailwindAttributes?: string[];\n\ttailwindConfig?: `./${string}`;\n\ttailwindFunctions?: string[];\n\ttailwindPreserveDuplicates?: boolean;\n\ttailwindPreserveWhitespace?: boolean;\n\ttailwindStylesheet?: `./${string}`;\n};\n\n/**\n * @description Prettier configuration with Tailwind CSS support.\n *\n * @docs\n *  - [prettier-plugin-tailwindcss](https://github.com/tailwindlabs/prettier-plugin-tailwindcss)\n *  - [prettier-plugin-classnames](https://github.com/ony3000/prettier-plugin-classnames)\n *  - [prettier-plugin-merge](https://github.com/ony3000/prettier-plugin-merge)\n */\nexport const configWithTailwind = defineEnumDeep({\n\t...baseConfig,\n\n\tcustomAttributes: [\"classNames\", \"classes\"],\n\tcustomFunctions: [\"cnMerge\", \"cnJoin\", \"cn\", \"tv\", \"tw\"],\n\tplugins: [\"prettier-plugin-tailwindcss\", \"prettier-plugin-classnames\", \"prettier-plugin-merge\"],\n\ttailwindAttributes: [\"classNames\", \"classes\"],\n\ttailwindFunctions: [\"cnMerge\", \"cnJoin\", \"cn\", \"tv\", \"tw\"],\n\ttailwindStylesheet: \"./tailwind.css\",\n}) satisfies ConfigWithTailwind;\n\nexport type ConfigWithAstro = Omit<Config, \"plugins\"> & {\n\tastroAllowShorthand?: boolean;\n\tastroSkipFrontmatter?: boolean;\n\tplugins?: Array<\"prettier-plugin-astro\" | AnyString>;\n};\n\n/**\n * @description Prettier configuration with Astro support.\n *\n * @docs [prettier-plugin-astro](https://github.com/withastro/prettier-plugin-astro#configuration)\n */\n\nexport const configWithAstro = defineEnumDeep({\n\t...baseConfig,\n\n\toverrides: [\n\t\t{\n\t\t\tfiles: \"*.astro\",\n\t\t\toptions: {\n\t\t\t\tparser: \"astro\",\n\t\t\t},\n\t\t},\n\t],\n\tplugins: [\"prettier-plugin-astro\"],\n}) satisfies ConfigWithAstro;\n"],"mappings":";;;AAGA,MAAa,aAAa,WAAW;CACpC,8BAA8B;CAC9B,uBAAuB;CACvB,gBAAgB;CAChB,YAAY;CACZ,aAAa;CACb,UAAU;CACV,eAAe;CACf,SAAS;CACT,CAAC;;;;;;;;;AAmCF,MAAa,qBAAqB,eAAe;CAChD,GAAG;CAEH,kBAAkB,CAAC,cAAc,UAAU;CAC3C,iBAAiB;EAAC;EAAW;EAAU;EAAM;EAAM;EAAK;CACxD,SAAS;EAAC;EAA+B;EAA8B;EAAwB;CAC/F,oBAAoB,CAAC,cAAc,UAAU;CAC7C,mBAAmB;EAAC;EAAW;EAAU;EAAM;EAAM;EAAK;CAC1D,oBAAoB;CACpB,CAAC;;;;;;AAcF,MAAa,kBAAkB,eAAe;CAC7C,GAAG;CAEH,WAAW,CACV;EACC,OAAO;EACP,SAAS,EACR,QAAQ,SACR;EACD,CACD;CACD,SAAS,CAAC,wBAAwB;CAClC,CAAC"}
+{"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zayne-labs/prettier-config",
   "type": "module",
-  "version": "0.11.5",
+  "version": "0.11.7",
   "description": "Zayne Labs' Prettier config",
   "author": "Ryan Zayne",
   "license": "MIT",
@@ -29,18 +29,18 @@
     "node": ">=18.x"
   },
   "dependencies": {
-    "@zayne-labs/toolkit-type-helpers": "^0.12.12"
+    "@zayne-labs/toolkit-type-helpers": "^0.12.17"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
-    "@changesets/cli": "^2.29.7",
+    "@changesets/cli": "^2.29.8",
     "@total-typescript/ts-reset": "^0.6.1",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",
-    "publint": "^0.3.15",
-    "tsdown": "^0.16.0",
+    "publint": "^0.3.16",
+    "tsdown": "^0.18.2",
     "typescript": "5.9.3",
-    "@zayne-labs/tsconfig": "0.11.5"
+    "@zayne-labs/tsconfig": "0.11.7"
   },
   "publishConfig": {
     "access": "public",