xenopomp-essentials 0.0.1-beta.9 → 0.1.0

package/cli-tools/index.d.mts

@@ -0,0 +1,60 @@
+/**
+ * Fluent interface for creating paths of application.
+ *
+ * @since 0.0.1
+ *
+ * @example
+ * import { PathBuilder } from 'xenopomp-essentials/cli-tools';
+ *
+ * const builder = new PathBuilder();
+ *
+ * const res = builder
+ *  .appSource()
+ *  .cd('./dist/src')
+ *  .file('.prettierrc')
+ *  .build();
+ *
+ *  console.log(res); //? C:/Projects/example/node_modules/xenopomp-essentials/dist/src/.prettierrc
+ */
+declare class PathBuilder {
+    private paths;
+    private pushPaths;
+    /**
+     * Pushes any custom paths to builder.
+     * @since 0.0.1
+     * @param paths
+     */
+    cd(...paths: string[]): PathBuilder;
+    /**
+     * Pushes filename to paths.
+     * @since 0.0.1
+     * @param fileName
+     */
+    file<T extends `${string}.${string}`>(fileName: T): PathBuilder;
+    /**
+     * Pushes path to compiled app directory.
+     * Is useful for cli tools that have to access files inside their bundles.
+     *
+     * It probably may take no effect (if import.meta is not available in a scope).
+     * If it is, will push cwd.
+     *
+     * @since 0.0.1
+     */
+    appSource(): PathBuilder;
+    /**
+     * Gets path of directory where script is running. In cli tools it access
+     * path, where cli tool was started.
+     * @since 0.0.1
+     */
+    cwd(): PathBuilder;
+    /**
+     * @since 0.0.1
+     */
+    clear(): PathBuilder;
+    /**
+     * @since 0.0.1
+     */
+    build(): string;
+}
+
+export { PathBuilder };

package/cli-tools/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Fluent interface for creating paths of application.
+ *
+ * @since 0.0.1
+ *
+ * @example
+ * import { PathBuilder } from 'xenopomp-essentials/cli-tools';
+ *
+ * const builder = new PathBuilder();
+ *
+ * const res = builder
+ *  .appSource()
+ *  .cd('./dist/src')
+ *  .file('.prettierrc')
+ *  .build();
+ *
+ *  console.log(res); //? C:/Projects/example/node_modules/xenopomp-essentials/dist/src/.prettierrc
+ */
+declare class PathBuilder {
+    private paths;
+    private pushPaths;
+    /**
+     * Pushes any custom paths to builder.
+     * @since 0.0.1
+     * @param paths
+     */
+    cd(...paths: string[]): PathBuilder;
+    /**
+     * Pushes filename to paths.
+     * @since 0.0.1
+     * @param fileName
+     */
+    file<T extends `${string}.${string}`>(fileName: T): PathBuilder;
+    /**
+     * Pushes path to compiled app directory.
+     * Is useful for cli tools that have to access files inside their bundles.
+     *
+     * It probably may take no effect (if import.meta is not available in a scope).
+     * If it is, will push cwd.
+     *
+     * @since 0.0.1
+     */
+    appSource(): PathBuilder;
+    /**
+     * Gets path of directory where script is running. In cli tools it access
+     * path, where cli tool was started.
+     * @since 0.0.1
+     */
+    cwd(): PathBuilder;
+    /**
+     * @since 0.0.1
+     */
+    clear(): PathBuilder;
+    /**
+     * @since 0.0.1
+     */
+    build(): string;
+}
+
+export { PathBuilder };

package/cli-tools/index.mjs

@@ -0,0 +1 @@
+import s from"node:path";import{z as r}from"zod";const i=r.object({dirname:r.string().optional()}),h=i.parse(import.meta);class a{paths=[];pushPaths(...t){return this.paths.push(...t),this}cd(...t){return this.pushPaths(...t)}file(t){return this.pushPaths(`./${t}`)}appSource(){return h.dirname?this.pushPaths(s.join(s.dirname(h.dirname),"../")):this.cwd()}cwd(){return this.pushPaths(process.cwd())}clear(){return this.paths=[],this}build(){return s.join(...this.paths)}}export{a as PathBuilder};

package/eslint/index.d.mts

