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

….0-alpha.12

Signed-off-by: Lexus Drumgold <[email protected]>

.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

src/internal/is-sep.ts

@@ -13,9 +13,11 @@ import type { Sep } from '#src/types'
  *
  * @see [`sep`][1]
  *
+ * @internal
+ *
  * @param {unknown} value - Possible path separator
  * @return {value is Sep} `true` if `str` is path separator
  */
-const isSep = (value: unknown): value is Sep => value === sep
+const isSep = (value: unknown): value is Sep => sep === value
 
 export default isSep

src/internal/is-unc-path.ts

@@ -11,6 +11,8 @@ import validateString from './validate-string'
  *
  * @see https://learn.microsoft.com/dotnet/standard/io/file-path-formats#unc-paths
  *
+ * @internal
+ *
  * @param {string} path - Path to evaluate
  * @param {boolean} [exact=true] - Check for exactly two leading separators
  * @return {boolean} `true` if path is UNC path

src/internal/normalize-string.ts

@@ -5,7 +5,15 @@
 
 import isAbsolute from '#src/lib/is-absolute'
 import sep from '#src/lib/sep'
-import { DOT } from './constants'
+import {
+ DOT,
+ at,
+ ifelse,
+ includes,
+ isEmptyString,
+ trim,
+ type Optional
+} from '@flex-development/tutils'
 import ensurePosix from './ensure-posix'
 import isSep from './is-sep'
 import validateString from './validate-string'
@@ -22,6 +30,8 @@ import validateString from './validate-string'
  *
  * [1]: {@link ../lib/sep.ts}
  *
+ * @internal
+ *
  * @param {string} path - Path to normalize
  * @param {boolean} [allow_above_root=!isAbsolute(path)] - Normalize past root
  * @return {string} Normalized `path`
@@ -34,20 +44,20 @@ const normalizeString = (
  validateString(path, 'path')
 
  // exit early if path is empty string
- if (path.trim().length === 0) return path
+ if (isEmptyString(trim(path))) return path
 
  // ensure path meets posix standards
  path = ensurePosix(path)
 
  // exit early if path does not contain dot characters or separators
- if (!path.includes(DOT) && !path.includes(sep)) return path
+ if (!includes(path, DOT) && !includes(path, sep)) return path
 
  /**
  * Current character in {@link path} being processed.
  *
- * @var {string | undefined} char
+ * @var {Optional<string>} char
  */
- let char: string | undefined
+ let char: Optional<string>
 
  /**
  * Total number of `.` (dot) characters in current path segment.
@@ -80,7 +90,7 @@ const normalizeString = (
  // normalize
  for (let i = 0; i <= path.length; ++i) {
  // set current character if current index is in bounds
- if (i < path.length) char = path[i]
+ if (i < path.length) char = at(path, i)
  // exit if trailing separator has been reached
  else if (isSep(char)) break
  // add trailing separator
@@ -133,7 +143,7 @@ const normalizeString = (
 
  // resolve past root
  if (allow_above_root) {
- res += `${!res ? '' : sep}${DOT.repeat(2)}`
+ res += `${ifelse(!res, '', sep)}${DOT.repeat(2)}`
  seglen = 2
  }
  } else {