chore: initial commit

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

.attw.json

@@ -0,0 +1,7 @@
+{
+  "color": true,
+  "emoji": true,
+  "format": "ascii",
+  "ignoreRules": ["cjs-resolves-to-esm"],
+  "summary": true
+}

.codecov.yml

@@ -0,0 +1,93 @@
+# CODECOV CONFIGURATION
+# https://docs.codecov.com/docs/codecovyml-reference
+
+---
+codecov:
+  notify:
+    after_n_builds: 3
+    wait_for_ci: true
+  require_ci_to_pass: true
+
+comment:
+  after_n_builds: 3
+  behavior: default
+  layout: header,diff,flags,components,tree,footer
+  require_base: false
+  require_changes: false
+  require_head: true
+  show_carryforward_flags: true
+  show_critical_paths: true
+
+coverage:
+  precision: 2
+  range: 90..100
+  round: nearest
+  status:
+    changes:
+      default:
+        branches:
+          - feat/*
+          - hotfix/*
+          - main
+          - release/*
+        if_ci_failed: error
+        if_not_found: success
+        informational: false
+        only_pulls: false
+    patch:
+      default:
+        branches:
+          - dependabot/*
+          - feat/*
+          - hotfix/*
+          - main
+          - release/*
+        if_ci_failed: error
+        if_not_found: success
+        informational: false
+        only_pulls: false
+        target: 100%
+        threshold: 0%
+    project:
+      default:
+        branches:
+          - dependabot/*
+          - feat/*
+          - hotfix/*
+          - main
+          - release/*
+        if_ci_failed: error
+        if_not_found: success
+        informational: false
+        only_pulls: false
+        target: 100%
+        threshold: 0%
+
+flags:
+  node20:
+    carryforward: false
+    paths:
+      - src/
+  node19:
+    carryforward: false
+    paths:
+      - src/
+  node18:
+    carryforward: false
+    paths:
+      - src/
+
+github_checks:
+  annotations: true
+
+ignore:
+  - '**/__mocks__/**'
+  - '**/__tests__/**'
+  - '**/interfaces/'
+  - '**/types/'
+  - '**/index.ts'
+  - '!src/index.ts'
+
+profiling:
+  critical_files_paths:
+    - src/location.ts

.commitlintrc.ts

@@ -0,0 +1,25 @@
+/**
+ * @file Configuration - commitlint
+ * @module config/commitlint
+ * @see https://commitlint.js.org
+ */
+
+import {
+  RuleConfigSeverity as Severity,
+  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': [Severity.Error, 'always', scopes(['chore'])]
+  }
+}
+
+export default config

.cspell.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://raw.githubusercontent.com/streetsidesoftware/cspell/main/cspell.schema.json",
+  "allowCompoundWords": true,
+  "caseSensitive": false,
+  "dictionaries": ["@flex-development/vfile-reader"],
+  "dictionaryDefinitions": [
+    {
+      "name": "@flex-development/vfile-reader",
+      "path": "./.dictionary.txt"
+    }
+  ],
+  "enableGlobDot": true,
+  "failFast": false,
+  "flagWords": [],
+  "ignorePaths": [
+    "**/*.log",
+    "**/*.snap",
+    "**/*.wasm",
+    "**/.*ignore",
+    "**/.gitconfig",
+    "**/CHANGELOG.md",
+    "**/LICENSE.md",
+    "**/RELEASE_NOTES.md",
+    "**/scratch.*",
+    ".cspell.json",
+    ".dictionary.txt",
+    ".git/",
+    ".husky/_/",
+    ".vscode/settings.json",
+    ".yarn/",
+    "dist/",
+    "patches/",
+    "yarn.lock"
+  ],
+  "ignoreRegExpList": [
+    "/@flex-development\\/.*/",
+    "/from\\s+(['\"]).*\\1/",
+    "\\\\u001B\\[\\d+m",
+    "import\\(.*\\)"
+  ],
+  "ignoreWords": [],
+  "language": "en-US",
+  "patterns": [],
+  "readonly": true,
+  "useGitignore": true,
+  "usePnP": false,
+  "version": "0.2"
+}

