@cyberskill/shared 3.2.0 → 3.3.0

package/dist/config/commitlint/index.js

@@ -1,10 +1,9 @@
-const e = {
-  extends: ["@commitlint/config-conventional"],
-  ignores: [
-    (n) => n.includes("[🚀 CI - Deploy]")
-  ]
+//#region src/config/commitlint/index.ts
+var e = {
+	extends: ["@commitlint/config-conventional"],
+	ignores: [(e) => e.includes("[🚀 CI - Deploy]")]
 };
-export {
-  e as default
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+export { e as default };
+
+//# sourceMappingURL=index.js.map

package/dist/config/commitlint/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/config/commitlint/index.ts"],"sourcesContent":["export default {\n    extends: ['@commitlint/config-conventional'],\n    ignores: [\n        (message: string) => message.includes('[🚀 CI - Deploy]'),\n    ],\n};\n"],"names":["index","message"],"mappings":"AAAA,MAAAA,IAAe;AAAA,EACX,SAAS,CAAC,iCAAiC;AAAA,EAC3C,SAAS;AAAA,IACL,CAACC,MAAoBA,EAAQ,SAAS,kBAAkB;AAAA,EAAA;AAEhE;"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/config/commitlint/index.ts"],"sourcesContent":["export default {\n    extends: ['@commitlint/config-conventional'],\n    ignores: [\n        (message: string) => message.includes('[🚀 CI - Deploy]'),\n    ],\n};\n"],"mappings":";AAAA,IAAA,IAAe;CACX,SAAS,CAAC,kCAAkC;CAC5C,SAAS,EACJ,MAAoB,EAAQ,SAAS,mBAAmB,CAC5D;CACJ"}

package/dist/config/config.type.js

@@ -1,5 +1,8 @@
-var T = /* @__PURE__ */ ((t) => (t.ESLINT = "eslint", t.COMMITLINT = "commitlint", t.LINT_STAGED = "lint-staged", t.VITEST_REACT_E2E = "vitest-react-e2e", t.VITEST_REACT_UNIT = "vitest-react-unit", t))(T || {});
-export {
-  T as E_ConfigType
-};
-//# sourceMappingURL=config.type.js.map
+//#region src/config/config.type.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.ESLINT = "eslint", e.COMMITLINT = "commitlint", e.LINT_STAGED = "lint-staged", e.VITEST_REACT_E2E = "vitest-react-e2e", e.VITEST_REACT_UNIT = "vitest-react-unit", e;
+}({});
+//#endregion
+export { e as E_ConfigType };
+
+//# sourceMappingURL=config.type.js.map

package/dist/config/config.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.type.js","sources":["../../src/config/config.type.ts"],"sourcesContent":["import type { T_Object } from '#typescript/index.js';\n\nexport enum E_ConfigType {\n    ESLINT = 'eslint',\n    COMMITLINT = 'commitlint',\n    LINT_STAGED = 'lint-staged',\n    VITEST_REACT_E2E = 'vitest-react-e2e',\n    VITEST_REACT_UNIT = 'vitest-react-unit',\n}\n\nexport type T_ConfigType = `${E_ConfigType}`;\n\nexport type T_ConfigHandler = (...config: T_Object[]) => T_Object;\n"],"names":["E_ConfigType"],"mappings":"AAEO,IAAKA,sBAAAA,OACRA,EAAA,SAAS,UACTA,EAAA,aAAa,cACbA,EAAA,cAAc,eACdA,EAAA,mBAAmB,oBACnBA,EAAA,oBAAoB,qBALZA,IAAAA,KAAA,CAAA,CAAA;"}
+{"version":3,"file":"config.type.js","names":[],"sources":["../../src/config/config.type.ts"],"sourcesContent":["import type { T_Object } from '#typescript/index.js';\n\nexport enum E_ConfigType {\n    ESLINT = 'eslint',\n    COMMITLINT = 'commitlint',\n    LINT_STAGED = 'lint-staged',\n    VITEST_REACT_E2E = 'vitest-react-e2e',\n    VITEST_REACT_UNIT = 'vitest-react-unit',\n}\n\nexport type T_ConfigType = `${E_ConfigType}`;\n\nexport type T_ConfigHandler = (...config: T_Object[]) => T_Object;\n"],"mappings":";AAEA,IAAY,IAAL,yBAAA,GAAA;QACH,EAAA,SAAA,UACA,EAAA,aAAA,cACA,EAAA,cAAA,eACA,EAAA,mBAAA,oBACA,EAAA,oBAAA;KACH"}

package/dist/config/config.util.js