@@ -0,0 +1,10 @@
+import ririd from '@ririd/eslint-config';
+import { D as Defined } from '../shared/xenopomp-essentials.BFV6RP1V.mjs';
+
+type RiridParams = Parameters<typeof ririd>;
+type RiridOptions = Defined<RiridParams[0]>;
+type UserConfig = Defined<RiridParams[1]>;
+
+declare function xenopomp(options?: RiridOptions, ...userConfigs: UserConfig[]): ReturnType<typeof ririd>;
+
+export { xenopomp as default };

package/eslint/index.d.ts

@@ -0,0 +1,10 @@
+import ririd from '@ririd/eslint-config';
+import { D as Defined } from '../shared/xenopomp-essentials.BFV6RP1V.js';
+
+type RiridParams = Parameters<typeof ririd>;
+type RiridOptions = Defined<RiridParams[0]>;
+type UserConfig = Defined<RiridParams[1]>;
+
+declare function xenopomp(options?: RiridOptions, ...userConfigs: UserConfig[]): ReturnType<typeof ririd>;
+
+export { xenopomp as default };

package/eslint/index.mjs

@@ -0,0 +1 @@
+import s from"@ririd/eslint-config";import{deepmerge as r}from"deepmerge-ts";import e from"globals";const n={next:!0,react:!0,jsonc:!1,yaml:!1,stylistic:{semi:!0,quotes:"single"},typescript:{overrides:{"ts/consistent-type-definitions":["error","interface"],"ts/interface-name-prefix":"off","ts/explicit-function-return-type":"off","ts/explicit-module-boundary-types":"off","ts/no-explicit-any":"off"}},rules:{"import/order":"off","react/react-in-jsx-scope":"off","react/prop-types":"off","antfu/top-level-function":"off","perfectionist/sort-imports":"off","perfectionist/sort-named-imports":"off","perfectionist/sort-named-exports":"off","antfu/consistent-chaining":"off","perfectionist/sort-exports":"off","style/no-multiple-empty-lines":"off"}};function i(t,...o){return s(r(n,t),{name:"Old config",languageOptions:{globals:{...e.browser,...e.jquery,...e.node,document:"readonly",navigator:"readonly",window:"readonly"}},ignores:["**/.next/*","**/node_modules/*","**/.github/*","cypress","**/__tests__/e2e/*","*.json","**/*.d.ts",".eslintrc.js","eslint.config.js",".prettierrc",".stylelintrc.js","tsconfig.json","package.json","*.md","*.config.ts","*.config.js","*.md"]},{name:"Rules breakup #1",rules:{"@next/next/no-duplicate-head":"off"}},{name:"Rules breakup #2",rules:{"style/operator-linebreak":"off","test/consistent-test-it":"off","test/prefer-lowercase-title":"off","style/jsx-quotes":"off","style/multiline-ternary":"off","style/indent":"off"},ignores:["cypress"]},...o)}export{i as default};

package/index.d.mts

@@ -1,6 +1,7 @@
 import { ElementType, ComponentProps, FC, ReactNode, Dispatch, SetStateAction } from 'react';
+export { D as Defined } from './shared/xenopomp-essentials.BFV6RP1V.mjs';
 import { Jsonifiable } from 'type-fest';
-export { transliterate } from 'transliteration';
+import * as transliteration from 'transliteration';
 
 /**
  * Matches any object but not arrays, class instances etc.
@@ -134,6 +135,11 @@ type FunctionalChildren<Args extends any[]> = ReactNode | ((...args: Args) => Re
  */
 type FcProps<Comp> = Comp extends FC<infer Props> ? Props : never;
 
+/**
+ * Matches any proper React component.
+ */
+type AnyFC = FC<unknown>;
+
 /**
  * Make any async func synchronous.
  *
@@ -227,12 +233,6 @@ type DeepInject<T, I extends AnyObject> = T extends object ? {
     [K in keyof T]: T[K] extends object ? T[K] & I & DeepInject<T[K], I> : T[K];
 } & I : T;
 
-/**
- * Removes undefined from union type.
- * @since 0.0.1
- */
-type Defined<T> = Exclude<T, undefined>;
-
 /**
  * Return never if type does not match JSON schema.
  *
@@ -498,4 +498,67 @@ interface VersionData {
  */
 declare const parseVersion: (raw: string) => VersionData;
 
