refactor!: api

- closes #253
- closes #291
- closes #301
- closes #321

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

.attw.json

@@ -2,6 +2,6 @@
   "color": true,
   "emoji": true,
   "format": "ascii",
-  "ignoreRules": ["cjs-resolves-to-esm"],
+  "ignoreRules": ["cjs-resolves-to-esm", "internal-resolution-error"],
   "summary": true
 }

.codecov.yml

@@ -4,12 +4,12 @@
 ---
 codecov:
   notify:
-    after_n_builds: 4
+    after_n_builds: 2
     wait_for_ci: true
   require_ci_to_pass: true
 
 comment:
-  after_n_builds: 4
+  after_n_builds: 2
   behavior: default
   layout: header,diff,flags,components,tree,footer
   require_base: false
@@ -24,14 +24,10 @@ component_management:
       - type: project
         target: 100%
   individual_components:
-    - component_id: internal
-      name: internal
+    - component_id: lib
+      name: lib
       paths:
-        - src/internal/*.ts
-    - component_id: utils
-      name: utils
-      paths:
-        - src/utils/*.ts
+        - src/lib/*.mts
 
 coverage:
   precision: 2
@@ -80,19 +76,11 @@ coverage:
         threshold: 0%
 
 flags:
-  node20:
-    carryforward: false
-    paths:
-      - src/
-  node19:
-    carryforward: false
-    paths:
-      - src/
-  node18:
+  node23:
     carryforward: false
     paths:
       - src/
-  node16:
+  node22:
     carryforward: false
     paths:
       - src/
@@ -101,12 +89,15 @@ github_checks:
   annotations: true
 
 ignore:
+  - '**/*.d.mts'
   - '**/__mocks__/**'
   - '**/__tests__/**'
-  - '**/index.ts'
-  - src/interfaces/
-  - src/types/
+  - '**/index.mts'
+  - '**/interfaces/**'
+  - '**/types/**'
+  - '!src/index.mts'
+  - src/internal/*.browser.mts
 
 profiling:
   critical_files_paths:
-    - src/utils/*.ts
+    - src/lib/*.mts

.commitlintrc.ts

@@ -0,0 +1,22 @@
+/**
+ * @file Configuration - commitlint
+ * @module config/commitlint
+ * @see https://commitlint.js.org
+ */
+
+import { RuleConfigSeverity, type UserConfig } from '@commitlint/types'
+import { scopes } from '@flex-development/commitlint-config'
+
+/**
+ * `commitlint` configuration object.
+ *
+ * @const {UserConfig} config
+ */
+const config: UserConfig = {
+  extends: ['@flex-development'],
+  rules: {
+    'scope-enum': [RuleConfigSeverity.Error, 'always', scopes(['chore'])]
+  }
+}
+
+export default config

.cspell.json

@@ -13,8 +13,9 @@
   "failFast": false,
   "flagWords": [],
   "ignorePaths": [
-    "**/*.log",
+    "**/*.patch",
     "**/*.snap",
+    "**/*.wasm",
     "**/.*ignore",
     "**/.gitconfig",
     "**/CHANGELOG.md",
@@ -26,15 +27,10 @@
     ".husky/_/",
     ".vscode/settings.json",
     ".yarn/",
-    "dist/",
     "patches/",
     "yarn.lock"
   ],
-  "ignoreRegExpList": [
-    "/@flex-development\\/.*/",
-    "/from\\s+(['\"]).*\\1/",
-    "import\\(.*\\)"
-  ],
+  "ignoreRegExpList": [],
   "ignoreWords": [],
   "language": "en-US",
   "patterns": [],

.dictionary.txt

@@ -1,34 +1,28 @@
-ardatan
 attw
-bdougie
 cefc
 codecov
 commitlintrc
-customizer
 dedupe
 dessant
+devlop
+docast
 dohm
+dprint
 fbca
 ggshield
 gpgsign
 hmarr
