@alessiofrittoli/package-configs 0.1.0

package/README.md

@@ -0,0 +1,616 @@
+<h1 align="center">Package configs ⚙️</h1>
+<p align="center">
+  Handle package configuration with ease
+</p>
+<p align="center">
+  <a href="https://npmjs.org/package/@alessiofrittoli/package-configs">
+    <img src="https://img.shields.io/npm/v/@alessiofrittoli/package-configs" alt="Latest version"/>
+  </a>
+  <a href="https://coveralls.io/github/alessiofrittoli/package-configs">
+    <img src="https://coveralls.io/repos/github/alessiofrittoli/package-configs/badge.svg" alt="Test coverage"/>
+  </a>
+  <a href="https://socket.dev/npm/package/@alessiofrittoli/package-configs/overview">
+    <img src="https://socket.dev/api/badge/npm/package/@alessiofrittoli/package-configs" alt="Socket Security score"/>
+  </a>
+  <a href="https://npmjs.org/package/@alessiofrittoli/package-configs">
+    <img src="https://img.shields.io/npm/dm/@alessiofrittoli/package-configs.svg" alt="npm downloads"/>
+  </a>
+  <a href="https://bundlephobia.com/package/@alessiofrittoli/package-configs">
+    <img src="https://badgen.net/bundlephobia/dependency-count/@alessiofrittoli/package-configs" alt="Dependencies"/>
+  </a>
+  <a href="https://libraries.io/npm/%40alessiofrittoli%2Fpackage-configs">
+    <img src="https://img.shields.io/librariesio/release/npm/@alessiofrittoli/package-configs" alt="Dependencies status"/>
+  </a>
+</p>
+<p align="center">
+  <a href="https://bundlephobia.com/package/@alessiofrittoli/package-configs">
+    <img src="https://badgen.net/bundlephobia/min/@alessiofrittoli/package-configs" alt="minified"/>
+  </a>
+  <a href="https://bundlephobia.com/package/@alessiofrittoli/package-configs">
+    <img src="https://badgen.net/bundlephobia/minzip/@alessiofrittoli/package-configs" alt="minizipped"/>
+  </a>
+  <a href="https://bundlephobia.com/package/@alessiofrittoli/package-configs">
+    <img src="https://badgen.net/bundlephobia/tree-shaking/@alessiofrittoli/package-configs" alt="Tree shakable"/>
+  </a>
+</p>
+<p align="center">
+  <a href="https://github.com/sponsors/alessiofrittoli">
+    <img src="https://img.shields.io/static/v1?label=Fund%20this%20package&message=%E2%9D%A4&logo=GitHub&color=%23DB61A2" alt="Fund this package"/>
+  </a>
+</p>
+
+[sponsor-badge]: https://img.shields.io/static/v1?label=Fund%20this%20package&message=%E2%9D%A4&logo=GitHub&color=%23DB61A2
+[sponsor-url]: https://github.com/sponsors/alessiofrittoli
+
+## Table of Content
+
+- [Development](#development)
+  - [Local development](#local-development)
+  - [Production build](#production-build)
+  - [Unit tests](#unit-tests)
+  - [Run tests with coverage](#run-tests-with-coverage)
+  - [Contributing](#contributing)
+- [API Reference](#api-reference)
+  - [TypeScript configurations](#typescript-configurations)
+    - [TypeScript configurations files](#typescript-configurations-files)
+    - [TypeScript utility functions](#typescript-utility-functions)
+  - [ESlint configurations](#eslint-configurations)
+  - [Oxlint configurations](#oxlint-configurations)
+  - [Prettier configurations](#prettier-configurations)
+  - [Tsdown configurations](#tsdown-configurations)
+  - [Vite configurations](#vite-configurations)
+  - [Markdownlint configurations](#markdownlint-configurations)
+
+---
+
+## Development
+
+Run the following to start development
+
+```shell
+nvm use
+
+pnpm i
+```
+
+### Local development
+
+Run the following
+
+```shell
+pnpm dev
+```
+
+This will generate unminified output code, sourcemaps and will enable source file watcher.
+
+---
+
+### Production build
+
+Run the following to create a local production build
+
+```shell
+pnpm build
+```
+
+This will generate minified output code without sourcemaps.
+
+---
+
+### Unit tests
+
+Run all the defined test suites by running the following:
+
+```shell
+# Run tests and watch file changes.
+pnpm test:watch
+
+# Run tests in a CI environment.
+pnpm test:ci
+```
+
+---
+
+#### Run tests with coverage
+
+An HTTP server is then started to serve coverage files from `./coverage` folder.
+
+⚠️ You may see a blank page the first time you run this command. Simply refresh the browser to see the updates.
+
+```shell
+pnpm test:coverage:serve
+```
+
+---
+
+### Contributing
+
+Contributions are truly welcome!
+
+Please refer to the [Contributing Doc](./CONTRIBUTING.md) for more information on how to start contributing to this project.
+
+Help keep this project up to date with [GitHub Sponsor][sponsor-url].
+
+[![GitHub Sponsor][sponsor-badge]][sponsor-url]
+
+---
+
+### Security
+
+If you believe you have found a security vulnerability, we encourage you to **_responsibly disclose this and NOT open a public issue_**. We will investigate all legitimate reports. Email `security@alessiofrittoli.it` to disclose any security vulnerabilities.
+
+---
+
+## API Reference
+
+### TypeScript configurations
+
+This project exports different configurations JSON files as well as some utility functions that you might need in your projects.
+
+#### TypeScript configurations files
+
+<details>
+
+<summary style="cursor:pointer">Base configuration file</summary>
+
+This file is intended for `base` processes and it mainly contains all the required configuration for your IDE too.
+
+```json
+{
+  "extends": "@alessiofrittoli/package-configs/tsconfig/base.json",
+  "compilerOptions": {
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}
+```
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">React bundler configuration file</summary>
+
+```json
+{
+  "extends": "@alessiofrittoli/package-configs/tsconfig/react-bundler.json"
+}
+```
+
+</details>
+
+---
+
+#### TypeScript utility functions
+
+##### `parseTsConfig()`
+
+Parse TypeScript configuration file.
+
+<details>
+
+<summary style="cursor:pointer">Parameters</summary>
+
+| Parameter         | Type                  | Default             | Description                                        |
+| ----------------- | --------------------- | ------------------- | -------------------------------------------------- |
+| `params`          | `ParseTsConfigParams` | `{}`                | (Optional) An object defining required parameters. |
+| `params.filepath` | `string`              | `"./tsconfig.json"` | (Optional) The TypeScript configuration file path. |
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Throws</summary>
+
+Throws an `Error` if the resolved `filepath` does not exists.
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Returns</summary>
+
+Type: `ParsedCommandLine`
+
+The parsed TypeScript configuration file.
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Examples</summary>
+
+```ts
+import { parseTsConfig } from '@alessiofrittoli/package-configs/tsconfig'
+
+const parsedTsConfig = parseTsConfig({ filepath: './tsconfig.build.json' })
+```
+
+</details>
+
+---
+
+##### `getTSConfigCompilerTarget()`
+
+Get TypeScript compiler target from resolved configuration file.
+
+<details>
+
+<summary style="cursor:pointer">Parameters</summary>
+
+| Parameter         | Type                  | Default             | Description                                        |
+| ----------------- | --------------------- | ------------------- | -------------------------------------------------- |
+| `params`          | `ParseTsConfigParams` | `{}`                | (Optional) An object defining required parameters. |
+| `params.filepath` | `string`              | `"./tsconfig.json"` | (Optional) The TypeScript configuration file path. |
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Returns</summary>
+
+Type: `string | undefined`
+
+The resolved TypeScript compiler target if any, `undefined` otherwise.
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Examples</summary>
+
+```ts
+import { getTSConfigCompilerTarget } from '@alessiofrittoli/package-configs/tsconfig'
+
+const compilerTarget = getTSConfigCompilerTarget({
+  filepath: './tsconfig.build.json',
+})
+```
+
+</details>
+
+---
+
+### ESlint configurations
+
+#### `eslintConfig()`
+
+Get `ESLint` base configuration.
+
+<details>
+
+<summary style="cursor:pointer">Parameters</summary>
+
+| Parameter | Type                | Description                       |
+| --------- | ------------------- | --------------------------------- |
+| `configs` | `LinterConfigArray` | (Optional) Custom configurations. |
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Returns</summary>
+
+Type: `LinterConfigArray`
+
+The ESLint configuration array.
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Examples</summary>
+
+```ts
+// my-project/eslint.config.ts
+import { eslintConfig } from "@alessiofrittoli/package-configs/eslint";
+
+export default eslintConfig( {...}, {...} );
+```
+
+</details>
+
+---
+
+### Oxlint configurations
+
+#### `oxlintConfig()`
+
+Get `Oxlint` base configuration.
+
+<details>
+
+<summary style="cursor:pointer">Parameters</summary>
+
+| Parameter | Type               | Description                       |
+| --------- | ------------------ | --------------------------------- |
+| `configs` | `T & OxlintConfig` | (Optional) Custom configurations. |
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Returns</summary>
+
+Type: `OxlintConfig`
+
+The Oxlint configuration.
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Examples</summary>
+
+```ts
+// my-project/oxlint.config.ts
+import { oxlintConfig } from "@alessiofrittoli/package-configs/oxlint";
+
+export default oxlintConfig( {...} );
+```
+
+</details>
+
+---
+
+### Prettier configurations
+
+#### `prettierConfig()`
+
+Get `Prettier` base configuration.
+
+<details>
+
+<summary style="cursor:pointer">Parameters</summary>
+
+| Parameter | Type             | Description                       |
+| --------- | ---------------- | --------------------------------- |
+| `configs` | `PrettierConfig` | (Optional) Custom configurations. |
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Returns</summary>
+
+Type: `PrettierConfig`
+
+The Prettier configuration.
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Examples</summary>
+
+```ts
+// my-project/prettier.config.ts
+import { prettierConfig } from "@alessiofrittoli/package-configs/prettier";
+
+export default prettierConfig( {...} );
+```
+
+</details>
+
+---
+
+### Tsdown configurations
+
+#### `tsdownConfig()`
+
+Get `tsdown` base configuration.
+
+<details>
+
+<summary style="cursor:pointer">Parameters</summary>
+
+| Parameter | Type                       | Description                                                                                               |
+| --------- | -------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `options` | `UserConfig\|UserConfigFn` | (Optional) An object defining custom options or a callable function that returns a custom options object. |
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Returns</summary>
+
+Type: `UserConfigFn`
+
+A callable function executed by `tsdown` processes.
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Default configurations</summary>
+
+| Property           | Value                    |
+| ------------------ | ------------------------ |
+| `entry`            | `["src/**\/index.ts"]`   |
+| `format`           | `["cjs", "esm"]`         |
+| `dts`              | `true`                   |
+| `shims`            | `true`                   |
+| `clean`            | `true`                   |
+| `treeshake`        | `true`                   |
+| `minify`           | `!watch`                 |
+| `sourcemap`        | `!!watch`                |
+| `target`           | resolved tsconfig target |
+| `deps`             | `{ ... }`                |
+| `deps.neverBundle` | `true`                   |
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Examples</summary>
+
+```ts
+// my-project/tsdown.config.ts
+
+import { tsdownConfig } from '@alessiofrittoli/package-configs/tsdown'
+import { join, resolve } from 'path'
+
+const tsConfigFile = 'tsconfig.build.json'
+
+export default tsdownConfig(({ outDir = 'example-custom-directory' }) => ({
+  tsconfig: resolve(process.cwd(), tsConfigFile),
+  outDir,
+  copy: [
+    {
+      from: 'src/assets',
+      to: join(outDir, 'assets'),
+    },
+  ],
+}))
+```
+
+</details>
+
+---
+
+### Vite configurations
+
+#### `viteConfig()`
+
+Get `vite` base configuration.
+
+<details>
+
+<summary style="cursor:pointer">Parameters</summary>
+
+| Parameter | Type         | Description                                                      |
+| --------- | ------------ | ---------------------------------------------------------------- |
+| `options` | `UserConfig` | (Optional) An object defining custom Vite configuration options. |
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Returns</summary>
+
+Type: `UserConfigFnObject`
+
+An object with base and custom Vite configuration options.
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Default configurations</summary>
+
+| Property                | Value                                                         |
+| ----------------------- | ------------------------------------------------------------- |
+| `resolve.tsconfigPaths` | `true`                                                        |
+| `test.reporters`        | `["tree"]\|[]` based on `VITEST_VSCODE` environment variable. |
+| `test.coverage.exclude` | `["**/*.mock.ts", "**/__tests__/**/*.mock.ts"]`               |
+
+</details>
+
+---
+
+<details>
+
+<summary style="cursor:pointer">Examples</summary>
+
+```ts
+// my-project/vite.config.ts
+
+/// <reference types="vitest/config" />
+import { viteConfig } from "@alessiofrittoli/package-configs/vite";
+
+export default viteConfig( {...} )
+```
+
+</details>
+
+---
+
+### Markdownlint configurations
+
+To help you having a better DX while writing markdown documentations this library provides you a set of base linting rules.
+
+Simply create a `.markdownlint.json` file at the root of your project and configure it like so:
+
+```json
+{
+  "extends": "@alessiofrittoli/package-configs/markdown/base.json"
+}
+```
+
+> [!WARNING]
+>
+> The imported `base.json` uses `https://raw.githubusercontent.com/DavidAnson/markdownlint/v0.41.0/schema/markdownlint-config-schema.json` as schema so make sure to add the following setting in your user/project JSON settings file:
+>
+> ```json
+> {
+>   "json.schemaDownload.trustedDomains": {
+>     "https://raw.githubusercontent.com/DavidAnson/markdownlint/": true
+>   }
+> }
+> ```
+
+### Made with ☕
+
+<table style='display:flex;gap:20px;'>
+  <tbody>
+    <tr>
+      <td>
+        <img alt="avatar" src='https://avatars.githubusercontent.com/u/35973186' style='width:60px;border-radius:50%;object-fit:contain;'>
+      </td>
+      <td>
+        <table style='display:flex;gap:2px;flex-direction:column;'>
+          <tbody>
+              <tr>
+                <td>
+                  <a href='https://github.com/alessiofrittoli' target='_blank' rel='noopener'>Alessio Frittoli</a>
+                </td>
+              </tr>
+              <tr>
+                <td>
+                  <small>
+                    <a href='https://alessiofrittoli.it' target='_blank' rel='noopener'>https://alessiofrittoli.it</a> |
+                    <a href='mailto:info@alessiofrittoli.it' target='_blank' rel='noopener'>info@alessiofrittoli.it</a>
+                  </small>
+                </td>
+              </tr>
+          </tbody>
+        </table>
+      </td>
+    </tr>
+  </tbody>
+</table>

package/dist/eslint/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../standard-BgmRUkms.cjs"),t=(...t)=>[...e.t,...t];exports.eslintConfig=t;

package/dist/eslint/index.d.cts

@@ -0,0 +1,13 @@
+import { Linter } from "eslint";
+//#region src/eslint/index.d.ts
+export type LinterConfig = Linter.Config;
+export type LinterConfigArray = LinterConfig[];
+/**
+ * Get `ESLint` base configuration.
+ *
+ * @param configs (Optional) Custom configurations.
+ *
+ * @returns The ESLint configuration array.
+ */
+export declare const eslintConfig: (...configs: LinterConfigArray) => LinterConfigArray;
+//#endregion

package/dist/eslint/index.d.mts

@@ -0,0 +1,13 @@
+import { Linter } from "eslint";
+//#region src/eslint/index.d.ts
+export type LinterConfig = Linter.Config;
+export type LinterConfigArray = LinterConfig[];
+/**
+ * Get `ESLint` base configuration.
+ *
+ * @param configs (Optional) Custom configurations.
+ *
+ * @returns The ESLint configuration array.
+ */
+export declare const eslintConfig: (...configs: LinterConfigArray) => LinterConfigArray;
+//#endregion

package/dist/eslint/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"../standard-9H_vBPqI.mjs";const t=(...t)=>[...e,...t];export{t as eslintConfig};

package/dist/eslint/profiles/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../standard-BgmRUkms.cjs");exports.standardProfile=e.t;

package/dist/eslint/profiles/index.d.cts

@@ -0,0 +1,8 @@
+import { Linter } from "eslint";
+//#region src/eslint/profiles/standard.d.ts
+/**
+ * `ESLint` standard profile.
+ *
+ */
+export declare const standardProfile: Linter.Config[];
+//#endregion

package/dist/eslint/profiles/index.d.mts

@@ -0,0 +1,8 @@
+import { Linter } from "eslint";
+//#region src/eslint/profiles/standard.d.ts
+/**
+ * `ESLint` standard profile.
+ *
+ */
+export declare const standardProfile: Linter.Config[];
+//#endregion

package/dist/eslint/profiles/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"../../standard-9H_vBPqI.mjs";export{e as standardProfile};

package/dist/markdown/configs/base.json

@@ -0,0 +1,6 @@
+{
+	"$schema": "https://raw.githubusercontent.com/DavidAnson/markdownlint/v0.41.0/schema/markdownlint-config-schema.json",
+	"line-length": false,
+	"no-hard-tabs": false,
+	"no-inline-html": false
+}

package/dist/oxlint/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../standard-BaghAlFU.cjs");let t=require("oxlint");const{categories:n,rules:r,plugins:i}=e.t,a=e=>{let a=[...i||[],...e?.plugins||[]];return(0,t.defineConfig)({...e,categories:{...n,...e?.categories},plugins:a.length>0?a:void 0,rules:{...r,...e?.rules}})};exports.oxlintConfig=a;

package/dist/oxlint/index.d.cts

@@ -0,0 +1,21 @@
+import { OxlintConfig, OxlintConfig as OxlintConfig$1, defineConfig } from "oxlint";
+//#region src/oxlint/index.d.ts
+export type LintPlugins = OxlintConfig$1['plugins'];
+/**
+ * Get `Oxlint` base configuration.
+ *
+ * @param configs (Optional) Custom configurations.
+ *
+ * @returns The Oxlint configuration array.
+ *
+ * [Oxlint Reference](https://oxc.rs/docs/guide/usage/linter/config.html#typescript-config)
+ *
+ * [Oxlint Rules Reference](https://oxc.rs/docs/guide/usage/linter/rules)
+ *
+ * [Oxlint Plugins Reference](https://oxc.rs/docs/guide/usage/linter/config.html#configure-plugins)
+ *
+ * [Oxlint Supported Plugins](https://oxc.rs/docs/guide/usage/linter/plugins.html#supported-plugins)
+ */
+export declare const oxlintConfig: <T extends OxlintConfig$1>(configs?: T & OxlintConfig$1) => ReturnType<typeof defineConfig>;
+//#endregion
+export type { OxlintConfig };

package/dist/oxlint/index.d.mts

@@ -0,0 +1,21 @@
+import { OxlintConfig, OxlintConfig as OxlintConfig$1, defineConfig } from "oxlint";
+//#region src/oxlint/index.d.ts
+export type LintPlugins = OxlintConfig$1['plugins'];
+/**
+ * Get `Oxlint` base configuration.
+ *
+ * @param configs (Optional) Custom configurations.
+ *
+ * @returns The Oxlint configuration array.
+ *
+ * [Oxlint Reference](https://oxc.rs/docs/guide/usage/linter/config.html#typescript-config)
+ *
+ * [Oxlint Rules Reference](https://oxc.rs/docs/guide/usage/linter/rules)
+ *
+ * [Oxlint Plugins Reference](https://oxc.rs/docs/guide/usage/linter/config.html#configure-plugins)
+ *
+ * [Oxlint Supported Plugins](https://oxc.rs/docs/guide/usage/linter/plugins.html#supported-plugins)
+ */
+export declare const oxlintConfig: <T extends OxlintConfig$1>(configs?: T & OxlintConfig$1) => ReturnType<typeof defineConfig>;
+//#endregion
+export type { OxlintConfig };

package/dist/oxlint/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"../standard-DKXaHXIw.mjs";import{defineConfig as t}from"oxlint";const{categories:n,rules:r,plugins:i}=e,a=e=>{let a=[...i||[],...e?.plugins||[]];return t({...e,categories:{...n,...e?.categories},plugins:a.length>0?a:void 0,rules:{...r,...e?.rules}})};export{a as oxlintConfig};

package/dist/oxlint/profiles/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../standard-BaghAlFU.cjs");exports.standardProfile=e.t;

package/dist/oxlint/profiles/index.d.cts

@@ -0,0 +1,4 @@
+import { OxlintConfig } from "oxlint";
+//#region src/oxlint/profiles/standard.d.ts
+export declare const standardProfile: OxlintConfig;
+//#endregion

package/dist/oxlint/profiles/index.d.mts

@@ -0,0 +1,4 @@
+import { OxlintConfig } from "oxlint";
+//#region src/oxlint/profiles/standard.d.ts
+export declare const standardProfile: OxlintConfig;
+//#endregion

package/dist/oxlint/profiles/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"../../standard-DKXaHXIw.mjs";export{e as standardProfile};

package/dist/prettier/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../standard-6L5tOVhX.cjs"),t=t=>({...e.t,...t});exports.prettierConfig=t;

package/dist/prettier/index.d.cts

@@ -0,0 +1,12 @@
+import { Config, Config as PrettierConfig } from "prettier";
+//#region src/prettier/index.d.ts
+/**
+ * Get `Prettier` base configuration.
+ *
+ * @param configs (Optional) Custom configurations.
+ *
+ * @returns The Prettier configuration array.
+ */
+export declare const prettierConfig: (configs?: Config) => Config;
+//#endregion
+export type { PrettierConfig };

package/dist/prettier/index.d.mts

@@ -0,0 +1,12 @@
+import { Config, Config as PrettierConfig } from "prettier";
+//#region src/prettier/index.d.ts
+/**
+ * Get `Prettier` base configuration.
+ *
+ * @param configs (Optional) Custom configurations.
+ *
+ * @returns The Prettier configuration array.
+ */
+export declare const prettierConfig: (configs?: Config) => Config;
+//#endregion
+export type { PrettierConfig };

package/dist/prettier/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"../standard-CRskCPOC.mjs";const t=t=>({...e,...t});export{t as prettierConfig};

package/dist/prettier/profiles/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../standard-6L5tOVhX.cjs");exports.standardProfile=e.t;

package/dist/prettier/profiles/index.d.cts

@@ -0,0 +1,4 @@
+import { Config } from "prettier";
+//#region src/prettier/profiles/standard.d.ts
+export declare const standardProfile: Config;
+//#endregion

package/dist/prettier/profiles/index.d.mts

@@ -0,0 +1,4 @@
+import { Config } from "prettier";
+//#region src/prettier/profiles/standard.d.ts
+export declare const standardProfile: Config;
+//#endregion

package/dist/prettier/profiles/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"../../standard-CRskCPOC.mjs";export{e as standardProfile};

package/dist/standard-6L5tOVhX.cjs

@@ -0,0 +1 @@
+const e={useTabs:!0,tabWidth:4,endOfLine:`lf`,printWidth:110,semi:!1,singleQuote:!0,jsxSingleQuote:!0,trailingComma:`all`,bracketSameLine:!1,arrowParens:`avoid`,bracketSpacing:!0,embeddedLanguageFormatting:`auto`,htmlWhitespaceSensitivity:`css`,proseWrap:`preserve`,quoteProps:`as-needed`,tailwindFunctions:[`clsx`],plugins:[`./node_modules/prettier-plugin-sort-imports/dist/index.js`],overrides:[{files:[`*.md`,`*.yml`,`*.yaml`],options:{useTabs:!1,tabWidth:2}}]};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return e}});

package/dist/standard-9H_vBPqI.mjs

@@ -0,0 +1 @@
+import e from"typescript-eslint";import t from"@eslint/js";import n from"globals";const r=[{languageOptions:{globals:{...n.browser,...n.node}}},t.configs.recommended,...e.configs.recommended,{ignores:[`**/dist/*`,`**/coverage/*`,`.vscode`]},{rules:{"@typescript-eslint/no-namespace":`off`,"@typescript-eslint/consistent-type-imports":`warn`}}];export{r as t};

package/dist/standard-BaghAlFU.cjs

@@ -0,0 +1 @@
+const e={categories:{correctness:`warn`},plugins:[`eslint`,`typescript`,`unicorn`,`oxc`],rules:{"eslint/no-unused-vars":`error`,"prefer-const":[`error`,{ignoreReadBeforeAssign:!0}],"typescript/explicit-function-return-type":`error`,"typescript/consistent-type-imports":`warn`}};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return e}});

package/dist/standard-BgmRUkms.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,s)=>(s=n==null?{}:e(i(n)),o(r||!n||!n.__esModule||!a.call(n,`default`)?t(s,`default`,{value:n,enumerable:!0}):s,n));let c=require("typescript-eslint");c=s(c,1);let l=require("@eslint/js");l=s(l,1);let u=require("globals");u=s(u,1);const d=[{languageOptions:{globals:{...u.default.browser,...u.default.node}}},l.default.configs.recommended,...c.default.configs.recommended,{ignores:[`**/dist/*`,`**/coverage/*`,`.vscode`]},{rules:{"@typescript-eslint/no-namespace":`off`,"@typescript-eslint/consistent-type-imports":`warn`}}];Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return d}});

package/dist/standard-CRskCPOC.mjs

@@ -0,0 +1 @@
+const e={useTabs:!0,tabWidth:4,endOfLine:`lf`,printWidth:110,semi:!1,singleQuote:!0,jsxSingleQuote:!0,trailingComma:`all`,bracketSameLine:!1,arrowParens:`avoid`,bracketSpacing:!0,embeddedLanguageFormatting:`auto`,htmlWhitespaceSensitivity:`css`,proseWrap:`preserve`,quoteProps:`as-needed`,tailwindFunctions:[`clsx`],plugins:[`./node_modules/prettier-plugin-sort-imports/dist/index.js`],overrides:[{files:[`*.md`,`*.yml`,`*.yaml`],options:{useTabs:!1,tabWidth:2}}]};export{e as t};

package/dist/standard-DKXaHXIw.mjs

@@ -0,0 +1 @@
+const e={categories:{correctness:`warn`},plugins:[`eslint`,`typescript`,`unicorn`,`oxc`],rules:{"eslint/no-unused-vars":`error`,"prefer-const":[`error`,{ignoreReadBeforeAssign:!0}],"typescript/explicit-function-return-type":`error`,"typescript/consistent-type-imports":`warn`}};export{e as t};

package/dist/tsconfig/configs/base.json

@@ -0,0 +1,28 @@
+{
+	"$schema": "https://json.schemastore.org/tsconfig",
+	"exclude": ["*/**/dist"],
+	"compilerOptions": {
+		"target": "es2022",
+		"strict": true,
+		"noEmit": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"forceConsistentCasingInFileNames": true,
+		"allowJs": false,
+		"exactOptionalPropertyTypes": false,
+		"noFallthroughCasesInSwitch": true,
+		"noImplicitAny": true,
+		"noImplicitOverride": true,
+		"noImplicitThis": true,
+		"noPropertyAccessFromIndexSignature": true,
+		"preserveConstEnums": true,
+		"resolveJsonModule": true,
+		"strictFunctionTypes": true,
+		"strictNullChecks": true,
+		"strictPropertyInitialization": true,
+		"noUncheckedSideEffectImports": true,
+		"libReplacement": false,
+		"allowSyntheticDefaultImports": true,
+		"allowImportingTsExtensions": true
+	}
+}

package/dist/tsconfig/configs/react-bundler.json

@@ -0,0 +1,14 @@
+{
+	"$schema": "https://json.schemastore.org/tsconfig",
+	"extends": "./base.json",
+	"compilerOptions": {
+		"lib": ["dom", "dom.iterable", "esnext"],
+		"module": "es2022",
+		"moduleResolution": "bundler",
+		"target": "es6",
+
+		"isolatedModules": true,
+		"jsx": "react-jsx",
+		"types": ["react"]
+	}
+}

package/dist/tsconfig/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("typescript"),t=require("path"),n=require("fs");const r=(r={})=>{let{filepath:i=(0,t.resolve)(process.cwd(),`tsconfig.json`)}=r;if(!(0,n.existsSync)(i))throw Error(`No configuration file found.`,{cause:{filepath:i}});let a=(0,t.parse)(i).dir,o=(0,e.readConfigFile)(i,e.sys.readFile);return(0,e.parseJsonConfigFileContent)(o.config,e.sys,a)},i=t=>{try{let n=r(t).options.target;return n?n===e.ScriptTarget.Latest?`esnext`:e.ScriptTarget[n]?.toLowerCase():void 0}catch(e){console.error(e)}};exports.getTSConfigCompilerTarget=i,exports.parseTsConfig=r;

package/dist/tsconfig/index.d.cts

@@ -0,0 +1,29 @@
+import { ParsedCommandLine } from "typescript";
+//#region src/tsconfig/index.d.ts
+export interface ParseTsConfigParams {
+  /**
+   * The TypeScript configuration file path.
+   *
+   * @default './tsconfig.json'
+   */
+  filepath?: string;
+}
+/**
+ * Parse TypeScript configuration file.
+ *
+ * @param params An object defining required parameters. See {@link ParseTsConfigParams} for more info.
+ *
+ * @returns The parsed TypeScript configuration file.
+ *
+ * @throws {Error} if the resolved `filepath` does not exists.
+ */
+export declare const parseTsConfig: (params?: ParseTsConfigParams) => ParsedCommandLine;
+/**
+ * Get TypeScript compiler target from resolved configuration file.
+ *
+ * @param params An object defining required parameters. See {@link ParseTsConfigParams} for more info.
+ *
+ * @returns The resolved TypeScript compiler target if any, `undefined` otherwise.
+ */
+export declare const getTSConfigCompilerTarget: (params?: ParseTsConfigParams) => string | undefined;
+//#endregion

package/dist/tsconfig/index.d.mts

@@ -0,0 +1,29 @@
+import { ParsedCommandLine } from "typescript";
+//#region src/tsconfig/index.d.ts
+export interface ParseTsConfigParams {
+  /**
+   * The TypeScript configuration file path.
+   *
+   * @default './tsconfig.json'
+   */
+  filepath?: string;
+}
+/**
+ * Parse TypeScript configuration file.
+ *
+ * @param params An object defining required parameters. See {@link ParseTsConfigParams} for more info.
+ *
+ * @returns The parsed TypeScript configuration file.
+ *
+ * @throws {Error} if the resolved `filepath` does not exists.
+ */
+export declare const parseTsConfig: (params?: ParseTsConfigParams) => ParsedCommandLine;
+/**
+ * Get TypeScript compiler target from resolved configuration file.
+ *
+ * @param params An object defining required parameters. See {@link ParseTsConfigParams} for more info.
+ *
+ * @returns The resolved TypeScript compiler target if any, `undefined` otherwise.
+ */
+export declare const getTSConfigCompilerTarget: (params?: ParseTsConfigParams) => string | undefined;
+//#endregion

package/dist/tsconfig/index.mjs

@@ -0,0 +1 @@
+import{ScriptTarget as e,parseJsonConfigFileContent as t,readConfigFile as n,sys as r}from"typescript";import{parse as i,resolve as a}from"path";import{existsSync as o}from"fs";const s=(e={})=>{let{filepath:s=a(process.cwd(),`tsconfig.json`)}=e;if(!o(s))throw Error(`No configuration file found.`,{cause:{filepath:s}});let c=i(s).dir,l=n(s,r.readFile);return t(l.config,r,c)},c=t=>{try{let n=s(t).options.target;return n?n===e.Latest?`esnext`:e[n]?.toLowerCase():void 0}catch(e){console.error(e)}};export{c as getTSConfigCompilerTarget,s as parseTsConfig};

package/dist/tsdown/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../tsconfig/index.cjs");let t=require("tsdown");const n=(n={})=>(0,t.defineConfig)(async(t,r)=>{let{target:i,watch:a=t.watch,tsconfig:o=t.tsconfig,deps:s=t.deps,...c}=typeof n==`function`?await n(t,r):n,l=i||(typeof o==`string`?e.getTSConfigCompilerTarget({filepath:o}):i);return{entry:[`src/**/index.ts`],format:[`cjs`,`esm`],dts:!0,shims:!0,clean:!0,treeshake:!0,minify:!a,sourcemap:!!a,tsconfig:o,target:l,watch:a,deps:{neverBundle:!0,...s},...c}});exports.tsdownConfig=n;

package/dist/tsdown/index.d.cts

@@ -0,0 +1,30 @@
+import { InlineConfig, UserConfig, UserConfigFn as UserConfigFn$1, UserConfigFnContext } from "tsdown";
+//#region src/tsdown/index.d.ts
+export type UserConfigFn = (inlineConfig: InlineConfig, context: UserConfigFnContext) => UserConfig | Promise<UserConfig>;
+/**
+ * Get `tsdown` base configuration.
+ *
+ * @param options (Optional) An object defining custom options or a callable function that returns a custom options object. See {@link UserConfig} or {@link UserConfigFn}.
+ *
+ * @returns A callable function executed by `tsdown` processes.
+ *
+ * ---
+ *
+ * Defaults:
+ *
+ * | Property                     | Value                    |
+ * | ---------------------------- | ------------------------ |
+ * | `entry`                      | `['src/**\/index.ts']`   |
+ * | `format`                     | `['cjs', 'esm']`         |
+ * | `dts`                        | `true`                   |
+ * | `shims`                      | `true`                   |
+ * | `clean`                      | `true`                   |
+ * | `treeshake`                  | `true`                   |
+ * | `minify`                     | `!watch`                 |
+ * | `sourcemap`                  | `!!watch`                |
+ * | `target`                     | resolved tsconfig target |
+ * | `deps`                       | `{ ... }`                |
+ * | `deps.neverBundle`           | `true`                   |
+ */
+export declare const tsdownConfig: (options?: UserConfig | UserConfigFn) => UserConfigFn$1;
+//#endregion

package/dist/tsdown/index.d.mts

@@ -0,0 +1,30 @@
+import { InlineConfig, UserConfig, UserConfigFn as UserConfigFn$1, UserConfigFnContext } from "tsdown";
+//#region src/tsdown/index.d.ts
+export type UserConfigFn = (inlineConfig: InlineConfig, context: UserConfigFnContext) => UserConfig | Promise<UserConfig>;
+/**
+ * Get `tsdown` base configuration.
+ *
+ * @param options (Optional) An object defining custom options or a callable function that returns a custom options object. See {@link UserConfig} or {@link UserConfigFn}.
+ *
+ * @returns A callable function executed by `tsdown` processes.
+ *
+ * ---
+ *
+ * Defaults:
+ *
+ * | Property                     | Value                    |
+ * | ---------------------------- | ------------------------ |
+ * | `entry`                      | `['src/**\/index.ts']`   |
+ * | `format`                     | `['cjs', 'esm']`         |
+ * | `dts`                        | `true`                   |
+ * | `shims`                      | `true`                   |
+ * | `clean`                      | `true`                   |
+ * | `treeshake`                  | `true`                   |
+ * | `minify`                     | `!watch`                 |
+ * | `sourcemap`                  | `!!watch`                |
+ * | `target`                     | resolved tsconfig target |
+ * | `deps`                       | `{ ... }`                |
+ * | `deps.neverBundle`           | `true`                   |
+ */
+export declare const tsdownConfig: (options?: UserConfig | UserConfigFn) => UserConfigFn$1;
+//#endregion

package/dist/tsdown/index.mjs

@@ -0,0 +1 @@
+import{getTSConfigCompilerTarget as e}from"../tsconfig/index.mjs";import{defineConfig as t}from"tsdown";const n=(n={})=>t(async(t,r)=>{let{target:i,watch:a=t.watch,tsconfig:o=t.tsconfig,deps:s=t.deps,...c}=typeof n==`function`?await n(t,r):n,l=i||(typeof o==`string`?e({filepath:o}):i);return{entry:[`src/**/index.ts`],format:[`cjs`,`esm`],dts:!0,shims:!0,clean:!0,treeshake:!0,minify:!a,sourcemap:!!a,tsconfig:o,target:l,watch:a,deps:{neverBundle:!0,...s},...c}});export{n as tsdownConfig};

package/dist/vite/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("vite");const t=(t={})=>{let{resolve:n,test:{coverage:r,...i}={},...a}=t;return(0,e.defineConfig)(()=>({resolve:{tsconfigPaths:!0,...n},test:{reporters:process.env.VITEST_VSCODE?[`tree`]:[],coverage:{exclude:[`**/*.mock.ts`,`**/__tests__/**/*.mock.ts`],...r},...i},...a}))};exports.viteConfig=t;

package/dist/vite/index.d.cts

@@ -0,0 +1,21 @@
+import { UserConfig, defineConfig } from "vite";
+//#region src/vite/index.d.ts
+/**
+ * Get `vite` base configuration.
+ *
+ * @param options (Optional) An object defining custom Vite configuration options. See {@link UserConfig} for more info.
+ *
+ * @returns An object with base and custom Vite configuration options.
+ *
+ * ---
+ *
+ * Defaults:
+ *
+ * | Property                | Value                                                         |
+ * | ----------------------- | ------------------------------------------------------------- |
+ * | `resolve.tsconfigPaths` | `true`                                                        |
+ * | `test.reporters`        | `['tree']\|[]` based on `VITEST_VSCODE` environment variable. |
+ * | `test.coverage.exclude` | `['**\/*.mock.ts', '**\/__tests__/**\/*.mock.ts']`            |
+ */
+export declare const viteConfig: (configs?: UserConfig) => ReturnType<typeof defineConfig>;
+//#endregion

package/dist/vite/index.d.mts

@@ -0,0 +1,21 @@
+import { UserConfig, defineConfig } from "vite";
+//#region src/vite/index.d.ts
+/**
+ * Get `vite` base configuration.
+ *
+ * @param options (Optional) An object defining custom Vite configuration options. See {@link UserConfig} for more info.
+ *
+ * @returns An object with base and custom Vite configuration options.
+ *
+ * ---
+ *
+ * Defaults:
+ *
+ * | Property                | Value                                                         |
+ * | ----------------------- | ------------------------------------------------------------- |
+ * | `resolve.tsconfigPaths` | `true`                                                        |
+ * | `test.reporters`        | `['tree']\|[]` based on `VITEST_VSCODE` environment variable. |
+ * | `test.coverage.exclude` | `['**\/*.mock.ts', '**\/__tests__/**\/*.mock.ts']`            |
+ */
+export declare const viteConfig: (configs?: UserConfig) => ReturnType<typeof defineConfig>;
+//#endregion

package/dist/vite/index.mjs

@@ -0,0 +1 @@
+import{defineConfig as e}from"vite";const t=(t={})=>{let{resolve:n,test:{coverage:r,...i}={},...a}=t;return e(()=>({resolve:{tsconfigPaths:!0,...n},test:{reporters:process.env.VITEST_VSCODE?[`tree`]:[],coverage:{exclude:[`**/*.mock.ts`,`**/__tests__/**/*.mock.ts`],...r},...i},...a}))};export{t as viteConfig};

package/package.json

@@ -0,0 +1,168 @@
+{
+	"name": "@alessiofrittoli/package-configs",
+	"version": "0.1.0",
+	"description": "Utility library that offers base configurations for your packages.",
+	"type": "module",
+	"author": {
+		"name": "Alessio Frittoli",
+		"email": "info@alessiofrittoli.it",
+		"url": "https://alessiofrittoli.it"
+	},
+	"license": "MIT",
+	"funding": [
+		{
+			"type": "github",
+			"url": "https://github.com/sponsors/alessiofrittoli"
+		}
+	],
+	"keywords": [
+		"tsdown",
+		"eslint",
+		"vite",
+		"vitest"
+	],
+	"homepage": "https://github.com/alessiofrittoli/package-configs#readme",
+	"bugs": {
+		"url": "https://github.com/alessiofrittoli/package-configs/issues",
+		"email": "info@alessiofrittoli.it"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/alessiofrittoli/package-configs.git"
+	},
+	"sideEffects": false,
+	"engines": {
+		"node": ">=24.15.0",
+		"pnpm": ">=11.27.1"
+	},
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.mts",
+	"files": [
+		"dist"
+	],
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.mts",
+				"default": "./dist/index.mjs"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
+		},
+		"./*": {
+			"import": {
+				"types": "./dist/*/index.d.mts",
+				"default": "./dist/*/index.mjs"
+			},
+			"require": {
+				"types": "./dist/*/index.d.cts",
+				"default": "./dist/*/index.cjs"
+			}
+		},
+		"./tsconfig/*.json": {
+			"import": "./dist/tsconfig/configs/*.json",
+			"require": "./dist/tsconfig/configs/*.json"
+		},
+		"./markdown/*.json": {
+			"import": "./dist/markdown/configs/*.json",
+			"require": "./dist/markdown/configs/*.json"
+		}
+	},
+	"scripts": {
+		"//1a": "*********************************************************************",
+		"//1b": "******************** DEV - BUILD - LINT - RELEASE *******************",
+		"//1c": "*********************************************************************",
+		"dev": "tsdown --watch",
+		"build:prod": "pnpm tsc && pnpm tsdown",
+		"build": "pnpm lint && pnpm build:prod",
+		"eslint": "eslint -c legacy-eslint.config.ts --report-unused-disable-directives --max-warnings 0 --cache --cache-location .cache/eslint",
+		"lint": "oxlint --report-unused-disable-directives --max-warnings 0",
+		"release": "node scripts/release.ts --verbose --npm",
+		"//2a": "*********************************************************************",
+		"//2b": "***************************** UNIT TESTS ****************************",
+		"//2c": "*********************************************************************",
+		"test": "vitest --reporter=tree",
+		"test:watch": "pnpm test watch",
+		"test:ci": "pnpm test run",
+		"//3a": "*********************************************************************",
+		"//3b": "************************ UNIT TESTS COVERAGE ************************",
+		"//3c": "*********************************************************************",
+		"test:coverage": "pnpm test:watch --coverage",
+		"test:coverage:ci": "pnpm test:ci --coverage",
+		"test:serve-coverage": "http-server ./coverage --gzip true -p 0 -o /index.html --silent",
+		"test:coverage:serve": "concurrently --prefix none --kill-others \"pnpm test:coverage\" \"pnpm test:serve-coverage\""
+	},
+	"peerDependencies": {
+		"@eslint/js": "^10.0.1",
+		"eslint": "^10.11.0",
+		"globals": "^17.12.0",
+		"oxlint": "^1.85.0",
+		"prettier": "^3.9.9",
+		"prettier-plugin-organize-imports": "^4.3.0",
+		"prettier-plugin-sh": "^0.20.2",
+		"prettier-plugin-sort-imports": "^1.8.11",
+		"prettier-plugin-tailwindcss": "^0.8.1",
+		"tsdown": "^0.23.0",
+		"typescript": "^6.0.3",
+		"typescript-eslint": "^8.70.1",
+		"vite": "^8.3.0",
+		"vitest": "^5.0.1"
+	},
+	"peerDependenciesMeta": {
+		"@eslint/js": {
+			"optional": true
+		},
+		"eslint": {
+			"optional": true
+		},
+		"globals": {
+			"optional": true
+		},
+		"oxlint": {
+			"optional": true
+		},
+		"prettier": {
+			"optional": true
+		},
+		"tsdown": {
+			"optional": true
+		},
+		"typescript": {
+			"optional": false
+		},
+		"typescript-eslint": {
+			"optional": true
+		},
+		"vite": {
+			"optional": true
+		},
+		"vitest": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@alessiofrittoli/node-scripts": "^3.4.0",
+		"@eslint/js": "^10.0.1",
+		"@types/node": "^24.13.2",
+		"@vitest/coverage-v8": "5.0.2",
+		"concurrently": "^10.0.5",
+		"eslint": "^10.11.0",
+		"globals": "^17.12.0",
+		"http-server": "^14.1.1",
+		"jiti": "^2.7.0",
+		"oxlint": "^1.85.0",
+		"prettier": "^3.9.9",
+		"prettier-plugin-organize-imports": "^4.3.0",
+		"prettier-plugin-sh": "^0.20.2",
+		"prettier-plugin-sort-imports": "^1.8.11",
+		"prettier-plugin-tailwindcss": "^0.8.1",
+		"tsdown": "^0.23.0",
+		"typescript": "6.0.3",
+		"typescript-eslint": "^8.70.1",
+		"vite": "^8.3.1",
+		"vitest": "^5.0.2"
+	}
+}