-export { type AnyObject, type ArrayItemType, type ArrayType, type AsyncFC, type AsyncReturnType, type AsyncVariableFC, type DeepInject, type DeepWriteable, type Defined, type EmptyObject, type FcProps, type Fn, type FunctionalChildren, type Jsonish, type Lenient, type LenientAutocomplete, type MatchType, type MergeTypes, type Modify, type NextErrorParams, type NextParams, type NextSearchParams, type Nullable, type OneOf, type OnlyFirst, type Preid, type RecordKey, type RecordValue, type ReplaceReturnType, type SelectivePartial, type SetState, type StrictOmit, type Synchronous, type Undefinable, type VariableFC, type VersionData, type WeakOmit, type Writeable, capitalize, parseVersion, pipe, uncapitalize };
+/**
+ * Transforms any given string to transliterated variant.
+ *
+ * @since 0.0.1
+ */
+declare const transliterate: transliteration.TransliterateFunction;
+
+/**
+ * Constraints number with min and max values.
+ * @param num
+ * @param min
+ * @param max
+ *
+ * @example Min value
+ * console.log({
+ *   ogNum: 1, // 1
+ *   minmax: minmax(1, [2, undefined]), // 2
+ * });
+ *
+ * @example Max value
+ * console.log({
+ *   ogNum: 1001, // 1001
+ *   minmax: minmax(1001, [undefined, 900]), // 900
+ * });
+ *
+ * @example Min and max value
+ * console.log({
+ *   ogNum: 600, // 600
+ *   minmax: minmax(1001, [2, 900]), // 600
+ * });
+ */
+declare const minmax: (num: number, [min, max]: [min: number | undefined, max: number | undefined]) => number;
+
+/**
+ * Creates properly type object with jsxDotNotation.
+ *
+ * @param comp
+ * @param rest
+ *
+ * @example
+ * const FlexComp: FC<PropsWithChildren> = ({ children }) => <div>{children}</div>;
+ * const FlexRow: FC<PropsWithChildren & { short?: boolean }> = ({ children }) => (
+ *   <div>{children}</div>
+ * );
+ * const FlexCol: FC<PropsWithChildren> = ({ children }) => <div>{children}</div>;
+ *
+ * const Flex = jsxDotNotation(FlexComp, {
+ *   Row: FlexRow,
+ *   Col: FlexCol,
+ * });
+ *
+ * const Am = () => {
+ *   return (
+ *     <Flex>
+ *       <Flex.Row short>
+ *         <Flex.Col></Flex.Col>
+ *       </Flex.Row>
+ *     </Flex>
+ *   );
+ * };
+ */
+declare function jsxDotNotation<Props = EmptyObject, Rest extends Record<string, FC<AnyObject>> = EmptyObject>(comp: FC<Props>, rest: Rest): FC<Props> & Rest;
+
+export { type AnyFC, type AnyObject, type ArrayItemType, type ArrayType, type AsyncFC, type AsyncReturnType, type AsyncVariableFC, type DeepInject, type DeepWriteable, type EmptyObject, type FcProps, type Fn, type FunctionalChildren, type Jsonish, type Lenient, type LenientAutocomplete, type MatchType, type MergeTypes, type Modify, type NextErrorParams, type NextParams, type NextSearchParams, type Nullable, type OneOf, type OnlyFirst, type Preid, type RecordKey, type RecordValue, type ReplaceReturnType, type SelectivePartial, type SetState, type StrictOmit, type Synchronous, type Undefinable, type VariableFC, type VersionData, type WeakOmit, type Writeable, capitalize, jsxDotNotation, minmax, parseVersion, pipe, transliterate, uncapitalize };

package/index.d.ts

@@ -1,6 +1,7 @@
 import { ElementType, ComponentProps, FC, ReactNode, Dispatch, SetStateAction } from 'react';
+export { D as Defined } from './shared/xenopomp-essentials.BFV6RP1V.js';
 import { Jsonifiable } from 'type-fest';
-export { transliterate } from 'transliteration';
+import * as transliteration from 'transliteration';
 
 /**
  * Matches any object but not arrays, class instances etc.
@@ -134,6 +135,11 @@ type FunctionalChildren<Args extends any[]> = ReactNode | ((...args: Args) => Re
  */
 type FcProps<Comp> = Comp extends FC<infer Props> ? Props : never;
 