@@ -1,44 +1,35 @@
-import f from "@antfu/eslint-config";
-import { E_ConfigType as n } from "./config.type.js";
-import o from "./eslint/index.js";
-import { vitestE2E as m } from "./vitest/vitest.e2e.js";
-import { vitestUnit as a } from "./vitest/vitest.unit.js";
-import { deepMerge as i } from "../util/object/object.util.js";
-const E = (...r) => {
-  const e = i(
-    ...Array.isArray(o) ? o : [o],
-    ...r
-  ), { ignores: t, ...s } = e;
-  return f(
-    {
-      stylistic: {
-        semi: !0,
-        indent: 4
-      },
-      formatters: !0,
-      yaml: !1,
-      markdown: !1,
-      react: !0
-    },
-    s,
-    ...Array.isArray(t) ? [{ ignores: t }] : []
-  );
-}, T = {
-  [n.ESLINT]: (r) => E(r),
-  [n.COMMITLINT]: (r) => i(r),
-  [n.LINT_STAGED]: (r) => i(r),
-  [n.VITEST_REACT_UNIT]: (r) => a(r),
-  [n.VITEST_REACT_E2E]: (r) => m(r)
+import { deepMerge as e } from "../util/object/object.util.js";
+import { E_ConfigType as t } from "./config.type.js";
+import { vitestE2E as n } from "./vitest/vitest.e2e.js";
+import { vitestUnit as r } from "./vitest/vitest.unit.js";
+import i from "./eslint/index.js";
+import a from "@antfu/eslint-config";
+//#region src/config/config.util.ts
+var o = (...t) => {
+	let { ignores: n, ...r } = e(...Array.isArray(i) ? i : [i], ...t);
+	return a({
+		stylistic: {
+			semi: !0,
+			indent: 4
+		},
+		formatters: !0,
+		yaml: !1,
+		markdown: !1,
+		react: !0
+	}, r, ...Array.isArray(n) ? [{ ignores: n }] : []);
+}, s = {
+	[t.ESLINT]: (e) => o(e),
+	[t.COMMITLINT]: (t) => e(t),
+	[t.LINT_STAGED]: (t) => e(t),
+	[t.VITEST_REACT_UNIT]: (e) => r(e),
+	[t.VITEST_REACT_E2E]: (e) => n(e)
 };
-function d(r, ...e) {
-  const t = T[r];
-  if (!e || e.length === 0)
-    return t({});
-  if (!t)
-    throw new Error(`Unknown config type: ${r}`);
-  return t(...e);
+function c(e, ...t) {
+	let n = s[e];
+	if (!n) throw Error(`Unknown config type: ${e}`);
+	return !t || t.length === 0 ? n({}) : n(...t);
 }
-export {
-  d as mergeConfigs
-};
-//# sourceMappingURL=config.util.js.map
+//#endregion
+export { c as mergeConfigs };
+
+//# sourceMappingURL=config.util.js.map

package/dist/config/config.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.util.js","sources":["../../src/config/config.util.ts"],"sourcesContent":["import antfu from '@antfu/eslint-config';\n\nimport type { T_Object } from '#typescript/index.js';\n\nimport { vitestE2E, vitestUnit } from '#config/vitest/index.js';\nimport { deepMerge } from '#util/index.js';\n\nimport type { T_ConfigHandler, T_ConfigType } from './config.type.js';\n\nimport { E_ConfigType } from './config.type.js';\nimport eslintBaseConfig from './eslint/index.js';\n\n/**\n * Handles ESLint configuration merging and processing.\n * This function merges the base ESLint configuration with additional configs\n * and applies the Antfu ESLint preset with specific styling and formatting rules.\n * It processes ignores separately and applies them as a final configuration layer.\n *\n * The function configures:\n * - Stylistic rules (semicolons, indentation, quotes)\n * - Formatters for CSS, HTML, and Markdown\n * - React support\n * - Custom ignore patterns\n *\n * @param config - Additional ESLint configuration objects to merge with the base config.\n * @returns A processed ESLint configuration object ready for use.\n */\nconst handleESLint: T_ConfigHandler = (...config) => {\n    const mergedConfig = deepMerge(\n        ...(Array.isArray(eslintBaseConfig) ? eslintBaseConfig : [eslintBaseConfig]),\n        ...config,\n    );\n\n    const { ignores, ...restConfig } = mergedConfig;\n\n    return antfu(\n        {\n            stylistic: {\n                semi: true,\n                indent: 4,\n            },\n            formatters: true,\n            yaml: false,\n            markdown: false,\n            react: true,\n        },\n        restConfig,\n        ...(Array.isArray(ignores) ? [{ ignores }] : []),\n    ) as unknown as T_Object;\n};\n\n/**\n * Configuration handlers for different config types.\n * This object maps configuration types to their respective handler functions,\n * providing a centralized way to process different types of configurations\n * with appropriate merging and processing logic.\n */\nconst configHandlers: Record<E_ConfigType, T_ConfigHandler> = {\n    [E_ConfigType.ESLINT]: config => handleESLint(config),\n    [E_ConfigType.COMMITLINT]: config => deepMerge(config),\n    [E_ConfigType.LINT_STAGED]: config => deepMerge(config),\n    [E_ConfigType.VITEST_REACT_UNIT]: config => vitestUnit(config) as T_Object,\n    [E_ConfigType.VITEST_REACT_E2E]: config => vitestE2E(config) as T_Object,\n};\n\n/**\n * Merges configurations based on the specified type.\n * This function provides a unified interface for merging different types of\n * configurations using their respective handlers. It supports ESLint, commitlint,\n * lint-staged, and Vitest configurations with appropriate processing for each type.\n *\n * The function automatically:\n * - Selects the appropriate handler for the config type\n * - Merges multiple configuration objects\n * - Handles empty configuration arrays gracefully\n * - Provides error handling for unknown config types\n *\n * @param type - The type of configuration to merge (ESLint, commitlint, lint-staged, or Vitest).\n * @param config - Configuration objects to merge, can be empty for default handling.\n * @returns A merged configuration object processed according to the specified type.\n * @throws {Error} When an unknown configuration type is provided.\n */\nexport function mergeConfigs(type: T_ConfigType, ...config: T_Object[]) {\n    const handler = configHandlers[type];\n\n    if (!config || config.length === 0) {\n        return handler({});\n    }\n\n    if (!handler) {\n        throw new Error(`Unknown config type: ${type}`);\n    }\n\n    return handler(...config);\n}\n"],"names":["antfu","E_ConfigType","eslintBaseConfig","vitestE2E","vitestUnit","deepMerge","handleESLint","config","mergedConfig","ignores","restConfig","configHandlers","mergeConfigs","type","handler"],"mappings":"AA2BA,OAAAA,OAAA;AAAA,SAAA,gBAAAC,SAAA;AAAA,OAAAC,OAAA;AAAA,SAAA,aAAAC,SAAA;AAAA,SAAA,cAAAC,SAAA;AAAA,SAAA,aAAAC,SAAA;AAAA,MAAMC,IAAgC,IAAIC,MAAW;AACjD,QAAMC,IAAeH;AAAA,IACjB,GAAI,MAAM,QAAQH,CAAgB,IAAIA,IAAmB,CAACA,CAAgB;AAAA,IAC1E,GAAGK;AAAA,EAAA,GAGD,EAAE,SAAAE,GAAS,GAAGC,EAAA,IAAeF;AAEnC,SAAOR;AAAA,IACH;AAAA,MACI,WAAW;AAAA,QACP,MAAM;AAAA,QACN,QAAQ;AAAA,MAAA;AAAA,MAEZ,YAAY;AAAA,MACZ,MAAM;AAAA,MACN,UAAU;AAAA,MACV,OAAO;AAAA,IAAA;AAAA,IAEXU;AAAA,IACA,GAAI,MAAM,QAAQD,CAAO,IAAI,CAAC,EAAE,SAAAA,EAAA,CAAS,IAAI,CAAA;AAAA,EAAC;AAEtD,GAQME,IAAwD;AAAA,EAC1D,CAACV,EAAa,MAAM,GAAG,CAAAM,MAAUD,EAAaC,CAAM;AAAA,EACpD,CAACN,EAAa,UAAU,GAAG,CAAAM,MAAUF,EAAUE,CAAM;AAAA,EACrD,CAACN,EAAa,WAAW,GAAG,CAAAM,MAAUF,EAAUE,CAAM;AAAA,EACtD,CAACN,EAAa,iBAAiB,GAAG,CAAAM,MAAUH,EAAWG,CAAM;AAAA,EAC7D,CAACN,EAAa,gBAAgB,GAAG,CAAAM,MAAUJ,EAAUI,CAAM;AAC/D;AAmBO,SAASK,EAAaC,MAAuBN,GAAoB;AACpE,QAAMO,IAAUH,EAAeE,CAAI;AAEnC,MAAI,CAACN,KAAUA,EAAO,WAAW;AAC7B,WAAOO,EAAQ,CAAA,CAAE;AAGrB,MAAI,CAACA;AACD,UAAM,IAAI,MAAM,wBAAwBD,CAAI,EAAE;AAGlD,SAAOC,EAAQ,GAAGP,CAAM;AAC5B;"}
+{"version":3,"file":"config.util.js","names":[],"sources":["../../src/config/config.util.ts"],"sourcesContent":["import antfu from '@antfu/eslint-config';\n\nimport type { T_Object } from '#typescript/index.js';\n\nimport { vitestE2E, vitestUnit } from '#config/vitest/index.js';\nimport { deepMerge } from '#util/index.js';\n\nimport type { T_ConfigHandler, T_ConfigType } from './config.type.js';\n\nimport { E_ConfigType } from './config.type.js';\nimport eslintBaseConfig from './eslint/index.js';\n\n/**\n * Handles ESLint configuration merging and processing.\n * This function merges the base ESLint configuration with additional configs\n * and applies the Antfu ESLint preset with specific styling and formatting rules.\n * It processes ignores separately and applies them as a final configuration layer.\n *\n * The function configures:\n * - Stylistic rules (semicolons, indentation, quotes)\n * - Formatters for CSS, HTML, and Markdown\n * - React support\n * - Custom ignore patterns\n *\n * @param config - Additional ESLint configuration objects to merge with the base config.\n * @returns A processed ESLint configuration object ready for use.\n */\nconst handleESLint: T_ConfigHandler = (...config) => {\n    const mergedConfig = deepMerge(\n        ...(Array.isArray(eslintBaseConfig) ? eslintBaseConfig : [eslintBaseConfig]),\n        ...config,\n    );\n\n    const { ignores, ...restConfig } = mergedConfig;\n\n    return antfu(\n        {\n            stylistic: {\n                semi: true,\n                indent: 4,\n            },\n            formatters: true,\n            yaml: false,\n            markdown: false,\n            react: true,\n        },\n        restConfig,\n        ...(Array.isArray(ignores) ? [{ ignores }] : []),\n    ) as unknown as T_Object;\n};\n\n/**\n * Configuration handlers for different config types.\n * This object maps configuration types to their respective handler functions,\n * providing a centralized way to process different types of configurations\n * with appropriate merging and processing logic.\n */\nconst configHandlers: Record<E_ConfigType, T_ConfigHandler> = {\n    [E_ConfigType.ESLINT]: config => handleESLint(config),\n    [E_ConfigType.COMMITLINT]: config => deepMerge(config),\n    [E_ConfigType.LINT_STAGED]: config => deepMerge(config),\n    [E_ConfigType.VITEST_REACT_UNIT]: config => vitestUnit(config) as T_Object,\n    [E_ConfigType.VITEST_REACT_E2E]: config => vitestE2E(config) as T_Object,\n};\n\n/**\n * Merges configurations based on the specified type.\n * This function provides a unified interface for merging different types of\n * configurations using their respective handlers. It supports ESLint, commitlint,\n * lint-staged, and Vitest configurations with appropriate processing for each type.\n *\n * The function automatically:\n * - Selects the appropriate handler for the config type\n * - Merges multiple configuration objects\n * - Handles empty configuration arrays gracefully\n * - Provides error handling for unknown config types\n *\n * @param type - The type of configuration to merge (ESLint, commitlint, lint-staged, or Vitest).\n * @param config - Configuration objects to merge, can be empty for default handling.\n * @returns A merged configuration object processed according to the specified type.\n * @throws {Error} When an unknown configuration type is provided.\n */\nexport function mergeConfigs(type: T_ConfigType, ...config: T_Object[]) {\n    const handler = configHandlers[type];\n\n    if (!handler) {\n        throw new Error(`Unknown config type: ${type}`);\n    }\n\n    if (!config || config.length === 0) {\n        return handler({});\n    }\n\n    return handler(...config);\n}\n"],"mappings":";;;;;;;AA2BA,IAAM,KAAiC,GAAG,MAAW;CAMjD,IAAM,EAAE,YAAS,GAAG,MALC,EACjB,GAAI,MAAM,QAAQ,EAAiB,GAAG,IAAmB,CAAC,EAAiB,EAC3E,GAAG,EACN;AAID,QAAO,EACH;EACI,WAAW;GACP,MAAM;GACN,QAAQ;GACX;EACD,YAAY;EACZ,MAAM;EACN,UAAU;EACV,OAAO;EACV,EACD,GACA,GAAI,MAAM,QAAQ,EAAQ,GAAG,CAAC,EAAE,YAAS,CAAC,GAAG,EAAE,CAClD;GASC,IAAwD;EACzD,EAAa,UAAS,MAAU,EAAa,EAAO;EACpD,EAAa,cAAa,MAAU,EAAU,EAAO;EACrD,EAAa,eAAc,MAAU,EAAU,EAAO;EACtD,EAAa,qBAAoB,MAAU,EAAW,EAAO;EAC7D,EAAa,oBAAmB,MAAU,EAAU,EAAO;CAC/D;AAmBD,SAAgB,EAAa,GAAoB,GAAG,GAAoB;CACpE,IAAM,IAAU,EAAe;AAE/B,KAAI,CAAC,EACD,OAAU,MAAM,wBAAwB,IAAO;AAOnD,QAJI,CAAC,KAAU,EAAO,WAAW,IACtB,EAAQ,EAAE,CAAC,GAGf,EAAQ,GAAG,EAAO"}

package/dist/config/env/env.constant.js

@@ -1,5 +1,6 @@
-const R = ".cyberskill-storage";
-export {
-  R as CYBERSKILL_STORAGE_DIRECTORY
-};
-//# sourceMappingURL=env.constant.js.map
+//#region src/config/env/env.constant.ts
+var e = ".cyberskill-storage";
+//#endregion
+export { e as CYBERSKILL_STORAGE_DIRECTORY };
+
+//# sourceMappingURL=env.constant.js.map

package/dist/config/env/env.constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.constant.js","sources":["../../../src/config/env/env.constant.ts"],"sourcesContent":["export const CYBERSKILL_STORAGE_DIRECTORY = '.cyberskill-storage';\n"],"names":["CYBERSKILL_STORAGE_DIRECTORY"],"mappings":"AAAO,MAAMA,IAA+B;"}
+{"version":3,"file":"env.constant.js","names":[],"sources":["../../../src/config/env/env.constant.ts"],"sourcesContent":["export const CYBERSKILL_STORAGE_DIRECTORY = '.cyberskill-storage';\n"],"mappings":";AAAA,IAAa,IAA+B"}

package/dist/config/env/env.util.js

@@ -1,30 +1,29 @@
-import n from "@dotenvx/dotenvx";
-import { cleanEnv as E, str as r, makeValidator as f } from "envalid";
-import i from "node:os";
-import a from "node:path";
-import o from "node:process";
-import { CYBERSKILL_STORAGE_DIRECTORY as m } from "./env.constant.js";
-import { E_Environment as R } from "../../typescript/common.type.js";
-let t = !1;
-const l = f((e) => typeof e == "boolean" ? e : typeof e == "string");
+import { E_Environment as e } from "../../typescript/common.type.js";
+import { CYBERSKILL_STORAGE_DIRECTORY as t } from "./env.constant.js";
+import n from "node:path";
+import r from "@dotenvx/dotenvx";
+import { cleanEnv as i, makeValidator as a, str as o } from "envalid";
+import s from "node:os";
+import c from "node:process";
+//#region src/config/env/env.util.ts
+var l = !1, u = a((e) => typeof e == "boolean" ? e : typeof e == "string");
 function d() {
-  o.env.NODE_ENV !== R.PRODUCTION && !t && (n.config(), t = !0);
+	c.env.NODE_ENV !== e.PRODUCTION && !l && (r.config(), l = !0);
 }
-function p() {
-  d();
-  const e = E(o.env, {
-    CWD: r({ default: o.cwd() }),
-    DEBUG: l({ default: !1 }),
-    CYBERSKILL_STORAGE_DIRECTORY: r({ default: a.join(i.homedir(), m) })
-  });
-  return {
-    CWD: e.CWD,
-    DEBUG: e.DEBUG,
-    CYBERSKILL_STORAGE_DIRECTORY: e.CYBERSKILL_STORAGE_DIRECTORY
-  };
+function f() {
+	d();
+	let e = i(c.env, {
+		CWD: o({ default: c.cwd() }),
+		DEBUG: u({ default: !1 }),
+		CYBERSKILL_STORAGE_DIRECTORY: o({ default: n.join(s.homedir(), t) })
+	});
+	return {
+		CWD: e.CWD,
+		DEBUG: e.DEBUG,
+		CYBERSKILL_STORAGE_DIRECTORY: e.CYBERSKILL_STORAGE_DIRECTORY
+	};
 }
-export {
-  p as getEnv,
-  d as loadEnvFile
-};
-//# sourceMappingURL=env.util.js.map
+//#endregion
+export { f as getEnv, d as loadEnvFile };
+
+//# sourceMappingURL=env.util.js.map

package/dist/config/env/env.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.util.js","sources":["../../../src/config/env/env.util.ts"],"sourcesContent":["import dotenvx from '@dotenvx/dotenvx';\nimport { cleanEnv, makeValidator, str } from 'envalid';\nimport os from 'node:os';\nimport path from 'node:path';\nimport process from 'node:process';\n\nimport { E_Environment } from '#typescript/index.js';\n\nimport type { I_Environment } from './env.type.js';\n\nimport { CYBERSKILL_STORAGE_DIRECTORY } from './env.constant.js';\n\n/**\n * Flag to track whether environment file has been loaded.\n * This variable prevents multiple loading of environment files during\n * the application lifecycle, ensuring environment variables are only\n * loaded once per session.\n */\nlet isEnvFileLoaded = false;\n\n/**\n * Custom validator for debug environment variable.\n * This validator accepts boolean values directly and converts string values\n * to true, providing flexible debug configuration options. It handles\n * both explicit boolean settings and string-based flags.\n *\n * @param input - The input value to validate (boolean or string).\n * @returns True if the input is a valid debug setting, false otherwise.\n */\nconst debugValidator = makeValidator((input) => {\n    if (typeof input === 'boolean') {\n        return input;\n    }\n    if (typeof input === 'string') {\n        return true;\n    }\n\n    return false;\n});\n\n/**\n * Loads environment variables from .env files.\n * This function loads environment variables from .env files using dotenvx,\n * but only in non-production environments. It includes a safety mechanism\n * to prevent multiple loading of the same environment file.\n *\n * The function:\n * - Checks if the current environment is not production\n * - Loads environment variables from .env files\n * - Prevents duplicate loading with a flag mechanism\n * - Uses dotenvx for enhanced environment file support\n */\nexport function loadEnvFile() {\n    // @ts-expect-error ignore type error\n    if (process.env.NODE_ENV !== E_Environment.PRODUCTION && !isEnvFileLoaded) {\n        dotenvx.config();\n        isEnvFileLoaded = true;\n    }\n}\n\n/**\n * Retrieves and validates the application environment configuration.\n * This function loads environment variables, validates them using envalid,\n * and returns a typed environment object with default values for missing\n * variables. It ensures all required environment variables are present\n * and properly typed.\n *\n * The function validates:\n * - CWD: Current working directory (defaults to process.cwd())\n * - DEBUG: Debug mode flag (defaults to false)\n * - CYBERSKILL_STORAGE_DIRECTORY: Storage directory path (defaults to user home directory)\n *\n * @returns A validated environment object with all required configuration values.\n */\nexport function getEnv(): I_Environment {\n    loadEnvFile();\n\n    const cleanedEnv = cleanEnv(process.env, {\n        CWD: str({ default: process.cwd() }),\n        DEBUG: debugValidator({ default: false }),\n        CYBERSKILL_STORAGE_DIRECTORY: str({ default: path.join(os.homedir(), CYBERSKILL_STORAGE_DIRECTORY) }),\n    });\n\n    const env = {\n        CWD: cleanedEnv.CWD,\n        DEBUG: cleanedEnv.DEBUG,\n        CYBERSKILL_STORAGE_DIRECTORY: cleanedEnv.CYBERSKILL_STORAGE_DIRECTORY,\n    };\n\n    return env;\n}\n"],"names":["isEnvFileLoaded","debugValidator","makeValidator","input","loadEnvFile","process","E_Environment","dotenvx","getEnv","cleanedEnv","cleanEnv","str","path","os","CYBERSKILL_STORAGE_DIRECTORY"],"mappings":";;;;;;;AAkBA,IAAIA,IAAkB;AAWtB,MAAMC,IAAiBC,EAAc,CAACC,MAC9B,OAAOA,KAAU,YACVA,IAEP,OAAOA,KAAU,QAKxB;AAcM,SAASC,IAAc;AAE1B,EAAIC,EAAQ,IAAI,aAAaC,EAAc,cAAc,CAACN,MACtDO,EAAQ,OAAA,GACRP,IAAkB;AAE1B;AAgBO,SAASQ,IAAwB;AACpC,EAAAJ,EAAA;AAEA,QAAMK,IAAaC,EAASL,EAAQ,KAAK;AAAA,IACrC,KAAKM,EAAI,EAAE,SAASN,EAAQ,IAAA,GAAO;AAAA,IACnC,OAAOJ,EAAe,EAAE,SAAS,IAAO;AAAA,IACxC,8BAA8BU,EAAI,EAAE,SAASC,EAAK,KAAKC,EAAG,WAAWC,CAA4B,EAAA,CAAG;AAAA,EAAA,CACvG;AAQD,SANY;AAAA,IACR,KAAKL,EAAW;AAAA,IAChB,OAAOA,EAAW;AAAA,IAClB,8BAA8BA,EAAW;AAAA,EAAA;AAIjD;"}
+{"version":3,"file":"env.util.js","names":[],"sources":["../../../src/config/env/env.util.ts"],"sourcesContent":["import dotenvx from '@dotenvx/dotenvx';\nimport { cleanEnv, makeValidator, str } from 'envalid';\nimport os from 'node:os';\nimport path from 'node:path';\nimport process from 'node:process';\n\nimport { E_Environment } from '#typescript/index.js';\n\nimport type { I_Environment } from './env.type.js';\n\nimport { CYBERSKILL_STORAGE_DIRECTORY } from './env.constant.js';\n\n/**\n * Flag to track whether environment file has been loaded.\n * This variable prevents multiple loading of environment files during\n * the application lifecycle, ensuring environment variables are only\n * loaded once per session.\n */\nlet isEnvFileLoaded = false;\n\n/**\n * Custom validator for debug environment variable.\n * This validator accepts boolean values directly and converts string values\n * to true, providing flexible debug configuration options. It handles\n * both explicit boolean settings and string-based flags.\n *\n * @param input - The input value to validate (boolean or string).\n * @returns True if the input is a valid debug setting, false otherwise.\n */\nconst debugValidator = makeValidator((input) => {\n    if (typeof input === 'boolean') {\n        return input;\n    }\n    if (typeof input === 'string') {\n        return true;\n    }\n\n    return false;\n});\n\n/**\n * Loads environment variables from .env files.\n * This function loads environment variables from .env files using dotenvx,\n * but only in non-production environments. It includes a safety mechanism\n * to prevent multiple loading of the same environment file.\n *\n * The function:\n * - Checks if the current environment is not production\n * - Loads environment variables from .env files\n * - Prevents duplicate loading with a flag mechanism\n * - Uses dotenvx for enhanced environment file support\n */\nexport function loadEnvFile() {\n    // @ts-expect-error ignore type error\n    if (process.env.NODE_ENV !== E_Environment.PRODUCTION && !isEnvFileLoaded) {\n        dotenvx.config();\n        isEnvFileLoaded = true;\n    }\n}\n\n/**\n * Retrieves and validates the application environment configuration.\n * This function loads environment variables, validates them using envalid,\n * and returns a typed environment object with default values for missing\n * variables. It ensures all required environment variables are present\n * and properly typed.\n *\n * The function validates:\n * - CWD: Current working directory (defaults to process.cwd())\n * - DEBUG: Debug mode flag (defaults to false)\n * - CYBERSKILL_STORAGE_DIRECTORY: Storage directory path (defaults to user home directory)\n *\n * @returns A validated environment object with all required configuration values.\n */\nexport function getEnv(): I_Environment {\n    loadEnvFile();\n\n    const cleanedEnv = cleanEnv(process.env, {\n        CWD: str({ default: process.cwd() }),\n        DEBUG: debugValidator({ default: false }),\n        CYBERSKILL_STORAGE_DIRECTORY: str({ default: path.join(os.homedir(), CYBERSKILL_STORAGE_DIRECTORY) }),\n    });\n\n    const env = {\n        CWD: cleanedEnv.CWD,\n        DEBUG: cleanedEnv.DEBUG,\n        CYBERSKILL_STORAGE_DIRECTORY: cleanedEnv.CYBERSKILL_STORAGE_DIRECTORY,\n    };\n\n    return env;\n}\n"],"mappings":";;;;;;;;AAkBA,IAAI,IAAkB,IAWhB,IAAiB,GAAe,MAC9B,OAAO,KAAU,YACV,IAEP,OAAO,KAAU,SAKvB;AAcF,SAAgB,IAAc;AAE1B,CAAI,EAAQ,IAAI,aAAa,EAAc,cAAc,CAAC,MACtD,EAAQ,QAAQ,EAChB,IAAkB;;AAkB1B,SAAgB,IAAwB;AACpC,IAAa;CAEb,IAAM,IAAa,EAAS,EAAQ,KAAK;EACrC,KAAK,EAAI,EAAE,SAAS,EAAQ,KAAK,EAAE,CAAC;EACpC,OAAO,EAAe,EAAE,SAAS,IAAO,CAAC;EACzC,8BAA8B,EAAI,EAAE,SAAS,EAAK,KAAK,EAAG,SAAS,EAAE,EAA6B,EAAE,CAAC;EACxG,CAAC;AAQF,QANY;EACR,KAAK,EAAW;EAChB,OAAO,EAAW;EAClB,8BAA8B,EAAW;EAC5C"}

package/dist/config/env/index.js

@@ -1,8 +1,3 @@
 import { CYBERSKILL_STORAGE_DIRECTORY as e } from "./env.constant.js";
-import { getEnv as R, loadEnvFile as t } from "./env.util.js";
-export {
-  e as CYBERSKILL_STORAGE_DIRECTORY,
-  R as getEnv,
-  t as loadEnvFile
-};
-//# sourceMappingURL=index.js.map
+import { getEnv as t, loadEnvFile as n } from "./env.util.js";
+export { e as CYBERSKILL_STORAGE_DIRECTORY, t as getEnv, n as loadEnvFile };

package/dist/config/eslint/index.js

@@ -1,19 +1,23 @@
-import * as o from "globals";
-const t = [
-  {
-    languageOptions: {
-      globals: { ...o.node, ...o.browser }
-    },
-    rules: {
-      "perfectionist/sort-imports": ["error", {
-        internalPattern: ["^#.*", "^@/.*"]
-      }],
-      "dot-notation": "off"
-    },
-    ignores: ["**/node_modules/**", "**/.git/**", "build", "dist", ".agent"]
-  }
-];
-export {
-  t as default
-};
-//# sourceMappingURL=index.js.map
+import * as e from "globals";
+//#region src/config/eslint/index.ts
+var t = [{
+	languageOptions: { globals: {
+		...e.node,
+		...e.browser
+	} },
+	rules: {
+		"perfectionist/sort-imports": ["error", { internalPattern: ["^#.*", "^@/.*"] }],
+		"dot-notation": "off"
+	},
+	ignores: [
+		"**/node_modules/**",
+		"**/.git/**",
+		"build",
+		"dist",
+		".agent"
+	]
+}];
+//#endregion
+export { t as default };
+
+//# sourceMappingURL=index.js.map

package/dist/config/eslint/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/config/eslint/index.ts"],"sourcesContent":["import * as globals from 'globals';\n\n/**\n * Base ESLint configuration.\n * This config provides the foundation for ESLint rules.\n */\nexport default [\n    {\n        languageOptions: {\n            globals: { ...globals.node, ...globals.browser },\n        },\n        rules: {\n            'perfectionist/sort-imports': ['error', {\n                internalPattern: ['^#.*', '^@/.*'],\n            }],\n            'dot-notation': 'off',\n        },\n        ignores: ['**/node_modules/**', '**/.git/**', 'build', 'dist', '.agent'],\n    },\n];\n"],"names":["eslintBaseConfig","globals"],"mappings":";AAMA,MAAAA,IAAe;AAAA,EACX;AAAA,IACI,iBAAiB;AAAA,MACb,SAAS,EAAE,GAAGC,EAAQ,MAAM,GAAGA,EAAQ,QAAA;AAAA,IAAQ;AAAA,IAEnD,OAAO;AAAA,MACH,8BAA8B,CAAC,SAAS;AAAA,QACpC,iBAAiB,CAAC,QAAQ,OAAO;AAAA,MAAA,CACpC;AAAA,MACD,gBAAgB;AAAA,IAAA;AAAA,IAEpB,SAAS,CAAC,sBAAsB,cAAc,SAAS,QAAQ,QAAQ;AAAA,EAAA;AAE/E;"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/config/eslint/index.ts"],"sourcesContent":["import * as globals from 'globals';\n\n/**\n * Base ESLint configuration.\n * This config provides the foundation for ESLint rules.\n */\nexport default [\n    {\n        languageOptions: {\n            globals: { ...globals.node, ...globals.browser },\n        },\n        rules: {\n            'perfectionist/sort-imports': ['error', {\n                internalPattern: ['^#.*', '^@/.*'],\n            }],\n            'dot-notation': 'off',\n        },\n        ignores: ['**/node_modules/**', '**/.git/**', 'build', 'dist', '.agent'],\n    },\n];\n"],"mappings":";;AAMA,IAAA,IAAe,CACX;CACI,iBAAiB,EACb,SAAS;EAAE,GAAG,EAAQ;EAAM,GAAG,EAAQ;EAAS,EACnD;CACD,OAAO;EACH,8BAA8B,CAAC,SAAS,EACpC,iBAAiB,CAAC,QAAQ,QAAQ,EACrC,CAAC;EACF,gBAAgB;EACnB;CACD,SAAS;EAAC;EAAsB;EAAc;EAAS;EAAQ;EAAS;CAC3E,CACJ"}

package/dist/config/graphql-codegen/graphql-codegen.util.js

@@ -1,39 +1,31 @@
-import { defineConfig as s } from "@eddeee888/gcg-typescript-resolver-files";
-import { loadEnvFile as c } from "../env/env.util.js";
-c();
-function p({
-  uri: t,
-  from: o,
-  to: e,
-  target: n = "client"
-}) {
-  const r = n === "client", i = n === "server";
-  return {
-    schema: t,
-    ignoreNoDocuments: !0,
-    overwrite: !0,
-    ...r && { documents: [o] },
-    generates: {
-      ...r && {
-        [e]: {
-          preset: "client",
-          presetConfig: {
-            fragmentMasking: !1,
-            persistedDocuments: !0
-          },
-          config: {
-            useTypeImports: !0,
-            namingConvention: "keep"
-          }
-        }
-      },
-      ...i && {
-        [e]: s()
-      }
-    }
-  };
+import { loadEnvFile as e } from "../env/env.util.js";
+import { defineConfig as t } from "@eddeee888/gcg-typescript-resolver-files";
+//#region src/config/graphql-codegen/graphql-codegen.util.ts
+e();
+function n({ uri: e, from: n, to: r, target: i = "client" }) {
+	let a = i === "client", o = i === "server";
+	return {
+		schema: e,
+		ignoreNoDocuments: !0,
+		overwrite: !0,
+		...a && { documents: [n] },
+		generates: {
+			...a && { [r]: {
+				preset: "client",
+				presetConfig: {
+					fragmentMasking: !1,
+					persistedDocuments: !0
+				},
+				config: {
+					useTypeImports: !0,
+					namingConvention: "keep"
+				}
+			} },
+			...o && { [r]: t() }
+		}
+	};
 }
-export {
-  p as createGraphqlCodegenConfig
-};
-//# sourceMappingURL=graphql-codegen.util.js.map
+//#endregion
+export { n as createGraphqlCodegenConfig };
+
+//# sourceMappingURL=graphql-codegen.util.js.map

package/dist/config/graphql-codegen/graphql-codegen.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphql-codegen.util.js","sources":["../../../src/config/graphql-codegen/graphql-codegen.util.ts"],"sourcesContent":["import type { CodegenConfig } from '@graphql-codegen/cli';\n\nimport { defineConfig } from '@eddeee888/gcg-typescript-resolver-files';\n\nimport type { I_GraphqlCodegenConfig } from './graphql-codegen.type.js';\n\nimport { loadEnvFile } from '../env/env.util.js';\n\nloadEnvFile();\n\n/**\n * Creates a GraphQL Code Generator configuration for client or server code generation.\n * This function generates a complete GraphQL Code Generator configuration based on\n * the specified target (client or server) with appropriate presets and settings.\n *\n * For client targets, it configures:\n * - Client preset with fragment masking disabled\n * - Persisted documents support\n * - Type imports and naming convention settings\n * - Document processing from specified source\n *\n * For server targets, it configures:\n * - TypeScript resolver files generation\n * - Server-side GraphQL type definitions\n * - Resolver function generation\n *\n * @param options - Configuration object containing uri, from, to, and target properties.\n * @param options.uri - The GraphQL schema URI to generate types from.\n * @param options.from - The source path for GraphQL documents (used for client generation).\n * @param options.to - The output path for generated files.\n * @param options.target - The generation target ('client' for frontend, 'server' for backend).\n * @returns A complete GraphQL Code Generator configuration object.\n */\nexport function createGraphqlCodegenConfig({\n    uri,\n    from,\n    to,\n    target = 'client',\n}: I_GraphqlCodegenConfig): CodegenConfig {\n    const isClient = target === 'client';\n    const isServer = target === 'server';\n\n    return {\n        schema: uri,\n        ignoreNoDocuments: true,\n        overwrite: true,\n        ...(isClient && { documents: [from] }),\n        generates: {\n            ...(isClient && {\n                [to]: {\n                    preset: 'client',\n                    presetConfig: {\n                        fragmentMasking: false,\n                        persistedDocuments: true,\n                    },\n                    config: {\n                        useTypeImports: true,\n                        namingConvention: 'keep',\n                    },\n                },\n            }),\n            ...(isServer && {\n                [to]: defineConfig(),\n            }),\n        },\n    };\n}\n"],"names":["defineConfig","loadEnvFile","createGraphqlCodegenConfig","uri","from","to","target","isClient","isServer"],"mappings":"AAQA,SAAA,gBAAAA,SAAA;AAAA,SAAA,eAAAC,SAAA;AAAAA,EAAA;AAyBO,SAASC,EAA2B;AAAA,EACvC,KAAAC;AAAA,EACA,MAAAC;AAAA,EACA,IAAAC;AAAA,EACA,QAAAC,IAAS;AACb,GAA0C;AACtC,QAAMC,IAAWD,MAAW,UACtBE,IAAWF,MAAW;AAE5B,SAAO;AAAA,IACH,QAAQH;AAAA,IACR,mBAAmB;AAAA,IACnB,WAAW;AAAA,IACX,GAAII,KAAY,EAAE,WAAW,CAACH,CAAI,EAAA;AAAA,IAClC,WAAW;AAAA,MACP,GAAIG,KAAY;AAAA,QACZ,CAACF,CAAE,GAAG;AAAA,UACF,QAAQ;AAAA,UACR,cAAc;AAAA,YACV,iBAAiB;AAAA,YACjB,oBAAoB;AAAA,UAAA;AAAA,UAExB,QAAQ;AAAA,YACJ,gBAAgB;AAAA,YAChB,kBAAkB;AAAA,UAAA;AAAA,QACtB;AAAA,MACJ;AAAA,MAEJ,GAAIG,KAAY;AAAA,QACZ,CAACH,CAAE,GAAGL,EAAA;AAAA,MAAa;AAAA,IACvB;AAAA,EACJ;AAER;"}
+{"version":3,"file":"graphql-codegen.util.js","names":[],"sources":["../../../src/config/graphql-codegen/graphql-codegen.util.ts"],"sourcesContent":["import type { CodegenConfig } from '@graphql-codegen/cli';\n\nimport { defineConfig } from '@eddeee888/gcg-typescript-resolver-files';\n\nimport type { I_GraphqlCodegenConfig } from './graphql-codegen.type.js';\n\nimport { loadEnvFile } from '../env/env.util.js';\n\nloadEnvFile();\n\n/**\n * Creates a GraphQL Code Generator configuration for client or server code generation.\n * This function generates a complete GraphQL Code Generator configuration based on\n * the specified target (client or server) with appropriate presets and settings.\n *\n * For client targets, it configures:\n * - Client preset with fragment masking disabled\n * - Persisted documents support\n * - Type imports and naming convention settings\n * - Document processing from specified source\n *\n * For server targets, it configures:\n * - TypeScript resolver files generation\n * - Server-side GraphQL type definitions\n * - Resolver function generation\n *\n * @param options - Configuration object containing uri, from, to, and target properties.\n * @param options.uri - The GraphQL schema URI to generate types from.\n * @param options.from - The source path for GraphQL documents (used for client generation).\n * @param options.to - The output path for generated files.\n * @param options.target - The generation target ('client' for frontend, 'server' for backend).\n * @returns A complete GraphQL Code Generator configuration object.\n */\nexport function createGraphqlCodegenConfig({\n    uri,\n    from,\n    to,\n    target = 'client',\n}: I_GraphqlCodegenConfig): CodegenConfig {\n    const isClient = target === 'client';\n    const isServer = target === 'server';\n\n    return {\n        schema: uri,\n        ignoreNoDocuments: true,\n        overwrite: true,\n        ...(isClient && { documents: [from] }),\n        generates: {\n            ...(isClient && {\n                [to]: {\n                    preset: 'client',\n                    presetConfig: {\n                        fragmentMasking: false,\n                        persistedDocuments: true,\n                    },\n                    config: {\n                        useTypeImports: true,\n                        namingConvention: 'keep',\n                    },\n                },\n            }),\n            ...(isServer && {\n                [to]: defineConfig(),\n            }),\n        },\n    };\n}\n"],"mappings":";;;AAQA,GAAa;AAyBb,SAAgB,EAA2B,EACvC,QACA,SACA,OACA,YAAS,YAC6B;CACtC,IAAM,IAAW,MAAW,UACtB,IAAW,MAAW;AAE5B,QAAO;EACH,QAAQ;EACR,mBAAmB;EACnB,WAAW;EACX,GAAI,KAAY,EAAE,WAAW,CAAC,EAAK,EAAE;EACrC,WAAW;GACP,GAAI,KAAY,GACX,IAAK;IACF,QAAQ;IACR,cAAc;KACV,iBAAiB;KACjB,oBAAoB;KACvB;IACD,QAAQ;KACJ,gBAAgB;KAChB,kBAAkB;KACrB;IACJ,EACJ;GACD,GAAI,KAAY,GACX,IAAK,GAAc,EACvB;GACJ;EACJ"}

package/dist/config/graphql-codegen/index.js

@@ -1,5 +1,2 @@
-import { createGraphqlCodegenConfig as r } from "./graphql-codegen.util.js";
-export {
-  r as createGraphqlCodegenConfig
-};
-//# sourceMappingURL=index.js.map
+import { createGraphqlCodegenConfig as e } from "./graphql-codegen.util.js";
+export { e as createGraphqlCodegenConfig };

package/dist/config/index.js

@@ -1,7 +1,3 @@
-import { E_ConfigType as r } from "./config.type.js";
-import { mergeConfigs as g } from "./config.util.js";
-export {
-  r as E_ConfigType,
-  g as mergeConfigs
-};
-//# sourceMappingURL=index.js.map
+import { E_ConfigType as e } from "./config.type.js";
+import { mergeConfigs as t } from "./config.util.js";
+export { e as E_ConfigType, t as mergeConfigs };

package/dist/config/lint-staged/index.js

@@ -1,8 +1,9 @@
-const t = {
-  "*.ts": () => "tsc --noEmit",
-  "*": ["eslint --fix --no-cache"]
+//#region src/config/lint-staged/index.ts
+var e = {
+	"*.ts": () => "tsc --noEmit",
+	"*": ["eslint --fix --no-cache"]
 };
-export {
-  t as default
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+export { e as default };
+
+//# sourceMappingURL=index.js.map

package/dist/config/lint-staged/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/config/lint-staged/index.ts"],"sourcesContent":["export default {\n    '*.ts': () => 'tsc --noEmit',\n    '*': ['eslint --fix --no-cache'],\n};\n"],"names":["index"],"mappings":"AAAA,MAAAA,IAAe;AAAA,EACX,QAAQ,MAAM;AAAA,EACd,KAAK,CAAC,yBAAyB;AACnC;"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/config/lint-staged/index.ts"],"sourcesContent":["export default {\n    '*.ts': () => 'tsc --noEmit',\n    '*': ['eslint --fix --no-cache'],\n};\n"],"mappings":";AAAA,IAAA,IAAe;CACX,cAAc;CACd,KAAK,CAAC,0BAA0B;CACnC"}

package/dist/config/storybook/index.js

@@ -1,7 +1,3 @@
 import { storybookMain as e } from "./storybook.main.js";
-import { storybookPreview as b } from "./storybook.preview.js";
-export {
-  e as storybookMain,
-  b as storybookPreview
-};
-//# sourceMappingURL=index.js.map
+import { storybookPreview as t } from "./storybook.preview.js";
+export { e as storybookMain, t as storybookPreview };

package/dist/config/storybook/storybook.main.js

@@ -1,19 +1,20 @@
-import { deepMerge as s } from "../../util/object/object.util.js";
-function n(o) {
-  return s({
-    stories: ["../src/**/*.stories.@(js|jsx|mjs|ts|tsx|mdx)"],
-    addons: [
-      "@storybook/addon-essentials",
-      "@storybook/addon-interactions",
-      "@storybook/addon-links"
-    ],
-    framework: {
-      name: "@storybook/react-vite",
-      options: {}
-    }
-  }, o);
+import { deepMerge as e } from "../../util/object/object.util.js";
+//#region src/config/storybook/storybook.main.ts
+function t(t) {
+	return e({
+		stories: ["../src/**/*.stories.@(js|jsx|mjs|ts|tsx|mdx)"],
+		addons: [
+			"@storybook/addon-essentials",
+			"@storybook/addon-interactions",
+			"@storybook/addon-links"
+		],
+		framework: {
+			name: "@storybook/react-vite",
+			options: {}
+		}
+	}, t);
 }
-export {
-  n as storybookMain
-};
-//# sourceMappingURL=storybook.main.js.map
+//#endregion
+export { t as storybookMain };
+
+//# sourceMappingURL=storybook.main.js.map

package/dist/config/storybook/storybook.main.js.map

@@ -1 +1 @@
-{"version":3,"file":"storybook.main.js","sources":["../../../src/config/storybook/storybook.main.ts"],"sourcesContent":["import type { StorybookConfig } from '@storybook/react-vite';\n\nimport { deepMerge } from '../../util/object/index.js';\n\n/**\n * Creates a Storybook main configuration for React projects using Vite.\n * This function generates a Storybook configuration specifically designed for React applications\n * with Vite as the build tool. It includes essential addons and framework settings.\n *\n * The configuration includes:\n * - React Vite framework integration\n * - Essential Storybook addons (docs, controls, actions, viewport, backgrounds)\n * - Story file pattern matching\n * - Vite configuration support\n * - Configurable options merging\n *\n * @param options - Additional Storybook configuration options to merge with the base config.\n * @returns A Storybook configuration object optimized for React with Vite.\n */\nexport function storybookMain(options?: Partial<StorybookConfig>): StorybookConfig {\n    const config: StorybookConfig = {\n        stories: ['../src/**/*.stories.@(js|jsx|mjs|ts|tsx|mdx)'],\n        addons: [\n            '@storybook/addon-essentials',\n            '@storybook/addon-interactions',\n            '@storybook/addon-links',\n        ],\n        framework: {\n            name: '@storybook/react-vite',\n            options: {},\n        },\n    };\n\n    return deepMerge(config, options) as StorybookConfig;\n}\n"],"names":["storybookMain","options","deepMerge"],"mappings":";AAmBO,SAASA,EAAcC,GAAqD;AAc/E,SAAOC,EAbyB;AAAA,IAC5B,SAAS,CAAC,8CAA8C;AAAA,IACxD,QAAQ;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,IAEJ,WAAW;AAAA,MACP,MAAM;AAAA,MACN,SAAS,CAAA;AAAA,IAAC;AAAA,EACd,GAGqBD,CAAO;AACpC;"}
+{"version":3,"file":"storybook.main.js","names":[],"sources":["../../../src/config/storybook/storybook.main.ts"],"sourcesContent":["import type { StorybookConfig } from '@storybook/react-vite';\n\nimport { deepMerge } from '../../util/object/index.js';\n\n/**\n * Creates a Storybook main configuration for React projects using Vite.\n * This function generates a Storybook configuration specifically designed for React applications\n * with Vite as the build tool. It includes essential addons and framework settings.\n *\n * The configuration includes:\n * - React Vite framework integration\n * - Essential Storybook addons (docs, controls, actions, viewport, backgrounds)\n * - Story file pattern matching\n * - Vite configuration support\n * - Configurable options merging\n *\n * @param options - Additional Storybook configuration options to merge with the base config.\n * @returns A Storybook configuration object optimized for React with Vite.\n */\nexport function storybookMain(options?: Partial<StorybookConfig>): StorybookConfig {\n    const config: StorybookConfig = {\n        stories: ['../src/**/*.stories.@(js|jsx|mjs|ts|tsx|mdx)'],\n        addons: [\n            '@storybook/addon-essentials',\n            '@storybook/addon-interactions',\n            '@storybook/addon-links',\n        ],\n        framework: {\n            name: '@storybook/react-vite',\n            options: {},\n        },\n    };\n\n    return deepMerge(config, options) as StorybookConfig;\n}\n"],"mappings":";;AAmBA,SAAgB,EAAc,GAAqD;AAc/E,QAAO,EAbyB;EAC5B,SAAS,CAAC,+CAA+C;EACzD,QAAQ;GACJ;GACA;GACA;GACH;EACD,WAAW;GACP,MAAM;GACN,SAAS,EAAE;GACd;EACJ,EAEwB,EAAQ"}

package/dist/config/storybook/storybook.preview.js

@@ -1,38 +1,32 @@
-const a = /(background|color)$/i, t = /Date$/i;
-function o(e) {
-  const r = {
-    parameters: {
-      controls: {
-        matchers: {
-          color: a,
-          date: t
-        }
-      },
-      backgrounds: {
-        default: "light",
-        values: [
-          {
-            name: "light",
-            value: "#ffffff"
-          },
-          {
-            name: "dark",
-            value: "#333333"
-          }
-        ]
-      }
-    }
-  };
-  return {
-    ...r,
-    ...e,
-    parameters: {
-      ...r.parameters,
-      ...e?.parameters
-    }
-  };
+//#region src/config/storybook/storybook.preview.ts
+var e = /(background|color)$/i, t = /Date$/i;
+function n(n) {
+	let r = { parameters: {
+		controls: { matchers: {
+			color: e,
+			date: t
+		} },
+		backgrounds: {
+			default: "light",
+			values: [{
+				name: "light",
+				value: "#ffffff"
+			}, {
+				name: "dark",
+				value: "#333333"
+			}]
+		}
+	} };
+	return {
+		...r,
+		...n,
+		parameters: {
+			...r.parameters,
+			...n?.parameters
+		}
+	};
 }
-export {
-  o as storybookPreview
-};
-//# sourceMappingURL=storybook.preview.js.map
+//#endregion
+export { n as storybookPreview };
+
+//# sourceMappingURL=storybook.preview.js.map

package/dist/config/storybook/storybook.preview.js.map

@@ -1 +1 @@
-{"version":3,"file":"storybook.preview.js","sources":["../../../src/config/storybook/storybook.preview.ts"],"sourcesContent":["import type { Preview } from '@storybook/react';\n\nconst RE_COLOR_MATCHER = /(background|color)$/i;\nconst RE_DATE_MATCHER = /Date$/i;\n\n/**\n * Creates a Storybook preview configuration with preconfigured controls and background settings.\n * This function generates a preview configuration that provides default parameters\n * and decorators for Storybook stories. It sets up common controls, backgrounds,\n * and viewport settings for consistent story rendering.\n *\n * The configuration includes:\n * - Default control parameters for common props\n * - Background color options\n * - Viewport presets for responsive testing\n * - Actions configuration for event handlers\n * - Configurable options merging\n *\n * @param options - Additional preview configuration options to merge with the base config.\n * @returns A Storybook preview configuration object.\n */\nexport function storybookPreview(options?: Partial<Preview>): Preview {\n    const preview: Preview = {\n        parameters: {\n            controls: {\n                matchers: {\n                    color: RE_COLOR_MATCHER,\n                    date: RE_DATE_MATCHER,\n                },\n            },\n            backgrounds: {\n                default: 'light',\n                values: [\n                    {\n                        name: 'light',\n                        value: '#ffffff',\n                    },\n                    {\n                        name: 'dark',\n                        value: '#333333',\n                    },\n                ],\n            },\n        },\n    };\n\n    return {\n        ...preview,\n        ...options,\n        parameters: {\n            ...preview.parameters,\n            ...options?.parameters,\n        },\n    };\n}\n"],"names":["RE_COLOR_MATCHER","RE_DATE_MATCHER","storybookPreview","options","preview"],"mappings":"AAEA,MAAMA,IAAmB,wBACnBC,IAAkB;AAkBjB,SAASC,EAAiBC,GAAqC;AAClE,QAAMC,IAAmB;AAAA,IACrB,YAAY;AAAA,MACR,UAAU;AAAA,QACN,UAAU;AAAA,UACN,OAAOJ;AAAA,UACP,MAAMC;AAAA,QAAA;AAAA,MACV;AAAA,MAEJ,aAAa;AAAA,QACT,SAAS;AAAA,QACT,QAAQ;AAAA,UACJ;AAAA,YACI,MAAM;AAAA,YACN,OAAO;AAAA,UAAA;AAAA,UAEX;AAAA,YACI,MAAM;AAAA,YACN,OAAO;AAAA,UAAA;AAAA,QACX;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAGJ,SAAO;AAAA,IACH,GAAGG;AAAA,IACH,GAAGD;AAAA,IACH,YAAY;AAAA,MACR,GAAGC,EAAQ;AAAA,MACX,GAAGD,GAAS;AAAA,IAAA;AAAA,EAChB;AAER;"}
+{"version":3,"file":"storybook.preview.js","names":[],"sources":["../../../src/config/storybook/storybook.preview.ts"],"sourcesContent":["import type { Preview } from '@storybook/react';\n\nconst RE_COLOR_MATCHER = /(background|color)$/i;\nconst RE_DATE_MATCHER = /Date$/i;\n\n/**\n * Creates a Storybook preview configuration with preconfigured controls and background settings.\n * This function generates a preview configuration that provides default parameters\n * and decorators for Storybook stories. It sets up common controls, backgrounds,\n * and viewport settings for consistent story rendering.\n *\n * The configuration includes:\n * - Default control parameters for common props\n * - Background color options\n * - Viewport presets for responsive testing\n * - Actions configuration for event handlers\n * - Configurable options merging\n *\n * @param options - Additional preview configuration options to merge with the base config.\n * @returns A Storybook preview configuration object.\n */\nexport function storybookPreview(options?: Partial<Preview>): Preview {\n    const preview: Preview = {\n        parameters: {\n            controls: {\n                matchers: {\n                    color: RE_COLOR_MATCHER,\n                    date: RE_DATE_MATCHER,\n                },\n            },\n            backgrounds: {\n                default: 'light',\n                values: [\n                    {\n                        name: 'light',\n                        value: '#ffffff',\n                    },\n                    {\n                        name: 'dark',\n                        value: '#333333',\n                    },\n                ],\n            },\n        },\n    };\n\n    return {\n        ...preview,\n        ...options,\n        parameters: {\n            ...preview.parameters,\n            ...options?.parameters,\n        },\n    };\n}\n"],"mappings":";AAEA,IAAM,IAAmB,wBACnB,IAAkB;AAkBxB,SAAgB,EAAiB,GAAqC;CAClE,IAAM,IAAmB,EACrB,YAAY;EACR,UAAU,EACN,UAAU;GACN,OAAO;GACP,MAAM;GACT,EACJ;EACD,aAAa;GACT,SAAS;GACT,QAAQ,CACJ;IACI,MAAM;IACN,OAAO;IACV,EACD;IACI,MAAM;IACN,OAAO;IACV,CACJ;GACJ;EACJ,EACJ;AAED,QAAO;EACH,GAAG;EACH,GAAG;EACH,YAAY;GACR,GAAG,EAAQ;GACX,GAAG,GAAS;GACf;EACJ"}