-iife
-infile
-keyid
+jchen
+kaisugi
 ksort
-larsgw
 lcov
-lintstagedrc
 mkbuild
-mlly
-nocheck
-npmrc
 nvmrc
-pathe
 pkgs
 preid
-tsconfigs
-tscu
+remarkrc
+sarif
+shfmt
 unstub
 vates
 vitest

.dprint.jsonc

@@ -0,0 +1,133 @@
+{
+  "$schema": "https://dprint.dev/schemas/v0.json",
+  "excludes": [
+    "!scratch.*",
+    "**/*.patch",
+    "**/*.snap",
+    "**/CHANGELOG.md",
+    "**/LICENSE.md",
+    "**/RELEASE_NOTES.md",
+    ".git/",
+    ".husky/_/",
+    ".yarn/",
+    "yarn.lock"
+  ],
+  "exec": {
+    "commands": [
+      {
+        "command": "node --experimental-strip-types --experimental-transform-types ./dprint/prettier.mts {{file_path}}",
+        "exts": ["css", "html", "json5", "scss", "yaml", "yml"],
+        "stdin": true
+      },
+      {
+        "command": "node --experimental-strip-types --experimental-transform-types ./dprint/remark.mts {{file_path}}",
+        "exts": ["md", "mdx"],
+        "stdin": true
+      },
+      {
+        "command": "node --experimental-strip-types --experimental-transform-types ./dprint/shfmt.mts {{file_path}}",
+        "exts": ["sh", "zsh"],
+        "fileNames": [
+          ".editorconfig",
+          ".env",
+          ".env.local",
+          ".env.repo",
+          ".eslintcache",
+          ".eslintignore",
+          ".gitattributes",
+          ".gitconfig",
+          ".gitignore",
+          ".npmrc",
+          ".nvmrc",
+          "Brewfile",
+          "commit-msg",
+          "pre-commit",
+          "pre-push"
+        ],
+        "stdin": true
+      }
+    ],
+    "cwd": "${configDir}"
+  },
+  "indentWidth": 2,
+  "json": {
+    "associations": ["**/*.{jsonc,json}"],
+    "array.preferSingleLine": false,
+    "commentLine.forceSpaceAfterSlashes": true,
+    "ignoreNodeCommentText": "dprint-ignore",
+    "object.preferSingleLine": false,
+    "trailingCommas": "never"
+  },
+  "lineWidth": 80,
+  "newLineKind": "lf",
+  "plugins": [
+    "https://plugins.dprint.dev/typescript-0.91.6.wasm",
+    "https://plugins.dprint.dev/json-0.19.3.wasm",
+    "https://plugins.dprint.dev/exec-0.5.0.json@8d9972eee71fa1590e04873540421f3eda7674d0f1aae3d7c788615e7b7413d0"
+  ],
+  "typescript": {
+    "arrowFunction.useParentheses": "preferNone",
+    "binaryExpression.linePerExpression": false,
+    "binaryExpression.operatorPosition": "sameLine",
+    "binaryExpression.spaceSurroundingBitwiseAndArithmeticOperator": true,
+    "bracePosition": "sameLine",
+    "commentLine.forceSpaceAfterSlashes": false,
+    "constructSignature.spaceAfterNewKeyword": true,
+    "constructor.spaceBeforeParentheses": false,
+    "constructorType.spaceAfterNewKeyword": true,
+    "doWhileStatement.spaceAfterWhileKeyword": true,
+    "enumDeclaration.memberSpacing": "maintain",
+    "exportDeclaration.forceMultiLine": "never",
+    "exportDeclaration.forceSingleLine": false,
+    "exportDeclaration.sortNamedExports": "maintain",
+    "exportDeclaration.spaceSurroundingNamedExports": true,
+    "forInStatement.spaceAfterForKeyword": true,
+    "forOfStatement.spaceAfterForKeyword": true,
+    "forStatement.spaceAfterForKeyword": true,
+    "forStatement.spaceAfterSemiColons": true,
+    "functionDeclaration.spaceBeforeParentheses": false,
+    "functionExpression.spaceAfterFunctionKeyword": false,
+    "functionExpression.spaceBeforeParentheses": false,
+    "getAccessor.spaceBeforeParentheses": false,
+    "ifStatement.spaceAfterIfKeyword": true,
+    "ignoreFileCommentText": "dprint-ignore-file",
+    "ignoreNodeCommentText": "dprint-ignore",
+    "importDeclaration.forceMultiLine": "never",
+    "importDeclaration.forceSingleLine": false,
+    "importDeclaration.sortNamedImports": "maintain",
+    "importDeclaration.spaceSurroundingNamedImports": true,
+    "jsx.bracketPosition": "nextLine",
+    "jsx.forceNewLinesSurroundingContent": false,
+    "jsx.multiLineParens": "prefer",
+    "jsx.quoteStyle": "preferSingle",
+    "jsxExpressionContainer.spaceSurroundingExpression": false,
+    "jsxSelfClosingElement.spaceBeforeSlash": true,
+    "memberExpression.linePerExpression": false,
+    "method.spaceBeforeParentheses": false,
+    "module.sortExportDeclarations": "caseSensitive",
+    "module.sortImportDeclarations": "caseSensitive",
+    "newLineKind": "lf",
+    "nextControlFlowPosition": "sameLine",
+    "objectExpression.spaceSurroundingProperties": true,
+    "objectPattern.spaceSurroundingProperties": true,
+    "operatorPosition": "nextLine",
+    "preferHanging": true,
+    "preferSingleLine": false,
+    "quoteProps": "asNeeded",
+    "quoteStyle": "alwaysSingle",
+    "semiColons": "asi",
+    "setAccessor.spaceBeforeParentheses": false,
+    "singleBodyPosition": "sameLine",
+    "spaceAround": false,
+    "spaceSurroundingProperties": true,
+    "taggedTemplate.spaceBeforeLiteral": false,
+    "trailingCommas": "never",
+    "typeAnnotation.spaceBeforeColon": false,
+    "typeAssertion.spaceBeforeExpression": false,
+    "typeLiteral.separatorKind.singleLine": "semiColon",
+    "typeLiteral.spaceSurroundingProperties": true,
+    "useBraces": "maintain",
+    "whileStatement.spaceAfterWhileKeyword": true
+  },
+  "useTabs": false
+}