+/**
+ * Matches any proper React component.
+ */
+type AnyFC = FC<unknown>;
+
 /**
  * Make any async func synchronous.
  *
@@ -227,12 +233,6 @@ type DeepInject<T, I extends AnyObject> = T extends object ? {
     [K in keyof T]: T[K] extends object ? T[K] & I & DeepInject<T[K], I> : T[K];
 } & I : T;
 
-/**
- * Removes undefined from union type.
- * @since 0.0.1
- */
-type Defined<T> = Exclude<T, undefined>;
-
 /**
  * Return never if type does not match JSON schema.
  *
@@ -498,4 +498,67 @@ interface VersionData {
  */
 declare const parseVersion: (raw: string) => VersionData;
 
-export { type AnyObject, type ArrayItemType, type ArrayType, type AsyncFC, type AsyncReturnType, type AsyncVariableFC, type DeepInject, type DeepWriteable, type Defined, type EmptyObject, type FcProps, type Fn, type FunctionalChildren, type Jsonish, type Lenient, type LenientAutocomplete, type MatchType, type MergeTypes, type Modify, type NextErrorParams, type NextParams, type NextSearchParams, type Nullable, type OneOf, type OnlyFirst, type Preid, type RecordKey, type RecordValue, type ReplaceReturnType, type SelectivePartial, type SetState, type StrictOmit, type Synchronous, type Undefinable, type VariableFC, type VersionData, type WeakOmit, type Writeable, capitalize, parseVersion, pipe, uncapitalize };
+/**
+ * Transforms any given string to transliterated variant.
+ *
+ * @since 0.0.1
+ */
+declare const transliterate: transliteration.TransliterateFunction;
+
+/**
+ * Constraints number with min and max values.
+ * @param num
+ * @param min
+ * @param max
+ *
+ * @example Min value
+ * console.log({
+ *   ogNum: 1, // 1
+ *   minmax: minmax(1, [2, undefined]), // 2
+ * });
+ *
+ * @example Max value
+ * console.log({
+ *   ogNum: 1001, // 1001
+ *   minmax: minmax(1001, [undefined, 900]), // 900
+ * });
+ *
+ * @example Min and max value
+ * console.log({
+ *   ogNum: 600, // 600
+ *   minmax: minmax(1001, [2, 900]), // 600
+ * });
+ */
+declare const minmax: (num: number, [min, max]: [min: number | undefined, max: number | undefined]) => number;
+
+/**
+ * Creates properly type object with jsxDotNotation.
+ *
+ * @param comp
+ * @param rest
+ *
+ * @example
+ * const FlexComp: FC<PropsWithChildren> = ({ children }) => <div>{children}</div>;
+ * const FlexRow: FC<PropsWithChildren & { short?: boolean }> = ({ children }) => (
+ *   <div>{children}</div>
+ * );
+ * const FlexCol: FC<PropsWithChildren> = ({ children }) => <div>{children}</div>;
+ *
+ * const Flex = jsxDotNotation(FlexComp, {
+ *   Row: FlexRow,
+ *   Col: FlexCol,
+ * });
+ *
+ * const Am = () => {
+ *   return (
+ *     <Flex>
+ *       <Flex.Row short>
+ *         <Flex.Col></Flex.Col>
+ *       </Flex.Row>
+ *     </Flex>
+ *   );
+ * };
+ */
+declare function jsxDotNotation<Props = EmptyObject, Rest extends Record<string, FC<AnyObject>> = EmptyObject>(comp: FC<Props>, rest: Rest): FC<Props> & Rest;
+
+export { type AnyFC, type AnyObject, type ArrayItemType, type ArrayType, type AsyncFC, type AsyncReturnType, type AsyncVariableFC, type DeepInject, type DeepWriteable, type EmptyObject, type FcProps, type Fn, type FunctionalChildren, type Jsonish, type Lenient, type LenientAutocomplete, type MatchType, type MergeTypes, type Modify, type NextErrorParams, type NextParams, type NextSearchParams, type Nullable, type OneOf, type OnlyFirst, type Preid, type RecordKey, type RecordValue, type ReplaceReturnType, type SelectivePartial, type SetState, type StrictOmit, type Synchronous, type Undefinable, type VariableFC, type VersionData, type WeakOmit, type Writeable, capitalize, jsxDotNotation, minmax, parseVersion, pipe, transliterate, uncapitalize };

package/index.mjs