.dictionary.txt

@@ -0,0 +1,30 @@
+attw
+cefc
+codecov
+commitlintrc
+dedupe
+deno
+dessant
+docast
+dohm
+dprint
+fbca
+ggshield
+gpgsign
+hmarr
+jchen
+kaisugi
+lintstagedrc
+mkbuild
+mlly
+nocheck
+nvmrc
+pathe
+pkgs
+preid
+shfmt
+unstub
+vates
+vfile
+vitest
+yarnrc

.dprint.jsonc

@@ -0,0 +1,154 @@
+{
+  "$schema": "https://dprint.dev/schemas/v0.json",
+  "excludes": [
+    "!**/__fixtures__/**/dist/",
+    "!**/__fixtures__/**/node_modules/",
+    "!**/typings/**/dist/",
+    "**/*.patch",
+    "**/*.snap",
+    "**/*config.*.timestamp*",
+    "**/.temp/",
+    "**/.vercel/",
+    "**/__fixtures__/git/**/*.txt",
+    "**/__tests__/benchmark.json",
+    "**/__tests__/report.json",
+    "**/__tests__/typecheck.json",
+    "**/coverage/",
+    "**/dist/",
+    "**/node_modules",
+    "**/tsconfig*temp.json",
+    ".git/",
+    ".husky/_/",
+    ".yarn/",
+    "CHANGELOG.md",
+    "LICENSE.md",
+    "RELEASE_NOTES.md",
+    "yarn.lock"
+  ],
+  "exec": {
+    "commands": [
+      {
+        "command": "node ./dprint/prettier.mjs {{file_path}}",
+        "exts": ["css", "html", "json5", "scss", "yaml", "yml"],
+        "stdin": true
+      },
+      {
+        "command": "node ./dprint/shfmt.mjs {{file_path}}",
+        "exts": ["sh", "txt", "zsh"],
+        "fileNames": [
+          ".editorconfig",
+          ".env",
+          ".env.local",
+          ".env.repo",
+          ".eslintcache",
+          ".eslintignore",
+          ".gitattributes",
+          ".gitconfig",
+          ".gitignore",
+          ".markdownlintignore",
+          ".npmrc",
+          ".nvmrc",
+          "Brewfile",
+          "commit-msg",
+          "pre-commit",
+          "pre-push"
+        ],
+        "stdin": true
+      }
+    ]
+  },
+  "incremental": true,
+  "indentWidth": 2,
+  "json": {
+    "associations": ["**/*.{jsonc,json}"],
+    "array.preferSingleLine": false,
+    "commentLine.forceSpaceAfterSlashes": true,
+    "ignoreNodeCommentText": "dprint-ignore",
+    "object.preferSingleLine": false,
+    "trailingCommas": "never"
+  },
+  "lineWidth": 80,
+  "markdown": {
+    "associations": ["**/*.{md,mdx}"],
+    "emphasisKind": "asterisks",
+    "ignoreDirective": "dprint-ignore",
+    "ignoreEndDirective": "dprint-ignore-end",
+    "ignoreFileDirective": "dprint-ignore-file",
+    "ignoreStartDirective": "dprint-ignore-start",
+    "lineWidth": 120,
+    "strongKind": "asterisks",
+    "textWrap": "maintain"
+  },
+  "newLineKind": "lf",
+  "plugins": [
+    "https://plugins.dprint.dev/typescript-0.88.10.wasm",
+    "https://plugins.dprint.dev/json-0.19.1.wasm",
+    "https://plugins.dprint.dev/markdown-0.16.3.wasm",
+    "https://plugins.dprint.dev/exec-0.4.4.json@c207bf9b9a4ee1f0ecb75c594f774924baf62e8e53a2ce9d873816a408cecbf7"
+  ],
+  "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": false,
+    "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": false,
+    "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
+}