build(deps): bump @flex-development/tutils from 6.0.0-alpha.10 to 6.0.0-alpha.12

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Author: unicornware

.eslintrc.base.cjs

@@ -246,7 +246,7 @@ const config = {
             allowedNames: ['self']
           }
         ],
-        '@typescript-eslint/no-throw-literal': 2,
+        '@typescript-eslint/no-throw-literal': 0,
         '@typescript-eslint/no-type-alias': 0,
         '@typescript-eslint/no-unnecessary-boolean-literal-compare': [
           2,
@@ -581,6 +581,7 @@ const config = {
         'no-return-await': 0,
         'no-shadow': 0,
         'no-sparse-arrays': 0,
+        'no-throw-literal': 0,
         'no-unused-expressions': 0,
         'no-unused-vars': 0,
         'no-use-before-define': 0,
@@ -661,7 +662,7 @@ const config = {
             terms: ['@fixme', '@todo']
           }
         ],
-        'unicorn/explicit-length-check': 2,
+        'unicorn/explicit-length-check': 0,
         'unicorn/filename-case': [
           2,
           {
@@ -858,7 +859,6 @@ const config = {
         'promise/valid-params': 0,
         'unicorn/consistent-destructuring': 0,
         'unicorn/error-message': 0,
-        'unicorn/explicit-length-check': 0,
         'unicorn/no-array-for-each': 0,
         'unicorn/no-hex-escape': 0,
         'unicorn/no-useless-undefined': 0,

package.json

@@ -80,8 +80,8 @@
     "typecheck:watch": "vitest typecheck"
   },
   "dependencies": {
-    "@flex-development/errnode": "1.5.0",
-    "@flex-development/tutils": "6.0.0-alpha.10"
+    "@flex-development/errnode": "2.0.0",
+    "@flex-development/tutils": "6.0.0-alpha.12"
   },
   "devDependencies": {
     "@commitlint/cli": "17.6.3",
@@ -164,7 +164,7 @@
   },
   "resolutions": {
     "@ardatan/sync-fetch": "larsgw/sync-fetch#head=worker_threads",
-    "@flex-development/tutils": "6.0.0-alpha.10"
+    "@flex-development/tutils": "6.0.0-alpha.12"
   },
   "engines": {
     "node": ">=16.20.0",

src/interfaces/__tests__/parsed-path.spec-d.ts

@@ -7,22 +7,22 @@ import type TestSubject from '../parsed-path'
 
 describe('unit-d:interfaces/ParsedPath', () => {
   it('should match [base: string]', () => {
-    expectTypeOf<TestSubject>().toHaveProperty('base').toBeString()
+    expectTypeOf<TestSubject>().toHaveProperty('base').toEqualTypeOf<string>()
   })
 
   it('should match [dir: string]', () => {
-    expectTypeOf<TestSubject>().toHaveProperty('dir').toBeString()
+    expectTypeOf<TestSubject>().toHaveProperty('dir').toEqualTypeOf<string>()
   })
 
   it('should match [ext: string]', () => {
-    expectTypeOf<TestSubject>().toHaveProperty('ext').toBeString()
+    expectTypeOf<TestSubject>().toHaveProperty('ext').toEqualTypeOf<string>()
   })
 
   it('should match [name: string]', () => {
-    expectTypeOf<TestSubject>().toHaveProperty('name').toBeString()
+    expectTypeOf<TestSubject>().toHaveProperty('name').toEqualTypeOf<string>()
   })
 
   it('should match [root: string]', () => {
-    expectTypeOf<TestSubject>().toHaveProperty('root').toBeString()
+    expectTypeOf<TestSubject>().toHaveProperty('root').toEqualTypeOf<string>()
   })
 })

src/interfaces/__tests__/path-object.spec-d.ts

@@ -3,12 +3,12 @@
  * @module pathe/interfaces/tests/unit-d/PathObject
  */
 
-import type { KeysRequired } from '@flex-development/tutils'
+import type { RequiredKeys } from '@flex-development/tutils'
 import type TestSubject from '../path-object'
 
 describe('unit-d:interfaces/PathObject', () => {
   it('should allow empty object', () => {
-    expectTypeOf<KeysRequired<TestSubject>>().toBeNever()
+    expectTypeOf<RequiredKeys<TestSubject>>().toBeNever()
   })
 
   it('should match [base?: string]', () => {

src/interfaces/parsed-path.ts

@@ -3,7 +3,7 @@
  * @module pathe/interfaces/ParsedPath
  */
 
-import type { ExactOptionalPropertyTypes } from '@flex-development/tutils'
+import type { Shake } from '@flex-development/tutils'
 import type PathObject from './path-object'
 
 /**
@@ -17,8 +17,8 @@ import type PathObject from './path-object'
  *
  * @see [`PathObject`][3]
  *
- * @extends {ExactOptionalPropertyTypes<Required<PathObject>>}
+ * @extends {Required<Shake<PathObject>>}
  */
-interface ParsedPath extends ExactOptionalPropertyTypes<Required<PathObject>> {}
+interface ParsedPath extends Required<Shake<PathObject>> {}
 
 export type { ParsedPath as default }

src/interfaces/path-object.ts

@@ -3,6 +3,8 @@
  * @module pathe/interfaces/PathObject
  */
 
+import type { Optional } from '@flex-development/tutils'
+
 /**
  * Object representing a path.
  */
@@ -15,7 +17,7 @@ interface PathObject {
    * @example
    *  'index.html'
    */
-  base?: string | undefined
+  base?: Optional<string>
 
   /**
    * Directory name or full directory path.
@@ -27,7 +29,7 @@ interface PathObject {
    * @example
    * '/home/user/dir'
    */
-  dir?: string | undefined
+  dir?: Optional<string>
 
   /**
    * File extension (if any).
@@ -39,7 +41,7 @@ interface PathObject {
    * @example
    *  'ts'
    */
-  ext?: string | undefined
+  ext?: Optional<string>
 
   /**
    * File name without extension (if any).
@@ -49,7 +51,7 @@ interface PathObject {
    * @example
    *  'index'
    */
-  name?: string | undefined
+  name?: Optional<string>
 
   /**
    * Root of path.
@@ -61,7 +63,7 @@ interface PathObject {
    * @example
    *  'c:\\'
    */
-  root?: string | undefined
+  root?: Optional<string>
 }
 
 export type { PathObject as default }

src/interfaces/pathe.ts

@@ -4,7 +4,7 @@
  */
 
 import type { Ext } from '#src/types'
-import type { EmptyString, Nullable } from '@flex-development/tutils'
+import type { EmptyString, Nilable } from '@flex-development/tutils'
 import type PlatformPath from './platform-path'
 
 /**
@@ -20,11 +20,11 @@ interface Pathe extends PlatformPath {
    * Does nothing if a file extension is not provided.
    *
    * @param {string} path - Path to evaluate
-   * @param {Nullable<string>} [ext] - File extension to add
+   * @param {Nilable<string>} [ext] - File extension to add
    * @return {string} `path` unmodified or with `ext` appended
    * @throws {TypeError} If `path` is not a string or `ext` is not a string
    */
-  addExt(path: string, ext?: Nullable<string>): string
+  addExt(path: string, ext?: Nilable<string>): string
 
   /**
    * Changes the file extension of the given `path`.
@@ -33,11 +33,11 @@ interface Pathe extends PlatformPath {
    * an empty string, however, `path`'s file extension will be removed.
    *
    * @param {string} path - Path to evaluate
-   * @param {Nullable<string>} [ext] - New file extension
+   * @param {Nilable<string>} [ext] - New file extension
    * @return {string} `path` unmodified or with changed file extension
    * @throws {TypeError} If `path` is not a string or `ext` is not a string
    */
-  changeExt(path: string, ext?: Nullable<string>): string
+  changeExt(path: string, ext?: Nilable<string>): string
 
   /**
    * Appends a file extension to the given `path` if and only if the path does
@@ -47,12 +47,12 @@ interface Pathe extends PlatformPath {
    * Does nothing if a file extension isn't provided.
    *
    * @param {string} path - Path to evaluate
-   * @param {Nullable<string>} [ext] - Default file extension
+   * @param {Nilable<string>} [ext] - Default file extension
    * @param {string[]} [ignore] - File extensions to ignore if found
    * @return {string} `path` unmodified or with `ext` appended
    * @throws {TypeError} If `path` is not a string or `ext` is not a string
    */
-  defaultExt(path: string, ext?: Nullable<string>, ignore?: string[]): string
+  defaultExt(path: string, ext?: Nilable<string>, ignore?: string[]): string
 
   /**
    * Formats a file extension.
@@ -75,11 +75,11 @@ interface Pathe extends PlatformPath {
    * a file extension isn't provided.
    *
    * @param {string} path - Path to evaluate
-   * @param {Nullable<string>} [ext] - File extension to removed
+   * @param {Nilable<string>} [ext] - File extension to removed
    * @return {string} `path` unmodified or with `ext` removed
    * @throws {TypeError} If `path` is not a string or `ext` is not a string
    */
-  removeExt(path: string, ext?: Nullable<string>): string
+  removeExt(path: string, ext?: Nilable<string>): string
 }
 
 export type { Pathe as default }

src/internal/constants.ts

@@ -3,13 +3,6 @@
  * @module pathe/internal/constants
  */
 
-/**
- * Dot character.
- *
- * @const {string} DOT
- */
-const DOT: string = '.'
-
 /**
  * Drive path regex.
  *
@@ -19,6 +12,8 @@ const DOT: string = '.'
  *
  * @see https://regex101.com/r/FsoDwJ
  *
+ * @internal
+ *
  * @const {RegExp} DRIVE_PATH_REGEX
  */
 const DRIVE_PATH_REGEX: RegExp = /^(?<drive>(?<letter>[a-z]):(?:\/|\\{2})?)/i
@@ -29,9 +24,11 @@ const DRIVE_PATH_REGEX: RegExp = /^(?<drive>(?<letter>[a-z]):(?:\/|\\{2})?)/i
  * @see https://regex101.com/r/3P8YKp
  * @see https://learn.microsoft.com/dotnet/standard/io/file-path-formats#unc-paths
  *
+ * @internal
+ *
  * @const {RegExp} UNC_PATH_REGEX
  */
 const UNC_PATH_REGEX: RegExp =
   /^(?<volume>[/\\]{2,}(?<host>[^/\\]+)[/\\]+(?<share>[^/\\]+)[/\\]*)(?:(?<dir>.+?)[/\\]*(?<file>[^/\\]+\..[^/\\]+)?[/\\]*(?=[/\\]*\n?$))?/
 
-export { DOT, DRIVE_PATH_REGEX, UNC_PATH_REGEX }
+export { DRIVE_PATH_REGEX, UNC_PATH_REGEX }

src/internal/ensure-posix.ts

@@ -19,6 +19,8 @@ import validateString from './validate-string'
  * @see https://nodejs.org/api/path.html#pathdelimiter
  * @see https://nodejs.org/api/path.html#pathsep
  *
+ * @internal
+ *
  * @param {string} [path=''] - Path to ensure
  * @return {string} POSIX-compliant `path`
  * @throws {TypeError} If `path` is not a string

src/internal/is-drive-path.ts

@@ -20,6 +20,8 @@ import validateString from './validate-string'
  * @example
  *  isDrivePath('myfile.html') // false
  *
+ * @internal
+ *
  * @param {string} path - Path to evaluate
  * @return {boolean} `true` if path starts with [drive letter][1]
  * @throws {TypeError} If `path` is not a string