@@ -1 +1 @@
-export{transliterate}from"transliteration";function n(t){function e(r){return t(r)}return e.pipe=r=>n(i=>r(t(i))),e}function a(t){return t.charAt(0).toUpperCase()+t.slice(1)}function c(t){return t.charAt(0).toLowerCase()+t.slice(1)}const o=t=>{const e=t.match(/(\d\.){2}\d/gi)?.at(0)||null,r=t.match(/(?<=-)\w+(?=\.\d)/gi)?.at(0),i=t.match(/(?<=((\d\.){2}\d-\w+\.))\d+/gi)?.at(0);return{version:e,preid:r,prerelease:i}};export{a as capitalize,o as parseVersion,n as pipe,c as uncapitalize};
+import{transliterate as a}from"transliteration";function i(t){function r(n){return t(n)}return r.pipe=n=>i(e=>n(t(e))),r}function o(t){return t.charAt(0).toUpperCase()+t.slice(1)}function c(t){return t.charAt(0).toLowerCase()+t.slice(1)}const s=t=>{const r=t.match(/(\d\.){2}\d/gi)?.at(0)||null,n=t.match(/(?<=-)\w+(?=\.\d)/gi)?.at(0),e=t.match(/(?<=((\d\.){2}\d-\w+\.))\d+/gi)?.at(0);return{version:r,preid:n,prerelease:e}},p=a,u=(t,[r,n])=>r&&t<=r?r:n&&t>=n?n:t;function l(t,r){return Object.assign(t,r)}export{o as capitalize,l as jsxDotNotation,u as minmax,s as parseVersion,i as pipe,p as transliterate,c as uncapitalize};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xenopomp-essentials",
-  "version": "0.0.1-beta.9",
+  "version": "0.1.0",
   "author": "XenoPOMP <101574433+XenoPOMP@users.noreply.github.com>",
   "license": "MIT",
   "type": "module",
@@ -20,7 +20,7 @@
     "build:main": "unbuild --config .config/build.config.ts",
     "build:packages:cli": "echo CLI",
     "lint": "run-s lint:*",
-    "lint:code": "eslint -c ./.config/eslint.config.mjs .",
+    "lint:code": "eslint",
     "coverage": "vitest run --coverage -c ./.config/vitest.config.ts",
     "prepare": "husky"
   },
@@ -28,18 +28,26 @@
   "types": "./index.d.ts",
   "peerDependencies": {
     "@types/react": ">=19",
+    "eslint": "^9",
     "next": ">=15",
     "react": ">=19",
     "type-fest": ">=4",
-    "typescript": ">=5.4"
+    "typescript": ">=5.4",
+    "zod": "*"
   },
   "dependencies": {
+    "@antfu/eslint-config": "^4.10.1",
+    "@ririd/eslint-config": "^1.4.0",
     "@types/react": "^19.0.8",
+    "deepmerge-ts": "^7.1.5",
+    "eslint": "^9.22.0",
+    "globals": "^16.0.0",
     "next": "^15.1.6",
     "react": "^19.0.0",
     "transliteration": "^2.3.5",
     "type-fest": "^4.33.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.7.3",
+    "zod": "^3.24.1"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.0",
@@ -47,11 +55,10 @@
     "@trivago/prettier-plugin-sort-imports": "^5.2.1",
     "@vitejs/plugin-react": "^4.3.4",
     "@vitest/coverage-istanbul": "^3.0.4",
-    "eslint": "^9.19.0",
-    "eslint-config-xeno": "^2.0.3-rc.3",
     "esno": "^4.8.0",
     "husky": "^9.1.7",
     "hygen": "^6.2.11",
+    "jiti": "^2.4.2",
     "jsdom": "^26.0.0",
     "lint-staged": "^15.4.2",
     "npm-run-all": "^4.1.5",
@@ -62,7 +69,6 @@
     "unbuild": "^3.3.1",
     "vite": "^6.0.11",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^3.0.4",
-    "zod": "^3.24.1"
+    "vitest": "^3.0.4"
   }
 }

package/shared/xenopomp-essentials.BFV6RP1V.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Removes undefined from union type.
+ * @since 0.0.1
+ */
+type Defined<T> = Exclude<T, undefined>;
+
+export type { Defined as D };

package/shared/xenopomp-essentials.BFV6RP1V.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Removes undefined from union type.
+ * @since 0.0.1
+ */
+type Defined<T> = Exclude<T, undefined>;
+
+export type { Defined as D };