.editorconfig

@@ -22,26 +22,25 @@ spaces_around_operators = true
 tab_width = 2
 trim_trailing_whitespace = true
 
-# handlebars
-[*.hbs]
-max_line_length = 100
-
 # markdown
-[*.md]
+[{*.md,*.mdx}]
 max_line_length = 120
 
 # shellscript
 [*.sh]
+binary_next_line = true
+function_next_line = false
+keep_comments = true
+keep_padding = false
 max_line_length = 100
+shell_variant = 0
+space_redirects = false
+switch_case_indent = true
 
 # snapshots
 [*.snap]
 max_line_length = 130
 
-# xml
-[*.xml]
-max_line_length = 100
-
 # yaml
-[*.yml]
+[{*.yaml,*.yml}]
 max_line_length = 100

.env.vars

@@ -0,0 +1,3 @@
+# variables
+
+GH_PROJECT_NUMBER=25

.env.zsh

@@ -6,5 +6,7 @@
 # - https://homebrew-file.readthedocs.io/en/latest/usage.html
 
 [ -f $PWD/.env.repo ] && source $PWD/.env.repo
+[ -f $PWD/.env.vars ] && source $PWD/.env.vars
 HOMEBREW_BREWFILE=./Brewfile
 NODE_NO_WARNINGS=1
+NODE_OPTIONS='--experimental-strip-types --experimental-transform-types'