[ { "path": ".appends/.github/labels.yml", "content": "# ----------------------------------------------------------------------------------------- #\n# These are the repository-specific labels that augment the Exercise-wide labels defined in #\n# https://github.com/exercism/org-wide-files/blob/main/global-files/.github/labels.yml. #\n# ----------------------------------------------------------------------------------------- #\n\n- name: 'breaking :boom:'\n description: ''\n color: 'fca708'\n\n- name: 'bug :bug:'\n description: \"Something isn't working\"\n color: 'b60205'\n\n- name: 'chore :wrench:'\n description: 'Meta related task such as build, test, linting, maintainers.json etc.'\n color: '000000'\n\n- name: 'ci :gear:'\n description: 'Continuous integration related'\n color: '000000'\n\n- name: 'dependencies'\n description: 'Pull requests that update a dependency file'\n color: '0366d6'\n\n- name: 'discussion :speech_balloon:'\n description: ''\n color: 'fbca04'\n\n- name: 'do not merge :construction:'\n description: ''\n color: 'fbca04'\n\n- name: 'documentation :book:'\n description: 'Documentation changes'\n color: '1d76db'\n\n- name: 'duplicate :repeat:'\n description: 'This issue or pull request already exists'\n color: 'ffffff'\n\n- name: 'enhancement :unicorn:'\n description: \"Changing current behaviour, enhancing what's already there\"\n color: 'a2eeef'\n\n- name: 'github_actions'\n description: 'Pull requests that update Github_actions code'\n color: '000000'\n\n- name: 'good first issue'\n description: 'First-time contributors preferred'\n color: 'b1db51'\n\n- name: 'hacktoberfest'\n description: 'Hacktoberfest issues! Everyone allowed <3'\n color: '000000'\n\n- name: 'help wanted'\n description: ''\n color: 'b1db51'\n\n- name: 'invalid'\n description: ''\n color: 'ffffff'\n\n- name: 'javascript'\n description: 'Pull requests that update Javascript code'\n color: '168700'\n\n- name: 'new exercise :sparkles:'\n description: 'Adding an exercise from the canonical data'\n color: '1105b7'\n\n- name: 'question :thinking:'\n description: ''\n color: 'ffffff'\n\n- name: 'reputation/contributed_code/major'\n description: ''\n color: '34FBF8'\n\n- name: 'reputation/contributed_code/minor'\n description: ''\n color: 'EF6513'\n\n- name: 'rfc :speech_balloon:'\n description: 'Request for Comments'\n color: 'fbca04'\n\n- name: 'security :rotating_light:'\n description: 'Security related issue or change'\n color: 'b60205'\n\n- name: 'sync :arrows_counterclockwise:'\n description: 'Sync an exercise with the canonical data'\n color: '1105b7'\n\n- name: 'track-anatomy'\n description: 'config.json, new exercises'\n color: '000000'\n\n- name: 'upstream ā¬†'\n description: ''\n color: 'ffffff'\n\n- name: 'v3-migration šŸ¤–'\n description: 'Preparing for Exercism v3'\n color: 'E99695'\n\n- name: 'wontfix :no_good_woman:'\n description: ''\n color: 'ffffff'\n" }, { "path": ".dependabot/config.yml", "content": "version: 1\nupdate_configs:\n - package_manager: 'javascript'\n directory: '/'\n update_schedule: 'live'\n allowed_updates:\n - match:\n update_type: 'security'\n" }, { "path": ".gitattributes", "content": "* text=auto eol=lf\n" }, { "path": ".github/CODEOWNERS", "content": "# Code owners\n.github/CODEOWNERS @exercism/maintainers-admin\n\n# Changes to `fetch-configlet` should be made in the `exercism/configlet` repo\nbin/fetch-configlet @exercism/maintainers-admin\nbin/fetch-configlet.ps1 @exercism/maintainers-admin\n\n" }, { "path": ".github/dependabot.yml", "content": "version: 2\n\nupdates:\n # Keep dependencies for GitHub Actions up-to-date\n - package-ecosystem: 'github-actions'\n directory: '/'\n schedule:\n interval: 'monthly'\n\n # Enable version updates for npm (yarn)\n - package-ecosystem: 'npm'\n # Look for `package.json` and `lock` files in the `root` directory\n directory: '/'\n # Check the npm registry for updates every day (weekdays)\n schedule:\n interval: 'monthly'\n\n # Enable version updates for npm (yarn)\n - package-ecosystem: 'npm'\n # Look for `package.json` and `lock` files in the common directory\n directory: '/common/'\n # Check the npm registry for updates every day (weekdays)\n schedule:\n interval: 'monthly'\n" }, { "path": ".github/labels.yml", "content": "# --------------------------------------------------------------- #\n# This is an auto-generated file - Do not manually edit this file #\n# --------------------------------------------------------------- #\n\n# This file is automatically generated by concatenating two files:\n#\n# 1. The Exercism-wide labels: defined in https://github.com/exercism/org-wide-files/blob/main/global-files/.github/labels.yml\n# 2. The repository-specific labels: defined in the `.appends/.github/labels.yml` file within this repository.\n#\n# If any of these two files change, a pull request is automatically created containing a re-generated version of this file.\n# Consequently, to change repository-specific labels you should update the `.appends/.github/labels.yml` file and _not_ this file.\n#\n# When the pull request has been merged, the GitHub labels will be automatically updated by the \"Sync labels\" workflow.\n# This typically takes 5-10 minutes.\n\n# --------------------------------------------------------------------- #\n# These are the Exercism-wide labels which are shared across all repos. #\n# --------------------------------------------------------------------- #\n\n# The following Exercism-wide labels are used to show \"tasks\" on the website, which will point users to things they can contribute to.\n\n# The `x:action/` labels describe what sort of work the contributor will be engaged in when working on the issue\n- name: \"x:action/create\"\n description: \"Work on something from scratch\"\n color: \"ffffff\"\n\n- name: \"x:action/fix\"\n description: \"Fix an issue\"\n color: \"ffffff\"\n\n- name: \"x:action/improve\"\n description: \"Improve existing functionality/content\"\n color: \"ffffff\"\n\n- name: \"x:action/proofread\"\n description: \"Proofread text\"\n color: \"ffffff\"\n\n- name: \"x:action/sync\"\n description: \"Sync content with its latest version\"\n color: \"ffffff\"\n\n# The `x:knowledge/` labels describe how much Exercism knowledge is required by the contributor\n- name: \"x:knowledge/none\"\n description: \"No existing Exercism knowledge required\"\n color: \"ffffff\"\n\n- name: \"x:knowledge/elementary\"\n description: \"Little Exercism knowledge required\"\n color: \"ffffff\"\n\n- name: \"x:knowledge/intermediate\"\n description: \"Quite a bit of Exercism knowledge required\"\n color: \"ffffff\"\n\n- name: \"x:knowledge/advanced\"\n description: \"Comprehensive Exercism knowledge required\"\n color: \"ffffff\"\n\n# The `x:module/` labels indicate what part of Exercism the contributor will be working on\n- name: \"x:module/analyzer\"\n description: \"Work on Analyzers\"\n color: \"ffffff\"\n\n- name: \"x:module/concept\"\n description: \"Work on Concepts\"\n color: \"ffffff\"\n\n- name: \"x:module/concept-exercise\"\n description: \"Work on Concept Exercises\"\n color: \"ffffff\"\n\n- name: \"x:module/generator\"\n description: \"Work on Exercise generators\"\n color: \"ffffff\"\n\n- name: \"x:module/practice-exercise\"\n description: \"Work on Practice Exercises\"\n color: \"ffffff\"\n\n- name: \"x:module/representer\"\n description: \"Work on Representers\"\n color: \"ffffff\"\n\n- name: \"x:module/test-runner\"\n description: \"Work on Test Runners\"\n color: \"ffffff\"\n\n# The `x:rep/` labels describe the amount of reputation to award\n#\n# For more information on reputation and how these labels should be used,\n# check out https://exercism.org/docs/using/product/reputation\n- name: \"x:rep/tiny\"\n description: \"Tiny amount of reputation\"\n color: \"ffffff\"\n\n- name: \"x:rep/small\"\n description: \"Small amount of reputation\"\n color: \"ffffff\"\n\n- name: \"x:rep/medium\"\n description: \"Medium amount of reputation\"\n color: \"ffffff\"\n\n- name: \"x:rep/large\"\n description: \"Large amount of reputation\"\n color: \"ffffff\"\n\n- name: \"x:rep/massive\"\n description: \"Massive amount of reputation\"\n color: \"ffffff\"\n\n# The `x:size/` labels describe the expected amount of work for a contributor\n- name: \"x:size/tiny\"\n description: \"Tiny amount of work\"\n color: \"ffffff\"\n\n- name: \"x:size/small\"\n description: \"Small amount of work\"\n color: \"ffffff\"\n\n- name: \"x:size/medium\"\n description: \"Medium amount of work\"\n color: \"ffffff\"\n\n- name: \"x:size/large\"\n description: \"Large amount of work\"\n color: \"ffffff\"\n\n- name: \"x:size/massive\"\n description: \"Massive amount of work\"\n color: \"ffffff\"\n\n# The `x:status/` label indicates if there is already someone working on the issue\n- name: \"x:status/claimed\"\n description: \"Someone is working on this issue\"\n color: \"ffffff\"\n\n# The `x:type/` labels describe what type of work the contributor will be engaged in\n- name: \"x:type/ci\"\n description: \"Work on Continuous Integration (e.g. GitHub Actions workflows)\"\n color: \"ffffff\"\n\n- name: \"x:type/coding\"\n description: \"Write code that is not student-facing content (e.g. test-runners, generators, but not exercises)\"\n color: \"ffffff\"\n\n- name: \"x:type/content\"\n description: \"Work on content (e.g. exercises, concepts)\"\n color: \"ffffff\"\n\n- name: \"x:type/docker\"\n description: \"Work on Dockerfiles\"\n color: \"ffffff\"\n\n- name: \"x:type/docs\"\n description: \"Work on Documentation\"\n color: \"ffffff\"\n\n# This Exercism-wide label is added to all automatically created pull requests that help migrate/prepare a track for Exercism v3\n- name: \"v3-migration šŸ¤–\"\n description: \"Preparing for Exercism v3\"\n color: \"e99695\"\n\n# This Exercism-wide label can be used to bulk-close issues in preparation for pausing community contributions\n- name: \"paused\"\n description: \"Work paused until further notice\"\n color: \"e4e669\"\n\n# ----------------------------------------------------------------------------------------- #\n# These are the repository-specific labels that augment the Exercise-wide labels defined in #\n# https://github.com/exercism/org-wide-files/blob/main/global-files/.github/labels.yml. #\n# ----------------------------------------------------------------------------------------- #\n\n- name: 'breaking :boom:'\n description: ''\n color: 'fca708'\n\n- name: 'bug :bug:'\n description: \"Something isn't working\"\n color: 'b60205'\n\n- name: 'chore :wrench:'\n description: 'Meta related task such as build, test, linting, maintainers.json etc.'\n color: '000000'\n\n- name: 'ci :gear:'\n description: 'Continuous integration related'\n color: '000000'\n\n- name: 'dependencies'\n description: 'Pull requests that update a dependency file'\n color: '0366d6'\n\n- name: 'discussion :speech_balloon:'\n description: ''\n color: 'fbca04'\n\n- name: 'do not merge :construction:'\n description: ''\n color: 'fbca04'\n\n- name: 'documentation :book:'\n description: 'Documentation changes'\n color: '1d76db'\n\n- name: 'duplicate :repeat:'\n description: 'This issue or pull request already exists'\n color: 'ffffff'\n\n- name: 'enhancement :unicorn:'\n description: \"Changing current behaviour, enhancing what's already there\"\n color: 'a2eeef'\n\n- name: 'github_actions'\n description: 'Pull requests that update Github_actions code'\n color: '000000'\n\n- name: 'good first issue'\n description: 'First-time contributors preferred'\n color: 'b1db51'\n\n- name: 'hacktoberfest'\n description: 'Hacktoberfest issues! Everyone allowed <3'\n color: '000000'\n\n- name: 'help wanted'\n description: ''\n color: 'b1db51'\n\n- name: 'invalid'\n description: ''\n color: 'ffffff'\n\n- name: 'javascript'\n description: 'Pull requests that update Javascript code'\n color: '168700'\n\n- name: 'new exercise :sparkles:'\n description: 'Adding an exercise from the canonical data'\n color: '1105b7'\n\n- name: 'question :thinking:'\n description: ''\n color: 'ffffff'\n\n- name: 'reputation/contributed_code/major'\n description: ''\n color: '34FBF8'\n\n- name: 'reputation/contributed_code/minor'\n description: ''\n color: 'EF6513'\n\n- name: 'rfc :speech_balloon:'\n description: 'Request for Comments'\n color: 'fbca04'\n\n- name: 'security :rotating_light:'\n description: 'Security related issue or change'\n color: 'b60205'\n\n- name: 'sync :arrows_counterclockwise:'\n description: 'Sync an exercise with the canonical data'\n color: '1105b7'\n\n- name: 'track-anatomy'\n description: 'config.json, new exercises'\n color: '000000'\n\n- name: 'upstream ā¬†'\n description: ''\n color: 'ffffff'\n\n- name: 'v3-migration šŸ¤–'\n description: 'Preparing for Exercism v3'\n color: 'E99695'\n\n- name: 'wontfix :no_good_woman:'\n description: ''\n color: 'ffffff'\n" }, { "path": ".github/workflows/action-format.yml", "content": "name: 'typescript / format'\n\non:\n issue_comment:\n types: [created]\n\njobs:\n format:\n name: 'Format code'\n runs-on: ubuntu-24.04\n if: github.event.issue.pull_request != '' && contains(github.event.comment.body, '/format')\n steps:\n - name: 'Post acknowledgement that it will format code'\n continue-on-error: true # Never fail the build if this fails\n uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n github.rest.issues.createComment({\n issue_number: context.issue.number,\n owner: context.repo.owner,\n repo: context.repo.repo,\n body: 'The \"Format code\" action has started running.'\n })\n\n - name: 'Download PR data'\n run: |\n PR_DATA=\"/tmp/pr.json\"\n\n jq -r \".issue.pull_request.url\" \"$GITHUB_EVENT_PATH\" | \\\n xargs curl --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' -o \"$PR_DATA\" --url\n\n - name: 'Check fork status'\n id: fork_status\n run: |\n IS_FORK=\"$(jq '.head.repo.fork' \"/tmp/pr.json\")\"\n echo \"fork=$IS_FORK\" >> \"$GITHUB_OUTPUT\"\n\n - name: 'Setup SSH deploy key'\n if: steps.fork_status.outputs.fork == 'false'\n run: |\n mkdir ~/.ssh\n echo \"${{ secrets.DEPLOY_KEY }}\" > ~/.ssh/id_ed25519\n chmod 600 ~/.ssh/id_ed25519\n\n - name: 'Checkout code'\n run: |\n PR_DATA=\"/tmp/pr.json\"\n\n HEAD_REF=$(jq -r \".head.ref\" \"$PR_DATA\")\n\n if [ ${{ steps.fork_status.outputs.fork }} == \"false\" ]; then\n echo \"::debug::Setting up repo using SSH\"\n HEAD_REPO=$(jq -r '.head.repo.ssh_url' \"$PR_DATA\")\n else\n echo \"::debug::Setting up repo using HTTPS\"\n HEAD_REPO=$(jq -r '.head.repo.clone_url | sub(\"https://\"; \"https://x-access-token:${{ secrets.GITHUB_TOKEN }}@\")' \"$PR_DATA\")\n fi\n\n git clone $HEAD_REPO .\n git checkout -b \"$HEAD_REF\" \"origin/$HEAD_REF\"\n - name: Enable corepack to fix https://github.com/actions/setup-node/pull/901\n run: corepack enable yarn\n - name: Use Node.js LTS (20.x)\n uses: actions/setup-node@0a44ba7841725637a19e28fa30b79a866c81b0a6\n with:\n node-version: 20.x\n cache: 'yarn'\n - name: Install project development dependencies\n run: corepack yarn install --immutable\n - name: 'Format code'\n run: ./bin/format.sh\n\n - name: 'Commit formatted code'\n run: |\n # Check if there is nothing to commit (i.e. no formatting changes made)\n if [ -z \"$(git status --porcelain)\" ]; then\n echo \"Code is already formatted correctly\"\n exit 0\n fi\n\n # Setup the git user (required to commit anything)\n git config --global user.email \"github-actions[bot]@users.noreply.github.com\"\n git config --global user.name \"github-actions[bot]\"\n\n # Commit the changes made by prettier\n git add .\n git commit -m \"[CI] Format code\"\n git push\n\n - name: 'Post acknowledgement that it has formatted the code'\n continue-on-error: true # Never fail the build if this fails\n uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n github.rest.issues.createComment({\n issue_number: context.issue.number,\n owner: context.repo.owner,\n repo: context.repo.repo,\n body: 'The \"Format code\" action has finished running.'\n })\n\n - name: 'Post reminder to trigger build manually'\n continue-on-error: true # Never fail the build if this fails\n if: steps.fork_status.outputs.fork == 'true'\n uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n github.rest.issues.createComment({\n issue_number: context.issue.number,\n owner: context.repo.owner,\n repo: context.repo.repo,\n body: 'For security reasons, `/format` does not trigger CI builds when the PR has been submitted from a fork. If checks were not passing due to code format, trigger a build to make the required checks pass, through one of the following ways:\\n\\n- Push an empty commit to this branch: `git commit --allow-empty -m \"Trigger builds\"`.\\n- Close and reopen the PR.\\n- Push a regular commit to this branch.'\n })\n" }, { "path": ".github/workflows/action-sync.yml", "content": "name: 'typescript / sync'\n\non:\n issue_comment:\n types: [created]\n\njobs:\n format:\n name: 'Sync all exercises'\n runs-on: ubuntu-24.04\n if: github.event.issue.pull_request != '' && contains(github.event.comment.body, '/sync')\n steps:\n - name: 'Post acknowledgement that it will sync exercises'\n continue-on-error: true # Never fail the build if this fails\n uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n github.rest.issues.createComment({\n issue_number: context.issue.number,\n owner: context.repo.owner,\n repo: context.repo.repo,\n body: 'The \"Sync all exercises\" action has started running.'\n })\n\n - name: 'Download PR data'\n run: |\n PR_DATA=\"/tmp/pr.json\"\n\n jq -r \".issue.pull_request.url\" \"$GITHUB_EVENT_PATH\" | \\\n xargs curl --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' -o \"$PR_DATA\" --url\n\n - name: 'Check fork status'\n id: fork_status\n run: |\n IS_FORK=\"$(jq '.head.repo.fork' \"/tmp/pr.json\")\"\n echo \"fork=$IS_FORK\" >> \"$GITHUB_OUTPUT\"\n\n - name: 'Setup SSH deploy key'\n if: steps.fork_status.outputs.fork == 'false'\n run: |\n mkdir ~/.ssh\n echo \"${{ secrets.DEPLOY_KEY }}\" > ~/.ssh/id_ed25519\n chmod 600 ~/.ssh/id_ed25519\n\n - name: 'Checkout code'\n run: |\n PR_DATA=\"/tmp/pr.json\"\n\n HEAD_REF=$(jq -r \".head.ref\" \"$PR_DATA\")\n\n if [ ${{ steps.fork_status.outputs.fork }} == \"false\" ]; then\n echo \"::debug::Setting up repo using SSH\"\n HEAD_REPO=$(jq -r '.head.repo.ssh_url' \"$PR_DATA\")\n else\n echo \"::debug::Setting up repo using HTTPS\"\n HEAD_REPO=$(jq -r '.head.repo.clone_url | sub(\"https://\"; \"https://x-access-token:${{ secrets.GITHUB_TOKEN }}@\")' \"$PR_DATA\")\n fi\n\n git clone $HEAD_REPO .\n git checkout -b \"$HEAD_REF\" \"origin/$HEAD_REF\"\n\n - name: 'Install dependencies'\n run: |\n corepack enable yarn\n corepack yarn install\n - name: 'Sync exercises'\n run: corepack yarn sync\n\n - name: 'Commit changes'\n run: |\n # Check if there is nothing to commit (i.e. no syncing changes made)\n if [ -z \"$(git status --porcelain)\" ]; then\n echo \"Exercises are already synced correctly\"\n exit 0\n fi\n\n # Setup the git user (required to commit anything)\n git config --global user.email \"github-actions[bot]@users.noreply.github.com\"\n git config --global user.name \"github-actions[bot]\"\n\n # Commit the changes made by prettier\n git add .\n git commit -m \"[CI] Sync exercises\"\n git push\n\n - name: 'Post acknowledgement that it has synced the code'\n continue-on-error: true # Never fail the build if this fails\n uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n github.rest.issues.createComment({\n issue_number: context.issue.number,\n owner: context.repo.owner,\n repo: context.repo.repo,\n body: 'The \"Sync all exercises\" action has finished running.'\n })\n\n - name: 'Post reminder to trigger build manually'\n continue-on-error: true # Never fail the build if this fails\n if: steps.fork_status.outputs.fork == 'true'\n uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n github.rest.issues.createComment({\n issue_number: context.issue.number,\n owner: context.repo.owner,\n repo: context.repo.repo,\n body: 'For security reasons, `/sync` does not trigger CI builds when the PR has been submitted from a fork. If checks were not passing due to code format, trigger a build to make the required checks pass, through one of the following ways:\\n\\n- Push an empty commit to this branch: `git commit --allow-empty -m \"Trigger builds\"`.\\n- Close and reopen the PR.\\n- Push a regular commit to this branch.'\n })\n" }, { "path": ".github/workflows/ci.js.yml", "content": "# This workflow will do a clean install of node dependencies and run tests across different versions of node\n# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions\n\nname: typescript / main\n\non:\n push:\n branches: [main]\n\njobs:\n precheck:\n runs-on: ubuntu-24.04\n\n steps:\n - uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871\n\n - name: Enable corepack to fix https://github.com/actions/setup-node/pull/901\n run: corepack enable yarn\n\n - name: Use Node.js LTS (20.x)\n uses: actions/setup-node@0a44ba7841725637a19e28fa30b79a866c81b0a6\n with:\n node-version: 20.x\n cache: 'yarn'\n\n - name: Install project dependencies\n run: corepack yarn install --immutable\n\n - name: Run exercism/typescript ci precheck (checks config, lint code, and runs tests) for all exercises\n run: corepack yarn ci:check\n\n ci:\n runs-on: ubuntu-24.04\n\n strategy:\n matrix:\n node-version: [20.x, 22.x]\n\n steps:\n - uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871\n - name: Enable corepack to fix https://github.com/actions/setup-node/pull/901\n run: corepack enable yarn\n\n - name: Use Node.js ${{ matrix.node-version }}\n uses: actions/setup-node@0a44ba7841725637a19e28fa30b79a866c81b0a6\n with:\n node-version: ${{ matrix.node-version }}\n cache: 'yarn'\n\n - name: Install project dependencies\n run: corepack yarn install --immutable\n\n - name: Run exercism/typescript ci (checks config, lint code, and runs tests) for all exercises\n run: corepack yarn ci\n\n impersonate:\n # This job tries to run tests for the 'hello-world' exercise, but\n # simulating what would happen if a student runs the tests standalone.\n # We do this by removing all project files in the root.\n\n runs-on: ubuntu-24.04\n\n steps:\n - uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871\n - name: Enable corepack to fix https://github.com/actions/setup-node/pull/901\n run: corepack enable yarn\n\n - name: Use Node.js 20.x\n uses: actions/setup-node@0a44ba7841725637a19e28fa30b79a866c81b0a6\n with:\n node-version: 20.x\n cache: 'yarn'\n\n - name: Remove root project files\n run: rm -f package.json yarn.lock .yarnrc.yml\n\n - name: Move solution file so that tests pass\n working-directory: exercises/practice/hello-world\n run: |\n rm -f hello-world.ts\n cp ./.meta/proof.ci.ts hello-world.ts\n\n - name: Install project dependencies\n working-directory: exercises/practice/hello-world\n run: corepack yarn install --no-immutable\n\n - name: Run tests\n working-directory: exercises/practice/hello-world\n run: corepack yarn test\n" }, { "path": ".github/workflows/codeql.yml", "content": "# For most projects, this workflow file will not need changing; you simply need\n# to commit it to your repository.\n#\n# You may wish to alter this file to override the set of languages analyzed,\n# or to provide custom queries or build logic.\nname: 'codeql'\n\non:\n push:\n branches: [main]\n pull_request:\n # The branches below must be a subset of the branches above\n branches: [main]\n schedule:\n - cron: '0 14 * * 5'\n\njobs:\n analyze:\n runs-on: ubuntu-24.04\n\n strategy:\n fail-fast: false\n matrix:\n # Override automatic language detection by changing the below list\n # Supported options are ['csharp', 'cpp', 'go', 'java', 'javascript', 'python']\n language: ['javascript']\n # Learn more...\n # https://docs.github.com/en/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection\n\n steps:\n - name: Checkout repository\n uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871 # v2.3.4\n\n # Initializes the CodeQL tools for scanning.\n - name: Initialize CodeQL\n uses: github/codeql-action/init@v3\n with:\n languages: ${{ matrix.language }}\n # If you wish to specify custom queries, you can do so here or in a config file.\n # By default, queries listed here will override any specified in a config file.\n # Prefix the list here with \"+\" to use these queries and those in the config file.\n # queries: ./path/to/local/query, your-org/your-repo/queries@main\n\n # Autobuild attempts to build any compiled languages (C/C++, C#, or Java).\n # If this step fails, then you should remove it and run the build manually (see below)\n - name: Autobuild\n uses: github/codeql-action/autobuild@v3\n\n # ā„¹ļø Command-line programs to run using the OS shell.\n # šŸ“š https://git.io/JvXDl\n\n # āœļø If the Autobuild fails above, remove it and uncomment the following three lines\n # and modify them (or add more) to build your code if your project\n # uses a compiled language\n\n #- run: |\n # make bootstrap\n # make release\n\n - name: Perform CodeQL Analysis\n uses: github/codeql-action/analyze@v3\n" }, { "path": ".github/workflows/configlet.yml", "content": "name: Configlet\n\non:\n pull_request:\n push:\n branches:\n - main\n workflow_dispatch:\n\npermissions:\n contents: read\n\njobs:\n configlet:\n uses: exercism/github-actions/.github/workflows/configlet.yml@main\n" }, { "path": ".github/workflows/no-important-files-changed.yml", "content": "name: No important files changed\n\non:\n pull_request_target:\n types: [opened]\n branches: [main]\n paths:\n - \"exercises/concept/**\"\n - \"exercises/practice/**\"\n - \"!exercises/*/*/.approaches/**\"\n - \"!exercises/*/*/.articles/**\"\n - \"!exercises/*/*/.docs/**\"\n - \"!exercises/*/*/.meta/**\"\n\npermissions:\n pull-requests: write\n\njobs:\n check:\n uses: exercism/github-actions/.github/workflows/check-no-important-files-changed.yml@main\n with:\n repository: ${{ github.event.pull_request.head.repo.owner.login }}/${{ github.event.pull_request.head.repo.name }}\n ref: ${{ github.head_ref }}\n" }, { "path": ".github/workflows/pause-community-contributions.yml", "content": "name: Pause Community Contributions\n\non:\n issues:\n types:\n - opened\n pull_request_target:\n types:\n - opened\n paths-ignore:\n - 'exercises/*/*/.approaches/**'\n - 'exercises/*/*/.articles/**'\n\npermissions:\n issues: write\n pull-requests: write\n\njobs:\n pause:\n if: github.repository_owner == 'exercism' # Stops this job from running on forks\n uses: exercism/github-actions/.github/workflows/community-contributions.yml@main\n with:\n forum_category: typescript\n secrets:\n github_membership_token: ${{ secrets.COMMUNITY_CONTRIBUTIONS_WORKFLOW_TOKEN }}\n" }, { "path": ".github/workflows/ping-cross-track-maintainers-team.yml", "content": "name: Ping cross-track maintainers team\n\non:\n pull_request_target:\n types:\n - opened\n\npermissions:\n pull-requests: write\n\njobs:\n ping:\n if: github.repository_owner == 'exercism' # Stops this job from running on forks\n uses: exercism/github-actions/.github/workflows/ping-cross-track-maintainers-team.yml@main\n secrets:\n github_membership_token: ${{ secrets.COMMUNITY_CONTRIBUTIONS_WORKFLOW_TOKEN }}\n" }, { "path": ".github/workflows/pr.ci.js.yml", "content": "# This workflow will do a clean install of node dependencies and run tests across different versions of node\n# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions\n\nname: typescript / pr\n\non: pull_request\n\njobs:\n precheck:\n runs-on: ubuntu-24.04\n\n steps:\n - name: Checkout PR\n uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871\n with:\n fetch-depth: ${{ github.event_name == 'pull_request' && 2 || 0 }}\n\n - name: Get changed files\n id: changed-files\n run: |\n if ${{ github.event_name == 'pull_request' }}; then\n echo \"changed_files=$(git diff --name-only --diff-filter=ACM -r HEAD^1 HEAD | xargs)\" >> $GITHUB_OUTPUT\n else\n echo \"changed_files=$(git diff --name-only --diff-filter=ACM ${{ github.event.before }} ${{ github.event.after }} | xargs)\" >> $GITHUB_OUTPUT\n fi\n\n - name: Enable corepack to fix https://github.com/actions/setup-node/pull/901\n run: corepack enable yarn\n\n - name: Use Node.js LTS (20.x)\n uses: actions/setup-node@0a44ba7841725637a19e28fa30b79a866c81b0a6\n with:\n node-version: 20.x\n cache: 'yarn'\n\n - name: Install project dependencies\n run: corepack yarn install --immutable\n\n - name: Run exercism/typescript ci precheck (stub files, config integrity) for changed exercises\n run: corepack yarn node scripts/pr-check.mjs ${{ steps.changed-files.outputs.changed_files }}\n\n ci:\n runs-on: ubuntu-24.04\n\n strategy:\n matrix:\n node-version: [20.x, 22.x]\n\n steps:\n - name: Checkout PR\n uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871\n with:\n fetch-depth: ${{ github.event_name == 'pull_request' && 2 || 0 }}\n\n - name: Get changed files\n id: changed-files\n run: |\n if ${{ github.event_name == 'pull_request' }}; then\n echo \"changed_files=$(git diff --name-only --diff-filter=ACM -r HEAD^1 HEAD | xargs)\" >> $GITHUB_OUTPUT\n else\n echo \"changed_files=$(git diff --name-only --diff-filter=ACM ${{ github.event.before }} ${{ github.event.after }} | xargs)\" >> $GITHUB_OUTPUT\n fi\n\n - name: Enable corepack to fix https://github.com/actions/setup-node/pull/901\n run: corepack enable yarn\n\n - name: Use Node.js ${{ matrix.node-version }}\n uses: actions/setup-node@0a44ba7841725637a19e28fa30b79a866c81b0a6\n with:\n node-version: ${{ matrix.node-version }}\n cache: 'yarn'\n\n - name: Install project dependencies\n run: corepack yarn install --immutable\n\n - name: Run exercism/typescript ci (runs tests) for changed/added exercises\n run: corepack yarn node scripts/pr.mjs ${{ steps.changed-files.outputs.changed_files }}\n\n impersonate:\n # This job tries to run tests for the 'hello-world' exercise, but\n # simulating what would happen if a student runs the tests standalone.\n # We do this by removing all project files in the root.\n\n runs-on: ubuntu-24.04\n\n steps:\n - uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871\n - name: Enable corepack to fix https://github.com/actions/setup-node/pull/901\n run: corepack enable yarn\n\n - name: Use Node.js 20.x\n uses: actions/setup-node@0a44ba7841725637a19e28fa30b79a866c81b0a6\n with:\n node-version: 20.x\n cache: 'yarn'\n\n - name: Remove root project files\n run: rm -f package.json yarn.lock .yarnrc.yml\n\n - name: Move solution file so that tests pass\n working-directory: exercises/practice/hello-world\n run: |\n rm -f hello-world.ts\n cp ./.meta/proof.ci.ts hello-world.ts\n\n - name: Install project dependencies\n working-directory: exercises/practice/hello-world\n run: corepack yarn install --no-immutable\n\n - name: Run tests\n working-directory: exercises/practice/hello-world\n run: corepack yarn test\n" }, { "path": ".github/workflows/run-configlet-sync.yml", "content": "name: Run Configlet Sync\n\non:\n workflow_dispatch:\n schedule:\n - cron: '0 0 15 * *'\n\njobs:\n call-gha-workflow:\n uses: exercism/github-actions/.github/workflows/configlet-sync.yml@main\n" }, { "path": ".github/workflows/sync-labels.yml", "content": "name: Tools\n\non:\n push:\n branches:\n - main\n paths:\n - .github/labels.yml\n - .github/workflows/sync-labels.yml\n workflow_dispatch:\n schedule:\n - cron: 0 0 1 * * # First day of each month\n\npermissions:\n issues: write\n\njobs:\n sync-labels:\n uses: exercism/github-actions/.github/workflows/labels.yml@main\n" }, { "path": ".github/workflows/verify-code-formatting.yml", "content": "name: typescript / format\n\non:\n push:\n pull_request:\n workflow_dispatch:\n\njobs:\n verify:\n runs-on: ubuntu-24.04\n steps:\n - name: 'Checkout code'\n uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871\n\n - name: 'Verify formatting of all files'\n run: ./bin/check-formatting.sh\n" }, { "path": ".gitignore", "content": "*.swp\n.DS_Store\n.idea\nnpm-debug.log\nbuild\nbabel-output\nlintreport.json\ndebug.log\n\n# Binaries downloaded by binary download scripts\nbin/configlet\nbin/configlet.exe\n\n# Node modules\n/exercises/**/node_modules\n/common/node_modules\n/node_modules\n\n# Yarn files\n/exercises/**/.pnp.*\n/exercises/**/.yarn/*\n!/exercises/**/.yarn/patches\n!/exercises/**/.yarn/plugins\n!/exercises/**/.yarn/releases\n!/exercises/**/.yarn/sdks\n!/exercises/**/.yarn/versions\n\n/common/.pnp.*\n/common/.yarn/*\n!/common/.yarn/patches\n!/common/.yarn/plugins\n!/common/.yarn/releases\n!/common/.yarn/sdks\n!/common/.yarn/versions\n\n/.pnp.*\n/.yarn/*\n!/.yarn/patches\n!/.yarn/plugins\n!/.yarn/releases\n!/.yarn/sdks\n!/.yarn/versions\n\n# Maintainer specific generated files\n/tmp_exercises\n/tmp\nexercise-package.json\n" }, { "path": ".prettierignore", "content": "/.github/labels.yml\n/.github/workflows/sync-labels.yml\n/.github/workflows/no-important-files-changed.yml\nexercises/**/README.md\n!/README.md\n\n.vscode/**/*\n.yarn/**/*\n\n# Originates from https://github.com/exercism/org-wide-files\nCODE_OF_CONDUCT.md\nLICENSE\n\n# These are formatted via configlet and will not match prettier\nexercises/**/.meta/config.json\nexercises/**/.approaches/config.json\nconfig.json\n\n# Originates from https://github.com/exercism/problem-specifications\nexercises/practice/**/.docs/instructions.md\nexercises/practice/**/.docs/introduction.md\n" }, { "path": ".prettierrc", "content": "{\n \"trailingComma\": \"es5\",\n \"tabWidth\": 2,\n \"semi\": false,\n \"singleQuote\": true,\n \"arrowParens\": \"always\",\n \"printWidth\": 80,\n \"endOfLine\": \"lf\"\n}\n" }, { "path": ".vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": ".vscode/settings.json", "content": "{\n \"cSpell.words\": [\n \"exercism\"\n ],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n },\n \"eslint.nodePath\": \".yarn/sdks\",\n \"prettier.prettierPath\": \".yarn/sdks/prettier/index.cjs\",\n \"typescript.tsdk\": \".yarn/sdks/typescript/lib\",\n \"typescript.enablePromptUseWorkspaceTsdk\": true\n}\n" }, { "path": ".yarn/sdks/eslint/bin/eslint.js", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require eslint/bin/eslint.js\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\n// Defer to the real eslint/bin/eslint.js your application uses\nmodule.exports = absRequire(`eslint/bin/eslint.js`);\n" }, { "path": ".yarn/sdks/eslint/lib/api.js", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require eslint\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\n// Defer to the real eslint your application uses\nmodule.exports = absRequire(`eslint`);\n" }, { "path": ".yarn/sdks/eslint/lib/unsupported-api.js", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require eslint/use-at-your-own-risk\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\n// Defer to the real eslint/use-at-your-own-risk your application uses\nmodule.exports = absRequire(`eslint/use-at-your-own-risk`);\n" }, { "path": ".yarn/sdks/eslint/package.json", "content": "{\n \"name\": \"eslint\",\n \"version\": \"9.8.0-sdk\",\n \"main\": \"./lib/api.js\",\n \"type\": \"commonjs\",\n \"bin\": {\n \"eslint\": \"./bin/eslint.js\"\n },\n \"exports\": {\n \"./package.json\": \"./package.json\",\n \".\": \"./lib/api.js\",\n \"./use-at-your-own-risk\": \"./lib/unsupported-api.js\"\n }\n}\n" }, { "path": ".yarn/sdks/integrations.yml", "content": "# This file is automatically generated by @yarnpkg/sdks.\n# Manual changes might be lost!\n\nintegrations:\n - vscode\n" }, { "path": ".yarn/sdks/prettier/bin/prettier.cjs", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require prettier/bin/prettier.cjs\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\n// Defer to the real prettier/bin/prettier.cjs your application uses\nmodule.exports = absRequire(`prettier/bin/prettier.cjs`);\n" }, { "path": ".yarn/sdks/prettier/index.cjs", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require prettier\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\n// Defer to the real prettier your application uses\nmodule.exports = absRequire(`prettier`);\n" }, { "path": ".yarn/sdks/prettier/package.json", "content": "{\n \"name\": \"prettier\",\n \"version\": \"3.3.3-sdk\",\n \"main\": \"./index.cjs\",\n \"type\": \"commonjs\",\n \"bin\": \"./bin/prettier.cjs\"\n}\n" }, { "path": ".yarn/sdks/typescript/bin/tsc", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require typescript/bin/tsc\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\n// Defer to the real typescript/bin/tsc your application uses\nmodule.exports = absRequire(`typescript/bin/tsc`);\n" }, { "path": ".yarn/sdks/typescript/bin/tsserver", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require typescript/bin/tsserver\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\n// Defer to the real typescript/bin/tsserver your application uses\nmodule.exports = absRequire(`typescript/bin/tsserver`);\n" }, { "path": ".yarn/sdks/typescript/lib/tsc.js", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require typescript/lib/tsc.js\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\n// Defer to the real typescript/lib/tsc.js your application uses\nmodule.exports = absRequire(`typescript/lib/tsc.js`);\n" }, { "path": ".yarn/sdks/typescript/lib/tsserver.js", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require typescript/lib/tsserver.js\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\nconst moduleWrapper = tsserver => {\n if (!process.versions.pnp) {\n return tsserver;\n }\n\n const {isAbsolute} = require(`path`);\n const pnpApi = require(`pnpapi`);\n\n const isVirtual = str => str.match(/\\/(\\$\\$virtual|__virtual__)\\//);\n const isPortal = str => str.startsWith(\"portal:/\");\n const normalize = str => str.replace(/\\\\/g, `/`).replace(/^\\/?/, `/`);\n\n const dependencyTreeRoots = new Set(pnpApi.getDependencyTreeRoots().map(locator => {\n return `${locator.name}@${locator.reference}`;\n }));\n\n // VSCode sends the zip paths to TS using the \"zip://\" prefix, that TS\n // doesn't understand. This layer makes sure to remove the protocol\n // before forwarding it to TS, and to add it back on all returned paths.\n\n function toEditorPath(str) {\n // We add the `zip:` prefix to both `.zip/` paths and virtual paths\n if (isAbsolute(str) && !str.match(/^\\^?(zip:|\\/zip\\/)/) && (str.match(/\\.zip\\//) || isVirtual(str))) {\n // We also take the opportunity to turn virtual paths into physical ones;\n // this makes it much easier to work with workspaces that list peer\n // dependencies, since otherwise Ctrl+Click would bring us to the virtual\n // file instances instead of the real ones.\n //\n // We only do this to modules owned by the the dependency tree roots.\n // This avoids breaking the resolution when jumping inside a vendor\n // with peer dep (otherwise jumping into react-dom would show resolution\n // errors on react).\n //\n const resolved = isVirtual(str) ? pnpApi.resolveVirtual(str) : str;\n if (resolved) {\n const locator = pnpApi.findPackageLocator(resolved);\n if (locator && (dependencyTreeRoots.has(`${locator.name}@${locator.reference}`) || isPortal(locator.reference))) {\n str = resolved;\n }\n }\n\n str = normalize(str);\n\n if (str.match(/\\.zip\\//)) {\n switch (hostInfo) {\n // Absolute VSCode `Uri.fsPath`s need to start with a slash.\n // VSCode only adds it automatically for supported schemes,\n // so we have to do it manually for the `zip` scheme.\n // The path needs to start with a caret otherwise VSCode doesn't handle the protocol\n //\n // Ref: https://github.com/microsoft/vscode/issues/105014#issuecomment-686760910\n //\n // 2021-10-08: VSCode changed the format in 1.61.\n // Before | ^zip:/c:/foo/bar.zip/package.json\n // After | ^/zip//c:/foo/bar.zip/package.json\n //\n // 2022-04-06: VSCode changed the format in 1.66.\n // Before | ^/zip//c:/foo/bar.zip/package.json\n // After | ^/zip/c:/foo/bar.zip/package.json\n //\n // 2022-05-06: VSCode changed the format in 1.68\n // Before | ^/zip/c:/foo/bar.zip/package.json\n // After | ^/zip//c:/foo/bar.zip/package.json\n //\n case `vscode <1.61`: {\n str = `^zip:${str}`;\n } break;\n\n case `vscode <1.66`: {\n str = `^/zip/${str}`;\n } break;\n\n case `vscode <1.68`: {\n str = `^/zip${str}`;\n } break;\n\n case `vscode`: {\n str = `^/zip/${str}`;\n } break;\n\n // To make \"go to definition\" work,\n // We have to resolve the actual file system path from virtual path\n // and convert scheme to supported by [vim-rzip](https://github.com/lbrayner/vim-rzip)\n case `coc-nvim`: {\n str = normalize(resolved).replace(/\\.zip\\//, `.zip::`);\n str = resolve(`zipfile:${str}`);\n } break;\n\n // Support neovim native LSP and [typescript-language-server](https://github.com/theia-ide/typescript-language-server)\n // We have to resolve the actual file system path from virtual path,\n // everything else is up to neovim\n case `neovim`: {\n str = normalize(resolved).replace(/\\.zip\\//, `.zip::`);\n str = `zipfile://${str}`;\n } break;\n\n default: {\n str = `zip:${str}`;\n } break;\n }\n } else {\n str = str.replace(/^\\/?/, process.platform === `win32` ? `` : `/`);\n }\n }\n\n return str;\n }\n\n function fromEditorPath(str) {\n switch (hostInfo) {\n case `coc-nvim`: {\n str = str.replace(/\\.zip::/, `.zip/`);\n // The path for coc-nvim is in format of //zipfile://.yarn/...\n // So in order to convert it back, we use .* to match all the thing\n // before `zipfile:`\n return process.platform === `win32`\n ? str.replace(/^.*zipfile:\\//, ``)\n : str.replace(/^.*zipfile:/, ``);\n } break;\n\n case `neovim`: {\n str = str.replace(/\\.zip::/, `.zip/`);\n // The path for neovim is in format of zipfile:////.yarn/...\n return str.replace(/^zipfile:\\/\\//, ``);\n } break;\n\n case `vscode`:\n default: {\n return str.replace(/^\\^?(zip:|\\/zip(\\/ts-nul-authority)?)\\/+/, process.platform === `win32` ? `` : `/`)\n } break;\n }\n }\n\n // Force enable 'allowLocalPluginLoads'\n // TypeScript tries to resolve plugins using a path relative to itself\n // which doesn't work when using the global cache\n // https://github.com/microsoft/TypeScript/blob/1b57a0395e0bff191581c9606aab92832001de62/src/server/project.ts#L2238\n // VSCode doesn't want to enable 'allowLocalPluginLoads' due to security concerns but\n // TypeScript already does local loads and if this code is running the user trusts the workspace\n // https://github.com/microsoft/vscode/issues/45856\n const ConfiguredProject = tsserver.server.ConfiguredProject;\n const {enablePluginsWithOptions: originalEnablePluginsWithOptions} = ConfiguredProject.prototype;\n ConfiguredProject.prototype.enablePluginsWithOptions = function() {\n this.projectService.allowLocalPluginLoads = true;\n return originalEnablePluginsWithOptions.apply(this, arguments);\n };\n\n // And here is the point where we hijack the VSCode <-> TS communications\n // by adding ourselves in the middle. We locate everything that looks\n // like an absolute path of ours and normalize it.\n\n const Session = tsserver.server.Session;\n const {onMessage: originalOnMessage, send: originalSend} = Session.prototype;\n let hostInfo = `unknown`;\n\n Object.assign(Session.prototype, {\n onMessage(/** @type {string | object} */ message) {\n const isStringMessage = typeof message === 'string';\n const parsedMessage = isStringMessage ? JSON.parse(message) : message;\n\n if (\n parsedMessage != null &&\n typeof parsedMessage === `object` &&\n parsedMessage.arguments &&\n typeof parsedMessage.arguments.hostInfo === `string`\n ) {\n hostInfo = parsedMessage.arguments.hostInfo;\n if (hostInfo === `vscode` && process.env.VSCODE_IPC_HOOK) {\n const [, major, minor] = (process.env.VSCODE_IPC_HOOK.match(\n // The RegExp from https://semver.org/ but without the caret at the start\n /(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$/\n ) ?? []).map(Number)\n\n if (major === 1) {\n if (minor < 61) {\n hostInfo += ` <1.61`;\n } else if (minor < 66) {\n hostInfo += ` <1.66`;\n } else if (minor < 68) {\n hostInfo += ` <1.68`;\n }\n }\n }\n }\n\n const processedMessageJSON = JSON.stringify(parsedMessage, (key, value) => {\n return typeof value === 'string' ? fromEditorPath(value) : value;\n });\n\n return originalOnMessage.call(\n this,\n isStringMessage ? processedMessageJSON : JSON.parse(processedMessageJSON)\n );\n },\n\n send(/** @type {any} */ msg) {\n return originalSend.call(this, JSON.parse(JSON.stringify(msg, (key, value) => {\n return typeof value === `string` ? toEditorPath(value) : value;\n })));\n }\n });\n\n return tsserver;\n};\n\nconst [major, minor] = absRequire(`typescript/package.json`).version.split(`.`, 2).map(value => parseInt(value, 10));\n// In TypeScript@>=5.5 the tsserver uses the public TypeScript API so that needs to be patched as well.\n// Ref https://github.com/microsoft/TypeScript/pull/55326\nif (major > 5 || (major === 5 && minor >= 5)) {\n moduleWrapper(absRequire(`typescript`));\n}\n\n// Defer to the real typescript/lib/tsserver.js your application uses\nmodule.exports = moduleWrapper(absRequire(`typescript/lib/tsserver.js`));\n" }, { "path": ".yarn/sdks/typescript/lib/tsserverlibrary.js", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require typescript/lib/tsserverlibrary.js\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\nconst moduleWrapper = tsserver => {\n if (!process.versions.pnp) {\n return tsserver;\n }\n\n const {isAbsolute} = require(`path`);\n const pnpApi = require(`pnpapi`);\n\n const isVirtual = str => str.match(/\\/(\\$\\$virtual|__virtual__)\\//);\n const isPortal = str => str.startsWith(\"portal:/\");\n const normalize = str => str.replace(/\\\\/g, `/`).replace(/^\\/?/, `/`);\n\n const dependencyTreeRoots = new Set(pnpApi.getDependencyTreeRoots().map(locator => {\n return `${locator.name}@${locator.reference}`;\n }));\n\n // VSCode sends the zip paths to TS using the \"zip://\" prefix, that TS\n // doesn't understand. This layer makes sure to remove the protocol\n // before forwarding it to TS, and to add it back on all returned paths.\n\n function toEditorPath(str) {\n // We add the `zip:` prefix to both `.zip/` paths and virtual paths\n if (isAbsolute(str) && !str.match(/^\\^?(zip:|\\/zip\\/)/) && (str.match(/\\.zip\\//) || isVirtual(str))) {\n // We also take the opportunity to turn virtual paths into physical ones;\n // this makes it much easier to work with workspaces that list peer\n // dependencies, since otherwise Ctrl+Click would bring us to the virtual\n // file instances instead of the real ones.\n //\n // We only do this to modules owned by the the dependency tree roots.\n // This avoids breaking the resolution when jumping inside a vendor\n // with peer dep (otherwise jumping into react-dom would show resolution\n // errors on react).\n //\n const resolved = isVirtual(str) ? pnpApi.resolveVirtual(str) : str;\n if (resolved) {\n const locator = pnpApi.findPackageLocator(resolved);\n if (locator && (dependencyTreeRoots.has(`${locator.name}@${locator.reference}`) || isPortal(locator.reference))) {\n str = resolved;\n }\n }\n\n str = normalize(str);\n\n if (str.match(/\\.zip\\//)) {\n switch (hostInfo) {\n // Absolute VSCode `Uri.fsPath`s need to start with a slash.\n // VSCode only adds it automatically for supported schemes,\n // so we have to do it manually for the `zip` scheme.\n // The path needs to start with a caret otherwise VSCode doesn't handle the protocol\n //\n // Ref: https://github.com/microsoft/vscode/issues/105014#issuecomment-686760910\n //\n // 2021-10-08: VSCode changed the format in 1.61.\n // Before | ^zip:/c:/foo/bar.zip/package.json\n // After | ^/zip//c:/foo/bar.zip/package.json\n //\n // 2022-04-06: VSCode changed the format in 1.66.\n // Before | ^/zip//c:/foo/bar.zip/package.json\n // After | ^/zip/c:/foo/bar.zip/package.json\n //\n // 2022-05-06: VSCode changed the format in 1.68\n // Before | ^/zip/c:/foo/bar.zip/package.json\n // After | ^/zip//c:/foo/bar.zip/package.json\n //\n case `vscode <1.61`: {\n str = `^zip:${str}`;\n } break;\n\n case `vscode <1.66`: {\n str = `^/zip/${str}`;\n } break;\n\n case `vscode <1.68`: {\n str = `^/zip${str}`;\n } break;\n\n case `vscode`: {\n str = `^/zip/${str}`;\n } break;\n\n // To make \"go to definition\" work,\n // We have to resolve the actual file system path from virtual path\n // and convert scheme to supported by [vim-rzip](https://github.com/lbrayner/vim-rzip)\n case `coc-nvim`: {\n str = normalize(resolved).replace(/\\.zip\\//, `.zip::`);\n str = resolve(`zipfile:${str}`);\n } break;\n\n // Support neovim native LSP and [typescript-language-server](https://github.com/theia-ide/typescript-language-server)\n // We have to resolve the actual file system path from virtual path,\n // everything else is up to neovim\n case `neovim`: {\n str = normalize(resolved).replace(/\\.zip\\//, `.zip::`);\n str = `zipfile://${str}`;\n } break;\n\n default: {\n str = `zip:${str}`;\n } break;\n }\n } else {\n str = str.replace(/^\\/?/, process.platform === `win32` ? `` : `/`);\n }\n }\n\n return str;\n }\n\n function fromEditorPath(str) {\n switch (hostInfo) {\n case `coc-nvim`: {\n str = str.replace(/\\.zip::/, `.zip/`);\n // The path for coc-nvim is in format of //zipfile://.yarn/...\n // So in order to convert it back, we use .* to match all the thing\n // before `zipfile:`\n return process.platform === `win32`\n ? str.replace(/^.*zipfile:\\//, ``)\n : str.replace(/^.*zipfile:/, ``);\n } break;\n\n case `neovim`: {\n str = str.replace(/\\.zip::/, `.zip/`);\n // The path for neovim is in format of zipfile:////.yarn/...\n return str.replace(/^zipfile:\\/\\//, ``);\n } break;\n\n case `vscode`:\n default: {\n return str.replace(/^\\^?(zip:|\\/zip(\\/ts-nul-authority)?)\\/+/, process.platform === `win32` ? `` : `/`)\n } break;\n }\n }\n\n // Force enable 'allowLocalPluginLoads'\n // TypeScript tries to resolve plugins using a path relative to itself\n // which doesn't work when using the global cache\n // https://github.com/microsoft/TypeScript/blob/1b57a0395e0bff191581c9606aab92832001de62/src/server/project.ts#L2238\n // VSCode doesn't want to enable 'allowLocalPluginLoads' due to security concerns but\n // TypeScript already does local loads and if this code is running the user trusts the workspace\n // https://github.com/microsoft/vscode/issues/45856\n const ConfiguredProject = tsserver.server.ConfiguredProject;\n const {enablePluginsWithOptions: originalEnablePluginsWithOptions} = ConfiguredProject.prototype;\n ConfiguredProject.prototype.enablePluginsWithOptions = function() {\n this.projectService.allowLocalPluginLoads = true;\n return originalEnablePluginsWithOptions.apply(this, arguments);\n };\n\n // And here is the point where we hijack the VSCode <-> TS communications\n // by adding ourselves in the middle. We locate everything that looks\n // like an absolute path of ours and normalize it.\n\n const Session = tsserver.server.Session;\n const {onMessage: originalOnMessage, send: originalSend} = Session.prototype;\n let hostInfo = `unknown`;\n\n Object.assign(Session.prototype, {\n onMessage(/** @type {string | object} */ message) {\n const isStringMessage = typeof message === 'string';\n const parsedMessage = isStringMessage ? JSON.parse(message) : message;\n\n if (\n parsedMessage != null &&\n typeof parsedMessage === `object` &&\n parsedMessage.arguments &&\n typeof parsedMessage.arguments.hostInfo === `string`\n ) {\n hostInfo = parsedMessage.arguments.hostInfo;\n if (hostInfo === `vscode` && process.env.VSCODE_IPC_HOOK) {\n const [, major, minor] = (process.env.VSCODE_IPC_HOOK.match(\n // The RegExp from https://semver.org/ but without the caret at the start\n /(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$/\n ) ?? []).map(Number)\n\n if (major === 1) {\n if (minor < 61) {\n hostInfo += ` <1.61`;\n } else if (minor < 66) {\n hostInfo += ` <1.66`;\n } else if (minor < 68) {\n hostInfo += ` <1.68`;\n }\n }\n }\n }\n\n const processedMessageJSON = JSON.stringify(parsedMessage, (key, value) => {\n return typeof value === 'string' ? fromEditorPath(value) : value;\n });\n\n return originalOnMessage.call(\n this,\n isStringMessage ? processedMessageJSON : JSON.parse(processedMessageJSON)\n );\n },\n\n send(/** @type {any} */ msg) {\n return originalSend.call(this, JSON.parse(JSON.stringify(msg, (key, value) => {\n return typeof value === `string` ? toEditorPath(value) : value;\n })));\n }\n });\n\n return tsserver;\n};\n\nconst [major, minor] = absRequire(`typescript/package.json`).version.split(`.`, 2).map(value => parseInt(value, 10));\n// In TypeScript@>=5.5 the tsserver uses the public TypeScript API so that needs to be patched as well.\n// Ref https://github.com/microsoft/TypeScript/pull/55326\nif (major > 5 || (major === 5 && minor >= 5)) {\n moduleWrapper(absRequire(`typescript`));\n}\n\n// Defer to the real typescript/lib/tsserverlibrary.js your application uses\nmodule.exports = moduleWrapper(absRequire(`typescript/lib/tsserverlibrary.js`));\n" }, { "path": ".yarn/sdks/typescript/lib/typescript.js", "content": "#!/usr/bin/env node\n\nconst {existsSync} = require(`fs`);\nconst {createRequire, register} = require(`module`);\nconst {resolve} = require(`path`);\nconst {pathToFileURL} = require(`url`);\n\nconst relPnpApiPath = \"../../../../.pnp.cjs\";\n\nconst absPnpApiPath = resolve(__dirname, relPnpApiPath);\nconst absRequire = createRequire(absPnpApiPath);\n\nconst absPnpLoaderPath = resolve(absPnpApiPath, `../.pnp.loader.mjs`);\nconst isPnpLoaderEnabled = existsSync(absPnpLoaderPath);\n\nif (existsSync(absPnpApiPath)) {\n if (!process.versions.pnp) {\n // Setup the environment to be able to require typescript\n require(absPnpApiPath).setup();\n if (isPnpLoaderEnabled && register) {\n register(pathToFileURL(absPnpLoaderPath));\n }\n }\n}\n\n// Defer to the real typescript your application uses\nmodule.exports = absRequire(`typescript`);\n" }, { "path": ".yarn/sdks/typescript/package.json", "content": "{\n \"name\": \"typescript\",\n \"version\": \"5.5.4-sdk\",\n \"main\": \"./lib/typescript.js\",\n \"type\": \"commonjs\",\n \"bin\": {\n \"tsc\": \"./bin/tsc\",\n \"tsserver\": \"./bin/tsserver\"\n }\n}\n" }, { "path": ".yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "CODE_OF_CONDUCT.md", "content": "# Code of Conduct\n\n## Introduction\n\nExercism is a platform centered around empathetic conversation.\nWe have a low tolerance for communication that makes anyone feel unwelcome, unsupported, insulted or discriminated against.\n\n## Seen or experienced something uncomfortable?\n\nIf you see or experience abuse, harassment, discrimination, or feel unsafe or upset, please email [abuse@exercism.org](mailto:abuse@exercism.org?subject=%5BCoC%5D) and include \\[CoC\\] in the subject line.\nWe will follow up with you as a priority.\n\n## Enforcement\n\nWe actively monitor for Code of Conduct (CoC) violations and take any reports of violations extremely seriously.\nWe have banned contributors, mentors and users due to violations.\n\nAfter we receive a report of a CoC violation, we view that person's conversation history on Exercism and related communication channels and attempt to understand whether someone has deliberately broken the CoC, or accidentally crossed a line.\nWe generally reach out to the person who has been reported to discuss any concerns we have and warn them that repeated violations will result in a ban.\nSometimes we decide that no violation has occurred and that no action is required and sometimes we will also ban people on a first offense.\nWe strive to be fair, but will err on the side of protecting the culture of our community.\n\nExercism's leadership reserve the right to take whatever action they feel appropriate with regards to CoC violations.\n\n## The simple version\n\n- Be empathetic\n- Be welcoming\n- Be kind\n- Be honest\n- Be supportive\n- Be polite\n\n## The details\n\nExercism should be a safe place for everybody regardless of\n\n- Gender, gender identity or gender expression\n- Sexual orientation\n- Disability\n- Physical appearance (including but not limited to body size)\n- Race\n- Age\n- Religion\n- Anything else you can think of\n\nAs someone who is part of this community, you agree that:\n\n- We are collectively and individually committed to safety and inclusivity\n- We have zero tolerance for abuse, harassment, or discrimination\n- We respect peopleā€™s boundaries and identities\n- We refrain from using language that can be considered offensive or oppressive (systemically or otherwise), eg. sexist, racist, homophobic, transphobic, ableist, classist, etc.\n - this includes (but is not limited to) various slurs.\n- We avoid using offensive topics as a form of humor\n\nWe actively work towards:\n\n- Being a safe community\n- Cultivating a network of support & encouragement for each other\n- Encouraging responsible and varied forms of expression\n\nWe condemn:\n\n- Stalking, doxxing, or publishing private information\n- Violence, threats of violence or violent language\n- Anything that compromises peopleā€™s safety\n- Conduct or speech which might be considered sexist, racist, homophobic, transphobic, ableist or otherwise discriminatory or offensive in nature\n- The use of unwelcome, suggestive, derogatory or inappropriate nicknames or terms\n- Disrespect towards others (jokes, innuendo, dismissive attitudes) and towards differences of opinion\n- Intimidation or harassment (online or in-person).\n Please read the [Citizen Code of Conduct](https://github.com/stumpsyn/policies/blob/master/citizen_code_of_conduct.md) for how we interpret harassment\n- Inappropriate attention or contact\n- Not understanding the differences between constructive criticism and disparagement\n\nThese things are NOT OK.\n\nBe aware of how your actions affect others.\nIf it makes someone uncomfortable, stop.\n\nIf you say something that is found offensive, and you are called out on it, try to:\n\n- Listen without interruption\n- Believe what the person is saying & do not attempt to disqualify what they have to say\n- Ask for tips / help with avoiding making the offense in the future\n- Apologize and ask forgiveness\n\n## History\n\nThis policy was initially adopted from the Front-end London Slack community and has been modified since.\nA version history can be seen on [GitHub](https://github.com/exercism/website-copy/edit/main/pages/code_of_conduct.md).\n\n_This policy is a \"living\" document, and subject to refinement and expansion in the future.\nThis policy applies to the Exercism website, the Exercism GitHub organization, any other Exercism-related communication channels (e.g. Discord, Forum, Twitter, email) and any other Exercism entity or event._\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing\n\nThis is the TypeScript track, one of the many tracks on [exercism][web-exercism]. It holds all the _exercises_ that are currently implemented and available for students to complete.\nThe track consists of various **core** exercises, the ones a student _must_ complete, and each **core** exercise may unlock various _side_ exercises.\nYou can find this in the [`config.json`][file-config].\nIt's not uncommon that people discover incorrect implementations of certain tests, have a suggestion for a track specific hint to aid the student on the _JavaScript specifics_, see optimisations in terms of the configurations of `jest`, `eslint` or other dependencies, report missing edge cases, factual errors, logical errors, and, implement exercises or develop new exercises.\n\n> [!IMPORTANT]\n> When contributing, please open your PR from a branch so our automated tooling can run.\n\nWe welcome contributions of all sorts and sizes, from reporting issues to submitting patches, as well as joining the current [discussions šŸ’¬][issue-discussion].\n\n---\n\n## Table of Contents\n\n- [Contributing](#contributing)\n - [Table of Contents](#table-of-contents)\n - [Code of Conduct](#code-of-conduct)\n - [Exercises](#exercises)\n - [New exercise](#new-exercise)\n - [Implementing existing exercise](#implementing-existing-exercise)\n - [Creating a track-specific exercise](#creating-a-track-specific-exercise)\n - [Existing exercises](#existing-exercises)\n - [Improving the README.md](#improving-the-readmemd)\n - [Syncing the exercise](#syncing-the-exercise)\n - [Improving or adding mentor notes](#improving-or-adding-mentor-notes)\n - [Improving or adding automated test analyzers](#improving-or-adding-automated-test-analyzers)\n - [Documentation](#documentation)\n - [Tools](#tools)\n - [Fetch configlet](#fetch-configlet)\n - [Scripts](#scripts)\n - [`format`](#format)\n - [`lint`](#lint)\n - [`test`](#test)\n - [`sync`](#sync)\n - [`checksum`](#checksum)\n - [`ci-check`](#ci-check)\n - [`ci`](#ci)\n - [`name-check`](#name-check)\n - [`name-uniq`](#name-uniq)\n\n---\n\nThis guide covers several common scenarios pertaining to **improving the TypeScript track**.\nThere are several other guides about contributing to other parts of the Exercism ecosystem, that are similar to this repository.\n\n- [Generic information about track-contributing][contributing-generic]\n- [The JavaScript track][contributing-javascript]\n- [The JavaScript Analyzer][contributing-javascript-analyzer]\n- [The JavaScript Test Runner][contributing-javascript-test-runner]\n- [The TypeScript Analyzer][contributing-typescript-analyzer]\n- [The TypeScript Test Runner][contributing-typescript-test-runner]\n\n## Code of Conduct\n\nHelp us keep Exercism welcoming. Please read and abide by the [Code of Conduct][coc].\n\n## Exercises\n\nBefore contributing code to any existing exercise or any new exercise, please have a thorough look at the current exercises and dive into [open issues][issue-open].\n\n### New exercise\n\nThere are two ways to implement new exercises (exercises that don't exist in this track).\n\n1. Pick one from [the list of exercises][list-of-exercises] (implemented in other tracks).\n2. Create a new, track-specific exercise from scratch.\n\n#### Implementing existing exercise\n\nLet's say you want to implement a new exercise, from the list of (practice) exercises, because you've noticed that this track could benefit from this exercise, really liked it in another track, or just because you find this interesting; the first step is to [check for an open issue][issue-new-exercise].\nIf it's there, make sure no one is working on it, and most of all that there is not an open Pull Request towards this exercise.\n\nIf there is no such issue, you may open one. The baseline of work is as follows:\n\n1. Open a new issue, we'll label it with `new exercise āœØ`\n1. We'll assign the issue to you, so you get to work on this exercise\n1. Create a new folder in `/exercises`\n1. You'll need to sync this folder with the matching config files.\n You can use `sync` to do this: `ASSIGNMENT=practice/slug corepack yarn sync`.\n1. Create a `.ts` stub file.\n1. Create a `.test.ts` test file.\n Here add the tests, per canonical data if possible (more on canonical data below).\n1. Create a `.meta/proof.ci.ts` file.\n Place a working implementation, assuming it's renamed to `.ts`\n1. Create `.meta/tests.toml`.\n If the exercise that is being implemented has test data in the [problem specifications repository][problem-specifications], the contents of this file **must** be a list of UUIDs of the tests that are implemented or not implemented.\n Scroll down to [tools](#tools) to find the configlet application which aids generating this file _interactively_.\n1. Create a `.meta/config.json`.\n Copy the structure from any other `.meta/config.json`. Fill the `blurb`, `source` and `source_url` according to the `metadata.yml` in the [problem specifications repository][problem-specifications].\n Add yourself as author.\n1. Create a `.docs/instructions.md` file.\n Copy the instructions from the [problem specifications repository][problem-specifications]\n1. Run the tests locally, using `scripts/test`: `ASSIGNMENT=practice/slug corepack yarn test`.\n1. Run the linter locally, using `scripts/lint`: `ASSIGNMENT=practice/slug corepack yarn lint`.\n1. Create an entry in `config.json`: a unique _new_ UUID (you can use the `configlet uuid` tool to generate one, scroll down to [tools](#tools) to see how you can get it), give it a difficulty (should be similar to similar exercises), and make sure the _order_ of the file is sane.\n Currently the file is ordered first on core - non core, then on difficulty low to high, and finally lexographically.\n1. Format the files, using `scripts/format`: `corepack yarn format`.\n\nThe final step is opening a Pull Request, with these items all checked off.\nMake sure the tests run and the linter is happy.\nIt will run automatically on your PR.\n\n#### Creating a track-specific exercise\n\nThe steps for a track-specific exercise are similar to those of implementing an established, existing exercise. The differences are:\n\n- You'll have to write a README.md and test-suite from scratch\n- You'll have to come up with a unique _slug_.\n- We need to require an icon for it.\n- Generate a UUID, for example using [configlet][configlet].\n\nOpen a new issue with your proposal, and we'll make sure all these steps are correctly taken.\nDon't worry! You're not alone in this.\n\n### Existing exercises\n\nThere are always improvements possible on existing exercises.\n\n#### Improving the README.md\n\n`README.md`: the description that shows up on the student's exercise page, when they are ready to start.\nIt's also downloaded as part of the exercise's data.\nhe `README.md`, together with the `.test.ts` file form the contract for the implementation of the exercise.\nNo test should _force_ a specific implementation, no `README.md` explanation should _give away_ a certain implementation.\nThe `README.md` files are [generated][doc-readme], which is explains [here][doc-readme].\n\n- This file may need to be _regenerated_ in order to sync with the latest canonical data.\n- You may contribute track specific `hints.md`, as listed in that [document][doc-readme]\n- You may improve the track specific `exercise-readme-insert.md`, and regenerate all the READMEs.\n\n> **Note**: In v3, this will no longer be exactly the same. We'll update this section of the guide when V3 is live.\n\n#### Syncing the exercise\n\nSyncing an exercise with _canonical data_: There is a [problem-specifications][problem-specifications] repository that holds test data in a standardised format.\nThese tests are occasionally fixed, improved, added, removed or otherwise changed.\nSyncing an exercise consists of:\n\n- updating `tests.toml`;\n- updating the `.test.ts` file;\n- updating the `.meta/tests.toml` file, if the exercise that is being updated has test data in the [problem specifications repository][problem-specifications].\n The contents of this file can be updated using configlet, interactively;\n- match the `proof.ci.ts` file to still work with the new tests; and\n- regenerate the [`README.md`][doc-readme], should there be any changes.\n\n#### Improving or adding mentor notes\n\n[Mentor notes][mentor-notes] are the notes that are given to the mentors to guide them with mentoring.\nThese notes _do not live in this repository_, but instead in the `website-copy` repository.\nFind their [contributing guidelines][contributing-website-copy] [here][contributing-website-copy].\n\n#### Improving or adding automated test analyzers\n\nSome exercises already have automated mentoring support.\nThese automations don't live in this repository, but instead in the `typescript-analyzer` repository.\nFind their [contributing guidelines][contributing-typescript-analyzer] [here][contributing-typescript-analyzer].\n\n## Documentation\n\nThere is quite a bit of student-facing documentation, which can be found in the [`docs`][file-docs] folder.\nYou may improve these files by making the required changes and opening a new Pull Request.\n\n## Tools\n\nYou'll need LTS or higher NodeJS in order to contribute to the _code_ in this respository. Run `yarn` in the root in order to be able to run the scripts as listed below.\nWe use the following dependencies:\n\n- `shelljs` in order to provide shell interface to scripts\n- `eslint` for linting all code in the stub, test file and example file\n- `jest` to run all the test files on all example implementations\n- `babel` to transpile everything so it works _regardless of your version of NodeJS_.\n\nWe also use `prettier` to format the files. When possible, use `corepack yarn format` to run prettier.\nIf you want to auto-format using your editor, match the version in the GitHub Workflow `verify-code-formatting.yml`.\n\n### Fetch configlet\n\nIf you'd like to download [configlet][configlet], you can use the [`fetch-configlet`][bin-fetch-configlet] binary.\nIt will run on Linux, Mac OSX and Windows, and download `configlet` to your local drive.\nFind more information about [configlet][configlet] [here][configlet].\n\n> If a track implements an exercise for which test data exists, the exercise _must_ contain a `.meta/tests.toml` file.\n> The goal of the `tests.toml` file is to keep track of which tests are implemented by the exercise.\n> Tests in this file are identified by their UUID and each test has a boolean value that indicates if it is implemented by that exercise.\n\nA `tests.toml` file for a track's `two-fer` exercise looks like this:\n\n```toml\n[canonical-tests]\n\n[19709124-b82e-4e86-a722-9e5c5ebf3952]\ndescription = \"no name given\"\ninclude = true\n\n[3451eebd-123f-4256-b667-7b109affce32]\ndescription = \"a name given\"\ninclude = true\n\n[653611c6-be9f-4935-ab42-978e25fe9a10]\ndescription = \"another name given\"\ninclude = false\n```\n\nTo make it easy to keep the `tests.toml` files up to date, contributors can use the `configlet` application's `sync` command.\nThis command will compare the tests specified in the `tests.toml` files against the tests that are defined in the exercise's canonical data.\nIt then interactively gives the maintainer the option to include or exclude test cases that are currently missing, updating the `tests.toml` file accordingly.\n\n### Scripts\n\nWe have various `scripts` for you in order to aid with maintaining and contributing to this repository.\n\n#### `format`\n\n> This has been aliased as a top-level package.json `scripts` script:\n>\n> ```shell\n> corepack yarn format\n> ```\n\n```typescript\n/*\n * Run this script (from root directory):\n *\n * $ corepack yarn format\n *\n * This runs `prettier` on all applicable files, FORCES using the same version\n * as the CI uses to check if the files have been formatted.\n */\n```\n\nUse this action to format all the files using the correct version of prettier.\nIf you want your editor to do this automatically, make sure you install `corepack yarn install`.\n\n#### `lint`\n\n> This has been aliased as a top-level package.json `scripts` script:\n>\n> ```shell\n> corepack yarn lint\n> ```\n\n```typescript\n/*\n * Run this script (from root directory):\n *\n * $ corepack yarn lint\n *\n * This runs `eslint` on all sample solutions (and test) files\n */\n```\n\nIf the `ASSIGNMENT` environment variable is set, only _that_ exercise is tested.\nFor example, if you only want to lint `two-fer`, you may, depending on your environment use:\n\n```shell\nASSIGNMENT=practice/two-fer corepack yarn lint\n```\n\n#### `test`\n\n> This has been aliased as a top-level package.json `scripts` script:\n>\n> ```shell\n> corepack yarn test\n> ```\n\n```typescript\n/**\n * Run this script (from root directory):\n *\n * $ corepack yarn test\n *\n * This runs `jest` tests for all sample solutions\n */\n```\n\nIf the `ASSIGNMENT` environment variable is set, only _that_ exercise is tested.\nFor example, if you only want to test the `example.js` for `two-fer`, you may, depending on your environment, use:\n\n```shell\nASSIGNMENT=practice/two-fer corepack yarn test\n```\n\n#### `sync`\n\n> This has been aliased as a top-level package.json `scripts` script:\n>\n> ```shell\n> corepack yarn sync\n> ```\n\n```typescript\n/**\n * Run this script (from root directory):\n *\n * $ corepack yarn sync\n *\n * This script is used to propagate any change to root package.json to\n * all exercises and keep them in sync.\n * There is a CI step which checks that package.json in root & exercises match\n * (see checksum script for more info).\n */\n```\n\nIf the `ASSIGNMENT` environment variable is set, only _that_ exercise is tested.\nFor example, if you only want to sync the files for `two-fer`, you may, depending on your environment, use:\n\n```shell\nASSIGNMENT=practice/two-fer corepack yarn sync\n```\n\n#### `checksum`\n\n```typescript\n/*\n * Run this script (from root directory):\n *\n * $ corepack yarn node scripts/checksum.mjs\n *\n * This will check root `package.json` matches each exercise's `package.json`.\n * But the catch is there are some dependencies used for build but not served to end users\n * We skip those dependencies while performing checksum.\n * See `SKIP_PACKAGES_FOR_CHECKSUM` in helpers.js for list of skipped packages.\n */\n```\n\n#### `ci-check`\n\n> This has been aliased as a top-level package.json `scripts` script:\n>\n> ```shell\n> corepack yarn ci:check\n> ```\n\n```typescript\n/**\n * Run this script (from root directory):\n *\n * $ corepack yarn ci:check\n *\n * This will run following checks:\n *\n * 1. Check config in all exercises matches\n * 2. Checks stubs exist\n * 3. Run eslint to check code-style\n */\n```\n\nRun this script to check stubs, configuration integrity and lint the code.\n\n#### `ci`\n\n> This has been aliased as a top-level package.json `scripts` script:\n>\n> ```shell\n> corepack yarn ci\n> ```\n\nThis script is _almost_ the same as `test`. You may use them interchangeably at moment of writing\n\n```typescript\n/**\n * Run this script (from root directory):\n *\n * $ corepack yarn ci\n *\n * This will run following checks:\n *\n * 1. Find the exercises\n * 2. Run tests against sample solutions\n */\n```\n\nRun this script to test all exercises.\n\n#### `name-check`\n\n```typescript\n/**\n * Run this script (from root directory):\n *\n * $ corepack yarn node scripts/name-check.mjs\n *\n * This will run following checks:\n *\n * 1. Package name is of the format \"@exercism/typescript-\"\n *\n * This script also allows fixing these names:\n *\n * $ corepack yarn node scripts/name-check.mjs --fix\n */\n```\n\nRun this script to check if package name in package.json of exercises is in expected format.\nRun this script with the `--fix` flag to automatically fix the names.\n\n#### `name-uniq`\n\n```typescript\n/**\n * Run this script (from root directory):\n *\n * $ corepack yarn node scripts/name-uniq.mjs\n *\n * This will run following checks:\n *\n * 1. All exercises have unique package names in their package.json files.\n */\n```\n\nRun this script to check if there is any duplicate package name.\n\n[configlet]: https://github.com/exercism/docs/blob/master/language-tracks/configuration/configlet.md\n[bin-fetch-configlet]: https://github.com/exercism/javascript/blob/master/bin/fetch-configlet\n[web-exercism]: https://exercism.org\n[file-config]: https://github.com/exercism/javascript/blob/master/config.json\n[file-docs]: https://github.com/exercism/javascript/blob/master/docs\n[issue-open]: https://github.com/exercism/javascript/issues\n[issue-discussion]: https://github.com/exercism/javascript/labels/discussion%20%3Aspeech_balloon%3A\n[issue-new-exercise]: https://github.com/exercism/javascript/issues?q=is%3Aopen+is%3Aissue+label%3A%22%3Asparkles%3A+new+exercise%22\n[list-of-exercises]: https://tracks.exercism.org/typescript/master/unimplemented\n[contributing-generic]: https://github.com/exercism/docs/tree/master/contributing-to-language-tracks\n[contributing-javascript]: https://github.com/exercism/javascript/blob/master/CONTRIBUTING.md\n[contributing-javascript-analyzer]: https://github.com/exercism/javascript-analyzer/blob/master/CONTRIBUTING.md\n[contributing-javascript-test-runner]: https://github.com/exercism/javascript-test-runner\n[contributing-typescript]: https://github.com/exercism/typescript/blob/master/CONTRIBUTING.md\n[contributing-typescript-analyzer]: https://github.com/exercism/typescript-analyzer/blob/master/CONTRIBUTING.md\n[contributing-typescript-test-runner]: https://github.com/exercism/typescript-test-runner\n[contributing-website-copy]: https://github.com/exercism/website-copy#contributing\n[doc-readme]: https://github.com/exercism/docs/blob/master/language-tracks/exercises/anatomy/readmes.md\n[problem-specifications]: https://github.com/exercism/problem-specifications\n[coc]: https://exercism.org/code-of-conduct\n[mentor-notes]: https://github.com/exercism/website-copy/tree/master/tracks/javascript/exercises\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2021 Exercism\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "README.md", "content": "# Exercism TypeScript Track\n\n[![configlet](https://github.com/exercism/typescript/actions/workflows/configlet.yml/badge.svg)](https://github.com/exercism/typescript/actions/workflows/configlet.yml) [![typescript / ci](https://github.com/exercism/typescript/workflows/typescript%20/%20main/badge.svg)](https://github.com/exercism/typescript/actions?query=workflow%3A%22typescript+%2F+main%22)\n\n**Exercism exercises in TypeScript**\n\nThis is the TypeScript track, one of the many tracks on [exercism][web-exercism].\nIt holds all the _exercises_ that are currently implemented and available for students to complete.\nThe track consists of various **core** exercises - the ones a student _must_ complete - and each **core** exercise may unlock various _side_ exercises.\nYou can find this in the [`config.json`][file-config].\n\n> In version 3 of exercism, the above no longer holds. See the [`exercism/v3`][git-v3] repository for more information.\n\n## Tools\n\nSee [CONTRIBUTING.md][file-contributing] for a list of requirements to contribute to this track.\nIt also has a list of tools you can use, of which the `test` tool is one of them.\n\n## Running the test suite\n\nThis runs `jest` tests for all sample solutions.\nThis _does not_ use the regular way to run `jest`, because the example solution files must be renamed to be imported correctly into the test files.\n\n```shell\ncorepack yarn test\n```\n\nIf the `ASSIGNMENT` environment variable is set, only _that_ exercise is tested.\nFor example, if you only want to test the `two-fer.example.ts` for `two-fer`, you may, depending on your environment, use:\n\n```shell\nASSIGNMENT=practice/two-fer corepack yarn test\n```\n\n> Running on Windows? Depending on your shell, environment variables are set differently.\n> You can use `cross-env` to normalize this. The following should work across environments:\n>\n> ```bash\n> corepack yarn dlx cross-env ASSIGNMENT=practice/two-fer corepack yarn test\n> ```\n\n## Related repositories\n\n- [Website Copy][git-website-copy] (Mentor Notes)\n- [The TypeScript Analyzer][git-typescript-analyzer]\n- [The TypeScript Representer][git-typescript-representer]\n- [The TypeScript Test Runner][git-typescript-test-runner]\n\n### Related JavaScript repositories\n\nA lot of the improvements made to this track and tooling, is also made to the JavaScript track and tooling and vice-versa.\n\n- [The JavaScript track][git-javascript]\n- [The JavaScript Analyzer][git-javascript-analyzer] (Automated Code Analysis)\n- [The JavaScript Representer][git-javascript-representer]\n- [The JavaScript Test Runner][git-javascript-test-runner]\n\n[web-exercism]: https://exercism.org\n[file-config]: https://github.com/exercism/typescript/blob/master/config.json\n[file-contributing]: https://github.com/exercism/typescript/blob/master/CONTRIBUTING.md\n[git-javascript]: https://github.com/exercism/javascript\n[git-javascript-analyzer]: https://github.com/exercism/javascript-analyzer\n[git-javascript-representer]: https://github.com/exercism/javascript-representer\n[git-javascript-test-runner]: https://github.com/exercism/javascript-test-runner\n[git-typescript]: https://github.com/exercism/typescript/\n[git-typescript-analyzer]: https://github.com/exercism/typescript-analyzer\n[git-typescript-representer]: https://github.com/exercism/typescript-representer\n[git-typescript-test-runner]: https://github.com/exercism/typescript-test-runner\n[git-v3]: https://github.com/exercism/v3\n[git-website-copy]: https://github.com/exercism/website-copy\n" }, { "path": "TAGS.md", "content": "# Tags\n\nThis document aims to provide reasoning why `config.json` contains the `\"tags\"` it contains.\n\nIt uses as a basis the JavaScript's [TAGS.md](https://github.com/exercism/javascript/blob/main/TAGS.md) because anything that JavaScript does can be done with TypeScript, being a transpiled language, and adds/modifies with the perks TypeScript brings on top of it.\n\n## Paradigms\n\n- [x] `paradigm/declarative`: mostly popularised by libraries and frameworks such as React, Vue, etc.\n- [x] `paradigm/functional`: there is a lot of support for functional programming, including various defactor libraries in the ecosystem providing functional programming patterns.\n- [x] `paradigm/imperative`: It retains JavaScript's script and DOM's manipulation imperative programming, but the language design doesn't encourage it.\n- [ ] `paradigm/logic`: whilst it is possible to write DSL or patterns that' allow for logic-based programming, JavaScript doesn't inherently support it.\n- [x] `paradigm/object_oriented`: becomes a main feature of the language compared to JavaScript, along with static type checking and a rich type system.\n\n## Typing\n\n- [x] `typing/static`: Will check types at compile time for any part of the code which has its types stated.\n- [x] `typing/dynamic`: At runtime all TypeScript's type information is stripped. Runtime type checking can also be manually achieved, as well.\n- [x] `typing/strong`: TypeScript adds a rich type system, that is checked at compile time if used.\n- [x] `typing/weak`: TypeScript allows for explicit (strong) typing, inferred (weak) typing, deferred (computed / conditional) typing, opt-out (using `any`) of typing, and forced run-time (using `unknown`) typing.\n\n## Execution mode\n\n- [x] `execution_mode/compiled`: TypeScript transpilation (transpilation via [`tsc`](https://www.typescriptlang.org/), or stripping types and then compiling using [`@babel/preset-typescript`](https://babeljs.io/docs/en/babel-preset-typescript)) compiles the code to a certain version of JavaScript. This includes in-memory compilation using tools such as [`ts-node`](https://github.com/TypeStrong/ts-node), however due to the in-line nature and REPL like support, it might be considered interpreted.\n- [x] `execution_mode/interpreted`: TypeScript _can_ be interpreted Just-In-Time by stripping types, for example using [`@babel/preset-typescript`](https://babeljs.io/docs/en/babel-preset-typescript).\n\n## Platform\n\n- [x] `platform/windows`: popularised by Electron and Node\n- [x] `platform/mac`: popularised by Electron and Node\n- [x] `platform/linux`: popularised by Electron and Node\n- [x] `platform/ios`: popularised by PhoneGap/Cordova, Ionic, React-Native\n- [x] `platform/android`: popularised by PhoneGap/Cordova, Ionic, React-Native\n- [x] `platform/web`: used in frontend frameworks like Angular\n\n## Runtime\n\n- [ ] `runtime/standalone_executable`: it doesn't. Any executable that exists packages Node, or requires Node or a Browser.\n- [x] `runtime/language_specific`: it runs on Node\n- [ ] `runtime/clr`: it doesn't\n- [ ] `runtime/jvm`: it doesn't\n- [ ] `runtime/beam`: it doesn't\n- [x] `runtime/wasmtime`: Just like JavaScript, it doesn't natively, but JavaScript can compile to WASM, and thus then run on wastime. It's a bit of a cheat, but probably what people will search for.\n\n## Used for\n\n- [x] `used_for/artificial_intelligence`: popularised by TensorFlow\n- [x] `used_for/backends`: popularised by Express\n- [x] `used_for/cross_platform_development`: popularised by PhoneGap/Cordova, Ionic, React-Native, Electron and more\n- [ ] `used_for/embedded_systems`: It's possible to run the transpiled JavaScript on microcontrollers and IoT platforms, but the low-end nature makes it not a viable, professional, solution. Therefore this is not included.\n- [ ] `used_for/financial_systems`: Although it improves in the type safeness department, TypeScript being still JavaScript makes it too slow for fintech.\n- [x] `used_for/frontends`: Most TypeScript usage is with Frontend frameworks.\n- [x] `used_for/games`: probably one of the most popular replacements for browser-based games.\n- [x] `used_for/guis`: same reason as frontends, which is more and more interesting as libraries such as React can now also render to less common/expected displays, such as terminals (and thus be used to build GUIs), not requiring CSS or other ways to provide styling.\n- [x] `used_for/mobile`: yep, see platform\n- [ ] `used_for/robotics`: it's possible. Things like Johnny-Five help a lot. However, it's not a _go to_ language to provide robotics programming, so it's not included.\n- [ ] `used_for/scientific_calculations`: possible, and not uncommon especially for _visualisation_ (for example d3), but not a _go to_ language to do scientific calculations, so it's not included.\n- [ ] `used_for/scripts`: You could still transpile your TypeScript files, but is usually not worth the hassle, so is not used for scripting at all compared to JavaScript\n- [x] `used_for/web_development`: yes\n" }, { "path": "babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "bin/check-formatting.sh", "content": "#!/usr/bin/env bash\n\nset -uo pipefail\n\nif [ -z \"${EXERCISM_PRETTIER_VERSION:-}\" ]; then\n echo \"[format] pulling prettier version from yarn.lock using sed\"\n EXERCISM_PRETTIER_VERSION=\"$(corepack yarn info prettier --json --name-only | sed -n -e 's/^\"prettier@npm://' -e 's/\"//p')\"\n echo \"[format] expected version is now ${EXERCISM_PRETTIER_VERSION:-}\"\nfi\n\nif [ -z \"${EXERCISM_PRETTIER_VERSION:-}\" ]; then\n echo \"Version could not be pulled using sed\" >&2\n echo \"[format] pulling prettier version from yarn.lock using grep\"\n EXERCISM_PRETTIER_VERSION=\"$(corepack yarn info prettier --json --name-only | grep -Po '\"prettier@npm:\\K[^\"]+')\"\n echo \"[format] expected version is now ${EXERCISM_PRETTIER_VERSION:-}\"\nfi\n\nif [ -z \"${EXERCISM_PRETTIER_VERSION:-}\" ]; then\n echo \"Version could not be pulled using grep or sed\" >&2\n echo \"\"\n echo \"---------------------------------------------------\"\n echo \"This script requires the EXERCISM_PRETTIER_VERSION variable to work.\"\n echo \"Please see https://exercism.org/docs/building/markdown/style-guide for guidance.\"\n echo \"---------------------------------------------------\"\n echo \"$(corepack yarn -v)\"\n echo \"\"\n echo \"This is what yarn why reports:\"\n echo \"$ corepack yarn why prettier\"\n echo \"$(corepack yarn why prettier)\"\n echo \"\"\n echo \"And corepack yarn info reports the following:\"\n echo \"$ corepack yarn info prettier --name-only\"\n echo \"$(corepack yarn info prettier --name-only)\"\n echo \"\"\n echo \"This is the version that can be extracted using grep:\"\n echo \"$ corepack yarn info prettier --json --name-only | grep -Po '\"prettier@npm:\\K[^\"]+'\"\n echo \"ā””ā”€ $(corepack yarn info prettier --json --name-only | grep -Po '\"prettier@npm:\\K[^\"]+')\"\n echo \"\"\n echo \"This is the version that can be extracted using sed:\"\n echo \"$ corepack yarn info prettier --json --name-only | sed -n -e 's/^\"prettier@npm://' -e 's/\"//p'\"\n echo \"ā””ā”€ $(corepack yarn info prettier --json --name-only | sed -n -e 's/^\"prettier@npm://' -e 's/\"//p')\"\n echo \"\"\n echo \"These files are found in the repo root:\"\n echo \"$(ls -p | grep -v /)\"\n echo \"---------------------------------------------------\"\n exit 1\nelse\n echo \"[format] running with prettier@$EXERCISM_PRETTIER_VERSION\"\nfi\n\ncorepack yarn dlx \"prettier@$EXERCISM_PRETTIER_VERSION\" --check \"**/*.{js,jsx,ts,tsx,css,sass,scss,html,json,md,yml}\"\n" }, { "path": "bin/fetch-configlet", "content": "#!/usr/bin/env bash\n\n# This file is a copy of the\n# https://github.com/exercism/configlet/blob/main/scripts/fetch-configlet file.\n# Please submit bugfixes/improvements to the above file to ensure that all tracks benefit from the changes.\n\nset -eo pipefail\n\ncurlopts=(\n --silent\n --show-error\n --fail\n --location\n --retry 3\n)\n\nif [[ -n \"${GITHUB_TOKEN}\" ]]; then\n curlopts+=(--header \"authorization: Bearer ${GITHUB_TOKEN}\")\nfi\n\nget_download_url() {\n local os=\"$1\"\n local ext=\"$2\"\n local latest='https://api.github.com/repos/exercism/configlet/releases/latest'\n local arch\n case \"$(uname -m)\" in\n aarch64|arm64) arch='arm64' ;;\n x86_64) arch='x86-64' ;;\n *686*) arch='i386' ;;\n *386*) arch='i386' ;;\n *) arch='x86-64' ;;\n esac\n local suffix=\"${os}_${arch}.${ext}\"\n curl \"${curlopts[@]}\" --header 'Accept: application/vnd.github.v3+json' \"${latest}\" |\n grep \"\\\"browser_download_url\\\": \\\".*/download/.*/configlet.*${suffix}\\\"$\" |\n cut -d'\"' -f4\n}\n\nmain() {\n local output_dir\n if [[ -d ./bin ]]; then\n output_dir=\"./bin\"\n elif [[ $PWD == */bin ]]; then\n output_dir=\"$PWD\"\n else\n echo \"Error: no ./bin directory found. This script should be ran from a repo root.\" >&2\n return 1\n fi\n\n local os\n case \"$(uname -s)\" in\n Darwin*) os='macos' ;;\n Linux*) os='linux' ;;\n Windows*) os='windows' ;;\n MINGW*) os='windows' ;;\n MSYS_NT-*) os='windows' ;;\n *) os='linux' ;;\n esac\n\n local ext\n case \"${os}\" in\n windows) ext='zip' ;;\n *) ext='tar.gz' ;;\n esac\n\n echo \"Fetching configlet...\" >&2\n local download_url\n download_url=\"$(get_download_url \"${os}\" \"${ext}\")\"\n local output_path=\"${output_dir}/latest-configlet.${ext}\"\n curl \"${curlopts[@]}\" --output \"${output_path}\" \"${download_url}\"\n\n case \"${ext}\" in\n zip) unzip \"${output_path}\" -d \"${output_dir}\" ;;\n *) tar xzf \"${output_path}\" -C \"${output_dir}\" ;;\n esac\n\n rm -f \"${output_path}\"\n\n local executable_ext\n case \"${os}\" in\n windows) executable_ext='.exe' ;;\n *) executable_ext='' ;;\n esac\n\n local configlet_path=\"${output_dir}/configlet${executable_ext}\"\n local configlet_version\n configlet_version=\"$(${configlet_path} --version)\"\n echo \"Downloaded configlet ${configlet_version} to ${configlet_path}\"\n}\n\nmain\n" }, { "path": "bin/fetch-configlet.ps1", "content": "# This file is a copy of the\n# https://github.com/exercism/configlet/blob/main/scripts/fetch-configlet.ps1 file.\n# Please submit bugfixes/improvements to the above file to ensure that all tracks\n# benefit from the changes.\n\n$ErrorActionPreference = \"Stop\"\n$ProgressPreference = \"SilentlyContinue\"\n\n$requestOpts = @{\n Headers = If ($env:GITHUB_TOKEN) { @{ Authorization = \"Bearer ${env:GITHUB_TOKEN}\" } } Else { @{ } }\n MaximumRetryCount = 3\n RetryIntervalSec = 1\n}\n\nFunction Get-DownloadUrl {\n $arch = If ([Environment]::Is64BitOperatingSystem) { \"x86-64\" } Else { \"i386\" }\n $latestUrl = \"https://api.github.com/repos/exercism/configlet/releases/latest\"\n Invoke-RestMethod -Uri $latestUrl -PreserveAuthorizationOnRedirect @requestOpts `\n | Select-Object -ExpandProperty assets `\n | Where-Object { $_.name -match \"^configlet_.+_windows_${arch}.zip$\" } `\n | Select-Object -ExpandProperty browser_download_url -First 1\n}\n\n$outputDirectory = \"bin\"\nif (!(Test-Path -Path $outputDirectory)) {\n Write-Output \"Error: no ./bin directory found. This script should be ran from a repo root.\"\n exit 1\n}\n\nWrite-Output \"Fetching configlet...\"\n$downloadUrl = Get-DownloadUrl\n$outputFileName = \"configlet.zip\"\n$outputPath = Join-Path -Path $outputDirectory -ChildPath $outputFileName\nInvoke-WebRequest -Uri $downloadUrl -OutFile $outputPath @requestOpts\n\n$configletPath = Join-Path -Path $outputDirectory -ChildPath \"configlet.exe\"\nif (Test-Path -Path $configletPath) { Remove-Item -Path $configletPath }\n[System.IO.Compression.ZipFile]::ExtractToDirectory($outputPath, $outputDirectory)\nRemove-Item -Path $outputPath\n\n$configletVersion = (Select-String -Pattern \"/releases/download/(.+?)/\" -InputObject $downloadUrl -AllMatches).Matches.Groups[1].Value\nWrite-Output \"Downloaded configlet ${configletVersion} to ${configletPath}\"\n" }, { "path": "bin/format.sh", "content": "#!/usr/bin/env bash\n\nset -uo pipefail\n\nif [ -z \"${EXERCISM_PRETTIER_VERSION:-}\" ]; then\n echo \"[format] pulling prettier version from yarn.lock using sed\"\n EXERCISM_PRETTIER_VERSION=\"$(corepack yarn info prettier --json --name-only | sed -n -e 's/^\"prettier@npm://' -e 's/\"//p')\"\n echo \"[format] expected version is now ${EXERCISM_PRETTIER_VERSION:-}\"\nfi\n\nif [ -z \"${EXERCISM_PRETTIER_VERSION:-}\" ]; then\n echo \"Version could not be pulled using sed\" >&2\n echo \"[format] pulling prettier version from yarn.lock using grep\"\n EXERCISM_PRETTIER_VERSION=\"$(corepack yarn info prettier --json --name-only | grep -Po '\"prettier@npm:\\K[^\"]+')\"\n echo \"[format] expected version is now ${EXERCISM_PRETTIER_VERSION:-}\"\nfi\n\nif [ -z \"${EXERCISM_PRETTIER_VERSION:-}\" ]; then\n echo \"Version could not be pulled using grep or sed\" >&2\n echo \"\"\n echo \"---------------------------------------------------\"\n echo \"This script requires the EXERCISM_PRETTIER_VERSION variable to work.\"\n echo \"Please see https://exercism.org/docs/building/markdown/style-guide for guidance.\"\n echo \"---------------------------------------------------\"\n echo \"$(corepack yarn -v)\"\n echo \"\"\n echo \"This is what corepack yarn why reports:\"\n echo \"$ corepack yarn why prettier\"\n echo \"$(corepack yarn why prettier)\"\n echo \"\"\n echo \"And corepack yarn info reports the following:\"\n echo \"$ corepack yarn info prettier --name-only\"\n echo \"$(corepack yarn info prettier --name-only)\"\n echo \"\"\n echo \"This is the version that can be extracted using grep:\"\n echo \"$ corepack yarn info prettier --json --name-only | grep -Po '\"prettier@npm:\\K[^\"]+'\"\n echo \"ā””ā”€ $(corepack yarn info prettier --json --name-only | grep -Po '\"prettier@npm:\\K[^\"]+')\"\n echo \"\"\n echo \"This is the version that can be extracted using sed:\"\n echo \"$ corepack yarn info prettier --json --name-only | sed -n -e 's/^\"prettier@npm://' -e 's/\"//p'\"\n echo \"ā””ā”€ $(corepack yarn info prettier --json --name-only | sed -n -e 's/^\"prettier@npm://' -e 's/\"//p')\"\n echo \"\"\n echo \"These files are found in the repo root:\"\n echo \"$(ls -p | grep -v /)\"\n echo \"---------------------------------------------------\"\n exit 1\nelse\n echo \"[format] running with prettier@$EXERCISM_PRETTIER_VERSION\"\nfi\n\ncorepack yarn dlx \"prettier@$EXERCISM_PRETTIER_VERSION\" --write \"**/*.{js,jsx,ts,tsx,css,sass,scss,html,json,md,yml}\"\n" }, { "path": "bin/generate-config-tree", "content": "#!/usr/bin/env node\n\nconst { exercises } = require('../config.json')\nconst TAG_CORE = '__core'\nconst TAG_BONUS = '__bonus'\n\n// node inter-opt exports\nexports.TAG_CORE = TAG_CORE\nexports.TAG_BONUS = TAG_BONUS\n\nexports.tree = exercises.reduce((result, exercise) => {\n const tag = exercise.slug\n const item = {\n slug: tag,\n difficulty: exercise.difficulty,\n }\n\n if (exercise.core) {\n const current = result[TAG_CORE] || []\n\n if (result[tag]) {\n console.warn(`${tag} is not ordered correctly in config.json`)\n }\n\n return {\n ...result,\n __core: current.concat([item]),\n [tag]: result[tag] || []\n }\n }\n\n const parent = exercise.unlocked_by || TAG_BONUS\n const current = result[parent] || []\n return { ...result, [parent]: current.concat([item]) }\n}, {})\n" }, { "path": "bin/md5-hash", "content": "#!/bin/bash\n#\n# Calculates the MD5 hash of a given file. It uses hashing utilities powered by\n# operating systems, but wraps them into a consistent interface.\n\nOS=$(\n case $(uname) in\n (Darwin*) echo \"mac\";;\n (Linux*) echo \"linux\";;\n # TODO: implement MD5 hashing on Windows\n # (Windows*) echo \"windows\";;\n (*) echo \"linux\";;\n esac\n)\n\ncase $OS in\n mac )\n md5 -q $@;;\n linux )\n md5sum $@ | sed -E 's/([a-z0-9]{32}).+$/\\1/';;\nesac\n" }, { "path": "bin/print-config-tree", "content": "#!/usr/bin/env node\n\nconst actions = require('./generate-config-tree')\n\nconst { tree, TAG_BONUS, TAG_CORE } = actions\nconst { [TAG_BONUS]: __bonus, [TAG_CORE]: __core, ...track } = tree\n\nfunction printLn(line) {\n process.stdout.write(`${line}\\n`)\n}\n\nfunction printList(items) {\n items.forEach(item => {\n printLn(`- ${item.slug} (${item.difficulty})`)\n })\n}\n\nprintLn('Core (matches config.json) of this track:')\nprintList(__core)\nprintLn('\\n')\nprintLn('core')\nprintLn('----')\nObject.keys(track).forEach(slug => {\n printLn(`ā”œā”€ ${slug}`)\n track[slug].forEach((side, index, self) => {\n junction = index === self.length - 1 ? 'ā””ā”€' : 'ā”œā”€'\n printLn(`ā”‚ ${junction} ${side.slug} (${side.difficulty})`)\n })\n printLn('ā”‚')\n})\n\nprintLn('bonus')\nprintLn('----')\nprintList(__bonus)\n" }, { "path": "common/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "common/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "common/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "common/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "common/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "common/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "common/keep.ts", "content": "// This exists to keep tsconfig.json in this folder happy\nexport {}\n" }, { "path": "common/package.json", "content": "{\n \"name\": \"@exercism/typescript\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"author\": \"Katrina Owen\",\n \"contributors\": [\n \"Derk-Jan Karrenbeld (https://derk-jan.com)\"\n ],\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "common/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "common/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "concepts/.keep", "content": "" }, { "path": "concepts/basics/.meta/config.json", "content": "{\n \"blurb\": \"Basics contains the minimal knowledge required to get started in TypeScript: function declarations, variable assignment, and exposing entities.\",\n \"authors\": [\"SleeplessByte\"],\n \"contributors\": [\"junedev\"]\n}\n" }, { "path": "concepts/basics/about.md", "content": "# About\n\nTypeScript is JavaScript with syntax for types, making it a a strongly typed programming language, supporting object-oriented, imperative, and declarative (e.g. functional programming) styles, giving you better tooling at any scale.\nIt has a few [primitives][mdn-primitive], and everything else is considered an object.\n\nWhile JavaScript is the most well-known as the scripting language for Web pages, many non-browser environments also use it, such as Node.js.\nThe language is actively being developed; and because of its multi-paradigm property, allows for many styles of programming.\n\nTypeScript builds on-top of this and is also actively developed.\nIn some rankings from 2023 it is more popular than JavaScript in daily use.\n\nBecause [you cannot learn TypeScript without learning JavaScript][handbook-js-or-ts], some of the content in this Track is focused on teaching JavaScript concepts and some of the concepts focus on TypeScript specific features only.\n\n## (Re-)Assignment\n\nThere are a few primary ways to assign values to names in TypeScript - using variables or constants.\nOn Exercism, variables are always written in [camelCase][wiki-camel-case]; constants are written in [SCREAMING_SNAKE_CASE][wiki-snake-case].\nThere is no official guide to follow, and various companies and organizations have various style guides.\n_Feel free to write variables any way you like_.\nThe upside from writing them the way the exercises are prepared is that they'll be highlighted differently in the web interface and most IDEs.\n\nVariables in TypeScript can be defined using the [`const`][mdn-const], [`let`][mdn-let] or [`var`][mdn-var] keyword.\n\nA variable can reference different values over its lifetime when using `let` or `var`.\nFor example, `myFirstVariable` can be defined and redefined many times using the assignment operator `=`:\n\n```typescript\nlet myFirstVariable = 1\nmyFirstVariable = 'Some string'\nmyFirstVariable = new SomeComplexClass()\n```\n\nIn contrast to `let` and `var`, variables that are defined with `const` can only be assigned once.\nThis is used to define constants in TypeScript.\n\n```typescript\nconst MY_FIRST_CONSTANT = 10\n\n// Can not be re-assigned.\nMY_FIRST_CONSTANT = 20\n// => TypeError: Assignment to constant variable.\n```\n\nBecause TypeScript can detect this statically, the TypeScript compiler will also yield an error:\n\n```typescript\n// ^? Cannot assign to 'MY_FIRST_CONSTANT' because it is a constant.(2588)\n```\n\nThis means you don't need to run the code to detect the `TypeError`.\n\n\n~~~~exercism/note\nšŸ’” In a later Learning Exercise, the difference between _constant_ assignment / binding and _constant_ value is explored and explained.\n~~~~\n\n## Type inference\n\nWithout diving too deep into the subject of [type inference][handbook-type-inference], you should be aware that an assigned variable usually as an inferred type, even without a type annotation.\n\n```typescript\nconst MY_FIRST_CONSTANT = 10\n// ^? const MY_FIRST_CONSTANT: number\n```\n\nThis type is then enforced throughout the code.\nThis also means that where the following code is valid JavaScript:\n\n```javascript\nlet myFirstVariable = 1\nmyFirstVariable = 'Some string'\n```\n\nIt complains when using TypeScript:\n\n```typescript\nlet myFirstVariable = 1\nmyFirstVariable = 'Some string'\n// ^? Type 'string' is not assignable to type 'number'.(2322)\n```\n\nThis feature ensures type-safety even when type annotations are not used.\n\n### Constant Assignment\n\nThe `const` keyword is mentioned _both_ for variables and constants.\nAnother concept often mentioned around constants is [(im)-mutability][wiki-mutability].\n\nThe `const` keyword only makes the _binding_ immutable, that is, you can only assign a value to a `const` variable once.\nIn TypeScript, only [primitive][mdn-primitive] values are immutable.\nHowever, [non-primitive][mdn-primitive] values can still be mutated.\n\n```typescript\nconst MY_MUTABLE_VALUE_CONSTANT = { food: 'apple' }\n\n// This is possible\nMY_MUTABLE_VALUE_CONSTANT.food = 'pear'\n\nMY_MUTABLE_VALUE_CONSTANT\n// => { food: \"pear\" }\n```\n\n### Constant Value (Immutability)\n\nAs a rule, on Exercism, and many other organizations and project style guides, don't mutate values that look like `const SCREAMING_SNAKE_CASE`.\nTechnically the values _can_ be changed, but for clarity and expectation management on Exercism this is discouraged.\nWhen this _must_ be enforced, use [`Object.freeze(value)`][mdn-object-freeze].\n\nWhere possible, the TypeScript keyword `readonly`, `as const`, or `Readonly` generic type may be used to enforce immutability statically.\nYou will learn more about this subject later.\n\n```typescript\nconst MY_VALUE_CONSTANT = Object.freeze({ food: 'apple' })\n\nMY_VALUE_CONSTANT.food = 'pear'\n// ^? Cannot assign to 'food' because it is a read-only property.(2540)\n\nMY_VALUE_CONSTANT\n// => { food: \"apple\" }\n```\n\nIn the wild, it's unlikely to see `Object.freeze` all over a code base, but the rule to not mutate a `SCREAMING_SNAKE_CASE` value ever, is a good rule; often enforced using automated analysis such as a linter.\n\n## Function Declarations\n\nIn TypeScript, units of functionality are encapsulated in _functions_, usually grouping functions together in the same file if they belong together.\nThese functions can take parameters (arguments), and can _return_ a value using the `return` keyword.\nFunctions are invoked using `()` syntax.\n\n```typescript\nfunction add(num1: number, num2: number): number {\n return num1 + num2\n}\n\nadd(1, 3)\n// => 4\n```\n\nFunction parameters should usually be annotated with a type using a colon (`:`) followed by the type.\nFunction return values can be annotated after closing the parameter list using a colon (`:`) followed by the type.\n\nIf a function does not have a type annotation for its return value, the type will be inferred.\n\n```typescript\nfunction add(num1: number, num2: number) {\n return num1 + num2\n}\n\nadd(1, 3)\n// ^? function add(num1: number, num2: number): number\n```\n\nHere the return type was inferred because TypeScript knows that the result of `number + number` must always be `number`.\n\n\n~~~~exercism/note\nšŸ’” In TypeScript there are _many_ different ways to declare a function.\nThese other ways look different than using the `function` keyword.\nThe track tries to gradually introduce them, but if you already know about them, feel free to use any of them.\nIn most cases, using one or the other isn't better or worse.\n~~~~\n\n## Type Annotations\n\nAs shown in the function declaration for `add`, the parameters have an explicit type annotation `: number`.\nVariable declarations, class properties, function declarations and more all support type annotations.\n\nBoth explicit type annotation as inferred types are enforced by the type-checker.\n\n```typescript\nadd('foo', 3)\n// ^? Argument of type 'string' is not assignable to parameter of type 'number'.(2345)\n```\n\nIf TypeScript does not find an explicit type annotation and cannot infer the type, it will assign the `any` type, which [you should not use][handbook-dont-use-any].\nLater you will learn about the `unknown` type as a good alternative.\n\n## Export and Import\n\nThe `export` and `import` keywords are powerful tools that turn a regular TypeScript file into a [TypeScript module][mdn-module].\nApart from allowing code to selectively expose components, such as functions, classes, variables and constants, it also enables a whole range of other features, such as:\n\n- [Renaming exports and imports][mdn-renaming-modules], which allows you to avoid naming conflicts,\n- [Dynamic Imports][mdn-dynamic-imports], which loads code on demand,\n- [Tree shaking][blog-tree-shaking], which reduces the size of the final code by eliminating side-effect free modules and even contents of modules _that are not used_,\n- Exporting [_live bindings_][blog-live-bindings], which allows you to export a value that mutates everywhere it's imported if the original value mutates.\n\nA concrete example is how the tests work on Exercism's TypeScript Track.\nEach exercise has at least one implementation file, for example `lasagna.ts`, and each exercise has at least one test file, for example `lasagna.test.ts`.\nThe implementation file uses `export` to expose the public API and the test file uses `import` to access these, which is how it can test the implementation's outcomes.\n\n```typescript\n// file.js\nexport const MY_VALUE = 10\n\nexport function add(num1, num2) {\n return num1 + num2\n}\n\n// file.spec.js\nimport { MY_VALUE, add } from './file.js'\n\nadd(MY_VALUE, 5)\n// => 15\n```\n\n\n~~~~exercism/advanced\nBecause the TypeScript compiler does _not rewrite import paths_, the imports should be written using the `.js` extension (as that's what it will become after transpilation).\nHowever, the option `allowImportingTsExtensions` is on because we have a process that rewrites the paths.\nThis allows importing from `.ts` (as well as `.js`).\n\nIn older code you will find imports _without file extension_.\n~~~~\n\n[blog-live-bindings]: https://2ality.com/2015/07/es6-module-exports.html#es6-modules-export-immutable-bindings\n[blog-tree-shaking]: https://bitsofco.de/what-is-tree-shaking/\n[mdn-const]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/const\n[mdn-dynamic-imports]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#Dynamic_Imports\n[mdn-let]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/let\n[mdn-module]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules\n[mdn-object-freeze]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze\n[mdn-primitive]: https://developer.mozilla.org/en-US/docs/Glossary/Primitive\n[mdn-renaming-modules]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules#Renaming_imports_and_exports\n[mdn-var]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/var\n[handbook-dont-use-any]: https://www.typescriptlang.org/docs/handbook/declaration-files/do-s-and-don-ts.html#any\n[handbook-js-or-ts]: https://www.typescriptlang.org/docs/handbook/typescript-from-scratch.html#learning-javascript-and-typescript\n[handbook-type-inference]: https://www.typescriptlang.org/docs/handbook/type-inference.html\n[wiki-mutability]: https://en.wikipedia.org/wiki/Immutable_object\n[wiki-camel-case]: https://en.wikipedia.org/wiki/Camel_case\n[wiki-snake-case]: https://en.wikipedia.org/wiki/Snake_case\n" }, { "path": "concepts/basics/introduction.md", "content": "# Introduction\n\nTypeScript is JavaScript with syntax for types, making it a a strongly typed programming language, supporting object-oriented, imperative, and declarative (e.g. functional programming) styles, giving you better tooling at any scale.\n\nBecause [you cannot learn TypeScript without learning JavaScript][handbook-js-or-ts], some of the content in this Track is focused on teaching JavaScript concepts and some of the concepts focus on TypeScript specific features only.\n\n## (Re-)Assignment\n\nThere are a few primary ways to assign values to names in TypeScript - using variables or constants.\nOn Exercism, variables are always written in [camelCase][wiki-camel-case]; constants are written in [SCREAMING_SNAKE_CASE][wiki-snake-case].\nThere is no official guide to follow, and various companies and organizations have various style guides.\n_Feel free to write variables any way you like_.\nThe upside from writing them the way the exercises are prepared is that they'll be highlighted differently in the web interface and most IDEs.\n\nVariables in TypeScript can be defined using the [`const`][mdn-const], [`let`][mdn-let] or [`var`][mdn-var] keyword.\n\nA variable can reference different values over its lifetime when using `let` or `var`.\nFor example, `myFirstVariable` can be defined and redefined many times using the assignment operator `=`:\n\n```typescript\nlet myFirstVariable = 1\nmyFirstVariable = 0\nmyFirstVariable = 42\n```\n\nIn contrast to `let` and `var`, variables that are defined with `const` can only be assigned once.\nThis is used to define constants in TypeScript.\n\n```typescript\nconst MY_FIRST_CONSTANT = 10\n\n// Can not be re-assigned.\nMY_FIRST_CONSTANT = 20\n// => TypeError: Assignment to constant variable.\n```\n\nBecause TypeScript can detect this statically, the TypeScript compiler will also yield an error:\n\n```typescript\n// ^? Cannot assign to 'MY_FIRST_CONSTANT' because it is a constant.(2588)\n```\n\nThis means you don't need to run the code to detect the `TypeError`.\n\n\n~~~~exercism/note\nšŸ’” In a later Learning Exercise, the difference between _constant_ assignment / binding and _constant_ value is explored and explained.\n~~~~\n\n## Type inference\n\nWithout diving too deep into the subject of [type inference][handbook-type-inference], you should be aware that an assigned variable usually as an inferred type, even without a type annotation.\n\n```typescript\nconst MY_FIRST_CONSTANT = 10\n// ^? const MY_FIRST_CONSTANT: number\n```\n\nThis type is then enforced throughout the code.\nThis also means that where the following code is valid JavaScript:\n\n```javascript\nlet myFirstVariable = 1\nmyFirstVariable = 'Some string'\n```\n\nIt complains when using TypeScript:\n\n```typescript\nlet myFirstVariable = 1\nmyFirstVariable = 'Some string'\n// ^? Type 'string' is not assignable to type 'number'.(2322)\n```\n\nThis feature ensures type-safety even when type annotations are not used.\n\n## Function Declarations\n\nIn TypeScript, units of functionality are encapsulated in _functions_, usually grouping functions together in the same file if they belong together.\nThese functions can take parameters (arguments), and can _return_ a value using the `return` keyword.\nFunctions are invoked using `()` syntax.\n\n```typescript\nfunction add(num1: number, num2: number): number {\n return num1 + num2\n}\n\nadd(1, 3)\n// => 4\n```\n\nFunction parameters should usually be annotated with a type using a colon (`:`) followed by the type.\nFunction return values can be annotated after closing the parameter list using a colon (`:`) followed by the type.\n\n\n~~~~exercism/note\nšŸ’” In TypeScript there are _many_ different ways to declare a function.\nThese other ways look different than using the `function` keyword.\nThe track tries to gradually introduce them, but if you already know about them, feel free to use any of them.\nIn most cases, using one or the other isn't better or worse.\n~~~~\n\n## Type Annotations\n\nAs shown in the function declaration for `add`, the parameters have an explicit type annotation `: number`.\nVariable declarations, class properties, function declarations and more all support type annotations.\n\nBoth explicit type annotation as inferred types are enforced by the type-checker.\n\n```typescript\nadd('foo', 3)\n// ^? Argument of type 'string' is not assignable to parameter of type 'number'.(2345)\n```\n\n## Exposing to Other Files\n\nTo make a `function`, a constant, or a variable available in _other files_, they need to be [exported][mdn-export] using the `export` keyword.\nAnother file may then [import][mdn-import] these using the `import` keyword.\nThis is also known as the module system.\nA great example is how all the tests work.\nEach exercise has at least one file, for example `lasagna.ts`, which contains the _implementation_.\nAdditionally, there is at least one other file, for example `lasagna.test.ts`, that contains the _tests_.\nThis file _imports_ the public (i.e. exported) entities to test the implementation:\n\n```typescript\n// file.ts\nexport const MY_VALUE = 10\n\nexport function add(num1, num2) {\n return num1 + num2\n}\n\n// file.test.ts\nimport { MY_VALUE, add } from './file.js'\n\nadd(MY_VALUE, 5)\n// => 15\n```\n\n[mdn-const]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/const\n[mdn-export]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/export\n[mdn-import]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import\n[mdn-let]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/let\n[mdn-var]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/var\n[handbook-js-or-ts]: https://www.typescriptlang.org/docs/handbook/typescript-from-scratch.html#learning-javascript-and-typescript\n[handbook-type-inference]: https://www.typescriptlang.org/docs/handbook/type-inference.html\n[wiki-camel-case]: https://en.wikipedia.org/wiki/Camel_case\n[wiki-snake-case]: https://en.wikipedia.org/wiki/Snake_case\n" }, { "path": "concepts/basics/links.json", "content": "[\n {\n \"url\": \"https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes.html\",\n \"description\": \"TypeScript for JavaScript Programmers\"\n },\n {\n \"url\": \"https://www.typescriptlang.org/docs/handbook/2/basic-types.html\",\n \"description\": \"TypeScript Handbook: The Basics\"\n },\n {\n \"url\": \"https://www.typescriptlang.org/docs/handbook/type-inference.html\",\n \"description\": \"TypeScript Handbook: Type Inference\"\n },\n {\n \"url\": \"https://developer.mozilla.org/en-US/docs/Glossary/Primitive\",\n \"description\": \"MDN Glossary: JavaScript Primitive\"\n },\n {\n \"url\": \"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze\",\n \"description\": \"MDN: JavaScript Object freezing\"\n },\n {\n \"url\": \"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules\",\n \"description\": \"MDN: JavaScript Module System\"\n },\n {\n \"url\": \"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules#Renaming_imports_and_exports\",\n \"description\": \"MDN: Renaming modules when importing or exporting\"\n },\n {\n \"url\": \"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import#Dynamic_Imports\",\n \"description\": \"MDN: JavaScript Dynamic imports\"\n },\n {\n \"url\": \"https://en.wikipedia.org/wiki/Immutable_object\",\n \"description\": \"About immutable objects\"\n },\n {\n \"url\": \"https://bitsofco.de/what-is-tree-shaking/\",\n \"description\": \"About tree shaking\"\n },\n {\n \"url\": \"https://2ality.com/2015/07/es6-module-exports.html#es6-modules-export-immutable-bindings\",\n \"description\": \"About live bindings (JavaScript exports)\"\n }\n]\n" }, { "path": "config.json", "content": "{\n \"language\": \"TypeScript\",\n \"slug\": \"typescript\",\n \"active\": true,\n \"status\": {\n \"concept_exercises\": false,\n \"test_runner\": true,\n \"representer\": true,\n \"analyzer\": true\n },\n \"blurb\": \"TypeScript is a language for writing more maintainable JavaScript. TypeScript adds optional types, classes, and modules to JavaScript.\",\n \"version\": 3,\n \"online_editor\": {\n \"indent_style\": \"space\",\n \"indent_size\": 2,\n \"highlightjs_language\": \"typescript\"\n },\n \"test_runner\": {\n \"average_run_time\": 8\n },\n \"files\": {\n \"solution\": [\n \"%{kebab_slug}.ts\"\n ],\n \"test\": [\n \"%{kebab_slug}.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ],\n \"exemplar\": [\n \".meta/exemplar.ts\"\n ]\n },\n \"exercises\": {\n \"concept\": [\n {\n \"slug\": \"lasagna\",\n \"name\": \"lasagna\",\n \"uuid\": \"a0bed44f-b179-4d09-8788-a23d2ace359e\",\n \"concepts\": [\n \"basics\"\n ],\n \"prerequisites\": [],\n \"status\": \"wip\"\n }\n ],\n \"practice\": [\n {\n \"slug\": \"hello-world\",\n \"name\": \"Hello World\",\n \"uuid\": \"755f6f85-9ab3-4af6-9e35-dbb9d64be9c5\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 1,\n \"topics\": [\n \"optional_values\",\n \"strings\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"two-fer\",\n \"name\": \"Two Fer\",\n \"uuid\": \"f66508fe-4ddc-4bbd-b8e6-542d400e57e9\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 1,\n \"topics\": [\n \"optional_values\",\n \"strings\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"resistor-color\",\n \"name\": \"Resistor Color\",\n \"uuid\": \"c6f41fd5-584c-46ca-b3c5-6a0825446bf4\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 1,\n \"topics\": [\n \"arrays\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"resistor-color-duo\",\n \"name\": \"Resistor Color Duo\",\n \"uuid\": \"fd677d24-72eb-46d9-bfa4-8013e96fa71f\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"strings\",\n \"arrays\"\n ]\n },\n {\n \"slug\": \"resistor-color-trio\",\n \"name\": \"Resistor Color Trio\",\n \"uuid\": \"9316fc6a-42d2-4b12-85e1-e8abd9ce3ae2\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"strings\",\n \"arrays\"\n ]\n },\n {\n \"slug\": \"leap\",\n \"name\": \"Leap\",\n \"uuid\": \"fb80f76c-42da-4f62-9f0f-8c85d984908b\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 1,\n \"topics\": [\n \"booleans\",\n \"integers\",\n \"logic\"\n ]\n },\n {\n \"slug\": \"line-up\",\n \"name\": \"Line Up\",\n \"uuid\": \"614dbbe5-56dc-47ea-86e6-ee64497f2cac\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 1,\n \"topics\": [\n \"numbers\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"rna-transcription\",\n \"name\": \"RNA Transcription\",\n \"uuid\": \"b4db381f-1c99-44c6-948c-c8892d77823e\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"strings\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"space-age\",\n \"name\": \"Space Age\",\n \"uuid\": \"8fe1e0ef-068e-4a53-a576-35be59f8152f\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"classes\",\n \"floating_point_numbers\"\n ]\n },\n {\n \"slug\": \"dnd-character\",\n \"name\": \"D&D Character\",\n \"uuid\": \"6f34eb4d-4028-4f89-9965-c9a887f416a0\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"classes\"\n ]\n },\n {\n \"slug\": \"darts\",\n \"name\": \"Darts\",\n \"uuid\": \"5697c090-4ab3-4f76-b9d2-a82330a27a91\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3\n },\n {\n \"slug\": \"pangram\",\n \"name\": \"Pangram\",\n \"uuid\": \"721d9c74-cc16-4b32-8f0b-ffab75027539\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"algorithms\",\n \"conditionals\",\n \"loops\",\n \"lists\",\n \"maps\",\n \"searching\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"bob\",\n \"name\": \"Bob\",\n \"uuid\": \"3977d4e5-82ca-4801-ae20-6682dda23506\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"conditionals\",\n \"pattern_recognition\",\n \"polymorphism\",\n \"regular_expressions\",\n \"strings\",\n \"unicode\"\n ]\n },\n {\n \"slug\": \"matrix\",\n \"name\": \"Matrix\",\n \"uuid\": \"167ec8f2-a206-4a7e-999d-7dbfc136a9fe\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"data_structures\",\n \"matrices\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"robot-name\",\n \"name\": \"Robot Name\",\n \"uuid\": \"b00dd1af-f89c-4382-ab43-514651de6b20\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"conditionals\",\n \"exception_handling\",\n \"randomness\",\n \"regular_expressions\",\n \"sets\"\n ]\n },\n {\n \"slug\": \"grade-school\",\n \"name\": \"Grade School\",\n \"uuid\": \"32e79fd7-f002-4bdc-b6bd-7a91d8c1af61\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"maps\",\n \"sorting\"\n ]\n },\n {\n \"slug\": \"clock\",\n \"name\": \"Clock\",\n \"uuid\": \"c6960d69-7794-4711-8891-9c5a63727112\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"integers\",\n \"logic\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"split-second-stopwatch\",\n \"name\": \"Split-Second Stopwatch\",\n \"uuid\": \"bc1fc50f-36ed-4a16-92bd-3001c8cd53d3\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4\n },\n {\n \"slug\": \"secret-handshake\",\n \"name\": \"Secret Handshake\",\n \"uuid\": \"ac2ec51b-a2cd-4d8c-99e3-5bd6758b4e7b\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"bitwise_operations\",\n \"conditionals\",\n \"loops\",\n \"games\"\n ]\n },\n {\n \"slug\": \"binary-search\",\n \"name\": \"Binary Search\",\n \"uuid\": \"53584e8d-9b8d-4c0e-8ad8-4c228fcf6bcf\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"conditionals\",\n \"loops\"\n ]\n },\n {\n \"slug\": \"linked-list\",\n \"name\": \"Linked List\",\n \"uuid\": \"5b7ab927-6e4d-480f-b005-d23091e579d6\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"data_structures\",\n \"lists\",\n \"optional_values\"\n ]\n },\n {\n \"slug\": \"prism\",\n \"name\": \"Prism\",\n \"uuid\": \"ba7d5b31-50ab-482f-9669-718949ccb753\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5\n },\n {\n \"slug\": \"rational-numbers\",\n \"name\": \"Rational Numbers\",\n \"uuid\": \"4439ab9d-266b-483b-b5ca-3920c478fd62\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"algorithms\",\n \"floating_point_numbers\",\n \"math\"\n ]\n },\n {\n \"slug\": \"atbash-cipher\",\n \"name\": \"Atbash Cipher\",\n \"uuid\": \"04de61fb-9fde-461c-b306-0b4ce52e2169\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 6,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"simple-cipher\",\n \"name\": \"Simple Cipher\",\n \"uuid\": \"3ea9d03e-6d06-48e5-a4d3-6e1bb9367c2f\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 7,\n \"topics\": [\n \"algorithms\",\n \"conditionals\",\n \"loops\",\n \"randomness\",\n \"strings\",\n \"text_formatting\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"wordy\",\n \"name\": \"Wordy\",\n \"uuid\": \"269577e5-e782-4264-9ad9-9ad4b8bc0aab\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 7,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"parsing\",\n \"pattern_recognition\",\n \"regular_expressions\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"list-ops\",\n \"name\": \"List Ops\",\n \"uuid\": \"26787ded-0aa2-46f6-88dd-13a00cce9236\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 8,\n \"topics\": [\n \"data_structures\",\n \"lists\",\n \"recursion\"\n ]\n },\n {\n \"slug\": \"word-count\",\n \"name\": \"Word Count\",\n \"uuid\": \"5e5c48fb-91bb-495a-97f6-ec8642739a0a\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 1,\n \"topics\": [\n \"loops\",\n \"lists\",\n \"regular_expressions\",\n \"strings\",\n \"unicode\"\n ]\n },\n {\n \"slug\": \"difference-of-squares\",\n \"name\": \"Difference of Squares\",\n \"uuid\": \"3f649490-dc7d-4a77-a2a0-2ae71ae834a9\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"algorithms\",\n \"loops\",\n \"integers\",\n \"math\"\n ]\n },\n {\n \"slug\": \"gigasecond\",\n \"name\": \"Gigasecond\",\n \"uuid\": \"9dfabc5c-d2a5-4896-9fc2-2b25b9a5f62f\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"time\"\n ]\n },\n {\n \"slug\": \"square-root\",\n \"name\": \"Square Root\",\n \"uuid\": \"bf4a0802-334b-4ed7-9ade-a3ef5fa6878e\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2\n },\n {\n \"slug\": \"reverse-string\",\n \"name\": \"Reverse String\",\n \"uuid\": \"86d5a60a-fc44-443d-bc00-5c6265e736c4\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"loops\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"triangle\",\n \"name\": \"Triangle\",\n \"uuid\": \"0eb37e93-d191-4451-bd77-cd3681c91d94\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"integers\"\n ]\n },\n {\n \"slug\": \"collatz-conjecture\",\n \"name\": \"Collatz Conjecture\",\n \"uuid\": \"a701b4ca-55ea-4aa9-a607-2fe8a9828d9c\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"conditionals\",\n \"exception_handling\",\n \"integers\",\n \"math\",\n \"recursion\"\n ]\n },\n {\n \"slug\": \"etl\",\n \"name\": \"ETL\",\n \"uuid\": \"ab027a47-d483-4011-aac4-564a6284e5b8\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"loops\",\n \"integers\",\n \"maps\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"protein-translation\",\n \"name\": \"Protein Translation\",\n \"uuid\": \"e18a436f-5d7b-4372-9f74-15e8e9a52d63\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"raindrops\",\n \"name\": \"Raindrops\",\n \"uuid\": \"c8677318-ba6c-4e8c-83ec-513cc6530e7f\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"conditionals\",\n \"integers\",\n \"strings\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"hamming\",\n \"name\": \"Hamming\",\n \"uuid\": \"18204e23-fca8-44dc-8d5c-abe66b87c640\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"equality\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"nucleotide-count\",\n \"name\": \"Nucleotide Count\",\n \"uuid\": \"ef16d487-524e-4c5a-8311-9162babba181\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"strings\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"camicia\",\n \"name\": \"Camicia\",\n \"uuid\": \"5ee5b5e4-bc56-4be5-b384-225b2b339444\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"scrabble-score\",\n \"name\": \"Scrabble Score\",\n \"uuid\": \"7c60f7c5-2922-4ce4-acbe-51c5ab654b4d\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"maps\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"allergies\",\n \"name\": \"Allergies\",\n \"uuid\": \"9389fcb2-841a-42b6-8ece-f5a63f750273\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 6,\n \"topics\": [\n \"arrays\",\n \"bitwise_operations\",\n \"conditionals\",\n \"loops\"\n ]\n },\n {\n \"slug\": \"perfect-numbers\",\n \"name\": \"Perfect Numbers\",\n \"uuid\": \"53cc064f-35d2-4a0e-a915-6a25130252c3\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"integers\",\n \"math\"\n ]\n },\n {\n \"slug\": \"complex-numbers\",\n \"name\": \"Complex Numbers\",\n \"uuid\": \"59d842b4-a804-4cd5-a388-983a22a70c9e\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"math\"\n ]\n },\n {\n \"slug\": \"luhn\",\n \"name\": \"Luhn\",\n \"uuid\": \"249365fb-145c-40e3-90ed-11f3f74a9df1\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"integers\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"grains\",\n \"name\": \"Grains\",\n \"uuid\": \"5a04b3f8-99b6-4aec-8afd-0d54930e4aff\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"integers\"\n ]\n },\n {\n \"slug\": \"pythagorean-triplet\",\n \"name\": \"Pythagorean Triplet\",\n \"uuid\": \"85d74be3-8a54-4355-9ef8-0f13ed2a7683\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"algorithms\",\n \"conditionals\",\n \"loops\",\n \"integers\",\n \"math\"\n ]\n },\n {\n \"slug\": \"relative-distance\",\n \"name\": \"Relative Distance\",\n \"uuid\": \"bbdf7688-65cb-4291-9a4a-0ab89d122a31\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"algorithms\",\n \"data_structures\",\n \"maps\"\n ]\n },\n {\n \"slug\": \"sum-of-multiples\",\n \"name\": \"Sum of Multiples\",\n \"uuid\": \"e431fb10-766a-4542-94ad-9c30224a3885\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"integers\",\n \"lists\",\n \"math\"\n ]\n },\n {\n \"slug\": \"acronym\",\n \"name\": \"Acronym\",\n \"uuid\": \"f6631a0f-2da3-47a4-b46b-7a81fa0d4dfd\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"loops\",\n \"regular_expressions\",\n \"strings\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"anagram\",\n \"name\": \"Anagram\",\n \"uuid\": \"d3c93056-07b9-4d06-a681-1bb25db68c01\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"filtering\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"isogram\",\n \"name\": \"Isogram\",\n \"uuid\": \"505eadfc-40df-476f-82d7-fe3b78b1f713\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"filtering\",\n \"searching\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"roman-numerals\",\n \"name\": \"Roman Numerals\",\n \"uuid\": \"a4ea1a4d-d010-4039-a2b5-e3e748df7f8a\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"pattern_recognition\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"series\",\n \"name\": \"Series\",\n \"uuid\": \"dd332597-4924-48dc-abb3-1d3fde492777\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"loops\",\n \"exception_handling\",\n \"strings\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"state-of-tic-tac-toe\",\n \"name\": \"State of Tic-Tac-Toe\",\n \"uuid\": \"86316f23-cbea-4a4d-b5e0-577d24073f08\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2\n },\n {\n \"slug\": \"phone-number\",\n \"name\": \"Phone Number\",\n \"uuid\": \"bbd4665c-be4b-4d70-bc92-e91ce7a1d55f\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"parsing\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"two-bucket\",\n \"name\": \"Two Bucket\",\n \"uuid\": \"6d187289-27b2-4630-b37b-58553271188a\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 6,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"games\",\n \"parsing\"\n ]\n },\n {\n \"slug\": \"variable-length-quantity\",\n \"name\": \"Variable Length Quantity\",\n \"uuid\": \"50050198-b5a3-4ab1-8b4b-0eadc8007ebb\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 6,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"bitwise_operations\",\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"lists\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"largest-series-product\",\n \"name\": \"Largest Series Product\",\n \"uuid\": \"b646dc26-59c1-436e-883a-20290de7a526\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 7,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"integers\",\n \"math\",\n \"regular_expressions\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"food-chain\",\n \"name\": \"Food Chain\",\n \"uuid\": \"246129c9-83b5-43e0-beb6-8a2cea7e4e17\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"algorithms\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"house\",\n \"name\": \"House\",\n \"uuid\": \"9850a74a-1842-4db0-b3ed-5a53b4f25050\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"recursion\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"isbn-verifier\",\n \"name\": \"ISBN Verifier\",\n \"uuid\": \"50447e18-cfe8-43fb-a791-e8a82483bef6\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"pattern_recognition\",\n \"regular_expressions\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"pig-latin\",\n \"name\": \"Pig Latin\",\n \"uuid\": \"38951bf1-6e7d-4d7d-9b7d-219471f17112\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"games\",\n \"regular_expressions\",\n \"strings\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"proverb\",\n \"name\": \"Proverb\",\n \"uuid\": \"b18876a7-f281-46e5-94b9-f805bb0d1fec\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"optional_values\",\n \"strings\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"twelve-days\",\n \"name\": \"Twelve Days\",\n \"uuid\": \"cb04ab17-9611-44a1-8406-ed385da0044d\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"pattern_recognition\",\n \"polymorphism\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"beer-song\",\n \"name\": \"Beer Song\",\n \"uuid\": \"7a4fefd2-6e71-42d6-82fd-a25d2ef9eae9\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"status\": \"deprecated\",\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"say\",\n \"name\": \"Say\",\n \"uuid\": \"8e7b92f4-a508-4200-bd62-b36281dd9ed9\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 6,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"integers\",\n \"strings\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"rectangles\",\n \"name\": \"Rectangles\",\n \"uuid\": \"6d81d98f-afde-4aea-85ff-c7baef98fb7e\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"matrices\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"saddle-points\",\n \"name\": \"Saddle Points\",\n \"uuid\": \"d35da73a-5124-4911-a2c3-07c68d4b79c2\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"integers\",\n \"lists\",\n \"matrices\",\n \"sets\"\n ]\n },\n {\n \"slug\": \"spiral-matrix\",\n \"name\": \"Spiral Matrix\",\n \"uuid\": \"702b1e87-55db-479f-9ef9-4ccdfe8849b1\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"data_structures\",\n \"matrices\"\n ]\n },\n {\n \"slug\": \"transpose\",\n \"name\": \"Transpose\",\n \"uuid\": \"4e484e0f-0b24-4778-a949-224294735c23\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"lists\",\n \"matrices\",\n \"strings\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"ocr-numbers\",\n \"name\": \"OCR Numbers\",\n \"uuid\": \"61f0964f-0779-446d-bd6b-6bb988414302\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"equality\",\n \"exception_handling\",\n \"integers\",\n \"parsing\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"nth-prime\",\n \"name\": \"Nth Prime\",\n \"uuid\": \"4c1392d7-8779-496f-b0bb-81605e777e3b\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"algorithms\",\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"integers\",\n \"math\"\n ]\n },\n {\n \"slug\": \"alphametics\",\n \"name\": \"Alphametics\",\n \"uuid\": \"7219275b-935b-48ac-8bed-3436221bf3f1\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 7,\n \"topics\": [\n \"algorithms\",\n \"games\"\n ]\n },\n {\n \"slug\": \"connect\",\n \"name\": \"Connect\",\n \"uuid\": \"69cbdc2a-50f4-4e14-b9f4-c1ddee021018\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 7,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"games\",\n \"maps\",\n \"parsing\"\n ]\n },\n {\n \"slug\": \"bowling\",\n \"name\": \"Bowling\",\n \"uuid\": \"18376dda-8e8d-4cf7-a44a-db71da438e87\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 8,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"games\",\n \"parsing\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"prime-factors\",\n \"name\": \"Prime Factors\",\n \"uuid\": \"ef38ee9b-39b7-4bb8-9a34-2e19eba92260\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"algorithms\",\n \"conditionals\",\n \"loops\",\n \"integers\",\n \"math\"\n ]\n },\n {\n \"slug\": \"diamond\",\n \"name\": \"Diamond\",\n \"uuid\": \"df7c1bff-2224-422b-9c34-64b28b09510e\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"games\",\n \"parsing\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"pascals-triangle\",\n \"name\": \"Pascal's Triangle\",\n \"uuid\": \"10edb37d-cf5d-443a-bb4c-8831a3986b61\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"math\"\n ]\n },\n {\n \"slug\": \"binary-search-tree\",\n \"name\": \"Binary Search Tree\",\n \"uuid\": \"b912fe4f-c505-4bac-8029-76412644375b\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 6,\n \"topics\": [\n \"algorithms\",\n \"conditionals\",\n \"loops\",\n \"recursion\"\n ]\n },\n {\n \"slug\": \"sublist\",\n \"name\": \"Sublist\",\n \"uuid\": \"c5ed4703-59cd-4e31-b109-ba5bfc48a578\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"data_structures\",\n \"lists\"\n ]\n },\n {\n \"slug\": \"custom-set\",\n \"name\": \"Custom Set\",\n \"uuid\": \"e2cfc3b4-5c71-4344-a692-5d55609f097b\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 6,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"data_structures\",\n \"equality\",\n \"lists\",\n \"recursion\",\n \"sets\"\n ]\n },\n {\n \"slug\": \"circular-buffer\",\n \"name\": \"Circular Buffer\",\n \"uuid\": \"759aa79d-975a-4b54-b306-618caba8f201\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 8,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"data_structures\",\n \"exception_handling\",\n \"lists\"\n ]\n },\n {\n \"slug\": \"word-search\",\n \"name\": \"Word Search\",\n \"uuid\": \"ab16bfad-960d-405b-aba4-afd142330663\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 8,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"equality\",\n \"optional_values\",\n \"parsing\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"sieve\",\n \"name\": \"Sieve\",\n \"uuid\": \"f3ad1525-c124-4b2f-b09f-4639eb4a6ad9\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"integers\",\n \"math\",\n \"recursion\"\n ]\n },\n {\n \"slug\": \"palindrome-products\",\n \"name\": \"Palindrome Products\",\n \"uuid\": \"ffb0ad36-2cf5-46d4-9a5f-5bbdfb9691a7\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 7,\n \"topics\": [\n \"algorithms\",\n \"conditionals\",\n \"loops\",\n \"integers\",\n \"math\"\n ]\n },\n {\n \"slug\": \"diffie-hellman\",\n \"name\": \"Diffie-Hellman\",\n \"uuid\": \"1d12bce3-bfdc-4785-9dc7-0a496d2e6d38\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"math\"\n ]\n },\n {\n \"slug\": \"robot-simulator\",\n \"name\": \"Robot Simulator\",\n \"uuid\": \"abe907d0-7ca0-4fe5-83fd-72a4d2acab66\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"games\",\n \"parsing\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"armstrong-numbers\",\n \"name\": \"Armstrong Numbers\",\n \"uuid\": \"31e1b8ba-a5dd-4806-9a4c-94f7550e25d5\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"algorithms\",\n \"integers\",\n \"math\"\n ]\n },\n {\n \"slug\": \"run-length-encoding\",\n \"name\": \"Run-Length Encoding\",\n \"uuid\": \"16c5cf98-c381-46bb-a439-78dbc847c0d0\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2,\n \"topics\": [\n \"conditionals\",\n \"exception_handling\",\n \"parsing\",\n \"pattern_recognition\",\n \"regular_expressions\",\n \"strings\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"bank-account\",\n \"name\": \"Bank Account\",\n \"uuid\": \"3247f8b4-8b80-4c0b-bc3b-779f7a3eb291\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"classes\",\n \"conditionals\"\n ]\n },\n {\n \"slug\": \"eliuds-eggs\",\n \"name\": \"Eliud's Eggs\",\n \"uuid\": \"2cdf947c-34ed-4ecf-92dd-4c4e6c21f9f3\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3\n },\n {\n \"slug\": \"bottle-song\",\n \"name\": \"Bottle Song\",\n \"uuid\": \"6bcfe2b6-e555-4c90-8c80-168730dd5ad3\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 3,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"rotational-cipher\",\n \"name\": \"Rotational Cipher\",\n \"uuid\": \"dbe39983-5635-4369-89a3-fd549144259b\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"strings\",\n \"iterators\"\n ]\n },\n {\n \"slug\": \"strain\",\n \"name\": \"Strain\",\n \"uuid\": \"160c31bd-814c-4de7-8af5-7cd223763da8\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"callbacks\",\n \"conditionals\",\n \"loops\",\n \"filtering\",\n \"lists\"\n ]\n },\n {\n \"slug\": \"accumulate\",\n \"name\": \"Accumulate\",\n \"uuid\": \"32953258-d488-4761-9669-895a359a8b9a\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"status\": \"deprecated\",\n \"topics\": [\n \"algorithms\",\n \"callbacks\",\n \"conditionals\",\n \"lists\"\n ]\n },\n {\n \"slug\": \"all-your-base\",\n \"name\": \"All Your Base\",\n \"uuid\": \"0f4f98fe-245a-4842-b3cf-6581b89afd44\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"exception_handling\",\n \"integers\",\n \"math\",\n \"parsing\"\n ]\n },\n {\n \"slug\": \"flatten-array\",\n \"name\": \"Flatten Array\",\n \"uuid\": \"ebe8227e-f445-4387-bf9f-54d4d9730142\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"arrays\",\n \"lists\",\n \"loops\",\n \"recursion\"\n ]\n },\n {\n \"slug\": \"matching-brackets\",\n \"name\": \"Matching Brackets\",\n \"uuid\": \"b455f96b-329d-4dec-ac31-599b02c0b2e5\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 5,\n \"topics\": [\n \"parsing\",\n \"stacks\",\n \"strings\"\n ]\n },\n {\n \"slug\": \"tournament\",\n \"name\": \"Tournament\",\n \"uuid\": \"f4634d37-2357-4b54-8cd8-ad450234537a\",\n \"practices\": [\n \"string-formatting\"\n ],\n \"prerequisites\": [\n \"strings\",\n \"string-formatting\"\n ],\n \"difficulty\": 6\n },\n {\n \"slug\": \"flower-field\",\n \"name\": \"Flower Field\",\n \"uuid\": \"f1c96aaa-0944-4a11-83df-9f3a4f5417f0\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 7,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"games\"\n ]\n },\n {\n \"slug\": \"minesweeper\",\n \"name\": \"Minesweeper\",\n \"uuid\": \"f5b00e76-3015-444d-8012-9862990db08c\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 7,\n \"status\": \"deprecated\",\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"games\"\n ]\n },\n {\n \"slug\": \"kindergarten-garden\",\n \"name\": \"Kindergarten Garden\",\n \"uuid\": \"d70d3579-999c-452c-9243-98908e24b47e\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 7,\n \"topics\": [\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"strings\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"queen-attack\",\n \"name\": \"Queen Attack\",\n \"uuid\": \"837fbe57-a567-4fc7-a7a2-8b63059ac8b7\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 8,\n \"topics\": [\n \"conditionals\",\n \"loops\",\n \"equality\",\n \"exception_handling\",\n \"optional_values\",\n \"parsing\",\n \"text_formatting\"\n ]\n },\n {\n \"slug\": \"react\",\n \"name\": \"React\",\n \"uuid\": \"6ad78102-09cc-4aeb-bfa7-58ba3dba57f3\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 8,\n \"topics\": [\n \"algorithms\",\n \"closures\",\n \"reactive_programming\"\n ]\n },\n {\n \"slug\": \"crypto-square\",\n \"name\": \"Crypto Square\",\n \"uuid\": \"e92b7444-a5c3-4452-82fd-8c70cf14085a\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 9,\n \"topics\": [\n \"algorithms\",\n \"arrays\",\n \"conditionals\",\n \"loops\",\n \"regular_expressions\",\n \"sorting\",\n \"text_formatting\",\n \"transforming\"\n ]\n },\n {\n \"slug\": \"knapsack\",\n \"name\": \"Knapsack\",\n \"uuid\": \"b80ebb8d-9416-4fc8-91ee-3db99411810c\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 9,\n \"topics\": [\n \"algorithms\"\n ]\n },\n {\n \"slug\": \"game-of-life\",\n \"name\": \"Conway's Game of Life\",\n \"uuid\": \"c338cbce-fad4-4de0-bf0d-4a90803a0fe9\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 2\n },\n {\n \"slug\": \"yacht\",\n \"name\": \"Yacht\",\n \"uuid\": \"06ac7eed-1417-4510-b526-eb068af21ad9\",\n \"practices\": [],\n \"prerequisites\": [],\n \"difficulty\": 4,\n \"topics\": [\"arrays\", \"conditionals\", \"filtering\", \"games\"]\n }\n ]\n },\n \"concepts\": [\n {\n \"uuid\": \"6b93ea93-3312-4aee-ad6f-3f8b034e92d9\",\n \"slug\": \"basics\",\n \"name\": \"Basics\"\n }\n ],\n \"key_features\": [\n {\n \"title\": \"Evolving\",\n \"content\": \"Typescript is a modern and constantly evolving open-source language supported by Microsoft.\",\n \"icon\": \"evolving\"\n },\n {\n \"title\": \"Widely used\",\n \"content\": \"TypeScript is used by many libraries and frameworks, and integrates with JavaScript code as well.\",\n \"icon\": \"widely-used\"\n },\n {\n \"title\": \"Typed JavaScript\",\n \"content\": \"Typescript flexible typing system lets you describe what to expect, supporting gradual adoption.\",\n \"icon\": \"dynamically-typed\"\n },\n {\n \"title\": \"Use any programming style\",\n \"content\": \"Use prototype-based, object-oriented, functional, or declarative programming styles, and more.\",\n \"icon\": \"multi-paradigm\"\n },\n {\n \"title\": \"Consistently Good Tooling\",\n \"content\": \"TS's JavaScript integration is handled by the language itself, enabling its tools and features.\",\n \"icon\": \"tooling\"\n },\n {\n \"title\": \"Large Community\",\n \"content\": \"The large number of users makes it easy to find answers, documentation, and libraries.\",\n \"icon\": \"community\"\n }\n ],\n \"tags\": [\n \"execution_mode/compiled\",\n \"paradigm/declarative\",\n \"paradigm/functional\",\n \"paradigm/imperative\",\n \"paradigm/object_oriented\",\n \"platform/android\",\n \"platform/ios\",\n \"platform/linux\",\n \"platform/mac\",\n \"platform/web\",\n \"platform/windows\",\n \"runtime/language_specific\",\n \"runtime/wasmtime\",\n \"typing/dynamic\",\n \"typing/static\",\n \"typing/strong\",\n \"typing/weak\",\n \"used_for/artificial_intelligence\",\n \"used_for/backends\",\n \"used_for/cross_platform_development\",\n \"used_for/frontends\",\n \"used_for/games\",\n \"used_for/guis\",\n \"used_for/mobile\",\n \"used_for/web_development\"\n ]\n}\n" }, { "path": "docs/ABOUT.md", "content": "# About\n\n[TypeScript](https://www.typescriptlang.org/) (TS) is a superset of JavaScript (JS), created at Microsoft\nin response to frustration developing large-scale applications in JS. In a large JS project, knowing\nwhat properties your own objects have, what arguments your functions take (and what type they need to be)\ncan become difficult. Similarly, since there is no ability to intelligently inspect JS code, when you include\na package (like from `npm`), you have to keep the documentation up so you know what methods are available and\nwhat arguments they take. TS solves these issues. It is currently an open-source project hosted on Github.\nIt supports tools for any browser as well as Node, for any host, on any OS. TS compiles to readable,\nstandards-based JavaScript.\n\nTS adds a flexible type system to JS, in addition to interfaces (custom types) and modifying the syntax of\nsome ECMAScript features such as classes. Types are optional and flexible (for example, you can specify an\nargument is a string OR a number). Types allow tooling available in most code editors that improve the\ndevelopment experience such as code completion and method detection, both in your own code and in packages\nyou use. It supports many upcoming ECMAScript features (such as async/await). TS can be written in Object Oriented or Functional\nstyles. It is compatible with all existing JS packages. TS transpiles to clean, readable JS.\n\nTry it out at the [playground](https://www.typescriptlang.org/play), and stay up to date via [the Typescript blog](https://devblogs.microsoft.com/typescript/) and [Twitter account](https://twitter.com/typescript).\n" }, { "path": "docs/INSTALLATION.md", "content": "# Installation\n\nYou need [NodeJS LTS](https://nodejs.org/en).\n\n> šŸ’” This track likely works with older stable versions, as well as the \"current\" version.\n> However, [by design](https://github.com/nodejs/release#release-schedule), odd versions are never stable.\n> Always make sure you install an even version of NodeJS.\n\nInstall [Yarn 4+](https://yarnpkg.com/getting-started/install) using Node.JS `corepack`:\n\n```shell\ncorepack enable yarn\n```\n\n## Checking your installation\n\nYou generally need to open a new terminal in order to use binaries you've just installed.\n\n```shell\n$ node -v\nv20.15.0\n\n$ corepack -v\n0.28.1\n\n$ corepack yarn -v\nv4.3.1\n```\n\n_Note: your versions will likely differ from this._\n\n## Assignment installation\n\n**Each assignment** needs some tools to run the tests:\n\nThey can be installed running this command within each assignment directory:\n\n```bash\n$ corepack yarn install\n```\n\nDepending on your editor, the [Editor SDK](https://yarnpkg.com/getting-started/editor-sdks) needs to be installed in each assignment, in order to work with Plug'n'Play installs.\nAt moment of writing the following are supported:\n\n- [CoC nvim](https://yarnpkg.com/getting-started/editor-sdks#coc-nvim)\n- [Emacs](https://yarnpkg.com/getting-started/editor-sdks#emacs)\n- [Neovim Native LSP](https://yarnpkg.com/getting-started/editor-sdks#neovim-native-lsp)\n- [VSCode](https://yarnpkg.com/getting-started/editor-sdks#vscode)\n\nFor example, if using VSCode, the commands you run are:\n\n```shell\n$ corepack yarn install\n\nāž¤ YN0000: Ā· Yarn 4.3.1\nāž¤ YN0000: ā”Œ Resolution step\nāž¤ YN0000: ā”” Completed\nāž¤ YN0000: ā”Œ Post-resolution validation\nāž¤ YN0060: ā”‚ # [...]\nāž¤ YN0000: ā”” Completed\nāž¤ YN0000: ā”Œ Fetch step\nāž¤ YN0000: ā”” Completed in 0s 566ms\nāž¤ YN0000: ā”Œ Link step\nāž¤ YN0000: ā”‚ ESM support for PnP uses the experimental loader API and is therefore experimental\nāž¤ YN0000: ā”” Completed\nāž¤ YN0000: Ā· Done with warnings in 0s 768ms\n\n$ corepack yarn dlx @yarnpkg/sdks vscode\n\nāž¤ YN0000: Ā· Yarn 4.3.1\nāž¤ YN0000: ā”Œ Resolution step\nāž¤ YN0085: ā”‚ + @yarnpkg/sdks@npm:3.1.3, and 103 more.\nāž¤ YN0000: ā”” Completed in 0s 509ms\nāž¤ YN0000: ā”Œ Fetch step\nāž¤ YN0013: ā”‚ 104 packages were added to the project (+ 2.87 MiB).\nāž¤ YN0000: ā”” Completed\nāž¤ YN0000: ā”Œ Link step\nāž¤ YN0000: ā”” Completed in 0s 270ms\nāž¤ YN0000: Ā· Done in 0s 881ms\n\nāž¤ YN0000: Cleaning up the existing SDK files...\nāž¤ YN0000: ā”Œ Generating SDKs inside .yarn/sdks\nāž¤ YN0000: ā”‚ āœ“ Eslint\nāž¤ YN0000: ā”‚ āœ“ Prettier\nāž¤ YN0000: ā”‚ āœ“ Typescript\nāž¤ YN0000: ā”‚ ā€¢ 5 SDKs were skipped based on your root dependencies\nāž¤ YN0000: ā”” Completed\nāž¤ YN0000: ā”Œ Generating settings\nāž¤ YN0000: ā”‚ āœ“ Vscode (updated šŸ”¼)\nāž¤ YN0000: ā”” Completed\n```\n\nYou must run install _inside the exercise directory_ before you are able to run the tests.\n[Yarn 4 PnP](https://yarnpkg.com/features/pnp/) is enabled, installing the dependencies in each exercise directory does NOT install a complete copy of all the dependencies.\n\nIf your editor is showing errors for `eslint`, `prettier`, or `typescript` afterwards, reload the window or reopen the editor.\n" }, { "path": "docs/LEARNING.md", "content": "# Learning\n\nIf you want to learn Typescript, check out the following resources.\n\n- [TS Tutorial](https://www.typescriptlang.org/docs/handbook/release-notes/overview.html)\n- [TS Playground](https://www.typescriptlang.org/play)\n\nTypeScript is a superset of JS.\nTypeScript offers all of JavaScriptā€™s features, and an additional layer on top of these: TypeScriptā€™s type system.\n\n- [Exploring ES6](https://leanpub.com/exploring-es6) book, by Axel Rauschmayer\n- [ES6 Katas](https://jskatas.org/#bundle-es6-katas) website\n- [Babel compiler](https://github.com/babel/babel)\n" }, { "path": "docs/RESOURCES.md", "content": "# Resources\n\n## Recommended References\n\n- [TypeScript QuickStart](https://www.typescriptlang.org/docs/handbook/release-notes/overview.html)\n- [TypeScript Playground](https://www.typescriptlang.org/play)\n\n- [ECMAScript 2015 Language Specification](https://www.ecma-international.org/wp-content/uploads/ECMA-262_6th_edition_june_2015.pdf) (pdf)\n- [Mozilla JavaScript Reference](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference)\n\n## Editors\n\n### Free/Open-Source\n\n- [VS Code](https://code.visualstudio.com)\n\n VS Code is an open-source code editor. You can find information on how to set up TypeScript [here](https://code.visualstudio.com/docs/languages/typescript). VS Code is a popular editor for TypeScript because Microsoft maintains both VS Code and TypeScript, so it works well with the language; VS Code supports TS without any extra configuration. In fact, VS Code was written using TypeScript!\n\n A common issue with VS Code and TS is when your editor and project versions are different, which can cause VS Code to display a possibly confusing error message. Instructions on how to handle this error are [here](https://code.visualstudio.com/docs/typescript/typescript-compiling#_using-newer-typescript-versions)\n\n### Licensed\n\n- [Sublime Text](https://www.sublimetext.com)\n\n Sublime Text is a popular code editor with support for most languages through installable plugins. It is free to try, but you will be regularly prompted to buy a license, which currently costs \\$70 USD.\n\n- [WebStorm](https://www.jetbrains.com/webstorm/)\n\n WebStorm is a fully-featured JavaScript/TypeScript IDE (Integrated Development Environment). It supports TypeScript with no extra configuration and has integrated testing, debugging and code analysis. It is free to try for 30 days, then an annual license costs \\$129 USD for the first year.\n" }, { "path": "docs/SNIPPET.txt", "content": "\nexport class HelloWorld {\n static hello(name = 'World'): string {\n return `Hello, ${name}!`\n }\n}\n" }, { "path": "docs/TESTS.md", "content": "# Tests\n\nBefore trying to execute the tests, ensure the assignment folder is set-up correctly by following the installation steps, namely `corepack yarn install` and the Editor SDK setup.\n\nExecute the tests with:\n\n```bash\n$ corepack yarn test\n```\n\nBe sure your code follows best practices, as other users do, with eslint, a tool to perform static analysis to your code.\nTools like this save you some time detecting typos or silly mistakes in your code:\n\n```bash\n$ corepack yarn lint\n```\n\nOr do both at the same time:\n\n```bash\n$ corepack yarn test && corepack yarn lint\n```\n\nThe TypeScript track on Exercism does not enforce code _style_, so you're free to choose between semicolons, tabs vs spaces, and everything in-between.\n\n## Making Your First Module\n\nUsually, tests on this track will load your implementation importing it as a module: `import Bob from './bob';`.\nTo make it work, you need to export your implementation from the file the tests are looking for your module, `bob.ts`:\n\n```typescript\nexport class Bob {\n public hey(message: string) {\n // Your solution here\n }\n}\n```\n\nWe've provided stubs in each exercise and placed this `export` in there for you.\n" }, { "path": "docs/config.json", "content": "{\n \"docs\": [\n {\n \"uuid\": \"c79ecacf-6b92-4033-9f25-1f86e7299760\",\n \"slug\": \"installation\",\n \"path\": \"docs/INSTALLATION.md\",\n \"title\": \"Installing TypeScript locally\",\n \"blurb\": \"Learn how to install TypeScript locally to solve Exercism's exercises on your own machine\"\n },\n {\n \"uuid\": \"d5553e1b-8432-4b27-a855-d060e830636d\",\n \"slug\": \"learning\",\n \"path\": \"docs/LEARNING.md\",\n \"title\": \"How to learn TypeScript\",\n \"blurb\": \"An overview of how to get started from scratch with TypeScript\"\n },\n {\n \"uuid\": \"bef8b724-0569-4ad9-8e00-5daff3c17057\",\n \"slug\": \"tests\",\n \"path\": \"docs/TESTS.md\",\n \"title\": \"Testing on the TypeScript track\",\n \"blurb\": \"Learn how to test your TypeScript exercises on Exercism\"\n },\n {\n \"uuid\": \"4d00c4da-0f99-4d0c-9a43-aca47128e4fb\",\n \"slug\": \"resources\",\n \"path\": \"docs/RESOURCES.md\",\n \"title\": \"Useful TypeScript resources\",\n \"blurb\": \"A collection of useful resources to help you master TypeScript\"\n }\n ]\n}\n" }, { "path": "eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nimport globals from 'globals'\n\nexport default [\n ...tsEslint.config(\n ...config,\n {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n },\n {\n files: ['scripts/**/*.mjs'],\n languageOptions: {\n globals: {\n ...globals.node,\n },\n },\n }\n ),\n {\n ignores: [\n // # Protected or generated\n '/.appends/**/*',\n '/.github/**/*',\n '/.vscode/**/*',\n '/.yarn/**/*',\n '/common/.vscode/**/*',\n '/common/.yarn/**/*',\n\n // # Binaries\n '/bin/*',\n\n // # Configuration\n '/config',\n '/babel.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/concept/.keep", "content": "" }, { "path": "exercises/concept/lasagna/.docs/hints.md", "content": "# Hints\n\n## 1. Define the expected oven time in minutes\n\n- Define a [constant][constants] which should contain the [`number`][numbers] value specified in the recipe.\n- [`export`][export] the constant.\n\n## 2. Calculate the remaining oven time in minutes\n\n- [Explicitly return a number][return] from the function.\n- Use the [mathematical operator for subtraction][operators] to subtract values.\n\n## 3. Calculate the preparation time in minutes\n\n- [Explicitly return a number][return] from the function.\n- Use the [mathematical operator for multiplication][operators] to multiply values.\n- Use the extra constant for the time in minutes per layer.\n\n## 4. Calculate the total working time in minutes\n\n- [Explicitly return a number][return] from the function.\n- [Invoke][invocation] one of the other methods implemented previously.\n- Use the [mathematical operator for addition][operators] to add values.\n\n[return]: https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Building_blocks/Return_values\n[export]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/export\n[operators]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators\n[constants]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/const\n[invocation]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Functions#Calling_functions\n[numbers]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type\n" }, { "path": "exercises/concept/lasagna/.docs/instructions.md", "content": "# Instructions\n\nLucian's girlfriend is on her way home, and he hasn't cooked their anniversary dinner!\n\nIn this exercise, you're going to write some code to help Lucian cook an exquisite lasagna from his favorite cookbook.\n\nYou have four tasks related to the time spent cooking the lasagna.\n\n## 1. Define the expected oven time in minutes\n\nDefine the `EXPECTED_MINUTES_IN_OVEN` constant that represents how many minutes the lasagna should be in the oven. It must be exported. According to the cooking book, the expected oven time in minutes is `40`.\n\n## 2. Calculate the remaining oven time in minutes\n\nImplement the `remainingMinutesInOven` function that takes the actual minutes the lasagna has been in the oven as a _parameter_ and _returns_ how many minutes the lasagna still has to remain in the oven, based on the **expected oven time in minutes** from the previous task.\n\n```javascript\nremainingMinutesInOven(30)\n// => 10\n```\n\n## 3. Calculate the preparation time in minutes\n\nImplement the `preparationTimeInMinutes` function that takes the number of layers you added to the lasagna as a _parameter_ and _returns_ how many minutes you spent preparing the lasagna, assuming each layer takes you 2 minutes to prepare.\n\n```javascript\npreparationTimeInMinutes(2)\n// => 4\n```\n\n## 4. Calculate the total working time in minutes\n\nImplement the `totalTimeInMinutes` function that takes _two parameters_: the `numberOfLayers` parameter is the number of layers you added to the lasagna, and the `actualMinutesInOven` parameter is the number of minutes the lasagna has been in the oven. The function should _return_ how many minutes in total you've worked on cooking the lasagna, which is the sum of the preparation time in minutes, and the time in minutes the lasagna has spent in the oven at the moment.\n\n```javascript\ntotalTimeInMinutes(3, 20)\n// => 26\n```\n" }, { "path": "exercises/concept/lasagna/.docs/introduction.md", "content": "# Introduction\n\nJavaScript is a dynamic language, supporting object-oriented, imperative, and declarative (e.g. functional programming) styles.\n\n## (Re-)Assignment\n\nThere are a few primary ways to assign values to names in JavaScript - using variables or constants. On Exercism, variables are always written in [camelCase][wiki-camel-case]; constants are written in [SCREAMING_SNAKE_CASE][wiki-snake-case]. There is no official guide to follow, and various companies and organizations have various style guides. _Feel free to write variables any way you like_. The upside from writing them the way the exercises are prepared is that they'll be highlighted differently in the web interface and most IDEs.\n\nVariables in JavaScript can be defined using the [`const`][mdn-const], [`let`][mdn-let] or [`var`][mdn-var] keyword.\n\nA variable can reference different values over its lifetime when using `let` or `var`. For example, `myFirstVariable` can be defined and redefined many times using the assignment operator `=`:\n\n```javascript\nlet myFirstVariable = 1\nmyFirstVariable = 'Some string'\nmyFirstVariable = new SomeComplexClass()\n```\n\nIn contrast to `let` and `var`, variables that are defined with `const` can only be assigned once. This is used to define constants in JavaScript.\n\n```javascript\nconst MY_FIRST_CONSTANT = 10\n\n// Can not be re-assigned.\nMY_FIRST_CONSTANT = 20\n// => TypeError: Assignment to constant variable.\n```\n\n> šŸ’” In a later Concept Exercise the difference between _constant_ assignment / binding and _constant_ value is explored and explained.\n\n## Function Declarations\n\nIn JavaScript, units of functionality are encapsulated in _functions_, usually grouping functions together in the same file if they belong together. These functions can take parameters (arguments), and can _return_ a value using the `return` keyword. Functions are invoked using `()` syntax.\n\n```javascript\nfunction add(num1, num2) {\n return num1 + num2\n}\n\nadd(1, 3)\n// => 4\n```\n\n> šŸ’” In JavaScript there are _many_ different ways to declare a function. These other ways look different than using the `function` keyword. The track tries to gradually introduce them, but if you already know about them, feel free to use any of them. In most cases, using one or the other isn't better or worse.\n\n## Exposing to Other Files\n\nTo make a `function`, a constant, or a variable available in _other files_, they need to be [exported][mdn-export] using the `export` keyword. Another file may then [import][mdn-import] these using the `import` keyword. This is also known as the module system. A great example is how all the tests work. Each exercise has at least one file, for example `lasagna.js`, which contains the _implementation_. Additionally there is at least one other file, for example `lasagna.spec.js`, that contains the _tests_. This file _imports_ the public (i.e. exported) entities in order to test the implementation:\n\n```javascript\n// file.js\nexport const MY_VALUE = 10\n\nexport function add(num1, num2) {\n return num1 + num2\n}\n\n// file.spec.js\nimport { MY_VALUE, add } from './file'\n\nadd(MY_VALUE, 5)\n// => 15\n```\n\n[mdn-const]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/const\n[mdn-export]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/export\n[mdn-import]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import\n[mdn-let]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/let\n[mdn-var]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/var\n[wiki-camel-case]: https://en.wikipedia.org/wiki/Camel_case\n[wiki-snake-case]: https://en.wikipedia.org/wiki/Snake_case\n" }, { "path": "exercises/concept/lasagna/.meta/config.json", "content": "{\n \"authors\": [\"SleeplessByte\"],\n \"files\": {\n \"solution\": [\n \"lasagna.ts\"\n ],\n \"test\": [\n \"__typetests__/lasagna.tst.ts\",\n \"lasagna.test.ts\"\n ],\n \"exemplar\": [\n \".meta/exemplar.ts\"\n ]\n },\n \"forked_from\": [\n \"javascript/lasagna\"\n ],\n \"blurb\": \"Learn the basics of TypeScript cooking a brilliant lasagna from your favorite cooking book.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": true,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": true\n }\n}\n" }, { "path": "exercises/concept/lasagna/.meta/design.md", "content": "# Design\n\n## Learning objectives\n\n- Know what a variable is.\n- Know what a constant variable is.\n- Know how to define a variable.\n- Know how to export a variable\n- Know how to return a value from a function (explicit return).\n- Know how to annotate a function parameter\n- Know how to annotate a function return type\n\n## Out of scope\n\nThis exercise is really just to introduce the bare minimum a student needs to know to solve a very basic exercise on Exercism.\nDetails about the primitive data types, different ways to define functions etc. will all be properly introduced in the later concept exercises.\n\nWe don't even explicitly teach the basics of numbers and arithmetic operators in the introduction.\nGiven the general code examples that are provided and some \"I will just try that\", the student should be fine solving the exercise nevertheless.\n\n## Concepts\n\n- `basics`\n\n## Prerequisites\n\nThere are no prerequisites.\n\n## Analyzer\n\nThis exercise could benefit from the following rules added to the the [analyzer][analyzer]:\n\n- Verify that the `remainingMinutesInOven` function uses the `EXPECTED_MINUTES_IN_OVEN` constant.\n- Verify that the `preparationTimeInMinutes` function uses the `PREPARATION_MINUTES_PER_LAYER` constant.\n- Verify that the `totalTimeInMinutes` function calls the `preparationTimeInMinutes` function.\n- Verify that no extra _bookkeeping_ or _intermediate_ variables are declared\n\n[analyzer]: https://github.com/exercism/typescript-analyzer\n" }, { "path": "exercises/concept/lasagna/.meta/exemplar.ts", "content": "/**\n * The amount of minutes the lasagna should be in the oven.\n */\nexport const EXPECTED_MINUTES_IN_OVEN = 40\n\n/**\n * The amount of minutes it takes to prepare a single layer.\n */\nconst PREPARATION_MINUTES_PER_LAYER = 2\n\n/**\n * Determines the amount of minutes the lasagna still needs to remain in the\n * oven to be properly prepared.\n *\n * @param actualMinutesInOven\n * @returns the number of minutes remaining\n */\nexport function remainingMinutesInOven(actualMinutesInOven: number): number {\n return EXPECTED_MINUTES_IN_OVEN - actualMinutesInOven\n}\n\n/**\n * Given a number of layers, determines the total preparation time.\n *\n * @param numberOfLayers\n * @returns the total preparation time\n */\nexport function preparationTimeInMinutes(numberOfLayers: number): number {\n return numberOfLayers * PREPARATION_MINUTES_PER_LAYER\n}\n\n/**\n * Calculates the total working time. That is, the time to prepare all the layers\n * of lasagna, and the time already spent in the oven.\n *\n * @param numberOfLayers\n * @param actualMinutesInOven\n * @returns the total working time\n */\nexport function totalTimeInMinutes(\n numberOfLayers: number,\n actualMinutesInOven: number\n): number {\n return preparationTimeInMinutes(numberOfLayers) + actualMinutesInOven\n}\n" }, { "path": "exercises/concept/lasagna/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/concept/lasagna/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/concept/lasagna/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/concept/lasagna/__typetests__/lasagna.tst.ts", "content": "import { describe, expect, test } from 'tstyche'\nimport {\n EXPECTED_MINUTES_IN_OVEN,\n remainingMinutesInOven,\n preparationTimeInMinutes,\n totalTimeInMinutes,\n} from '../lasagna.ts'\n\ndescribe('EXPECTED_MINUTES_IN_OVEN', () => {\n test('constant is defined as a number or a constant number', () => {\n expect(EXPECTED_MINUTES_IN_OVEN).type.toBeAssignableTo()\n })\n})\n\ndescribe('remainingMinutesInOven', () => {\n test('takes one number parameter', () => {\n expect>().type.toBe<[number]>()\n })\n\n test('returns a number', () => {\n expect>().type.toBe()\n })\n})\n\ndescribe('preparationTimeInMinutes', () => {\n test('takes one number parameter', () => {\n expect>().type.toBe<[number]>()\n })\n\n test('returns a number', () => {\n expect>().type.toBe()\n })\n})\n\ndescribe('totalTimeInMinutes', () => {\n test('takes two number parameters', () => {\n expect>().type.toBe<\n [number, number]\n >()\n })\n\n test('returns a number', () => {\n expect>().type.toBe()\n })\n})\n" }, { "path": "exercises/concept/lasagna/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/concept/lasagna/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/concept/lasagna/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/concept/lasagna/lasagna.test.ts", "content": "import { describe, test, expect } from '@jest/globals'\n\nimport {\n EXPECTED_MINUTES_IN_OVEN,\n remainingMinutesInOven,\n preparationTimeInMinutes,\n totalTimeInMinutes,\n} from './lasagna.ts'\n\ndescribe('EXPECTED_MINUTES_IN_OVEN', () => {\n test('constant is defined correctly', () => {\n expect(EXPECTED_MINUTES_IN_OVEN).toBe(40)\n })\n})\n\ndescribe('remainingMinutesInOven', () => {\n test('calculates the remaining time', () => {\n expect(remainingMinutesInOven(25)).toBe(15)\n expect(remainingMinutesInOven(5)).toBe(35)\n expect(remainingMinutesInOven(39)).toBe(1)\n })\n\n test('works correctly for the edge cases', () => {\n expect(remainingMinutesInOven(40)).toBe(0)\n expect(remainingMinutesInOven(0)).toBe(40)\n })\n})\n\ndescribe('preparationTimeInMinutes', () => {\n test('calculates the preparation time', () => {\n expect(preparationTimeInMinutes(1)).toBe(2)\n expect(preparationTimeInMinutes(2)).toBe(4)\n expect(preparationTimeInMinutes(8)).toBe(16)\n })\n})\n\ndescribe('totalTimeInMinutes', () => {\n test('calculates the total cooking time', () => {\n expect(totalTimeInMinutes(1, 5)).toBe(7)\n expect(totalTimeInMinutes(4, 15)).toBe(23)\n expect(totalTimeInMinutes(1, 30)).toBe(32)\n })\n})\n" }, { "path": "exercises/concept/lasagna/lasagna.ts", "content": "// šŸ‘‹šŸ½ Hi there!\n//\n// On the TypeScript track we provide you with stubs. These stubs provide a\n// starting point to solving the exercise.\n//\n// In general, each variable/constant and each declared function will have a\n// JSDoc comment block above it, explaining what the variable/constant holds or\n// the function is supposed to accomplish.\n//\n// šŸ’” Often, the JSDoc comment blocks have annotations, such as @param and\n// @returns which are usually highlighted with a different color if the IDE\n// you're in recognizes them. It's these annotations that are used when\n// referring to the constant, variable, or function from somewhere else that\n// IDEs display.\n//\n// You don't need to write these yourself; it is not expected in idiomatic\n// TypeScript, but some companies and style-guides do enforce them.\n//\n// šŸ’” You're allowed to completely clear a stub before you get started. Often\n// we recommend using the stub, because they are already set-up correctly to\n// work with the tests, which you can find in ./lasagna.spec.js\n//\n// Good luck preparing some lasagna!\n\n/**\n * The number of minutes it takes to prepare a single layer.\n */\nconst PREPARATION_MINUTES_PER_LAYER = 2\n\n/**\n * Determines the number of minutes the lasagna still needs to remain in the\n * oven to be properly prepared.\n *\n * @param actualMinutesInOven\n * @returns the number of minutes remaining\n */\nexport function remainingMinutesInOven(actualMinutesInOven: number): number {\n throw new Error('Remove this line and implement the function')\n}\n\n/**\n * Given a number of layers, determines the total preparation time.\n *\n * @param numberOfLayers\n * @returns the total preparation time\n */\nexport function preparationTimeInMinutes(numberOfLayers: number): number {\n throw new Error('Remove this line and implement the function')\n}\n\n/**\n * Calculates the total working time. That is, the time to prepare all the\n * layers of lasagna, and the time already spent in the oven.\n *\n * @param numberOfLayers\n * @param actualMinutesInOven\n * @returns the total working time\n */\nexport function totalTimeInMinutes(\n numberOfLayers: number,\n actualMinutesInOven: number\n): number {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/concept/lasagna/package.json", "content": "{\n \"name\": \"@exercism/typescript-lasagna\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism concept exercise on lasagna\",\n \"author\": \"Derk-Jan Karrenbeld (https://derk-jan.com)\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/concept/lasagna/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/concept/lasagna/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/accumulate/.docs/instructions.md", "content": "# Instructions\n\nImplement the `accumulate` operation, which, given a collection and an\noperation to perform on each element of the collection, returns a new\ncollection containing the result of applying that operation to each element of\nthe input collection.\n\nGiven the collection of numbers:\n\n- 1, 2, 3, 4, 5\n\nAnd the operation:\n\n- square a number (`x => x * x`)\n\nYour code should be able to produce the collection of squares:\n\n- 1, 4, 9, 16, 25\n\nCheck out the test suite to see the expected function signature.\n\n## Restrictions\n\nKeep your hands off that collect/map/fmap/whatchamacallit functionality\nprovided by your standard library!\nSolve this one yourself using other basic tools instead.\n" }, { "path": "exercises/practice/accumulate/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"emiller42\",\n \"lumosmind\",\n \"masters3d\",\n \"pkchv\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"accumulate.ts\"\n ],\n \"test\": [\n \"accumulate.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement the `accumulate` operation, which, given a collection and an operation to perform on each element of the collection, returns a new collection containing the result of applying that operation to each element of the input collection.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Conversation with James Edward Gray II\",\n \"source_url\": \"https://twitter.com/jeg2\"\n}\n" }, { "path": "exercises/practice/accumulate/.meta/proof.ci.ts", "content": "export function accumulate(list: T[], accumulator: (arg: T) => O): O[] {\n const out = []\n let idx = -1\n const end = list.length\n\n while (++idx < end) {\n out.push(accumulator(list[idx]))\n }\n\n return out\n}\n" }, { "path": "exercises/practice/accumulate/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/accumulate/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/accumulate/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/accumulate/accumulate.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { accumulate } from './accumulate.ts'\n\ndescribe('accumulate()', () => {\n it('accumulation empty', () => {\n const accumulator = (e: number): number => e * e\n expect(accumulate([], accumulator)).toEqual([])\n })\n\n xit('accumulate squares', () => {\n const accumulator = (n: number): number => n * n\n const result = accumulate([1, 2, 3], accumulator)\n expect(result).toEqual([1, 4, 9])\n })\n\n xit('accumulate upcases', () => {\n const accumulator = (word: string): string => word.toUpperCase()\n const result = accumulate('hello world'.split(/\\s/), accumulator)\n expect(result).toEqual(['HELLO', 'WORLD'])\n })\n\n xit('accumulate reversed strings', () => {\n const accumulator = (word: string): string =>\n word.split('').reverse().join('')\n const result = accumulate(\n 'the quick brown fox etc'.split(/\\s/),\n accumulator\n )\n expect(result).toEqual(['eht', 'kciuq', 'nworb', 'xof', 'cte'])\n })\n\n xit('accumulate recursively', () => {\n const result = accumulate('a b c'.split(/\\s/), (char: string) =>\n accumulate('1 2 3'.split(/\\s/), (digit: string) => char + digit)\n )\n\n expect(result).toEqual([\n ['a1', 'a2', 'a3'],\n ['b1', 'b2', 'b3'],\n ['c1', 'c2', 'c3'],\n ])\n })\n})\n" }, { "path": "exercises/practice/accumulate/accumulate.ts", "content": "export function accumulate(list: unknown, accumulator: unknown): never {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/accumulate/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/accumulate/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/accumulate/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/accumulate/package.json", "content": "{\n \"name\": \"@exercism/typescript-accumulate\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/accumulate/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/accumulate/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/acronym/.docs/instructions.md", "content": "# Instructions\n\nConvert a phrase to its acronym.\n\nTechies love their TLA (Three Letter Acronyms)!\n\nHelp generate some jargon by writing a program that converts a long name like Portable Network Graphics to its acronym (PNG).\n\nPunctuation is handled as follows: hyphens are word separators (like whitespace); all other punctuation can be removed from the input.\n\nFor example:\n\n| Input | Output |\n| ------------------------- | ------ |\n| As Soon As Possible | ASAP |\n| Liquid-crystal display | LCD |\n| Thank George It's Friday! | TGIF |\n" }, { "path": "exercises/practice/acronym/.meta/config.json", "content": "{\n \"authors\": [],\n \"contributors\": [\n \"lilislilit\",\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"acronym.ts\"\n ],\n \"test\": [\n \"acronym.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Convert a long phrase to its acronym.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Julien Vanier\",\n \"source_url\": \"https://github.com/monkbroc\"\n}\n" }, { "path": "exercises/practice/acronym/.meta/proof.ci.ts", "content": "export function parse(phrase: string): string {\n if (typeof phrase !== 'undefined' && phrase !== undefined) {\n const match = phrase.match(/[A-Z]+[a-z]*|[a-z]+/g)\n return !match\n ? ''\n : match.reduce(\n (acronym: string, word: string) => (acronym += word[0].toUpperCase()),\n ''\n )\n }\n return ''\n}\n" }, { "path": "exercises/practice/acronym/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[1e22cceb-c5e4-4562-9afe-aef07ad1eaf4]\ndescription = \"basic\"\n\n[79ae3889-a5c0-4b01-baf0-232d31180c08]\ndescription = \"lowercase words\"\n\n[ec7000a7-3931-4a17-890e-33ca2073a548]\ndescription = \"punctuation\"\n\n[32dd261c-0c92-469a-9c5c-b192e94a63b0]\ndescription = \"all caps word\"\n\n[ae2ac9fa-a606-4d05-8244-3bcc4659c1d4]\ndescription = \"punctuation without whitespace\"\n\n[0e4b1e7c-1a6d-48fb-81a7-bf65eb9e69f9]\ndescription = \"very long abbreviation\"\n\n[6a078f49-c68d-4b7b-89af-33a1a98c28cc]\ndescription = \"consecutive delimiters\"\n\n[5118b4b1-4572-434c-8d57-5b762e57973e]\ndescription = \"apostrophes\"\n\n[adc12eab-ec2d-414f-b48c-66a4fc06cdef]\ndescription = \"underscore emphasis\"\n" }, { "path": "exercises/practice/acronym/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/acronym/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/acronym/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/acronym/acronym.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { parse } from './acronym.ts'\n\ndescribe('Acronym are produced from', () => {\n it('title cased phrases', () => {\n expect(parse('Portable Network Graphics')).toEqual('PNG')\n })\n\n xit('other title cased phrases', () => {\n expect(parse('Ruby on Rails')).toEqual('ROR')\n })\n\n xit('inconsistently cased phrases', () => {\n expect(parse('HyperText Markup Language')).toEqual('HTML')\n })\n\n xit('phrases with punctuation', () => {\n expect(parse('First In, First Out')).toEqual('FIFO')\n })\n\n xit('other phrases with punctuation', () => {\n expect(parse('PHP: Hypertext Preprocessor')).toEqual('PHP')\n })\n\n xit('phrases with punctuation and sentence casing', () => {\n expect(parse('Complementary metal-oxide semiconductor')).toEqual('CMOS')\n })\n})\n" }, { "path": "exercises/practice/acronym/acronym.ts", "content": "export function parse(phrase: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/acronym/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/acronym/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/acronym/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/acronym/package.json", "content": "{\n \"name\": \"@exercism/typescript-acronym\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/acronym/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/acronym/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/all-your-base/.docs/instructions.md", "content": "# Instructions\n\nConvert a sequence of digits in one base, representing a number, into a sequence of digits in another base, representing the same number.\n\n~~~~exercism/note\nTry to implement the conversion yourself.\nDo not use something else to perform the conversion for you.\n~~~~\n\n## About [Positional Notation][positional-notation]\n\nIn positional notation, a number in base **b** can be understood as a linear combination of powers of **b**.\n\nThe number 42, _in base 10_, means:\n\n`(4 Ɨ 10Ā¹) + (2 Ɨ 10ā°)`\n\nThe number 101010, _in base 2_, means:\n\n`(1 Ɨ 2āµ) + (0 Ɨ 2ā“) + (1 Ɨ 2Ā³) + (0 Ɨ 2Ā²) + (1 Ɨ 2Ā¹) + (0 Ɨ 2ā°)`\n\nThe number 1120, _in base 3_, means:\n\n`(1 Ɨ 3Ā³) + (1 Ɨ 3Ā²) + (2 Ɨ 3Ā¹) + (0 Ɨ 3ā°)`\n\n_Yes. Those three numbers above are exactly the same. Congratulations!_\n\n[positional-notation]: https://en.wikipedia.org/wiki/Positional_notation\n" }, { "path": "exercises/practice/all-your-base/.docs/introduction.md", "content": "# Introduction\n\nYou've just been hired as professor of mathematics.\nYour first week went well, but something is off in your second week.\nThe problem is that every answer given by your students is wrong!\nLuckily, your math skills have allowed you to identify the problem: the student answers _are_ correct, but they're all in base 2 (binary)!\nAmazingly, it turns out that each week, the students use a different base.\nTo help you quickly verify the student answers, you'll be building a tool to translate between bases.\n" }, { "path": "exercises/practice/all-your-base/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"all-your-base.ts\"\n ],\n \"test\": [\n \"all-your-base.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Convert a number, represented as a sequence of digits in one base, to any other base.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/all-your-base/.meta/proof.ci.ts", "content": "const isValidBase = (base: number): boolean => {\n return !base || base < 2 || Math.floor(base) !== base\n}\n\nconst isInputValid = (array: number[], base: number): boolean => {\n if (!array || !array.length) {\n return false\n }\n const val = base - 1\n for (let i = 0, n = array.length; i < n; i++) {\n const tmp = array[i]\n if (tmp > val || tmp < 0) {\n return false\n }\n }\n return true\n}\n\nconst convertFromDecimalToBase = (\n num: number,\n outputBase: number\n): number[] => {\n let tmp = num\n const result = []\n while (tmp) {\n result.unshift(tmp % outputBase)\n tmp = Math.floor(tmp / outputBase)\n }\n return result\n}\n\nexport function convert(\n array: number[],\n inputBase: number,\n outputBase: number\n): number[] {\n if (isValidBase(inputBase)) {\n throw new Error('Wrong input base')\n }\n if (isValidBase(outputBase)) {\n throw new Error('Wrong output base')\n }\n const regexp = new RegExp('^0.', 'g')\n const str = array.join('')\n if (str.match(regexp) || !isInputValid(array, inputBase)) {\n throw new Error('Input has wrong format')\n }\n if (str === '0') {\n return [0]\n }\n if (str === '1') {\n return [1]\n }\n const decimalValue = array.reduce(\n (accumulator, value) => accumulator * inputBase + value,\n 0\n )\n return convertFromDecimalToBase(decimalValue, outputBase)\n}\n" }, { "path": "exercises/practice/all-your-base/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[5ce422f9-7a4b-4f44-ad29-49c67cb32d2c]\ndescription = \"single bit one to decimal\"\n\n[0cc3fea8-bb79-46ac-a2ab-5a2c93051033]\ndescription = \"binary to single decimal\"\n\n[f12db0f9-0d3d-42c2-b3ba-e38cb375a2b8]\ndescription = \"single decimal to binary\"\n\n[2c45cf54-6da3-4748-9733-5a3c765d925b]\ndescription = \"binary to multiple decimal\"\n\n[65ddb8b4-8899-4fcc-8618-181b2cf0002d]\ndescription = \"decimal to binary\"\n\n[8d418419-02a7-4824-8b7a-352d33c6987e]\ndescription = \"trinary to hexadecimal\"\n\n[d3901c80-8190-41b9-bd86-38d988efa956]\ndescription = \"hexadecimal to trinary\"\n\n[5d42f85e-21ad-41bd-b9be-a3e8e4258bbf]\ndescription = \"15-bit integer\"\n\n[d68788f7-66dd-43f8-a543-f15b6d233f83]\ndescription = \"empty list\"\n\n[5e27e8da-5862-4c5f-b2a9-26c0382b6be7]\ndescription = \"single zero\"\n\n[2e1c2573-77e4-4b9c-8517-6c56c5bcfdf2]\ndescription = \"multiple zeros\"\n\n[3530cd9f-8d6d-43f5-bc6e-b30b1db9629b]\ndescription = \"leading zeros\"\n\n[a6b476a1-1901-4f2a-92c4-4d91917ae023]\ndescription = \"input base is one\"\n\n[e21a693a-7a69-450b-b393-27415c26a016]\ndescription = \"input base is zero\"\n\n[54a23be5-d99e-41cc-88e0-a650ffe5fcc2]\ndescription = \"input base is negative\"\n\n[9eccf60c-dcc9-407b-95d8-c37b8be56bb6]\ndescription = \"negative digit\"\n\n[232fa4a5-e761-4939-ba0c-ed046cd0676a]\ndescription = \"invalid positive digit\"\n\n[14238f95-45da-41dc-95ce-18f860b30ad3]\ndescription = \"output base is one\"\n\n[73dac367-da5c-4a37-95fe-c87fad0a4047]\ndescription = \"output base is zero\"\n\n[13f81f42-ff53-4e24-89d9-37603a48ebd9]\ndescription = \"output base is negative\"\n\n[0e6c895d-8a5d-4868-a345-309d094cfe8d]\ndescription = \"both bases are negative\"\n" }, { "path": "exercises/practice/all-your-base/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/all-your-base/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/all-your-base/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/all-your-base/all-your-base.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { convert } from './all-your-base.ts'\n\ndescribe('Converter', () => {\n it('single bit one to decimal', () => {\n expect(convert([1], 2, 10)).toEqual([1])\n })\n\n xit('binary to single decimal', () => {\n expect(convert([1, 0, 1], 2, 10)).toEqual([5])\n })\n\n xit('single decimal to binary', () => {\n expect(convert([5], 10, 2)).toEqual([1, 0, 1])\n })\n\n xit('binary to multiple decimal', () => {\n expect(convert([1, 0, 1, 0, 1, 0], 2, 10)).toEqual([4, 2])\n })\n\n xit('decimal to binary', () => {\n expect(convert([4, 2], 10, 2)).toEqual([1, 0, 1, 0, 1, 0])\n })\n\n xit('trinary to hexadecimal', () => {\n expect(convert([1, 1, 2, 0], 3, 16)).toEqual([2, 10])\n })\n\n xit('hexadecimal to trinary', () => {\n expect(convert([2, 10], 16, 3)).toEqual([1, 1, 2, 0])\n })\n\n xit('15-bit integer', () => {\n expect(convert([3, 46, 60], 97, 73)).toEqual([6, 10, 45])\n })\n\n xit('empty list', () => {\n expect(() => {\n convert([], 2, 10)\n }).toThrow('Input has wrong format')\n })\n\n xit('single zero', () => {\n expect(convert([0], 10, 2)).toEqual([0])\n })\n\n xit('multiple zeros', () => {\n expect(() => {\n convert([0, 0, 0], 10, 2)\n }).toThrow('Input has wrong format')\n })\n\n xit('leading zeros', () => {\n expect(() => {\n convert([0, 6, 0], 7, 10)\n }).toThrow('Input has wrong format')\n })\n\n xit('negative digit', () => {\n expect(() => {\n convert([1, -1, 1, 0, 1, 0], 2, 10)\n }).toThrow('Input has wrong format')\n })\n\n xit('invalid positive digit', () => {\n expect(() => {\n convert([1, 2, 1, 0, 1, 0], 2, 10)\n }).toThrow('Input has wrong format')\n })\n\n xit('first base is one', () => {\n expect(() => {\n convert([], 1, 10)\n }).toThrow('Wrong input base')\n })\n\n xit('second base is one', () => {\n expect(() => {\n convert([1, 0, 1, 0, 1, 0], 2, 1)\n }).toThrow('Wrong output base')\n })\n\n xit('first base is zero', () => {\n expect(() => {\n convert([], 0, 10)\n }).toThrow('Wrong input base')\n })\n\n xit('second base is zero', () => {\n expect(() => {\n convert([7], 10, 0)\n }).toThrow('Wrong output base')\n })\n\n xit('first base is negative', () => {\n expect(() => {\n convert([1], -2, 10)\n }).toThrow('Wrong input base')\n })\n\n xit('second base is negative', () => {\n expect(() => {\n convert([1], 2, -7)\n }).toThrow('Wrong output base')\n })\n\n xit('both bases are negative', () => {\n expect(() => {\n convert([1], -2, -7)\n }).toThrow('Wrong input base')\n })\n\n xit('wrong output_base base not integer', () => {\n expect(() => {\n convert([0], 3, 2.5)\n }).toThrow('Wrong output base')\n })\n})\n" }, { "path": "exercises/practice/all-your-base/all-your-base.ts", "content": "export function convert(\n digits: unknown,\n inputBase: unknown,\n outputBase: unknown\n): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/all-your-base/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/all-your-base/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/all-your-base/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/all-your-base/package.json", "content": "{\n \"name\": \"@exercism/typescript-all-your-base\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/all-your-base/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/all-your-base/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/allergies/.docs/instructions.md", "content": "# Instructions\n\nGiven a person's allergy score, determine whether or not they're allergic to a given item, and their full list of allergies.\n\nAn allergy test produces a single numeric score which contains the information about all the allergies the person has (that they were tested for).\n\nThe list of items (and their value) that were tested are:\n\n- eggs (1)\n- peanuts (2)\n- shellfish (4)\n- strawberries (8)\n- tomatoes (16)\n- chocolate (32)\n- pollen (64)\n- cats (128)\n\nSo if Tom is allergic to peanuts and chocolate, he gets a score of 34.\n\nNow, given just that score of 34, your program should be able to say:\n\n- Whether Tom is allergic to any one of those allergens listed above.\n- All the allergens Tom is allergic to.\n\nNote: a given score may include allergens **not** listed above (i.e. allergens that score 256, 512, 1024, etc.).\nYour program should ignore those components of the score.\nFor example, if the allergy score is 257, your program should only report the eggs (1) allergy.\n" }, { "path": "exercises/practice/allergies/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"allergies.ts\"\n ],\n \"test\": [\n \"allergies.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a person's allergy score, determine whether or not they're allergic to a given item, and their full list of allergies.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Exercise by the JumpstartLab team for students at The Turing School of Software and Design.\",\n \"source_url\": \"https://www.turing.edu/\"\n}\n" }, { "path": "exercises/practice/allergies/.meta/proof.ci.ts", "content": "export class Allergies {\n private allergenIndex: number\n\n private possibleAllergies = [\n 'eggs',\n 'peanuts',\n 'shellfish',\n 'strawberries',\n 'tomatoes',\n 'chocolate',\n 'pollen',\n 'cats',\n ] as const\n\n constructor(allergenIndex: number) {\n this.allergenIndex = allergenIndex\n }\n\n public allergicTo(food: string): boolean {\n let isAllergic = false\n\n const allergyList = this.list()\n for (const allergy of allergyList) {\n if (allergy === food) {\n isAllergic = true\n break\n }\n }\n\n return isAllergic\n }\n\n public list(): string[] {\n const possibleAllergies = this.possibleAllergies\n const allergicTo = []\n\n for (let i = 0; i < possibleAllergies.length; i++) {\n const allergy = possibleAllergies[i]\n if (this.allergenIndex & Math.pow(2, i)) {\n allergicTo.push(allergy)\n }\n }\n\n return allergicTo\n }\n}\n" }, { "path": "exercises/practice/allergies/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[17fc7296-2440-4ac4-ad7b-d07c321bc5a0]\ndescription = \"testing for eggs allergy -> not allergic to anything\"\n\n[07ced27b-1da5-4c2e-8ae2-cb2791437546]\ndescription = \"testing for eggs allergy -> allergic only to eggs\"\n\n[5035b954-b6fa-4b9b-a487-dae69d8c5f96]\ndescription = \"testing for eggs allergy -> allergic to eggs and something else\"\n\n[64a6a83a-5723-4b5b-a896-663307403310]\ndescription = \"testing for eggs allergy -> allergic to something, but not eggs\"\n\n[90c8f484-456b-41c4-82ba-2d08d93231c6]\ndescription = \"testing for eggs allergy -> allergic to everything\"\n\n[d266a59a-fccc-413b-ac53-d57cb1f0db9d]\ndescription = \"testing for peanuts allergy -> not allergic to anything\"\n\n[ea210a98-860d-46b2-a5bf-50d8995b3f2a]\ndescription = \"testing for peanuts allergy -> allergic only to peanuts\"\n\n[eac69ae9-8d14-4291-ac4b-7fd2c73d3a5b]\ndescription = \"testing for peanuts allergy -> allergic to peanuts and something else\"\n\n[9152058c-ce39-4b16-9b1d-283ec6d25085]\ndescription = \"testing for peanuts allergy -> allergic to something, but not peanuts\"\n\n[d2d71fd8-63d5-40f9-a627-fbdaf88caeab]\ndescription = \"testing for peanuts allergy -> allergic to everything\"\n\n[b948b0a1-cbf7-4b28-a244-73ff56687c80]\ndescription = \"testing for shellfish allergy -> not allergic to anything\"\n\n[9ce9a6f3-53e9-4923-85e0-73019047c567]\ndescription = \"testing for shellfish allergy -> allergic only to shellfish\"\n\n[b272fca5-57ba-4b00-bd0c-43a737ab2131]\ndescription = \"testing for shellfish allergy -> allergic to shellfish and something else\"\n\n[21ef8e17-c227-494e-8e78-470a1c59c3d8]\ndescription = \"testing for shellfish allergy -> allergic to something, but not shellfish\"\n\n[cc789c19-2b5e-4c67-b146-625dc8cfa34e]\ndescription = \"testing for shellfish allergy -> allergic to everything\"\n\n[651bde0a-2a74-46c4-ab55-02a0906ca2f5]\ndescription = \"testing for strawberries allergy -> not allergic to anything\"\n\n[b649a750-9703-4f5f-b7f7-91da2c160ece]\ndescription = \"testing for strawberries allergy -> allergic only to strawberries\"\n\n[50f5f8f3-3bac-47e6-8dba-2d94470a4bc6]\ndescription = \"testing for strawberries allergy -> allergic to strawberries and something else\"\n\n[23dd6952-88c9-48d7-a7d5-5d0343deb18d]\ndescription = \"testing for strawberries allergy -> allergic to something, but not strawberries\"\n\n[74afaae2-13b6-43a2-837a-286cd42e7d7e]\ndescription = \"testing for strawberries allergy -> allergic to everything\"\n\n[c49a91ef-6252-415e-907e-a9d26ef61723]\ndescription = \"testing for tomatoes allergy -> not allergic to anything\"\n\n[b69c5131-b7d0-41ad-a32c-e1b2cc632df8]\ndescription = \"testing for tomatoes allergy -> allergic only to tomatoes\"\n\n[1ca50eb1-f042-4ccf-9050-341521b929ec]\ndescription = \"testing for tomatoes allergy -> allergic to tomatoes and something else\"\n\n[e9846baa-456b-4eff-8025-034b9f77bd8e]\ndescription = \"testing for tomatoes allergy -> allergic to something, but not tomatoes\"\n\n[b2414f01-f3ad-4965-8391-e65f54dad35f]\ndescription = \"testing for tomatoes allergy -> allergic to everything\"\n\n[978467ab-bda4-49f7-b004-1d011ead947c]\ndescription = \"testing for chocolate allergy -> not allergic to anything\"\n\n[59cf4e49-06ea-4139-a2c1-d7aad28f8cbc]\ndescription = \"testing for chocolate allergy -> allergic only to chocolate\"\n\n[b0a7c07b-2db7-4f73-a180-565e07040ef1]\ndescription = \"testing for chocolate allergy -> allergic to chocolate and something else\"\n\n[f5506893-f1ae-482a-b516-7532ba5ca9d2]\ndescription = \"testing for chocolate allergy -> allergic to something, but not chocolate\"\n\n[02debb3d-d7e2-4376-a26b-3c974b6595c6]\ndescription = \"testing for chocolate allergy -> allergic to everything\"\n\n[17f4a42b-c91e-41b8-8a76-4797886c2d96]\ndescription = \"testing for pollen allergy -> not allergic to anything\"\n\n[7696eba7-1837-4488-882a-14b7b4e3e399]\ndescription = \"testing for pollen allergy -> allergic only to pollen\"\n\n[9a49aec5-fa1f-405d-889e-4dfc420db2b6]\ndescription = \"testing for pollen allergy -> allergic to pollen and something else\"\n\n[3cb8e79f-d108-4712-b620-aa146b1954a9]\ndescription = \"testing for pollen allergy -> allergic to something, but not pollen\"\n\n[1dc3fe57-7c68-4043-9d51-5457128744b2]\ndescription = \"testing for pollen allergy -> allergic to everything\"\n\n[d3f523d6-3d50-419b-a222-d4dfd62ce314]\ndescription = \"testing for cats allergy -> not allergic to anything\"\n\n[eba541c3-c886-42d3-baef-c048cb7fcd8f]\ndescription = \"testing for cats allergy -> allergic only to cats\"\n\n[ba718376-26e0-40b7-bbbe-060287637ea5]\ndescription = \"testing for cats allergy -> allergic to cats and something else\"\n\n[3c6dbf4a-5277-436f-8b88-15a206f2d6c4]\ndescription = \"testing for cats allergy -> allergic to something, but not cats\"\n\n[1faabb05-2b98-4995-9046-d83e4a48a7c1]\ndescription = \"testing for cats allergy -> allergic to everything\"\n\n[f9c1b8e7-7dc5-4887-aa93-cebdcc29dd8f]\ndescription = \"list when: -> no allergies\"\n\n[9e1a4364-09a6-4d94-990f-541a94a4c1e8]\ndescription = \"list when: -> just eggs\"\n\n[8851c973-805e-4283-9e01-d0c0da0e4695]\ndescription = \"list when: -> just peanuts\"\n\n[2c8943cb-005e-435f-ae11-3e8fb558ea98]\ndescription = \"list when: -> just strawberries\"\n\n[6fa95d26-044c-48a9-8a7b-9ee46ec32c5c]\ndescription = \"list when: -> eggs and peanuts\"\n\n[19890e22-f63f-4c5c-a9fb-fb6eacddfe8e]\ndescription = \"list when: -> more than eggs but not peanuts\"\n\n[4b68f470-067c-44e4-889f-c9fe28917d2f]\ndescription = \"list when: -> lots of stuff\"\n\n[0881b7c5-9efa-4530-91bd-68370d054bc7]\ndescription = \"list when: -> everything\"\n\n[12ce86de-b347-42a0-ab7c-2e0570f0c65b]\ndescription = \"list when: -> no allergen score parts\"\n\n[93c2df3e-4f55-4fed-8116-7513092819cd]\ndescription = \"list when: -> no allergen score parts without highest valid score\"\n" }, { "path": "exercises/practice/allergies/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/allergies/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/allergies/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/allergies/allergies.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Allergies } from './allergies.ts'\n\ndescribe('allergicTo', () => {\n it('no allergies means not allergic', () => {\n const allergies = new Allergies(0)\n\n expect(allergies.allergicTo('peanuts')).toBeFalsy()\n expect(allergies.allergicTo('cats')).toBeFalsy()\n expect(allergies.allergicTo('strawberries')).toBeFalsy()\n })\n\n xit('is allergic to eggs', () => {\n const allergies = new Allergies(1)\n\n expect(allergies.allergicTo('eggs')).toBeTruthy()\n })\n\n xit('allergic to eggs in addition to other stuff', () => {\n const allergies = new Allergies(5)\n\n expect(allergies.allergicTo('eggs')).toBeTruthy()\n expect(allergies.allergicTo('shellfish')).toBeTruthy()\n expect(allergies.allergicTo('strawberries')).toBeFalsy()\n })\n})\n\ndescribe('list', () => {\n xit('no allergies at all', () => {\n const allergies = new Allergies(0)\n const expected: string[] = []\n\n expect(allergies.list()).toEqual(expected)\n })\n\n xit('allergic to just eggs', () => {\n const allergies = new Allergies(1)\n const expected = ['eggs']\n\n expect(allergies.list()).toEqual(expected)\n })\n\n xit('allergic to just peanuts', () => {\n const allergies = new Allergies(2)\n const expected = ['peanuts']\n\n expect(allergies.list()).toEqual(expected)\n })\n\n xit('allergic to just strawberries', () => {\n const allergies = new Allergies(8)\n const expected = ['strawberries']\n\n expect(allergies.list()).toEqual(expected)\n })\n\n xit('allergic to eggs and peanuts', () => {\n const allergies = new Allergies(3)\n const expected = ['eggs', 'peanuts']\n\n expect(allergies.list()).toEqual(expected)\n })\n\n xit('allergic to more than eggs but not peanuts', () => {\n const allergies = new Allergies(5)\n const expected = ['eggs', 'shellfish']\n\n expect(allergies.list()).toEqual(expected)\n })\n\n xit('allergic to lots of stuff', () => {\n const allergies = new Allergies(248)\n const expected = ['strawberries', 'tomatoes', 'chocolate', 'pollen', 'cats']\n\n expect(allergies.list()).toEqual(expected)\n })\n\n xit('allergic to everything', () => {\n const allergies = new Allergies(255)\n const expected = [\n 'eggs',\n 'peanuts',\n 'shellfish',\n 'strawberries',\n 'tomatoes',\n 'chocolate',\n 'pollen',\n 'cats',\n ]\n\n expect(allergies.list()).toEqual(expected)\n })\n\n xit('ignore non allergen score parts', () => {\n const allergies = new Allergies(509)\n const expected = [\n 'eggs',\n 'shellfish',\n 'strawberries',\n 'tomatoes',\n 'chocolate',\n 'pollen',\n 'cats',\n ]\n\n expect(allergies.list()).toEqual(expected)\n })\n\n xit('ignore non allergen score parts, without highest valid score', () => {\n const allergies = new Allergies(257)\n const expected = ['eggs']\n\n expect(allergies.list()).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/allergies/allergies.ts", "content": "export class Allergies {\n constructor(allergenIndex: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public list(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public allergicTo(allergen: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/allergies/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/allergies/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/allergies/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/allergies/package.json", "content": "{\n \"name\": \"@exercism/typescript-allergies\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/allergies/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/allergies/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/alphametics/.docs/instructions.md", "content": "# Instructions\n\nGiven an alphametics puzzle, find the correct solution.\n\n[Alphametics][alphametics] is a puzzle where letters in words are replaced with numbers.\n\nFor example `SEND + MORE = MONEY`:\n\n```text\n S E N D\n M O R E +\n-----------\nM O N E Y\n```\n\nReplacing these with valid numbers gives:\n\n```text\n 9 5 6 7\n 1 0 8 5 +\n-----------\n1 0 6 5 2\n```\n\nThis is correct because every letter is replaced by a different number and the words, translated into numbers, then make a valid sum.\n\nEach letter must represent a different digit, and the leading digit of a multi-digit number must not be zero.\n\n[alphametics]: https://en.wikipedia.org/wiki/Alphametics\n" }, { "path": "exercises/practice/alphametics/.meta/config.json", "content": "{\n \"authors\": [\n \"W0lfw00d\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"alphametics.ts\"\n ],\n \"test\": [\n \"alphametics.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given an alphametics puzzle, find the correct solution.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/alphametics/.meta/proof.ci.ts", "content": "export function solve(puzzle: string): undefined | { [key: string]: number } {\n const parts: string[] = puzzle\n .split(/[+|==]/g)\n .map((o) => o.trim())\n .filter((o) => o !== '')\n\n if (parts.length < 3) {\n return undefined\n }\n\n const uniqueLetters = new Set(parts.join('').split(''))\n const firstLetters = new Set(parts.map((p) => p[0]))\n\n const numberCombinations: number[][] = getNumberCombinations(\n [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],\n uniqueLetters.size\n )\n\n while (numberCombinations.length) {\n const permutations = generate(\n Array(uniqueLetters.size)\n .fill(Array())\n .map((_, i) => i)\n )\n const numberCombination: number[] = numberCombinations.pop() || []\n for (const permutation of permutations) {\n const newNumbers = assignNumbers(\n numberCombination,\n uniqueLetters,\n permutation\n )\n if (testNumbers(newNumbers, parts, firstLetters)) {\n return newNumbers\n }\n }\n }\n return undefined\n}\n\nfunction assignNumbers(\n numberCombination: number[],\n uniqueLetters: Set,\n permutation: number[]\n): { [key: string]: number } {\n const output: { [key: string]: number } = {}\n let i = 0\n for (const letter of uniqueLetters.values()) {\n output[letter] = numberCombination[permutation[i++]]\n }\n return output\n}\n\nfunction testNumbers(\n numbers: { [key: string]: number },\n puzzleParts: string[],\n firstLetters: Set\n): boolean {\n const keys: string[] = Object.keys(numbers)\n for (const key of keys) {\n if (numbers[key] === 0 && firstLetters.has(key)) {\n return false\n }\n }\n const replaceRegex = new RegExp(`[${keys.join('')}]`, 'g')\n\n const puzzlePartsNumbers: number[] = puzzleParts\n .join(',')\n .replace(replaceRegex, (input) => numbers[input].toString())\n .split(',')\n .map((t) => parseInt(t, 10))\n\n const total = puzzlePartsNumbers.slice(puzzlePartsNumbers.length - 1)[0]\n return (\n total ===\n puzzlePartsNumbers\n .slice(0, puzzleParts.length - 1)\n .reduce((acc: number, val: number) => acc + val, 0)\n )\n}\n\nfunction* generate(A: number[]): IterableIterator {\n const c = []\n const n = A.length\n yield A\n for (let i = 0; i < n; i++) {\n c[i] = 0\n }\n let i = 0\n while (i < n) {\n if (c[i] < i) {\n if (i % 2 === 0) {\n swap(A, 0, i)\n } else {\n swap(A, c[i], i)\n }\n yield A\n c[i] += 1\n i = 0\n } else {\n c[i] = 0\n i += 1\n }\n }\n}\n\nfunction swap(list: number[], x: number, y: number): number[] {\n const tmp = list[x]\n list[x] = list[y]\n list[y] = tmp\n return list\n}\n\nfunction getNumberCombinations(arr: number[], size: number): number[][] {\n const len = arr.length\n\n if (size === len) {\n return [arr]\n }\n\n return arr.reduce((acc: number[][], val: number, i: number) => {\n const res: number[][] = getNumberCombinations(\n arr.slice(i + 1),\n size - 1\n ).map((comb) => [val].concat(comb))\n\n return acc.concat(res)\n }, [])\n}\n" }, { "path": "exercises/practice/alphametics/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[e0c08b07-9028-4d5f-91e1-d178fead8e1a]\ndescription = \"puzzle with three letters\"\n\n[a504ee41-cb92-4ec2-9f11-c37e95ab3f25]\ndescription = \"solution must have unique value for each letter\"\n\n[4e3b81d2-be7b-4c5c-9a80-cd72bc6d465a]\ndescription = \"leading zero solution is invalid\"\n\n[8a3e3168-d1ee-4df7-94c7-b9c54845ac3a]\ndescription = \"puzzle with two digits final carry\"\n\n[a9630645-15bd-48b6-a61e-d85c4021cc09]\ndescription = \"puzzle with four letters\"\n\n[3d905a86-5a52-4e4e-bf80-8951535791bd]\ndescription = \"puzzle with six letters\"\n\n[4febca56-e7b7-4789-97b9-530d09ba95f0]\ndescription = \"puzzle with seven letters\"\n\n[12125a75-7284-4f9a-a5fa-191471e0d44f]\ndescription = \"puzzle with eight letters\"\n\n[fb05955f-38dc-477a-a0b6-5ef78969fffa]\ndescription = \"puzzle with ten letters\"\n\n[9a101e81-9216-472b-b458-b513a7adacf7]\ndescription = \"puzzle with ten letters and 199 addends\"\n" }, { "path": "exercises/practice/alphametics/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/alphametics/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/alphametics/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/alphametics/alphametics.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { solve } from './alphametics.ts'\n\ndescribe('Solve the alphametics puzzle', () => {\n it('puzzle with three letters', () => {\n const puzzle = 'I + BB == ILL'\n const expected = {\n I: 1,\n B: 9,\n L: 0,\n }\n expect(solve(puzzle)).toEqual(expected)\n })\n\n xit('solution must have unique value for each letter', () => {\n const puzzle = 'A == B'\n expect(solve(puzzle)).toBeUndefined()\n })\n\n xit('leading zero solution is invalid', () => {\n const puzzle = 'ACA + DD == BD'\n expect(solve(puzzle)).toBeUndefined()\n })\n\n xit('puzzle with four letters', () => {\n const puzzle = 'AS + A == MOM'\n const expected = {\n A: 9,\n S: 2,\n M: 1,\n O: 0,\n }\n expect(solve(puzzle)).toEqual(expected)\n })\n\n xit('puzzle with six letters', () => {\n const puzzle = 'NO + NO + TOO == LATE'\n const expected = {\n N: 7,\n O: 4,\n T: 9,\n L: 1,\n A: 0,\n E: 2,\n }\n expect(solve(puzzle)).toEqual(expected)\n })\n\n xit('puzzle with seven letters', () => {\n const puzzle = 'HE + SEES + THE == LIGHT'\n const expected = {\n E: 4,\n G: 2,\n H: 5,\n I: 0,\n L: 1,\n S: 9,\n T: 7,\n }\n expect(solve(puzzle)).toEqual(expected)\n })\n\n xit('puzzle with eight letters', () => {\n const puzzle = 'SEND + MORE == MONEY'\n const expected = {\n S: 9,\n E: 5,\n N: 6,\n D: 7,\n M: 1,\n O: 0,\n R: 8,\n Y: 2,\n }\n expect(solve(puzzle)).toEqual(expected)\n })\n\n xit('puzzle with ten letters', () => {\n const puzzle = 'AND + A + STRONG + OFFENSE + AS + A + GOOD == DEFENSE'\n const expected = {\n A: 5,\n D: 3,\n E: 4,\n F: 7,\n G: 8,\n N: 0,\n O: 2,\n R: 1,\n S: 6,\n T: 9,\n }\n expect(solve(puzzle)).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/alphametics/alphametics.ts", "content": "export function solve(puzzle: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/alphametics/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/alphametics/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/alphametics/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/alphametics/package.json", "content": "{\n \"name\": \"@exercism/typescript-alphametics\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/alphametics/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/alphametics/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/anagram/.docs/instructions.append.md", "content": "# Instructions Append\n\nThe anagrams can be returned in any order.\n" }, { "path": "exercises/practice/anagram/.docs/instructions.md", "content": "# Instructions\n\nGiven a target word and one or more candidate words, your task is to find the candidates that are anagrams of the target.\n\nAn anagram is a rearrangement of letters to form a new word: for example `\"owns\"` is an anagram of `\"snow\"`.\nA word is _not_ its own anagram: for example, `\"stop\"` is not an anagram of `\"stop\"`.\n\nThe target word and candidate words are made up of one or more ASCII alphabetic characters (`A`-`Z` and `a`-`z`).\nLowercase and uppercase characters are equivalent: for example, `\"PoTS\"` is an anagram of `\"sTOp\"`, but `\"StoP\"` is not an anagram of `\"sTOp\"`.\nThe words you need to find should be taken from the candidate words, using the same letter case.\n\nGiven the target `\"stone\"` and the candidate words `\"stone\"`, `\"tones\"`, `\"banana\"`, `\"tons\"`, `\"notes\"`, and `\"Seton\"`, the anagram words you need to find are `\"tones\"`, `\"notes\"`, and `\"Seton\"`.\n" }, { "path": "exercises/practice/anagram/.docs/introduction.md", "content": "# Introduction\n\nAt a garage sale, you find a lovely vintage typewriter at a bargain price!\nExcitedly, you rush home, insert a sheet of paper, and start typing away.\nHowever, your excitement wanes when you examine the output: all words are garbled!\nFor example, it prints \"stop\" instead of \"post\" and \"least\" instead of \"stale.\"\nCarefully, you try again, but now it prints \"spot\" and \"slate.\"\nAfter some experimentation, you find there is a random delay before each letter is printed, which messes up the order.\nYou now understand why they sold it for so little money!\n\nYou realize this quirk allows you to generate anagrams, which are words formed by rearranging the letters of another word.\nPleased with your finding, you spend the rest of the day generating hundreds of anagrams.\n" }, { "path": "exercises/practice/anagram/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"CRivasGomez\",\n \"fredrb\",\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"anagram.ts\"\n ],\n \"test\": [\n \"anagram.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a word and a list of possible anagrams, select the correct sublist.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Inspired by the Extreme Startup game\",\n \"source_url\": \"https://github.com/rchatley/extreme_startup\"\n}\n" }, { "path": "exercises/practice/anagram/.meta/proof.ci.ts", "content": "function sort(input: string): string {\n return input.toString().toLowerCase().split('').sort().join('')\n}\n\nexport class Anagram {\n private value: string\n constructor(input: string) {\n this.value = input\n }\n\n public matches(...input: string[]): string[] {\n const result: string[] = []\n for (const each of input) {\n if (sort(each) === sort(this.value)) {\n if (each.toLowerCase() === this.value.toLowerCase()) {\n continue\n }\n result.push(each)\n }\n }\n return result\n }\n}\n" }, { "path": "exercises/practice/anagram/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[dd40c4d2-3c8b-44e5-992a-f42b393ec373]\ndescription = \"no matches\"\n\n[b3cca662-f50a-489e-ae10-ab8290a09bdc]\ndescription = \"detects two anagrams\"\ninclude = false\n\n[03eb9bbe-8906-4ea0-84fa-ffe711b52c8b]\ndescription = \"detects two anagrams\"\nreimplements = \"b3cca662-f50a-489e-ae10-ab8290a09bdc\"\n\n[a27558ee-9ba0-4552-96b1-ecf665b06556]\ndescription = \"does not detect anagram subsets\"\n\n[64cd4584-fc15-4781-b633-3d814c4941a4]\ndescription = \"detects anagram\"\n\n[99c91beb-838f-4ccd-b123-935139917283]\ndescription = \"detects three anagrams\"\n\n[78487770-e258-4e1f-a646-8ece10950d90]\ndescription = \"detects multiple anagrams with different case\"\n\n[1d0ab8aa-362f-49b7-9902-3d0c668d557b]\ndescription = \"does not detect non-anagrams with identical checksum\"\n\n[9e632c0b-c0b1-4804-8cc1-e295dea6d8a8]\ndescription = \"detects anagrams case-insensitively\"\n\n[b248e49f-0905-48d2-9c8d-bd02d8c3e392]\ndescription = \"detects anagrams using case-insensitive subject\"\n\n[f367325c-78ec-411c-be76-e79047f4bd54]\ndescription = \"detects anagrams using case-insensitive possible matches\"\n\n[7cc195ad-e3c7-44ee-9fd2-d3c344806a2c]\ndescription = \"does not detect an anagram if the original word is repeated\"\ninclude = false\n\n[630abb71-a94e-4715-8395-179ec1df9f91]\ndescription = \"does not detect an anagram if the original word is repeated\"\nreimplements = \"7cc195ad-e3c7-44ee-9fd2-d3c344806a2c\"\n\n[9878a1c9-d6ea-4235-ae51-3ea2befd6842]\ndescription = \"anagrams must use all letters exactly once\"\n\n[85757361-4535-45fd-ac0e-3810d40debc1]\ndescription = \"words are not anagrams of themselves (case-insensitive)\"\ninclude = false\n\n[68934ed0-010b-4ef9-857a-20c9012d1ebf]\ndescription = \"words are not anagrams of themselves\"\nreimplements = \"85757361-4535-45fd-ac0e-3810d40debc1\"\n\n[589384f3-4c8a-4e7d-9edc-51c3e5f0c90e]\ndescription = \"words are not anagrams of themselves even if letter case is partially different\"\nreimplements = \"85757361-4535-45fd-ac0e-3810d40debc1\"\n\n[ba53e423-7e02-41ee-9ae2-71f91e6d18e6]\ndescription = \"words are not anagrams of themselves even if letter case is completely different\"\nreimplements = \"85757361-4535-45fd-ac0e-3810d40debc1\"\n\n[a0705568-628c-4b55-9798-82e4acde51ca]\ndescription = \"words other than themselves can be anagrams\"\ninclude = false\n\n[33d3f67e-fbb9-49d3-a90e-0beb00861da7]\ndescription = \"words other than themselves can be anagrams\"\nreimplements = \"a0705568-628c-4b55-9798-82e4acde51ca\"\n\n[a6854f66-eec1-4afd-a137-62ef2870c051]\ndescription = \"handles case of greek letters\"\n\n[fd3509e5-e3ba-409d-ac3d-a9ac84d13296]\ndescription = \"different characters may have the same bytes\"\n" }, { "path": "exercises/practice/anagram/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/anagram/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/anagram/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/anagram/anagram.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Anagram } from './anagram.ts'\n\nconst areSetsEqual = (setA: Set, setB: Set): boolean =>\n setA.size === setB.size && [...setA].every((val) => setB.has(val))\n\ndescribe('Anagram', () => {\n it('no matches', () => {\n const subject = new Anagram('diaper')\n const matches = subject.matches('hello', 'world', 'zombies', 'pants')\n const expected = []\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('detects two anagrams', () => {\n const subject = new Anagram('solemn')\n const matches = subject.matches('lemons', 'cherry', 'melons')\n const expected = ['lemons', 'melons']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('does not detect anagram subsets', () => {\n const subject = new Anagram('good')\n const matches = subject.matches('dog', 'goody')\n const expected = []\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('detects anagram', () => {\n const subject = new Anagram('listen')\n const matches = subject.matches('enlists', 'google', 'inlets', 'banana')\n const expected = ['inlets']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('detects three anagrams', () => {\n const subject = new Anagram('allergy')\n const matches = subject.matches(\n 'gallery',\n 'ballerina',\n 'regally',\n 'clergy',\n 'largely',\n 'leading'\n )\n const expected = ['gallery', 'regally', 'largely']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('detects multiple anagrams with different case', () => {\n const subject = new Anagram('nose')\n const matches = subject.matches('Eons', 'ONES')\n const expected = ['Eons', 'ONES']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('does not detect non-anagrams with identical checksum', () => {\n const subject = new Anagram('mass')\n const matches = subject.matches('last')\n const expected = []\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('detects anagrams case-insensitively', () => {\n const subject = new Anagram('Orchestra')\n const matches = subject.matches('cashregister', 'Carthorse', 'radishes')\n const expected = ['Carthorse']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('detects anagrams using case-insensitive subject', () => {\n const subject = new Anagram('Orchestra')\n const matches = subject.matches('cashregister', 'carthorse', 'radishes')\n const expected = ['carthorse']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('detects anagrams using case-insensitive possible matches', () => {\n const subject = new Anagram('orchestra')\n const matches = subject.matches('cashregister', 'Carthorse', 'radishes')\n const expected = ['Carthorse']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('does not detect an anagram if the original word is repeated', () => {\n const subject = new Anagram('go')\n const matches = subject.matches('goGoGO')\n const expected = []\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('anagrams must use all letters exactly once', () => {\n const subject = new Anagram('tapper')\n const matches = subject.matches('patter')\n const expected = []\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('words are not anagrams of themselves', () => {\n const subject = new Anagram('BANANA')\n const matches = subject.matches('BANANA')\n const expected = []\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('words are not anagrams of themselves even if letter case is partially different', () => {\n const subject = new Anagram('BANANA')\n const matches = subject.matches('Banana')\n const expected = []\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('words are not anagrams of themselves even if letter case is completely different', () => {\n const subject = new Anagram('BANANA')\n const matches = subject.matches('Banana')\n const expected = []\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('words other than themselves can be anagrams', () => {\n const subject = new Anagram('LISTEN')\n const matches = subject.matches('LISTEN', 'Silent')\n const expected = ['Silent']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('handles case of greek letters', () => {\n const subject = new Anagram('Ī‘Ī’Ī“')\n const matches = subject.matches('Ī’Ī“Ī‘', 'Ī’Ī“Ī”', 'Ī³Ī²Ī±', 'Ī±Ī²Ī³')\n const expected = ['Ī’Ī“Ī‘', 'Ī³Ī²Ī±']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('different characters may have the same bytes', () => {\n const subject = new Anagram('aā¬‚')\n const matches = subject.matches('ā‚¬a')\n const expected = []\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('matches() accepts string arguments', () => {\n const subject = new Anagram('ant')\n const matches = subject.matches('stand', 'tan', 'at')\n const expected = ['tan']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n\n xit('matches() accepts single string argument', () => {\n const subject = new Anagram('ant')\n const matches = subject.matches('tan')\n const expected = ['tan']\n\n expect(areSetsEqual(new Set(expected), new Set(matches))).toEqual(true)\n })\n})\n" }, { "path": "exercises/practice/anagram/anagram.ts", "content": "export class Anagram {\n constructor(input: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public matches(...potentials: unknown[]): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/anagram/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/anagram/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/anagram/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/anagram/package.json", "content": "{\n \"name\": \"@exercism/typescript-anagram\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/anagram/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/anagram/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/armstrong-numbers/.docs/instructions.md", "content": "# Instructions\n\nAn [Armstrong number][armstrong-number] is a number that is the sum of its own digits each raised to the power of the number of digits.\n\nFor example:\n\n- 9 is an Armstrong number, because `9 = 9^1 = 9`\n- 10 is _not_ an Armstrong number, because `10 != 1^2 + 0^2 = 1`\n- 153 is an Armstrong number, because: `153 = 1^3 + 5^3 + 3^3 = 1 + 125 + 27 = 153`\n- 154 is _not_ an Armstrong number, because: `154 != 1^3 + 5^3 + 4^3 = 1 + 125 + 64 = 190`\n\nWrite some code to determine whether a number is an Armstrong number.\n\n[armstrong-number]: https://en.wikipedia.org/wiki/Narcissistic_number\n" }, { "path": "exercises/practice/armstrong-numbers/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"armstrong-numbers.ts\"\n ],\n \"test\": [\n \"armstrong-numbers.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Determine if a number is an Armstrong number.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Narcissistic_number\"\n}\n" }, { "path": "exercises/practice/armstrong-numbers/.meta/proof.ci.ts", "content": "export function isArmstrongNumber(input: number | bigint): boolean {\n const digits = String(input).split('')\n const sum = digits.reduce((total, current) => {\n return total + BigInt(parseInt(current, 10)) ** BigInt(digits.length)\n }, BigInt(0))\n\n // eslint-disable-next-line eqeqeq\n return sum == input\n}\n" }, { "path": "exercises/practice/armstrong-numbers/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[c1ed103c-258d-45b2-be73-d8c6d9580c7b]\ndescription = \"Zero is an Armstrong number\"\n\n[579e8f03-9659-4b85-a1a2-d64350f6b17a]\ndescription = \"Single-digit numbers are Armstrong numbers\"\n\n[2d6db9dc-5bf8-4976-a90b-b2c2b9feba60]\ndescription = \"There are no two-digit Armstrong numbers\"\n\n[509c087f-e327-4113-a7d2-26a4e9d18283]\ndescription = \"Three-digit number that is an Armstrong number\"\n\n[7154547d-c2ce-468d-b214-4cb953b870cf]\ndescription = \"Three-digit number that is not an Armstrong number\"\n\n[6bac5b7b-42e9-4ecb-a8b0-4832229aa103]\ndescription = \"Four-digit number that is an Armstrong number\"\n\n[eed4b331-af80-45b5-a80b-19c9ea444b2e]\ndescription = \"Four-digit number that is not an Armstrong number\"\n\n[f971ced7-8d68-4758-aea1-d4194900b864]\ndescription = \"Seven-digit number that is an Armstrong number\"\n\n[7ee45d52-5d35-4fbd-b6f1-5c8cd8a67f18]\ndescription = \"Seven-digit number that is not an Armstrong number\"\n\n[5ee2fdf8-334e-4a46-bb8d-e5c19c02c148]\ndescription = \"Armstrong number containing seven zeroes\"\n\n[12ffbf10-307a-434e-b4ad-c925680e1dd4]\ndescription = \"The largest and last Armstrong number\"\n" }, { "path": "exercises/practice/armstrong-numbers/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/armstrong-numbers/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/armstrong-numbers/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/armstrong-numbers/armstrong-numbers.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { isArmstrongNumber } from './armstrong-numbers.ts'\n\ndescribe('Armstrong Numbers', () => {\n it('Single-digit numbers are Armstrong numbers', () => {\n expect(isArmstrongNumber(5)).toBeTruthy()\n })\n\n xit('There are no two-digit Armstrong numbers', () => {\n expect(isArmstrongNumber(10)).toBeFalsy()\n })\n\n xit('Three-digit number that is an Armstrong number', () => {\n expect(isArmstrongNumber(153)).toBeTruthy()\n })\n\n xit('Three-digit number that is not an Armstrong number', () => {\n expect(isArmstrongNumber(100)).toBeFalsy()\n })\n\n xit('Four-digit number that is an Armstrong number', () => {\n expect(isArmstrongNumber(9474)).toBeTruthy()\n })\n\n xit('Four-digit number that is not an Armstrong number', () => {\n expect(isArmstrongNumber(9475)).toBeFalsy()\n })\n\n xit('Seven-digit number that is an Armstrong number', () => {\n expect(isArmstrongNumber(9926315)).toBeTruthy()\n })\n\n xit('Seven-digit number that is not an Armstrong number', () => {\n expect(isArmstrongNumber(9926314)).toBeFalsy()\n })\n\n xit('Armstrong number containing seven zeroes', () => {\n expect(\n isArmstrongNumber(BigInt('186709961001538790100634132976990'))\n ).toBeTruthy()\n })\n\n xit('The largest and last Armstrong number', () => {\n expect(\n isArmstrongNumber(BigInt('115132219018763992565095597973971522401'))\n ).toBeTruthy()\n })\n})\n" }, { "path": "exercises/practice/armstrong-numbers/armstrong-numbers.ts", "content": "export function isArmstrongNumber(number: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/armstrong-numbers/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/armstrong-numbers/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/armstrong-numbers/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/armstrong-numbers/package.json", "content": "{\n \"name\": \"@exercism/typescript-armstrong-numbers\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/armstrong-numbers/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/armstrong-numbers/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/atbash-cipher/.docs/instructions.md", "content": "# Instructions\n\nCreate an implementation of the Atbash cipher, an ancient encryption system created in the Middle East.\n\nThe Atbash cipher is a simple substitution cipher that relies on transposing all the letters in the alphabet such that the resulting alphabet is backwards.\nThe first letter is replaced with the last letter, the second with the second-last, and so on.\n\nAn Atbash cipher for the Latin alphabet would be as follows:\n\n```text\nPlain: abcdefghijklmnopqrstuvwxyz\nCipher: zyxwvutsrqponmlkjihgfedcba\n```\n\nIt is a very weak cipher because it only has one possible key, and it is a simple mono-alphabetic substitution cipher.\nHowever, this may not have been an issue in the cipher's time.\n\nCiphertext is written out in groups of fixed length, the traditional group size being 5 letters, leaving numbers unchanged, and punctuation is excluded.\nThis is to make it harder to guess things based on word boundaries.\nAll text will be encoded as lowercase letters.\n\n## Examples\n\n- Encoding `test` gives `gvhg`\n- Encoding `x123 yes` gives `c123b vh`\n- Decoding `gvhg` gives `test`\n- Decoding `gsvjf rxpyi ldmul cqfnk hlevi gsvoz abwlt` gives `thequickbrownfoxjumpsoverthelazydog`\n" }, { "path": "exercises/practice/atbash-cipher/.meta/config.json", "content": "{\n \"authors\": [\n \"bward\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"Roshanjossey\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"atbash-cipher.ts\"\n ],\n \"test\": [\n \"atbash-cipher.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Create an implementation of the Atbash cipher, an ancient encryption system created in the Middle East.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Atbash\"\n}\n" }, { "path": "exercises/practice/atbash-cipher/.meta/proof.ci.ts", "content": "const alphabet = 'abcdefghijklmnopqrstuvwxyz'\nconst numbers = '0123456789'\n\nexport function encode(plainText: string): string {\n const lowerCaseLettersOnly = plainText\n .toLowerCase()\n .split('')\n .filter((char) => alphabet.includes(char) || numbers.includes(char))\n .join('')\n\n return decode(lowerCaseLettersOnly)\n .split('')\n .reduce((accumulator: string[], _, index, array) => {\n if (index % 5 === 0) {\n accumulator.push(array.slice(index, index + 5).join(''))\n }\n return accumulator\n }, [])\n .join(' ')\n}\n\nexport function decode(cipherText: string): string {\n return cipherText\n .split(' ')\n .join('')\n .split('')\n .map((char) =>\n alphabet.includes(char) ? alphabet[25 - alphabet.indexOf(char)] : char\n )\n .join('')\n}\n" }, { "path": "exercises/practice/atbash-cipher/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[2f47ebe1-eab9-4d6b-b3c6-627562a31c77]\ndescription = \"encode yes\"\n\n[b4ffe781-ea81-4b74-b268-cc58ba21c739]\ndescription = \"encode no\"\n\n[10e48927-24ab-4c4d-9d3f-3067724ace00]\ndescription = \"encode OMG\"\n\n[d59b8bc3-509a-4a9a-834c-6f501b98750b]\ndescription = \"encode spaces\"\n\n[31d44b11-81b7-4a94-8b43-4af6a2449429]\ndescription = \"encode mindblowingly\"\n\n[d503361a-1433-48c0-aae0-d41b5baa33ff]\ndescription = \"encode numbers\"\n\n[79c8a2d5-0772-42d4-b41b-531d0b5da926]\ndescription = \"encode deep thought\"\n\n[9ca13d23-d32a-4967-a1fd-6100b8742bab]\ndescription = \"encode all the letters\"\n\n[bb50e087-7fdf-48e7-9223-284fe7e69851]\ndescription = \"decode exercism\"\n\n[ac021097-cd5d-4717-8907-b0814b9e292c]\ndescription = \"decode a sentence\"\n\n[18729de3-de74-49b8-b68c-025eaf77f851]\ndescription = \"decode numbers\"\n\n[0f30325f-f53b-415d-ad3e-a7a4f63de034]\ndescription = \"decode all the letters\"\n\n[39640287-30c6-4c8c-9bac-9d613d1a5674]\ndescription = \"decode with too many spaces\"\n\n[b34edf13-34c0-49b5-aa21-0768928000d5]\ndescription = \"decode with no spaces\"\n" }, { "path": "exercises/practice/atbash-cipher/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/atbash-cipher/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/atbash-cipher/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/atbash-cipher/atbash-cipher.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { encode, decode } from './atbash-cipher.ts'\n\ndescribe('AtbashCipher', () => {\n describe('encoding', () => {\n it('encode yes', () => {\n const cipherText = encode('yes')\n expect(cipherText).toEqual('bvh')\n })\n\n xit('encode no', () => {\n const cipherText = encode('no')\n expect(cipherText).toEqual('ml')\n })\n\n xit('encode OMG', () => {\n const cipherText = encode('OMG')\n expect(cipherText).toEqual('lnt')\n })\n\n xit('encode spaces', () => {\n const cipherText = encode('O M G')\n expect(cipherText).toEqual('lnt')\n })\n\n xit('encode mindblowingly', () => {\n const cipherText = encode('mindblowingly')\n expect(cipherText).toEqual('nrmwy oldrm tob')\n })\n\n xit('encode numbers', () => {\n const cipherText = encode('Testing,1 2 3, testing.')\n expect(cipherText).toEqual('gvhgr mt123 gvhgr mt')\n })\n\n xit('encode deep thought', () => {\n const cipherText = encode('Truth is fiction.')\n expect(cipherText).toEqual('gifgs rhurx grlm')\n })\n\n xit('encode all the letters', () => {\n const cipherText = encode('thequickbrownfoxjumpsoverthelazydog')\n expect(cipherText).toEqual('gsvjf rxpyi ldmul cqfnk hlevi gsvoz abwlt')\n })\n })\n\n xdescribe('decode', () => {\n xit('decode exercism', () => {\n const plainText = decode('vcvix rhn')\n expect(plainText).toEqual('exercism')\n })\n\n xit('decode a sentence', () => {\n const cipherText = decode('zmlyh gzxov rhlug vmzhg vkkrm thglm v')\n expect(cipherText).toEqual('anobstacleisoftenasteppingstone')\n })\n\n xit('decode numbers', () => {\n const plainText = decode('gvhgr mt123 gvhgr mt')\n expect(plainText).toEqual('testing123testing')\n })\n\n xit('decode all the letters', () => {\n const cipherText = decode('gsvjf rxpyi ldmul cqfnk hlevi gsvoz abwlt')\n expect(cipherText).toEqual('thequickbrownfoxjumpsoverthelazydog')\n })\n })\n})\n" }, { "path": "exercises/practice/atbash-cipher/atbash-cipher.ts", "content": "export function encode(plainText: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n\nexport function decode(cipherText: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/atbash-cipher/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/atbash-cipher/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/atbash-cipher/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/atbash-cipher/package.json", "content": "{\n \"name\": \"@exercism/typescript-atbash-cipher\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/atbash-cipher/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/atbash-cipher/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/bank-account/.docs/instructions.md", "content": "# Instructions\n\nYour task is to implement bank accounts supporting opening/closing, withdrawals, and deposits of money.\n\nAs bank accounts can be accessed in many different ways (internet, mobile phones, automatic charges), your bank software must allow accounts to be safely accessed from multiple threads/processes (terminology depends on your programming language) in parallel.\nFor example, there may be many deposits and withdrawals occurring in parallel; you need to ensure there are no [race conditions][wikipedia] between when you read the account balance and set the new balance.\n\nIt should be possible to close an account; operations against a closed account must fail.\n\n[wikipedia]: https://en.wikipedia.org/wiki/Race_condition#In_software\n" }, { "path": "exercises/practice/bank-account/.docs/introduction.md", "content": "# Introduction\n\nAfter years of filling out forms and waiting, you've finally acquired your banking license.\nThis means you are now officially eligible to open your own bank, hurray!\n\nYour first priority is to get the IT systems up and running.\nAfter a day of hard work, you can already open and close accounts, as well as handle withdrawals and deposits.\n\nSince you couldn't be bothered writing tests, you invite some friends to help test the system.\nHowever, after just five minutes, one of your friends claims they've lost money!\nWhile you're confident your code is bug-free, you start looking through the logs to investigate.\n\nAh yes, just as you suspected, your friend is at fault!\nThey shared their test credentials with another friend, and together they conspired to make deposits and withdrawals from the same account _in parallel_.\nWho would do such a thing?\n\nWhile you argue that it's physically _impossible_ for someone to access their account in parallel, your friend smugly notifies you that the banking rules _require_ you to support this.\nThus, no parallel banking support, no go-live signal.\nSighing, you create a mental note to work on this tomorrow.\nThis will set your launch date back at _least_ one more day, but well...\n" }, { "path": "exercises/practice/bank-account/.meta/config.json", "content": "{\n \"authors\": [\n \"therealowenrees\"\n ],\n \"files\": {\n \"solution\": [\n \"bank-account.ts\"\n ],\n \"test\": [\n \"bank-account.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Simulate a bank account supporting opening/closing, withdraws, and deposits of money. Watch out for concurrent transactions!\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/bank-account/.meta/proof.ci.ts", "content": "export class ValueError extends Error {\n constructor() {\n super('Bank account error')\n }\n}\n\nexport class BankAccount {\n private _isOpen: boolean\n private _balance: number\n\n constructor() {\n this._isOpen = false\n this._balance = 0\n }\n\n open(): void {\n if (this._isOpen) throw new ValueError()\n this._isOpen = true\n }\n\n close(): void {\n if (!this._isOpen) throw new ValueError()\n this._isOpen = false\n this._balance = 0\n }\n\n deposit(amount: number): void {\n if (!this._isOpen || amount < 0) throw new ValueError()\n this._balance += amount\n }\n\n withdraw(amount: number): void {\n if (!this._isOpen || amount < 0 || amount > this._balance)\n throw new ValueError()\n this._balance -= amount\n }\n\n get balance(): number {\n if (!this._isOpen) throw new ValueError()\n return this._balance\n }\n}\n" }, { "path": "exercises/practice/bank-account/.meta/solutions/bank-account.ts", "content": "export class ValueError extends Error {\n constructor() {\n super('Bank account error')\n }\n}\n\nexport class BankAccount {\n private _isOpen: boolean\n private _balance: number\n\n constructor() {\n this._isOpen = false\n this._balance = 0\n }\n\n open(): void {\n if (this._isOpen) throw new ValueError()\n this._isOpen = true\n }\n\n close(): void {\n if (!this._isOpen) throw new ValueError()\n this._isOpen = false\n this._balance = 0\n }\n\n deposit(amount: number): void {\n if (!this._isOpen || amount < 0) throw new ValueError()\n this._balance += amount\n }\n\n withdraw(amount: number): void {\n if (!this._isOpen || amount < 0 || amount > this._balance)\n throw new ValueError()\n this._balance -= amount\n }\n\n get balance(): number {\n if (!this._isOpen) throw new ValueError()\n return this._balance\n }\n}\n" }, { "path": "exercises/practice/bank-account/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[983a1528-4ceb-45e5-8257-8ce01aceb5ed]\ndescription = \"Newly opened account has zero balance\"\n\n[e88d4ec3-c6bf-4752-8e59-5046c44e3ba7]\ndescription = \"Single deposit\"\n\n[3d9147d4-63f4-4844-8d2b-1fee2e9a2a0d]\ndescription = \"Multiple deposits\"\n\n[08f1af07-27ae-4b38-aa19-770bde558064]\ndescription = \"Withdraw once\"\n\n[6f6d242f-8c31-4ac6-8995-a90d42cad59f]\ndescription = \"Withdraw twice\"\n\n[45161c94-a094-4c77-9cec-998b70429bda]\ndescription = \"Can do multiple operations sequentially\"\n\n[f9facfaa-d824-486e-8381-48832c4bbffd]\ndescription = \"Cannot check balance of closed account\"\n\n[7a65ba52-e35c-4fd2-8159-bda2bde6e59c]\ndescription = \"Cannot deposit into closed account\"\n\n[a0a1835d-faae-4ad4-a6f3-1fcc2121380b]\ndescription = \"Cannot deposit into unopened account\"\n\n[570dfaa5-0532-4c1f-a7d3-0f65c3265608]\ndescription = \"Cannot withdraw from closed account\"\n\n[c396d233-1c49-4272-98dc-7f502dbb9470]\ndescription = \"Cannot close an account that was not opened\"\n\n[c06f534f-bdc2-4a02-a388-1063400684de]\ndescription = \"Cannot open an already opened account\"\n\n[0722d404-6116-4f92-ba3b-da7f88f1669c]\ndescription = \"Reopened account does not retain balance\"\n\n[ec42245f-9361-4341-8231-a22e8d19c52f]\ndescription = \"Cannot withdraw more than deposited\"\n\n[4f381ef8-10ef-4507-8e1d-0631ecc8ee72]\ndescription = \"Cannot withdraw negative\"\n\n[d45df9ea-1db0-47f3-b18c-d365db49d938]\ndescription = \"Cannot deposit negative\"\n\n[ba0c1e0b-0f00-416f-8097-a7dfc97871ff]\ndescription = \"Can handle concurrent transactions\"\n" }, { "path": "exercises/practice/bank-account/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/bank-account/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/bank-account/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/bank-account/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/bank-account/bank-account.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { BankAccount, ValueError } from './bank-account.ts'\n\ndescribe('Bank Account', () => {\n it('newly opened account has zero balance', () => {\n const account = new BankAccount()\n account.open()\n expect(account.balance).toEqual(0)\n })\n\n xit('can deposit money', () => {\n const account = new BankAccount()\n account.open()\n account.deposit(100)\n expect(account.balance).toEqual(100)\n })\n\n xit('can deposit money sequentially', () => {\n const account = new BankAccount()\n account.open()\n account.deposit(100)\n account.deposit(50)\n expect(account.balance).toEqual(150)\n })\n\n xit('can withdraw money', () => {\n const account = new BankAccount()\n account.open()\n account.deposit(100)\n account.withdraw(50)\n expect(account.balance).toEqual(50)\n })\n\n xit('can withdraw money sequentially', () => {\n const account = new BankAccount()\n account.open()\n account.deposit(100)\n account.withdraw(20)\n account.withdraw(80)\n expect(account.balance).toEqual(0)\n })\n\n xit('checking balance of closed account throws error', () => {\n const account = new BankAccount()\n account.open()\n account.close()\n expect(() => account.balance).toThrow(ValueError)\n })\n\n xit('deposit into closed account throws error', () => {\n const account = new BankAccount()\n account.open()\n account.close()\n expect(() => {\n account.deposit(50)\n }).toThrow(ValueError)\n })\n\n xit('withdraw from closed account throws error', () => {\n const account = new BankAccount()\n account.open()\n account.close()\n expect(() => {\n account.withdraw(50)\n }).toThrow(ValueError)\n })\n\n xit('close already closed account throws error', () => {\n const account = new BankAccount()\n expect(() => {\n account.close()\n }).toThrow(ValueError)\n })\n\n xit('open already opened account throws error', () => {\n const account = new BankAccount()\n account.open()\n expect(() => {\n account.open()\n }).toThrow(ValueError)\n })\n\n xit('reopened account does not retain balance', () => {\n const account = new BankAccount()\n account.open()\n account.deposit(50)\n account.close()\n account.open()\n expect(account.balance).toEqual(0)\n })\n\n xit('cannot withdraw more than deposited', () => {\n const account = new BankAccount()\n account.open()\n account.deposit(25)\n expect(() => {\n account.withdraw(50)\n }).toThrow(ValueError)\n })\n\n xit('cannot withdraw negative amount', () => {\n const account = new BankAccount()\n account.open()\n account.deposit(100)\n expect(() => {\n account.withdraw(-50)\n }).toThrow(ValueError)\n })\n\n xit('cannot deposit negative amount', () => {\n const account = new BankAccount()\n account.open()\n expect(() => {\n account.deposit(-50)\n }).toThrow(ValueError)\n })\n\n xit('changing balance directly throws error', () => {\n const account = new BankAccount()\n account.open()\n expect(() => {\n // @ts-expect-error This is supposed to be a read-only property\n account.balance = 100\n }).toThrow(Error)\n })\n})\n" }, { "path": "exercises/practice/bank-account/bank-account.ts", "content": "//\n// This is only a SKELETON file for the 'Bank Account' exercise. It's been provided as a\n// convenience to get you started writing code faster.\n//\n\nexport class ValueError extends Error {\n constructor() {\n super('Bank account error')\n }\n}\n\nexport class BankAccount {\n constructor() {\n throw new Error('Remove this line and implement the function')\n }\n\n open(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n close(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n deposit(_argument: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n withdraw(_argument: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n get balance(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/bank-account/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/bank-account/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/bank-account/package.json", "content": "{\n \"name\": \"@exercism/typescript-bank-account\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/bank-account/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/bank-account/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/beer-song/.docs/instructions.md", "content": "# Instructions\n\nRecite the lyrics to that beloved classic, that field-trip favorite: 99 Bottles of Beer on the Wall.\n\nNote that not all verses are identical.\n\n```text\n99 bottles of beer on the wall, 99 bottles of beer.\nTake one down and pass it around, 98 bottles of beer on the wall.\n\n98 bottles of beer on the wall, 98 bottles of beer.\nTake one down and pass it around, 97 bottles of beer on the wall.\n\n97 bottles of beer on the wall, 97 bottles of beer.\nTake one down and pass it around, 96 bottles of beer on the wall.\n\n96 bottles of beer on the wall, 96 bottles of beer.\nTake one down and pass it around, 95 bottles of beer on the wall.\n\n95 bottles of beer on the wall, 95 bottles of beer.\nTake one down and pass it around, 94 bottles of beer on the wall.\n\n94 bottles of beer on the wall, 94 bottles of beer.\nTake one down and pass it around, 93 bottles of beer on the wall.\n\n93 bottles of beer on the wall, 93 bottles of beer.\nTake one down and pass it around, 92 bottles of beer on the wall.\n\n92 bottles of beer on the wall, 92 bottles of beer.\nTake one down and pass it around, 91 bottles of beer on the wall.\n\n91 bottles of beer on the wall, 91 bottles of beer.\nTake one down and pass it around, 90 bottles of beer on the wall.\n\n90 bottles of beer on the wall, 90 bottles of beer.\nTake one down and pass it around, 89 bottles of beer on the wall.\n\n89 bottles of beer on the wall, 89 bottles of beer.\nTake one down and pass it around, 88 bottles of beer on the wall.\n\n88 bottles of beer on the wall, 88 bottles of beer.\nTake one down and pass it around, 87 bottles of beer on the wall.\n\n87 bottles of beer on the wall, 87 bottles of beer.\nTake one down and pass it around, 86 bottles of beer on the wall.\n\n86 bottles of beer on the wall, 86 bottles of beer.\nTake one down and pass it around, 85 bottles of beer on the wall.\n\n85 bottles of beer on the wall, 85 bottles of beer.\nTake one down and pass it around, 84 bottles of beer on the wall.\n\n84 bottles of beer on the wall, 84 bottles of beer.\nTake one down and pass it around, 83 bottles of beer on the wall.\n\n83 bottles of beer on the wall, 83 bottles of beer.\nTake one down and pass it around, 82 bottles of beer on the wall.\n\n82 bottles of beer on the wall, 82 bottles of beer.\nTake one down and pass it around, 81 bottles of beer on the wall.\n\n81 bottles of beer on the wall, 81 bottles of beer.\nTake one down and pass it around, 80 bottles of beer on the wall.\n\n80 bottles of beer on the wall, 80 bottles of beer.\nTake one down and pass it around, 79 bottles of beer on the wall.\n\n79 bottles of beer on the wall, 79 bottles of beer.\nTake one down and pass it around, 78 bottles of beer on the wall.\n\n78 bottles of beer on the wall, 78 bottles of beer.\nTake one down and pass it around, 77 bottles of beer on the wall.\n\n77 bottles of beer on the wall, 77 bottles of beer.\nTake one down and pass it around, 76 bottles of beer on the wall.\n\n76 bottles of beer on the wall, 76 bottles of beer.\nTake one down and pass it around, 75 bottles of beer on the wall.\n\n75 bottles of beer on the wall, 75 bottles of beer.\nTake one down and pass it around, 74 bottles of beer on the wall.\n\n74 bottles of beer on the wall, 74 bottles of beer.\nTake one down and pass it around, 73 bottles of beer on the wall.\n\n73 bottles of beer on the wall, 73 bottles of beer.\nTake one down and pass it around, 72 bottles of beer on the wall.\n\n72 bottles of beer on the wall, 72 bottles of beer.\nTake one down and pass it around, 71 bottles of beer on the wall.\n\n71 bottles of beer on the wall, 71 bottles of beer.\nTake one down and pass it around, 70 bottles of beer on the wall.\n\n70 bottles of beer on the wall, 70 bottles of beer.\nTake one down and pass it around, 69 bottles of beer on the wall.\n\n69 bottles of beer on the wall, 69 bottles of beer.\nTake one down and pass it around, 68 bottles of beer on the wall.\n\n68 bottles of beer on the wall, 68 bottles of beer.\nTake one down and pass it around, 67 bottles of beer on the wall.\n\n67 bottles of beer on the wall, 67 bottles of beer.\nTake one down and pass it around, 66 bottles of beer on the wall.\n\n66 bottles of beer on the wall, 66 bottles of beer.\nTake one down and pass it around, 65 bottles of beer on the wall.\n\n65 bottles of beer on the wall, 65 bottles of beer.\nTake one down and pass it around, 64 bottles of beer on the wall.\n\n64 bottles of beer on the wall, 64 bottles of beer.\nTake one down and pass it around, 63 bottles of beer on the wall.\n\n63 bottles of beer on the wall, 63 bottles of beer.\nTake one down and pass it around, 62 bottles of beer on the wall.\n\n62 bottles of beer on the wall, 62 bottles of beer.\nTake one down and pass it around, 61 bottles of beer on the wall.\n\n61 bottles of beer on the wall, 61 bottles of beer.\nTake one down and pass it around, 60 bottles of beer on the wall.\n\n60 bottles of beer on the wall, 60 bottles of beer.\nTake one down and pass it around, 59 bottles of beer on the wall.\n\n59 bottles of beer on the wall, 59 bottles of beer.\nTake one down and pass it around, 58 bottles of beer on the wall.\n\n58 bottles of beer on the wall, 58 bottles of beer.\nTake one down and pass it around, 57 bottles of beer on the wall.\n\n57 bottles of beer on the wall, 57 bottles of beer.\nTake one down and pass it around, 56 bottles of beer on the wall.\n\n56 bottles of beer on the wall, 56 bottles of beer.\nTake one down and pass it around, 55 bottles of beer on the wall.\n\n55 bottles of beer on the wall, 55 bottles of beer.\nTake one down and pass it around, 54 bottles of beer on the wall.\n\n54 bottles of beer on the wall, 54 bottles of beer.\nTake one down and pass it around, 53 bottles of beer on the wall.\n\n53 bottles of beer on the wall, 53 bottles of beer.\nTake one down and pass it around, 52 bottles of beer on the wall.\n\n52 bottles of beer on the wall, 52 bottles of beer.\nTake one down and pass it around, 51 bottles of beer on the wall.\n\n51 bottles of beer on the wall, 51 bottles of beer.\nTake one down and pass it around, 50 bottles of beer on the wall.\n\n50 bottles of beer on the wall, 50 bottles of beer.\nTake one down and pass it around, 49 bottles of beer on the wall.\n\n49 bottles of beer on the wall, 49 bottles of beer.\nTake one down and pass it around, 48 bottles of beer on the wall.\n\n48 bottles of beer on the wall, 48 bottles of beer.\nTake one down and pass it around, 47 bottles of beer on the wall.\n\n47 bottles of beer on the wall, 47 bottles of beer.\nTake one down and pass it around, 46 bottles of beer on the wall.\n\n46 bottles of beer on the wall, 46 bottles of beer.\nTake one down and pass it around, 45 bottles of beer on the wall.\n\n45 bottles of beer on the wall, 45 bottles of beer.\nTake one down and pass it around, 44 bottles of beer on the wall.\n\n44 bottles of beer on the wall, 44 bottles of beer.\nTake one down and pass it around, 43 bottles of beer on the wall.\n\n43 bottles of beer on the wall, 43 bottles of beer.\nTake one down and pass it around, 42 bottles of beer on the wall.\n\n42 bottles of beer on the wall, 42 bottles of beer.\nTake one down and pass it around, 41 bottles of beer on the wall.\n\n41 bottles of beer on the wall, 41 bottles of beer.\nTake one down and pass it around, 40 bottles of beer on the wall.\n\n40 bottles of beer on the wall, 40 bottles of beer.\nTake one down and pass it around, 39 bottles of beer on the wall.\n\n39 bottles of beer on the wall, 39 bottles of beer.\nTake one down and pass it around, 38 bottles of beer on the wall.\n\n38 bottles of beer on the wall, 38 bottles of beer.\nTake one down and pass it around, 37 bottles of beer on the wall.\n\n37 bottles of beer on the wall, 37 bottles of beer.\nTake one down and pass it around, 36 bottles of beer on the wall.\n\n36 bottles of beer on the wall, 36 bottles of beer.\nTake one down and pass it around, 35 bottles of beer on the wall.\n\n35 bottles of beer on the wall, 35 bottles of beer.\nTake one down and pass it around, 34 bottles of beer on the wall.\n\n34 bottles of beer on the wall, 34 bottles of beer.\nTake one down and pass it around, 33 bottles of beer on the wall.\n\n33 bottles of beer on the wall, 33 bottles of beer.\nTake one down and pass it around, 32 bottles of beer on the wall.\n\n32 bottles of beer on the wall, 32 bottles of beer.\nTake one down and pass it around, 31 bottles of beer on the wall.\n\n31 bottles of beer on the wall, 31 bottles of beer.\nTake one down and pass it around, 30 bottles of beer on the wall.\n\n30 bottles of beer on the wall, 30 bottles of beer.\nTake one down and pass it around, 29 bottles of beer on the wall.\n\n29 bottles of beer on the wall, 29 bottles of beer.\nTake one down and pass it around, 28 bottles of beer on the wall.\n\n28 bottles of beer on the wall, 28 bottles of beer.\nTake one down and pass it around, 27 bottles of beer on the wall.\n\n27 bottles of beer on the wall, 27 bottles of beer.\nTake one down and pass it around, 26 bottles of beer on the wall.\n\n26 bottles of beer on the wall, 26 bottles of beer.\nTake one down and pass it around, 25 bottles of beer on the wall.\n\n25 bottles of beer on the wall, 25 bottles of beer.\nTake one down and pass it around, 24 bottles of beer on the wall.\n\n24 bottles of beer on the wall, 24 bottles of beer.\nTake one down and pass it around, 23 bottles of beer on the wall.\n\n23 bottles of beer on the wall, 23 bottles of beer.\nTake one down and pass it around, 22 bottles of beer on the wall.\n\n22 bottles of beer on the wall, 22 bottles of beer.\nTake one down and pass it around, 21 bottles of beer on the wall.\n\n21 bottles of beer on the wall, 21 bottles of beer.\nTake one down and pass it around, 20 bottles of beer on the wall.\n\n20 bottles of beer on the wall, 20 bottles of beer.\nTake one down and pass it around, 19 bottles of beer on the wall.\n\n19 bottles of beer on the wall, 19 bottles of beer.\nTake one down and pass it around, 18 bottles of beer on the wall.\n\n18 bottles of beer on the wall, 18 bottles of beer.\nTake one down and pass it around, 17 bottles of beer on the wall.\n\n17 bottles of beer on the wall, 17 bottles of beer.\nTake one down and pass it around, 16 bottles of beer on the wall.\n\n16 bottles of beer on the wall, 16 bottles of beer.\nTake one down and pass it around, 15 bottles of beer on the wall.\n\n15 bottles of beer on the wall, 15 bottles of beer.\nTake one down and pass it around, 14 bottles of beer on the wall.\n\n14 bottles of beer on the wall, 14 bottles of beer.\nTake one down and pass it around, 13 bottles of beer on the wall.\n\n13 bottles of beer on the wall, 13 bottles of beer.\nTake one down and pass it around, 12 bottles of beer on the wall.\n\n12 bottles of beer on the wall, 12 bottles of beer.\nTake one down and pass it around, 11 bottles of beer on the wall.\n\n11 bottles of beer on the wall, 11 bottles of beer.\nTake one down and pass it around, 10 bottles of beer on the wall.\n\n10 bottles of beer on the wall, 10 bottles of beer.\nTake one down and pass it around, 9 bottles of beer on the wall.\n\n9 bottles of beer on the wall, 9 bottles of beer.\nTake one down and pass it around, 8 bottles of beer on the wall.\n\n8 bottles of beer on the wall, 8 bottles of beer.\nTake one down and pass it around, 7 bottles of beer on the wall.\n\n7 bottles of beer on the wall, 7 bottles of beer.\nTake one down and pass it around, 6 bottles of beer on the wall.\n\n6 bottles of beer on the wall, 6 bottles of beer.\nTake one down and pass it around, 5 bottles of beer on the wall.\n\n5 bottles of beer on the wall, 5 bottles of beer.\nTake one down and pass it around, 4 bottles of beer on the wall.\n\n4 bottles of beer on the wall, 4 bottles of beer.\nTake one down and pass it around, 3 bottles of beer on the wall.\n\n3 bottles of beer on the wall, 3 bottles of beer.\nTake one down and pass it around, 2 bottles of beer on the wall.\n\n2 bottles of beer on the wall, 2 bottles of beer.\nTake one down and pass it around, 1 bottle of beer on the wall.\n\n1 bottle of beer on the wall, 1 bottle of beer.\nTake it down and pass it around, no more bottles of beer on the wall.\n\nNo more bottles of beer on the wall, no more bottles of beer.\nGo to the store and buy some more, 99 bottles of beer on the wall.\n```\n" }, { "path": "exercises/practice/beer-song/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"beer-song.ts\"\n ],\n \"test\": [\n \"beer-song.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Produce the lyrics to that beloved classic, that field-trip favorite: 99 Bottles of Beer on the Wall.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Learn to Program by Chris Pine\",\n \"source_url\": \"https://pine.fm/LearnToProgram/?Chapter=06\"\n}\n" }, { "path": "exercises/practice/beer-song/.meta/proof.ci.ts", "content": "function pluralize(input: number): string {\n if (input === 0) {\n return 'o more bottles '\n }\n\n return input === 1 ? '1 bottle ' : `${input} bottles `\n}\n\nexport function verse(input: number): string {\n const wall = 'of beer on the wall'\n if (input === 0) {\n return `N${pluralize(0)}${wall}, n${pluralize(0)}of beer.\nGo to the store and buy some more, ${pluralize(99)}${wall}.\n`\n }\n if (input === 1) {\n return `${pluralize(1)}${wall}, ${pluralize(1)}of beer.\nTake it down and pass it around, n${pluralize(0)}${wall}.\n`\n }\n return `${pluralize(input)}${wall}, ${pluralize(input)}of beer.\nTake one down and pass it around, ${pluralize(input - 1)}${wall}.\n`\n}\n\nexport function sing(end: number = 99, start: number = 0): string {\n let temp = ``\n for (let i: number = end; i >= start; i -= 1) {\n temp += verse(i)\n if (i !== start) {\n temp += '\\n'\n }\n }\n return temp\n}\n" }, { "path": "exercises/practice/beer-song/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[5a02fd08-d336-4607-8006-246fe6fa9fb0]\ndescription = \"first generic verse\"\n\n[77299ca6-545e-4217-a9cc-606b342e0187]\ndescription = \"last generic verse\"\n\n[102cbca0-b197-40fd-b548-e99609b06428]\ndescription = \"verse with 2 bottles\"\n\n[b8ef9fce-960e-4d85-a0c9-980a04ec1972]\ndescription = \"verse with 1 bottle\"\n\n[c59d4076-f671-4ee3-baaa-d4966801f90d]\ndescription = \"verse with 0 bottles\"\n\n[7e17c794-402d-4ca6-8f96-4d8f6ee1ec7e]\ndescription = \"first two verses\"\n\n[949868e7-67e8-43d3-9bb4-69277fe020fb]\ndescription = \"last three verses\"\n\n[bc220626-126c-4e72-8df4-fddfc0c3e458]\ndescription = \"all verses\"\n" }, { "path": "exercises/practice/beer-song/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/beer-song/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/beer-song/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/beer-song/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/beer-song/beer-song.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { verse, sing } from './beer-song.ts'\n\ndescribe('Beer', () => {\n it('prints an arbitrary verse', () => {\n const expected = `8 bottles of beer on the wall, 8 bottles of beer.\nTake one down and pass it around, 7 bottles of beer on the wall.\n`\n\n expect(verse(8)).toEqual(expected)\n })\n\n xit('handles 1 bottle', () => {\n const expected = `1 bottle of beer on the wall, 1 bottle of beer.\nTake it down and pass it around, no more bottles of beer on the wall.\n`\n expect(verse(1)).toEqual(expected)\n })\n\n xit('handles 0 bottles', () => {\n const expected = `No more bottles of beer on the wall, no more bottles of beer.\nGo to the store and buy some more, 99 bottles of beer on the wall.\n`\n expect(verse(0)).toEqual(expected)\n })\n\n xit('sings several verses', () => {\n const expected = `8 bottles of beer on the wall, 8 bottles of beer.\nTake one down and pass it around, 7 bottles of beer on the wall.\n\n7 bottles of beer on the wall, 7 bottles of beer.\nTake one down and pass it around, 6 bottles of beer on the wall.\n\n6 bottles of beer on the wall, 6 bottles of beer.\nTake one down and pass it around, 5 bottles of beer on the wall.\n`\n expect(sing(8, 6)).toEqual(expected)\n })\n\n xit('sings the rest of the verses', () => {\n const expected = `3 bottles of beer on the wall, 3 bottles of beer.\nTake one down and pass it around, 2 bottles of beer on the wall.\n\n2 bottles of beer on the wall, 2 bottles of beer.\nTake one down and pass it around, 1 bottle of beer on the wall.\n\n1 bottle of beer on the wall, 1 bottle of beer.\nTake it down and pass it around, no more bottles of beer on the wall.\n\nNo more bottles of beer on the wall, no more bottles of beer.\nGo to the store and buy some more, 99 bottles of beer on the wall.\n`\n expect(sing(3)).toEqual(expected)\n })\n\n xit('sings all the verses', () => {\n const song = sing()\n expect(song).toEqual(`99 bottles of beer on the wall, 99 bottles of beer.\nTake one down and pass it around, 98 bottles of beer on the wall.\n\n98 bottles of beer on the wall, 98 bottles of beer.\nTake one down and pass it around, 97 bottles of beer on the wall.\n\n97 bottles of beer on the wall, 97 bottles of beer.\nTake one down and pass it around, 96 bottles of beer on the wall.\n\n96 bottles of beer on the wall, 96 bottles of beer.\nTake one down and pass it around, 95 bottles of beer on the wall.\n\n95 bottles of beer on the wall, 95 bottles of beer.\nTake one down and pass it around, 94 bottles of beer on the wall.\n\n94 bottles of beer on the wall, 94 bottles of beer.\nTake one down and pass it around, 93 bottles of beer on the wall.\n\n93 bottles of beer on the wall, 93 bottles of beer.\nTake one down and pass it around, 92 bottles of beer on the wall.\n\n92 bottles of beer on the wall, 92 bottles of beer.\nTake one down and pass it around, 91 bottles of beer on the wall.\n\n91 bottles of beer on the wall, 91 bottles of beer.\nTake one down and pass it around, 90 bottles of beer on the wall.\n\n90 bottles of beer on the wall, 90 bottles of beer.\nTake one down and pass it around, 89 bottles of beer on the wall.\n\n89 bottles of beer on the wall, 89 bottles of beer.\nTake one down and pass it around, 88 bottles of beer on the wall.\n\n88 bottles of beer on the wall, 88 bottles of beer.\nTake one down and pass it around, 87 bottles of beer on the wall.\n\n87 bottles of beer on the wall, 87 bottles of beer.\nTake one down and pass it around, 86 bottles of beer on the wall.\n\n86 bottles of beer on the wall, 86 bottles of beer.\nTake one down and pass it around, 85 bottles of beer on the wall.\n\n85 bottles of beer on the wall, 85 bottles of beer.\nTake one down and pass it around, 84 bottles of beer on the wall.\n\n84 bottles of beer on the wall, 84 bottles of beer.\nTake one down and pass it around, 83 bottles of beer on the wall.\n\n83 bottles of beer on the wall, 83 bottles of beer.\nTake one down and pass it around, 82 bottles of beer on the wall.\n\n82 bottles of beer on the wall, 82 bottles of beer.\nTake one down and pass it around, 81 bottles of beer on the wall.\n\n81 bottles of beer on the wall, 81 bottles of beer.\nTake one down and pass it around, 80 bottles of beer on the wall.\n\n80 bottles of beer on the wall, 80 bottles of beer.\nTake one down and pass it around, 79 bottles of beer on the wall.\n\n79 bottles of beer on the wall, 79 bottles of beer.\nTake one down and pass it around, 78 bottles of beer on the wall.\n\n78 bottles of beer on the wall, 78 bottles of beer.\nTake one down and pass it around, 77 bottles of beer on the wall.\n\n77 bottles of beer on the wall, 77 bottles of beer.\nTake one down and pass it around, 76 bottles of beer on the wall.\n\n76 bottles of beer on the wall, 76 bottles of beer.\nTake one down and pass it around, 75 bottles of beer on the wall.\n\n75 bottles of beer on the wall, 75 bottles of beer.\nTake one down and pass it around, 74 bottles of beer on the wall.\n\n74 bottles of beer on the wall, 74 bottles of beer.\nTake one down and pass it around, 73 bottles of beer on the wall.\n\n73 bottles of beer on the wall, 73 bottles of beer.\nTake one down and pass it around, 72 bottles of beer on the wall.\n\n72 bottles of beer on the wall, 72 bottles of beer.\nTake one down and pass it around, 71 bottles of beer on the wall.\n\n71 bottles of beer on the wall, 71 bottles of beer.\nTake one down and pass it around, 70 bottles of beer on the wall.\n\n70 bottles of beer on the wall, 70 bottles of beer.\nTake one down and pass it around, 69 bottles of beer on the wall.\n\n69 bottles of beer on the wall, 69 bottles of beer.\nTake one down and pass it around, 68 bottles of beer on the wall.\n\n68 bottles of beer on the wall, 68 bottles of beer.\nTake one down and pass it around, 67 bottles of beer on the wall.\n\n67 bottles of beer on the wall, 67 bottles of beer.\nTake one down and pass it around, 66 bottles of beer on the wall.\n\n66 bottles of beer on the wall, 66 bottles of beer.\nTake one down and pass it around, 65 bottles of beer on the wall.\n\n65 bottles of beer on the wall, 65 bottles of beer.\nTake one down and pass it around, 64 bottles of beer on the wall.\n\n64 bottles of beer on the wall, 64 bottles of beer.\nTake one down and pass it around, 63 bottles of beer on the wall.\n\n63 bottles of beer on the wall, 63 bottles of beer.\nTake one down and pass it around, 62 bottles of beer on the wall.\n\n62 bottles of beer on the wall, 62 bottles of beer.\nTake one down and pass it around, 61 bottles of beer on the wall.\n\n61 bottles of beer on the wall, 61 bottles of beer.\nTake one down and pass it around, 60 bottles of beer on the wall.\n\n60 bottles of beer on the wall, 60 bottles of beer.\nTake one down and pass it around, 59 bottles of beer on the wall.\n\n59 bottles of beer on the wall, 59 bottles of beer.\nTake one down and pass it around, 58 bottles of beer on the wall.\n\n58 bottles of beer on the wall, 58 bottles of beer.\nTake one down and pass it around, 57 bottles of beer on the wall.\n\n57 bottles of beer on the wall, 57 bottles of beer.\nTake one down and pass it around, 56 bottles of beer on the wall.\n\n56 bottles of beer on the wall, 56 bottles of beer.\nTake one down and pass it around, 55 bottles of beer on the wall.\n\n55 bottles of beer on the wall, 55 bottles of beer.\nTake one down and pass it around, 54 bottles of beer on the wall.\n\n54 bottles of beer on the wall, 54 bottles of beer.\nTake one down and pass it around, 53 bottles of beer on the wall.\n\n53 bottles of beer on the wall, 53 bottles of beer.\nTake one down and pass it around, 52 bottles of beer on the wall.\n\n52 bottles of beer on the wall, 52 bottles of beer.\nTake one down and pass it around, 51 bottles of beer on the wall.\n\n51 bottles of beer on the wall, 51 bottles of beer.\nTake one down and pass it around, 50 bottles of beer on the wall.\n\n50 bottles of beer on the wall, 50 bottles of beer.\nTake one down and pass it around, 49 bottles of beer on the wall.\n\n49 bottles of beer on the wall, 49 bottles of beer.\nTake one down and pass it around, 48 bottles of beer on the wall.\n\n48 bottles of beer on the wall, 48 bottles of beer.\nTake one down and pass it around, 47 bottles of beer on the wall.\n\n47 bottles of beer on the wall, 47 bottles of beer.\nTake one down and pass it around, 46 bottles of beer on the wall.\n\n46 bottles of beer on the wall, 46 bottles of beer.\nTake one down and pass it around, 45 bottles of beer on the wall.\n\n45 bottles of beer on the wall, 45 bottles of beer.\nTake one down and pass it around, 44 bottles of beer on the wall.\n\n44 bottles of beer on the wall, 44 bottles of beer.\nTake one down and pass it around, 43 bottles of beer on the wall.\n\n43 bottles of beer on the wall, 43 bottles of beer.\nTake one down and pass it around, 42 bottles of beer on the wall.\n\n42 bottles of beer on the wall, 42 bottles of beer.\nTake one down and pass it around, 41 bottles of beer on the wall.\n\n41 bottles of beer on the wall, 41 bottles of beer.\nTake one down and pass it around, 40 bottles of beer on the wall.\n\n40 bottles of beer on the wall, 40 bottles of beer.\nTake one down and pass it around, 39 bottles of beer on the wall.\n\n39 bottles of beer on the wall, 39 bottles of beer.\nTake one down and pass it around, 38 bottles of beer on the wall.\n\n38 bottles of beer on the wall, 38 bottles of beer.\nTake one down and pass it around, 37 bottles of beer on the wall.\n\n37 bottles of beer on the wall, 37 bottles of beer.\nTake one down and pass it around, 36 bottles of beer on the wall.\n\n36 bottles of beer on the wall, 36 bottles of beer.\nTake one down and pass it around, 35 bottles of beer on the wall.\n\n35 bottles of beer on the wall, 35 bottles of beer.\nTake one down and pass it around, 34 bottles of beer on the wall.\n\n34 bottles of beer on the wall, 34 bottles of beer.\nTake one down and pass it around, 33 bottles of beer on the wall.\n\n33 bottles of beer on the wall, 33 bottles of beer.\nTake one down and pass it around, 32 bottles of beer on the wall.\n\n32 bottles of beer on the wall, 32 bottles of beer.\nTake one down and pass it around, 31 bottles of beer on the wall.\n\n31 bottles of beer on the wall, 31 bottles of beer.\nTake one down and pass it around, 30 bottles of beer on the wall.\n\n30 bottles of beer on the wall, 30 bottles of beer.\nTake one down and pass it around, 29 bottles of beer on the wall.\n\n29 bottles of beer on the wall, 29 bottles of beer.\nTake one down and pass it around, 28 bottles of beer on the wall.\n\n28 bottles of beer on the wall, 28 bottles of beer.\nTake one down and pass it around, 27 bottles of beer on the wall.\n\n27 bottles of beer on the wall, 27 bottles of beer.\nTake one down and pass it around, 26 bottles of beer on the wall.\n\n26 bottles of beer on the wall, 26 bottles of beer.\nTake one down and pass it around, 25 bottles of beer on the wall.\n\n25 bottles of beer on the wall, 25 bottles of beer.\nTake one down and pass it around, 24 bottles of beer on the wall.\n\n24 bottles of beer on the wall, 24 bottles of beer.\nTake one down and pass it around, 23 bottles of beer on the wall.\n\n23 bottles of beer on the wall, 23 bottles of beer.\nTake one down and pass it around, 22 bottles of beer on the wall.\n\n22 bottles of beer on the wall, 22 bottles of beer.\nTake one down and pass it around, 21 bottles of beer on the wall.\n\n21 bottles of beer on the wall, 21 bottles of beer.\nTake one down and pass it around, 20 bottles of beer on the wall.\n\n20 bottles of beer on the wall, 20 bottles of beer.\nTake one down and pass it around, 19 bottles of beer on the wall.\n\n19 bottles of beer on the wall, 19 bottles of beer.\nTake one down and pass it around, 18 bottles of beer on the wall.\n\n18 bottles of beer on the wall, 18 bottles of beer.\nTake one down and pass it around, 17 bottles of beer on the wall.\n\n17 bottles of beer on the wall, 17 bottles of beer.\nTake one down and pass it around, 16 bottles of beer on the wall.\n\n16 bottles of beer on the wall, 16 bottles of beer.\nTake one down and pass it around, 15 bottles of beer on the wall.\n\n15 bottles of beer on the wall, 15 bottles of beer.\nTake one down and pass it around, 14 bottles of beer on the wall.\n\n14 bottles of beer on the wall, 14 bottles of beer.\nTake one down and pass it around, 13 bottles of beer on the wall.\n\n13 bottles of beer on the wall, 13 bottles of beer.\nTake one down and pass it around, 12 bottles of beer on the wall.\n\n12 bottles of beer on the wall, 12 bottles of beer.\nTake one down and pass it around, 11 bottles of beer on the wall.\n\n11 bottles of beer on the wall, 11 bottles of beer.\nTake one down and pass it around, 10 bottles of beer on the wall.\n\n10 bottles of beer on the wall, 10 bottles of beer.\nTake one down and pass it around, 9 bottles of beer on the wall.\n\n9 bottles of beer on the wall, 9 bottles of beer.\nTake one down and pass it around, 8 bottles of beer on the wall.\n\n8 bottles of beer on the wall, 8 bottles of beer.\nTake one down and pass it around, 7 bottles of beer on the wall.\n\n7 bottles of beer on the wall, 7 bottles of beer.\nTake one down and pass it around, 6 bottles of beer on the wall.\n\n6 bottles of beer on the wall, 6 bottles of beer.\nTake one down and pass it around, 5 bottles of beer on the wall.\n\n5 bottles of beer on the wall, 5 bottles of beer.\nTake one down and pass it around, 4 bottles of beer on the wall.\n\n4 bottles of beer on the wall, 4 bottles of beer.\nTake one down and pass it around, 3 bottles of beer on the wall.\n\n3 bottles of beer on the wall, 3 bottles of beer.\nTake one down and pass it around, 2 bottles of beer on the wall.\n\n2 bottles of beer on the wall, 2 bottles of beer.\nTake one down and pass it around, 1 bottle of beer on the wall.\n\n1 bottle of beer on the wall, 1 bottle of beer.\nTake it down and pass it around, no more bottles of beer on the wall.\n\nNo more bottles of beer on the wall, no more bottles of beer.\nGo to the store and buy some more, 99 bottles of beer on the wall.\n`)\n })\n})\n" }, { "path": "exercises/practice/beer-song/beer-song.ts", "content": "export function verse(index: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n\nexport function sing(\n initialBottlesCount?: unknown,\n takeDownCount?: unknown\n): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/beer-song/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/beer-song/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/beer-song/package.json", "content": "{\n \"name\": \"@exercism/typescript-beer-song\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/beer-song/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/beer-song/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/binary-search/.docs/instructions.md", "content": "# Instructions\n\nYour task is to implement a binary search algorithm.\n\nA binary search algorithm finds an item in a list by repeatedly splitting it in half, only keeping the half which contains the item we're looking for.\nIt allows us to quickly narrow down the possible locations of our item until we find it, or until we've eliminated all possible locations.\n\n~~~~exercism/caution\nBinary search only works when a list has been sorted.\n~~~~\n\nThe algorithm looks like this:\n\n- Find the middle element of a _sorted_ list and compare it with the item we're looking for.\n- If the middle element is our item, then we're done!\n- If the middle element is greater than our item, we can eliminate that element and all the elements **after** it.\n- If the middle element is less than our item, we can eliminate that element and all the elements **before** it.\n- If every element of the list has been eliminated then the item is not in the list.\n- Otherwise, repeat the process on the part of the list that has not been eliminated.\n\nHere's an example:\n\nLet's say we're looking for the number 23 in the following sorted list: `[4, 8, 12, 16, 23, 28, 32]`.\n\n- We start by comparing 23 with the middle element, 16.\n- Since 23 is greater than 16, we can eliminate the left half of the list, leaving us with `[23, 28, 32]`.\n- We then compare 23 with the new middle element, 28.\n- Since 23 is less than 28, we can eliminate the right half of the list: `[23]`.\n- We've found our item.\n" }, { "path": "exercises/practice/binary-search/.docs/introduction.md", "content": "# Introduction\n\nYou have stumbled upon a group of mathematicians who are also singer-songwriters.\nThey have written a song for each of their favorite numbers, and, as you can imagine, they have a lot of favorite numbers (like [0][zero] or [73][seventy-three] or [6174][kaprekars-constant]).\n\nYou are curious to hear the song for your favorite number, but with so many songs to wade through, finding the right song could take a while.\nFortunately, they have organized their songs in a playlist sorted by the title ā€” which is simply the number that the song is about.\n\nYou realize that you can use a binary search algorithm to quickly find a song given the title.\n\n[zero]: https://en.wikipedia.org/wiki/0\n[seventy-three]: https://en.wikipedia.org/wiki/73_(number)\n[kaprekars-constant]: https://en.wikipedia.org/wiki/6174_(number)\n" }, { "path": "exercises/practice/binary-search/.meta/config.json", "content": "{\n \"authors\": [\n \"anuragsoni\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"binary-search.ts\"\n ],\n \"test\": [\n \"binary-search.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement a binary search algorithm.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Binary_search_algorithm\"\n}\n" }, { "path": "exercises/practice/binary-search/.meta/proof.ci.ts", "content": "export function find(array: number[], element: number): number | never {\n let start = 0\n let end = array.length - 1\n let middle: number\n\n while (start <= end) {\n middle = Math.floor((start + end) / 2)\n if (element === array[middle]) {\n return middle\n } else if (element < array[middle]) {\n end = middle - 1\n } else if (element > array[middle]) {\n start = middle + 1\n }\n }\n\n throw new Error('Value not in array')\n}\n" }, { "path": "exercises/practice/binary-search/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[b55c24a9-a98d-4379-a08c-2adcf8ebeee8]\ndescription = \"finds a value in an array with one element\"\n\n[73469346-b0a0-4011-89bf-989e443d503d]\ndescription = \"finds a value in the middle of an array\"\n\n[327bc482-ab85-424e-a724-fb4658e66ddb]\ndescription = \"finds a value at the beginning of an array\"\n\n[f9f94b16-fe5e-472c-85ea-c513804c7d59]\ndescription = \"finds a value at the end of an array\"\n\n[f0068905-26e3-4342-856d-ad153cadb338]\ndescription = \"finds a value in an array of odd length\"\n\n[fc316b12-c8b3-4f5e-9e89-532b3389de8c]\ndescription = \"finds a value in an array of even length\"\n\n[da7db20a-354f-49f7-a6a1-650a54998aa6]\ndescription = \"identifies that a value is not included in the array\"\n\n[95d869ff-3daf-4c79-b622-6e805c675f97]\ndescription = \"a value smaller than the array's smallest value is not found\"\n\n[8b24ef45-6e51-4a94-9eac-c2bf38fdb0ba]\ndescription = \"a value larger than the array's largest value is not found\"\n\n[f439a0fa-cf42-4262-8ad1-64bf41ce566a]\ndescription = \"nothing is found in an empty array\"\n\n[2c353967-b56d-40b8-acff-ce43115eed64]\ndescription = \"nothing is found when the left and right bounds cross\"\n" }, { "path": "exercises/practice/binary-search/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/binary-search/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/binary-search/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/binary-search/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/binary-search/binary-search.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { find } from './binary-search.ts'\n\ndescribe('Binary Search', () => {\n it('finds a value in an array with one element', () => {\n expect(find([6], 6)).toEqual(0)\n })\n\n xit('finds a value in the middle of an array', () => {\n const array = [1, 3, 4, 6, 8, 9, 11]\n expect(find(array, 6)).toEqual(3)\n })\n\n xit('finds a value at the beginning of an array', () => {\n const array = [1, 3, 4, 6, 8, 9, 11]\n expect(find(array, 1)).toEqual(0)\n })\n\n xit('finds a value at the end of an array', () => {\n const array = [1, 3, 4, 6, 8, 9, 11]\n expect(find(array, 11)).toEqual(6)\n })\n\n xit('finds a value in an array of odd length', () => {\n const array = [1, 3, 5, 8, 13, 21, 34, 55, 89, 144, 233, 377, 634]\n expect(find(array, 144)).toEqual(9)\n })\n\n xit('finds a value in an array of even length', () => {\n const array = [1, 3, 5, 8, 13, 21, 34, 55, 89, 144, 233, 377]\n expect(find(array, 21)).toEqual(5)\n })\n\n xit('identifies that a value is not included in the array', () => {\n const array = [1, 3, 4, 6, 8, 9, 11]\n expect(() => find(array, 7)).toThrow(new Error('Value not in array'))\n })\n\n xit(\"a value smaller than the array's smallest value is not found\", () => {\n const array = [1, 3, 4, 6, 8, 9, 11]\n expect(() => find(array, 0)).toThrow(new Error('Value not in array'))\n })\n\n xit(\"a value larger than the array's largest value is not found\", () => {\n const array = [1, 3, 4, 6, 8, 9, 11]\n expect(() => find(array, 13)).toThrow(new Error('Value not in array'))\n })\n\n xit('nothing is found in an empty array', () => {\n expect(() => find([], 1)).toThrow(new Error('Value not in array'))\n })\n\n xit('nothing is found when the left and right bounds cross', () => {\n expect(() => find([1, 2], 0)).toThrow(new Error('Value not in array'))\n })\n})\n" }, { "path": "exercises/practice/binary-search/binary-search.ts", "content": "export function find(haystack: unknown, needle: unknown): number | never {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/binary-search/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/binary-search/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/binary-search/package.json", "content": "{\n \"name\": \"@exercism/typescript-binary-search\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/binary-search/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/binary-search/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/binary-search-tree/.docs/instructions.md", "content": "# Instructions\n\nInsert and search for numbers in a binary tree.\n\nWhen we need to represent sorted data, an array does not make a good data structure.\n\nSay we have the array `[1, 3, 4, 5]`, and we add 2 to it so it becomes `[1, 3, 4, 5, 2]`.\nNow we must sort the entire array again!\nWe can improve on this by realizing that we only need to make space for the new item `[1, nil, 3, 4, 5]`, and then adding the item in the space we added.\nBut this still requires us to shift many elements down by one.\n\nBinary Search Trees, however, can operate on sorted data much more efficiently.\n\nA binary search tree consists of a series of connected nodes.\nEach node contains a piece of data (e.g. the number 3), a variable named `left`, and a variable named `right`.\nThe `left` and `right` variables point at `nil`, or other nodes.\nSince these other nodes in turn have other nodes beneath them, we say that the left and right variables are pointing at subtrees.\nAll data in the left subtree is less than or equal to the current node's data, and all data in the right subtree is greater than the current node's data.\n\nFor example, if we had a node containing the data 4, and we added the data 2, our tree would look like this:\n\n![A graph with root node 4 and a single child node 2.](https://assets.exercism.org/images/exercises/binary-search-tree/tree-4-2.svg)\n\n```text\n 4\n /\n 2\n```\n\nIf we then added 6, it would look like this:\n\n![A graph with root node 4 and two child nodes 2 and 6.](https://assets.exercism.org/images/exercises/binary-search-tree/tree-4-2-6.svg)\n\n```text\n 4\n / \\\n 2 6\n```\n\nIf we then added 3, it would look like this\n\n![A graph with root node 4, two child nodes 2 and 6, and a grandchild node 3.](https://assets.exercism.org/images/exercises/binary-search-tree/tree-4-2-6-3.svg)\n\n```text\n 4\n / \\\n 2 6\n \\\n 3\n```\n\nAnd if we then added 1, 5, and 7, it would look like this\n\n![A graph with root node 4, two child nodes 2 and 6, and four grandchild nodes 1, 3, 5 and 7.](https://assets.exercism.org/images/exercises/binary-search-tree/tree-4-2-6-1-3-5-7.svg)\n\n```text\n 4\n / \\\n / \\\n 2 6\n / \\ / \\\n 1 3 5 7\n```\n\n## Credit\n\nThe images were created by [habere-et-dispertire][habere-et-dispertire] using [PGF/TikZ][pgf-tikz] by Till Tantau.\n\n[habere-et-dispertire]: https://exercism.org/profiles/habere-et-dispertire\n[pgf-tikz]: https://en.wikipedia.org/wiki/PGF/TikZ\n" }, { "path": "exercises/practice/binary-search-tree/.meta/config.json", "content": "{\n \"authors\": [\n \"Sn0wFox\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"peerreynders\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"binary-search-tree.ts\"\n ],\n \"test\": [\n \"binary-search-tree.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Insert and search for numbers in a binary tree.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Josh Cheek\"\n}\n" }, { "path": "exercises/practice/binary-search-tree/.meta/proof.ci.ts", "content": "type BinarySearchTreeMaybe = BinarySearchTree | undefined\ntype EachFn = (data: number) => void\n\nexport class BinarySearchTree {\n private readonly _data: number\n private _left?: BinarySearchTree\n private _right?: BinarySearchTree\n\n constructor(data: number) {\n this._data = data\n }\n\n public insert(value: number): this {\n if (value <= this._data) {\n if (this._left) this._left.insert(value)\n else this._left = new BinarySearchTree(value)\n } else {\n if (this._right) this._right.insert(value)\n else this._right = new BinarySearchTree(value)\n }\n\n return this\n }\n\n public each(fn: EachFn): void {\n if (this._left) this._left.each(fn)\n fn(this._data)\n if (this._right) this._right.each(fn)\n }\n\n public get data(): number {\n return this._data\n }\n\n public get left(): BinarySearchTreeMaybe {\n return this._left\n }\n\n public get right(): BinarySearchTreeMaybe {\n return this._right\n }\n}\n" }, { "path": "exercises/practice/binary-search-tree/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[e9c93a78-c536-4750-a336-94583d23fafa]\ndescription = \"data is retained\"\n\n[7a95c9e8-69f6-476a-b0c4-4170cb3f7c91]\ndescription = \"smaller number at left node\"\n\n[22b89499-9805-4703-a159-1a6e434c1585]\ndescription = \"same number at left node\"\n\n[2e85fdde-77b1-41ed-b6ac-26ce6b663e34]\ndescription = \"greater number at right node\"\n\n[dd898658-40ab-41d0-965e-7f145bf66e0b]\ndescription = \"can create complex tree\"\n\n[9e0c06ef-aeca-4202-b8e4-97f1ed057d56]\ndescription = \"can sort single number\"\n\n[425e6d07-fceb-4681-a4f4-e46920e380bb]\ndescription = \"can sort if second number is smaller than first\"\n\n[bd7532cc-6988-4259-bac8-1d50140079ab]\ndescription = \"can sort if second number is same as first\"\n\n[b6d1b3a5-9d79-44fd-9013-c83ca92ddd36]\ndescription = \"can sort if second number is greater than first\"\n\n[d00ec9bd-1288-4171-b968-d44d0808c1c8]\ndescription = \"can sort complex tree\"\n" }, { "path": "exercises/practice/binary-search-tree/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/binary-search-tree/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/binary-search-tree/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/binary-search-tree/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/binary-search-tree/binary-search-tree.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { BinarySearchTree } from './binary-search-tree.ts'\n\nfunction recordAllData(bst: BinarySearchTree): unknown[] {\n const out: unknown[] = []\n bst.each((data) => {\n out.push(data)\n })\n return out\n}\n\ndescribe('BinarySearchTree', () => {\n it('should retain data', () => {\n expect(new BinarySearchTree(4).data).toEqual(4)\n })\n\n xit('should insert a lesser number to the left', () => {\n const four = new BinarySearchTree(4)\n four.insert(2)\n\n expect(four.data).toEqual(4)\n expect(four.left!.data).toEqual(2)\n })\n\n xit('should insert the same number to the left', () => {\n const four = new BinarySearchTree(4)\n four.insert(4)\n\n expect(four.data).toEqual(4)\n expect(four.left!.data).toEqual(4)\n })\n\n xit('should insert a greater number to the right', () => {\n const four = new BinarySearchTree(4)\n four.insert(5)\n\n expect(four.data).toEqual(4)\n expect(four.right!.data).toEqual(5)\n })\n\n xit('should deal with a complex tree', () => {\n const four = new BinarySearchTree(4)\n four.insert(2)\n four.insert(6)\n four.insert(1)\n four.insert(3)\n four.insert(7)\n four.insert(5)\n\n expect(four.data).toEqual(4)\n expect(four.left!.data).toEqual(2)\n expect(four.left!.left!.data).toEqual(1)\n expect(four.left!.right!.data).toEqual(3)\n expect(four.right!.data).toEqual(6)\n expect(four.right!.left!.data).toEqual(5)\n expect(four.right!.right!.data).toEqual(7)\n })\n\n xit('should iterate over one element', () => {\n expect(recordAllData(new BinarySearchTree(4))).toEqual([4])\n })\n\n xit('should iterate over smaller element', () => {\n const four = new BinarySearchTree(4)\n four.insert(2)\n\n expect(recordAllData(four)).toEqual([2, 4])\n })\n\n xit('should iterate over larger element', () => {\n const four = new BinarySearchTree(4)\n four.insert(5)\n\n expect(recordAllData(four)).toEqual([4, 5])\n })\n\n xit('should iterate over complex tree', () => {\n const four = new BinarySearchTree(4)\n four.insert(2)\n four.insert(1)\n four.insert(3)\n four.insert(6)\n four.insert(7)\n four.insert(5)\n\n expect(recordAllData(four)).toEqual([1, 2, 3, 4, 5, 6, 7])\n })\n})\n" }, { "path": "exercises/practice/binary-search-tree/binary-search-tree.ts", "content": "export class BinarySearchTree {\n constructor(data: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public get data(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public get right(): BinarySearchTree | undefined {\n throw new Error('Remove this line and implement the function')\n }\n\n public get left(): BinarySearchTree | undefined {\n throw new Error('Remove this line and implement the function')\n }\n\n public insert(item: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public each(callback: (data: unknown) => unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/binary-search-tree/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/binary-search-tree/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/binary-search-tree/package.json", "content": "{\n \"name\": \"@exercism/typescript-binary-search-tree\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/binary-search-tree/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/binary-search-tree/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/bob/.docs/instructions.md", "content": "# Instructions\n\nYour task is to determine what Bob will reply to someone when they say something to him or ask him a question.\n\nBob only ever answers one of five things:\n\n- **\"Sure.\"**\n This is his response if you ask him a question, such as \"How are you?\"\n The convention used for questions is that it ends with a question mark.\n- **\"Whoa, chill out!\"**\n This is his answer if you YELL AT HIM.\n The convention used for yelling is ALL CAPITAL LETTERS.\n- **\"Calm down, I know what I'm doing!\"**\n This is what he says if you yell a question at him.\n- **\"Fine. Be that way!\"**\n This is how he responds to silence.\n The convention used for silence is nothing, or various combinations of whitespace characters.\n- **\"Whatever.\"**\n This is what he answers to anything else.\n" }, { "path": "exercises/practice/bob/.docs/introduction.md", "content": "# Introduction\n\nBob is a [lackadaisical][] teenager.\nHe likes to think that he's very cool.\nAnd he definitely doesn't get excited about things.\nThat wouldn't be cool.\n\nWhen people talk to him, his responses are pretty limited.\n\n[lackadaisical]: https://www.collinsdictionary.com/dictionary/english/lackadaisical\n" }, { "path": "exercises/practice/bob/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"amscotti\",\n \"DFXLuna\",\n \"kytrinyx\",\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"bob.ts\"\n ],\n \"test\": [\n \"bob.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Bob is a lackadaisical teenager. In conversation, his responses are very limited.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Inspired by the 'Deaf Grandma' exercise in Chris Pine's Learn to Program tutorial.\",\n \"source_url\": \"https://pine.fm/LearnToProgram/chap_06.html\"\n}\n" }, { "path": "exercises/practice/bob/.meta/description.md", "content": "# Description\n\nBob is a lackadaisical teenager. In conversation, his responses are very limited.\n\nBob answers 'Sure.' if you ask him a question.\n\nHe answers 'Whoa, chill out!' if you yell at him.\n\nHe says 'Fine. Be that way!' if you address him without actually saying\nanything.\n\nHe answers 'Whatever.' to anything else.\n" }, { "path": "exercises/practice/bob/.meta/proof.ci.ts", "content": "function isYelling(message: string): boolean {\n return message.toUpperCase() === message && message.toLowerCase() !== message\n}\n\nfunction isQuestion(message: string): boolean {\n return message.trim().slice(-1) === '?'\n}\n\nfunction isSilence(message: string): boolean {\n return message.trim().length === 0\n}\n\nexport function hey(message: string): string {\n if (isYelling(message) && isQuestion(message)) {\n return \"Calm down, I know what I'm doing!\"\n }\n\n if (isYelling(message)) {\n return 'Whoa, chill out!'\n }\n\n if (isQuestion(message)) {\n return 'Sure.'\n }\n\n if (isSilence(message)) {\n return 'Fine. Be that way!'\n }\n\n return 'Whatever.'\n}\n" }, { "path": "exercises/practice/bob/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[e162fead-606f-437a-a166-d051915cea8e]\ndescription = \"stating something\"\n\n[73a966dc-8017-47d6-bb32-cf07d1a5fcd9]\ndescription = \"shouting\"\n\n[d6c98afd-df35-4806-b55e-2c457c3ab748]\ndescription = \"shouting gibberish\"\n\n[8a2e771d-d6f1-4e3f-b6c6-b41495556e37]\ndescription = \"asking a question\"\n\n[81080c62-4e4d-4066-b30a-48d8d76920d9]\ndescription = \"asking a numeric question\"\n\n[2a02716d-685b-4e2e-a804-2adaf281c01e]\ndescription = \"asking gibberish\"\n\n[c02f9179-ab16-4aa7-a8dc-940145c385f7]\ndescription = \"talking forcefully\"\n\n[153c0e25-9bb5-4ec5-966e-598463658bcd]\ndescription = \"using acronyms in regular speech\"\n\n[a5193c61-4a92-4f68-93e2-f554eb385ec6]\ndescription = \"forceful question\"\n\n[a20e0c54-2224-4dde-8b10-bd2cdd4f61bc]\ndescription = \"shouting numbers\"\n\n[f7bc4b92-bdff-421e-a238-ae97f230ccac]\ndescription = \"no letters\"\n\n[bb0011c5-cd52-4a5b-8bfb-a87b6283b0e2]\ndescription = \"question with no letters\"\n\n[496143c8-1c31-4c01-8a08-88427af85c66]\ndescription = \"shouting with special characters\"\n\n[e6793c1c-43bd-4b8d-bc11-499aea73925f]\ndescription = \"shouting with no exclamation mark\"\n\n[aa8097cc-c548-4951-8856-14a404dd236a]\ndescription = \"statement containing question mark\"\n\n[9bfc677d-ea3a-45f2-be44-35bc8fa3753e]\ndescription = \"non-letters with question\"\n\n[8608c508-f7de-4b17-985b-811878b3cf45]\ndescription = \"prattling on\"\n\n[bc39f7c6-f543-41be-9a43-fd1c2f753fc0]\ndescription = \"silence\"\n\n[d6c47565-372b-4b09-b1dd-c40552b8378b]\ndescription = \"prolonged silence\"\n\n[4428f28d-4100-4d85-a902-e5a78cb0ecd3]\ndescription = \"alternate silence\"\n\n[66953780-165b-4e7e-8ce3-4bcb80b6385a]\ndescription = \"multiple line question\"\n\n[5371ef75-d9ea-4103-bcfa-2da973ddec1b]\ndescription = \"starting with whitespace\"\n\n[05b304d6-f83b-46e7-81e0-4cd3ca647900]\ndescription = \"ending with whitespace\"\n\n[72bd5ad3-9b2f-4931-a988-dce1f5771de2]\ndescription = \"other whitespace\"\n\n[12983553-8601-46a8-92fa-fcaa3bc4a2a0]\ndescription = \"non-question ending with whitespace\"\n" }, { "path": "exercises/practice/bob/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/bob/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/bob/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/bob/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/bob/bob.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { hey } from './bob.ts'\n\ndescribe('Bob', () => {\n it('stating something', () => {\n const result = hey('Tom-ay-to, tom-aaaah-to.')\n expect(result).toEqual('Whatever.')\n })\n\n xit('shouting', () => {\n const result = hey('WATCH OUT!')\n expect(result).toEqual('Whoa, chill out!')\n })\n\n xit('shouting gibberish', () => {\n const result = hey('FCECDFCAAB')\n expect(result).toEqual('Whoa, chill out!')\n })\n\n xit('asking a question', () => {\n const result = hey('Does this cryogenic chamber make me look fat?')\n expect(result).toEqual('Sure.')\n })\n\n xit('asking a numeric question', () => {\n const result = hey('You are, what, like 15?')\n expect(result).toEqual('Sure.')\n })\n\n xit('asking gibberish', () => {\n const result = hey('fffbbcbeab?')\n expect(result).toEqual('Sure.')\n })\n\n xit('talking forcefully', () => {\n const result = hey(\"Let's go make out behind the gym!\")\n expect(result).toEqual('Whatever.')\n })\n\n xit('using acronyms in regular speech', () => {\n const result = hey(\"It's OK if you don't want to go to the DMV.\")\n expect(result).toEqual('Whatever.')\n })\n\n xit('forceful question', () => {\n const result = hey('WHAT THE HELL WERE YOU THINKING?')\n expect(result).toEqual(\"Calm down, I know what I'm doing!\")\n })\n\n xit('shouting numbers', () => {\n const result = hey('1, 2, 3 GO!')\n expect(result).toEqual('Whoa, chill out!')\n })\n\n xit('no letters', () => {\n const result = hey('1, 2, 3')\n expect(result).toEqual('Whatever.')\n })\n\n xit('question with no letters', () => {\n const result = hey('4?')\n expect(result).toEqual('Sure.')\n })\n\n xit('shouting with special characters', () => {\n const result = hey('ZOMG THE %^*@#$(*^ ZOMBIES ARE COMING!!11!!1!')\n expect(result).toEqual('Whoa, chill out!')\n })\n\n xit('shouting with no exclamation mark', () => {\n const result = hey('I HATE THE DMV')\n expect(result).toEqual('Whoa, chill out!')\n })\n\n xit('statement containing question mark', () => {\n const result = hey('Ending with ? means a question.')\n expect(result).toEqual('Whatever.')\n })\n\n xit('prattling on', () => {\n const result = hey('Wait! Hang on. Are you going to be OK?')\n expect(result).toEqual('Sure.')\n })\n\n xit('silence', () => {\n const result = hey('')\n expect(result).toEqual('Fine. Be that way!')\n })\n\n xit('prolonged silence', () => {\n const result = hey(' ')\n expect(result).toEqual('Fine. Be that way!')\n })\n\n xit('alternate silence', () => {\n const result = hey('\\t\\t\\t\\t\\t\\t\\t\\t\\t\\t')\n expect(result).toEqual('Fine. Be that way!')\n })\n\n xit('multiple line question', () => {\n const result = hey('\\nDoes this cryogenic chamber make me look fat?\\nNo.')\n expect(result).toEqual('Whatever.')\n })\n\n xit('starting with whitespace', () => {\n const result = hey(' hmmmmmmm...')\n expect(result).toEqual('Whatever.')\n })\n\n xit('ending with whitespace', () => {\n const result = hey('Okay if like my spacebar quite a bit? ')\n expect(result).toEqual('Sure.')\n })\n\n xit('other whitespace', () => {\n const result = hey('\\n\\r \\t')\n expect(result).toEqual('Fine. Be that way!')\n })\n\n xit('non-question ending with whitespace', () => {\n const result = hey('This is a statement ending with whitespace ')\n expect(result).toEqual('Whatever.')\n })\n})\n" }, { "path": "exercises/practice/bob/bob.ts", "content": "export function hey(message: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/bob/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/bob/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/bob/package.json", "content": "{\n \"name\": \"@exercism/typescript-bob\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/bob/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/bob/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/bottle-song/.docs/instructions.md", "content": "# Instructions\n\nRecite the lyrics to that popular children's repetitive song: Ten Green Bottles.\n\nNote that not all verses are identical.\n\n```text\nTen green bottles hanging on the wall,\nTen green bottles hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be nine green bottles hanging on the wall.\n\nNine green bottles hanging on the wall,\nNine green bottles hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be eight green bottles hanging on the wall.\n\nEight green bottles hanging on the wall,\nEight green bottles hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be seven green bottles hanging on the wall.\n\nSeven green bottles hanging on the wall,\nSeven green bottles hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be six green bottles hanging on the wall.\n\nSix green bottles hanging on the wall,\nSix green bottles hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be five green bottles hanging on the wall.\n\nFive green bottles hanging on the wall,\nFive green bottles hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be four green bottles hanging on the wall.\n\nFour green bottles hanging on the wall,\nFour green bottles hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be three green bottles hanging on the wall.\n\nThree green bottles hanging on the wall,\nThree green bottles hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be two green bottles hanging on the wall.\n\nTwo green bottles hanging on the wall,\nTwo green bottles hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be one green bottle hanging on the wall.\n\nOne green bottle hanging on the wall,\nOne green bottle hanging on the wall,\nAnd if one green bottle should accidentally fall,\nThere'll be no green bottles hanging on the wall.\n```\n" }, { "path": "exercises/practice/bottle-song/.meta/config.json", "content": "{\n \"authors\": [\n \"Budmin\"\n ],\n \"files\": {\n \"solution\": [\n \"bottle-song.ts\"\n ],\n \"test\": [\n \"bottle-song.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Produce the lyrics to the popular children's repetitive song: Ten Green Bottles.\",\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Ten_Green_Bottles\"\n }\n " }, { "path": "exercises/practice/bottle-song/.meta/proof.ci.ts", "content": "const NUMBERS = [\n 'no',\n 'One',\n 'Two',\n 'Three',\n 'Four',\n 'Five',\n 'Six',\n 'Seven',\n 'Eight',\n 'Nine',\n 'Ten',\n]\n\nexport const recite = (\n initialBottleCount: number,\n takeDownCount = 1\n): string[] => {\n const out: string[] = []\n\n for (\n let i = initialBottleCount;\n i > initialBottleCount - takeDownCount;\n i--\n ) {\n const currentBottles = i === 1 ? 'bottle' : 'bottles'\n const nextBottles = i - 1 === 1 ? 'bottle' : 'bottles'\n\n const line = `${NUMBERS[i]} green ${currentBottles} hanging on the wall,`\n out.push(\n line,\n line,\n `And if one green bottle should accidentally fall,`,\n `There'll be ${NUMBERS[i - 1].toLowerCase()} green ${nextBottles} hanging on the wall.`\n )\n\n if (initialBottleCount - takeDownCount !== i - 1) {\n out.push('')\n }\n }\n\n return out\n}\n" }, { "path": "exercises/practice/bottle-song/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[d4ccf8fc-01dc-48c0-a201-4fbeb30f2d03]\ndescription = \"verse -> single verse -> first generic verse\"\n\n[0f0aded3-472a-4c64-b842-18d4f1f5f030]\ndescription = \"verse -> single verse -> last generic verse\"\n\n[f61f3c97-131f-459e-b40a-7428f3ed99d9]\ndescription = \"verse -> single verse -> verse with 2 bottles\"\n\n[05eadba9-5dbd-401e-a7e8-d17cc9baa8e0]\ndescription = \"verse -> single verse -> verse with 1 bottle\"\n\n[a4a28170-83d6-4dc1-bd8b-319b6abb6a80]\ndescription = \"lyrics -> multiple verses -> first two verses\"\n\n[3185d438-c5ac-4ce6-bcd3-02c9ff1ed8db]\ndescription = \"lyrics -> multiple verses -> last three verses\"\n\n[28c1584a-0e51-4b65-9ae2-fbc0bf4bbb28]\ndescription = \"lyrics -> multiple verses -> all verses\"\n" }, { "path": "exercises/practice/bottle-song/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/bottle-song/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/bottle-song/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/bottle-song/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/bottle-song/bottle-song.test.ts", "content": "import { describe, expect, it, xit } from '@jest/globals'\nimport { recite } from './bottle-song.ts'\n\ndescribe('Bottle Song', () => {\n describe('verse', () => {\n describe('single verse', () => {\n it('first generic verse', () => {\n const expected = [\n `Ten green bottles hanging on the wall,`,\n `Ten green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be nine green bottles hanging on the wall.`,\n ]\n expect(recite(10, 1)).toEqual(expected)\n })\n\n xit('last generic verse', () => {\n const expected = [\n `Three green bottles hanging on the wall,`,\n `Three green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be two green bottles hanging on the wall.`,\n ]\n expect(recite(3, 1)).toEqual(expected)\n })\n\n xit('verse with 2 bottles', () => {\n const expected = [\n `Two green bottles hanging on the wall,`,\n `Two green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be one green bottle hanging on the wall.`,\n ]\n expect(recite(2, 1)).toEqual(expected)\n })\n\n xit('verse with 1 bottle', () => {\n const expected = [\n `One green bottle hanging on the wall,`,\n `One green bottle hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be no green bottles hanging on the wall.`,\n ]\n expect(recite(1, 1)).toEqual(expected)\n })\n })\n })\n\n describe('lyrics', () => {\n describe('multiple verses', () => {\n xit('first two verses', () => {\n const expected = [\n `Ten green bottles hanging on the wall,`,\n `Ten green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be nine green bottles hanging on the wall.`,\n ``,\n `Nine green bottles hanging on the wall,`,\n `Nine green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be eight green bottles hanging on the wall.`,\n ]\n expect(recite(10, 2)).toEqual(expected)\n })\n\n xit('last three verses', () => {\n const expected = [\n `Three green bottles hanging on the wall,`,\n `Three green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be two green bottles hanging on the wall.`,\n ``,\n `Two green bottles hanging on the wall,`,\n `Two green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be one green bottle hanging on the wall.`,\n ``,\n `One green bottle hanging on the wall,`,\n `One green bottle hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be no green bottles hanging on the wall.`,\n ]\n expect(recite(3, 3)).toEqual(expected)\n })\n\n xit('all verses', () => {\n const expected = [\n `Ten green bottles hanging on the wall,`,\n `Ten green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be nine green bottles hanging on the wall.`,\n ``,\n `Nine green bottles hanging on the wall,`,\n `Nine green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be eight green bottles hanging on the wall.`,\n ``,\n `Eight green bottles hanging on the wall,`,\n `Eight green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be seven green bottles hanging on the wall.`,\n ``,\n `Seven green bottles hanging on the wall,`,\n `Seven green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be six green bottles hanging on the wall.`,\n ``,\n `Six green bottles hanging on the wall,`,\n `Six green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be five green bottles hanging on the wall.`,\n ``,\n `Five green bottles hanging on the wall,`,\n `Five green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be four green bottles hanging on the wall.`,\n ``,\n `Four green bottles hanging on the wall,`,\n `Four green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be three green bottles hanging on the wall.`,\n ``,\n `Three green bottles hanging on the wall,`,\n `Three green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be two green bottles hanging on the wall.`,\n ``,\n `Two green bottles hanging on the wall,`,\n `Two green bottles hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be one green bottle hanging on the wall.`,\n ``,\n `One green bottle hanging on the wall,`,\n `One green bottle hanging on the wall,`,\n `And if one green bottle should accidentally fall,`,\n `There'll be no green bottles hanging on the wall.`,\n ]\n expect(recite(10, 10)).toEqual(expected)\n })\n })\n })\n})\n" }, { "path": "exercises/practice/bottle-song/bottle-song.ts", "content": "export const recite = (\n initialBottleCount: unknown,\n takeDownCount: unknown\n): unknown => {\n throw new Error('Remove this statement and implement this function')\n}\n" }, { "path": "exercises/practice/bottle-song/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/bottle-song/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/bottle-song/package.json", "content": "{\n \"name\": \"@exercism/typescript-bottle-song\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism practice exercise on bottle-song\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/bottle-song/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/bottle-song/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/bowling/.docs/instructions.md", "content": "# Instructions\n\nScore a bowling game.\n\nBowling is a game where players roll a heavy ball to knock down pins arranged in a triangle.\nWrite code to keep track of the score of a game of bowling.\n\n## Scoring Bowling\n\nThe game consists of 10 frames.\nA frame is composed of one or two ball throws with 10 pins standing at frame initialization.\nThere are three cases for the tabulation of a frame.\n\n- An open frame is where a score of less than 10 is recorded for the frame.\n In this case the score for the frame is the number of pins knocked down.\n\n- A spare is where all ten pins are knocked down by the second throw.\n The total value of a spare is 10 plus the number of pins knocked down in their next throw.\n\n- A strike is where all ten pins are knocked down by the first throw.\n The total value of a strike is 10 plus the number of pins knocked down in the next two throws.\n If a strike is immediately followed by a second strike, then the value of the first strike cannot be determined until the ball is thrown one more time.\n\nHere is a three frame example:\n\n| Frame 1 | Frame 2 | Frame 3 |\n| :--------: | :--------: | :--------------: |\n| X (strike) | 5/ (spare) | 9 0 (open frame) |\n\nFrame 1 is (10 + 5 + 5) = 20\n\nFrame 2 is (5 + 5 + 9) = 19\n\nFrame 3 is (9 + 0) = 9\n\nThis means the current running total is 48.\n\nThe tenth frame in the game is a special case.\nIf someone throws a spare or a strike then they get one or two fill balls respectively.\nFill balls exist to calculate the total of the 10th frame.\nScoring a strike or spare on the fill ball does not give the player more fill balls.\nThe total value of the 10th frame is the total number of pins knocked down.\n\nFor a tenth frame of X1/ (strike and a spare), the total value is 20.\n\nFor a tenth frame of XXX (three strikes), the total value is 30.\n\n## Requirements\n\nWrite code to keep track of the score of a game of bowling.\nIt should support two operations:\n\n- `roll(pins : int)` is called each time the player rolls a ball.\n The argument is the number of pins knocked down.\n- `score() : int` is called only at the very end of the game.\n It returns the total score for that game.\n" }, { "path": "exercises/practice/bowling/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"bowling.ts\"\n ],\n \"test\": [\n \"bowling.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Score a bowling game.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"The Bowling Game Kata from UncleBob\",\n \"source_url\": \"https://web.archive.org/web/20221001111000/http://butunclebob.com/ArticleS.UncleBob.TheBowlingGameKata\"\n}\n" }, { "path": "exercises/practice/bowling/.meta/proof.ci.ts", "content": "type Frame = 'X' | 'S' | number | undefined\n\nexport class Bowling {\n private readonly maxPins: number\n private readonly maxFrames: number\n\n private currentFrame: number\n private frames: Frame[]\n private frameScores: number[]\n private frameRoll: number\n private remainingPins: number\n\n constructor() {\n this.maxPins = 10\n this.maxFrames = 10\n this.currentFrame = 0\n\n this.frames = []\n this.frameScores = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n\n this.initializeFrame()\n }\n\n private initializeFrame(): void {\n this.frameRoll = 1\n this.remainingPins = this.maxPins\n this.currentFrame = this.currentFrame + 1\n }\n\n private incrementFrame(): void {\n this.frameRoll = this.frameRoll + 1\n }\n\n private incrementScore(pins: number): void {\n if (this.currentFrame > this.maxFrames) return\n this.frameScores[this.currentFrame - 1] += pins\n }\n\n private scoreStrike(): void {\n this.frames[this.currentFrame - 1] = 'X'\n this.applyStrikeBonus(this.maxPins)\n this.applySpareBonus(this.maxPins)\n this.incrementFrame()\n }\n\n private scoreFirstRoll(pins: number): void {\n this.remainingPins = this.remainingPins - pins\n this.applySpareBonus(pins)\n this.applyStrikeBonus(pins)\n this.incrementFrame()\n }\n\n private scoreSpare(pins: number): void {\n this.frames[this.currentFrame - 1] = 'S'\n this.applyStrikeBonus(pins)\n this.incrementFrame()\n }\n\n private scoreOpenFrame(pins: number): void {\n this.frames[this.currentFrame - 1] =\n this.maxPins - this.remainingPins + pins\n this.applyStrikeBonus(pins)\n this.incrementFrame()\n }\n\n private applySpareBonus(pins: number): void {\n // pins on the first roll after a spare are counted twice (on the frame of spare)\n if (this.frames[this.currentFrame - 2] === 'S') {\n this.frameScores[this.currentFrame - 2] += pins\n }\n }\n\n private applyStrikeBonus(pins: number): void {\n // on the two rolls after a strike are counted twice (on the frame of the strike)\n if (\n this.frames[this.currentFrame - 3] === 'X' &&\n this.frames[this.currentFrame - 2] === 'X' &&\n this.frameRoll === 1 &&\n this.currentFrame <= this.maxFrames + 2\n ) {\n this.frameScores[this.currentFrame - 3] += pins\n }\n if (\n this.frames[this.currentFrame - 2] === 'X' &&\n this.currentFrame <= this.maxFrames + 1\n ) {\n this.frameScores[this.currentFrame - 2] += pins\n }\n }\n\n private isGameOver(): boolean {\n if (this.currentFrame <= this.maxFrames) return false\n\n if (\n this.frames[this.maxFrames - 1] !== 'X' &&\n this.frames[this.maxFrames - 1] !== 'S'\n )\n return true\n\n // spare in the last frame gets no more than bonus roll\n if (this.frames[this.maxFrames - 1] === 'S' && this.frameRoll > 1)\n return true\n\n // bonus roll after the spare in the last frame may get a strike but then the games ends\n // without another roll\n if (\n this.frames[this.maxFrames - 1] === 'S' &&\n this.frames[this.maxFrames] === 'X'\n )\n return true\n\n if (this.frames[this.maxFrames - 1] === 'X') {\n // if the first bonus roll is not a strike then finish the bonus frame\n if (\n this.frames[this.maxFrames] !== 'X' &&\n this.currentFrame > this.maxFrames + 1\n )\n return true\n\n if (this.frames[this.maxFrames] === 'X') {\n // if the second bonus roll is a strike, but was still used, the game is over\n if (this.frames[this.maxFrames + 1] !== 'X' && this.frameRoll > 1)\n return true\n // if the second bonus roll is a strike the game is over\n if (this.frames[this.maxFrames + 1] === 'X') return true\n }\n }\n return false\n }\n\n public roll(pins: number): void {\n if (pins < 0) {\n throw new Error('Negative roll is invalid')\n }\n\n if (pins > this.remainingPins) {\n throw new Error('Pin count exceeds pins on the lane')\n }\n\n if (this.isGameOver()) {\n throw new Error('Cannot roll after game is over')\n }\n\n this.incrementScore(pins)\n\n if (this.frameRoll === 1) {\n if (pins === this.maxPins) {\n this.scoreStrike()\n this.initializeFrame()\n } else {\n this.scoreFirstRoll(pins)\n }\n } else {\n if (pins === this.remainingPins) {\n this.scoreSpare(pins)\n } else {\n this.scoreOpenFrame(pins)\n }\n this.initializeFrame()\n }\n }\n\n public score(): number {\n if (!this.isGameOver()) {\n throw new Error('Score cannot be taken until the end of the game')\n }\n return this.frameScores.reduce((total, num) => total + num)\n }\n}\n" }, { "path": "exercises/practice/bowling/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[656ae006-25c2-438c-a549-f338e7ec7441]\ndescription = \"should be able to score a game with all zeros\"\n\n[f85dcc56-cd6b-4875-81b3-e50921e3597b]\ndescription = \"should be able to score a game with no strikes or spares\"\n\n[d1f56305-3ac2-4fe0-8645-0b37e3073e20]\ndescription = \"a spare followed by zeros is worth ten points\"\n\n[0b8c8bb7-764a-4287-801a-f9e9012f8be4]\ndescription = \"points scored in the roll after a spare are counted twice\"\n\n[4d54d502-1565-4691-84cd-f29a09c65bea]\ndescription = \"consecutive spares each get a one roll bonus\"\n\n[e5c9cf3d-abbe-4b74-ad48-34051b2b08c0]\ndescription = \"a spare in the last frame gets a one roll bonus that is counted once\"\n\n[75269642-2b34-4b72-95a4-9be28ab16902]\ndescription = \"a strike earns ten points in a frame with a single roll\"\n\n[037f978c-5d01-4e49-bdeb-9e20a2e6f9a6]\ndescription = \"points scored in the two rolls after a strike are counted twice as a bonus\"\n\n[1635e82b-14ec-4cd1-bce4-4ea14bd13a49]\ndescription = \"consecutive strikes each get the two roll bonus\"\n\n[e483e8b6-cb4b-4959-b310-e3982030d766]\ndescription = \"a strike in the last frame gets a two roll bonus that is counted once\"\n\n[9d5c87db-84bc-4e01-8e95-53350c8af1f8]\ndescription = \"rolling a spare with the two roll bonus does not get a bonus roll\"\n\n[576faac1-7cff-4029-ad72-c16bcada79b5]\ndescription = \"strikes with the two roll bonus do not get bonus rolls\"\n\n[efb426ec-7e15-42e6-9b96-b4fca3ec2359]\ndescription = \"last two strikes followed by only last bonus with non strike points\"\n\n[72e24404-b6c6-46af-b188-875514c0377b]\ndescription = \"a strike with the one roll bonus after a spare in the last frame does not get a bonus\"\n\n[62ee4c72-8ee8-4250-b794-234f1fec17b1]\ndescription = \"all strikes is a perfect game\"\n\n[1245216b-19c6-422c-b34b-6e4012d7459f]\ndescription = \"rolls cannot score negative points\"\n\n[5fcbd206-782c-4faa-8f3a-be5c538ba841]\ndescription = \"a roll cannot score more than 10 points\"\n\n[fb023c31-d842-422d-ad7e-79ce1db23c21]\ndescription = \"two rolls in a frame cannot score more than 10 points\"\n\n[6082d689-d677-4214-80d7-99940189381b]\ndescription = \"bonus roll after a strike in the last frame cannot score more than 10 points\"\n\n[e9565fe6-510a-4675-ba6b-733a56767a45]\ndescription = \"two bonus rolls after a strike in the last frame cannot score more than 10 points\"\n\n[2f6acf99-448e-4282-8103-0b9c7df99c3d]\ndescription = \"two bonus rolls after a strike in the last frame can score more than 10 points if one is a strike\"\n\n[6380495a-8bc4-4cdb-a59f-5f0212dbed01]\ndescription = \"the second bonus rolls after a strike in the last frame cannot be a strike if the first one is not a strike\"\n\n[2b2976ea-446c-47a3-9817-42777f09fe7e]\ndescription = \"second bonus roll after a strike in the last frame cannot score more than 10 points\"\n\n[29220245-ac8d-463d-bc19-98a94cfada8a]\ndescription = \"an unstarted game cannot be scored\"\n\n[4473dc5d-1f86-486f-bf79-426a52ddc955]\ndescription = \"an incomplete game cannot be scored\"\n\n[2ccb8980-1b37-4988-b7d1-e5701c317df3]\ndescription = \"cannot roll if game already has ten frames\"\n\n[4864f09b-9df3-4b65-9924-c595ed236f1b]\ndescription = \"bonus rolls for a strike in the last frame must be rolled before score can be calculated\"\n\n[537f4e37-4b51-4d1c-97e2-986eb37b2ac1]\ndescription = \"both bonus rolls for a strike in the last frame must be rolled before score can be calculated\"\n\n[8134e8c1-4201-4197-bf9f-1431afcde4b9]\ndescription = \"bonus roll for a spare in the last frame must be rolled before score can be calculated\"\n\n[9d4a9a55-134a-4bad-bae8-3babf84bd570]\ndescription = \"cannot roll after bonus roll for spare\"\n\n[d3e02652-a799-4ae3-b53b-68582cc604be]\ndescription = \"cannot roll after bonus rolls for strike\"\n" }, { "path": "exercises/practice/bowling/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/bowling/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/bowling/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/bowling/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/bowling/bowling.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Bowling } from './bowling.ts'\n\ndescribe('Bowling', () => {\n describe('Check game can be scored correctly.', () => {\n it('should be able to score a game with all zeros', () => {\n const rolls = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(0)\n })\n\n xit('should be able to score a game with no strikes or spares', () => {\n const rolls = [3, 6, 3, 6, 3, 6, 3, 6, 3, 6, 3, 6, 3, 6, 3, 6, 3, 6, 3, 6]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(90)\n })\n\n xit('a spare followed by zeros is worth ten points', () => {\n const rolls = [6, 4, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(10)\n })\n\n xit('points scored in the roll after a spare are counted twice', () => {\n const rolls = [6, 4, 3, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(16)\n })\n\n xit('consecutive spares each get a one roll bonus', () => {\n const rolls = [5, 5, 3, 7, 4, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(31)\n })\n\n xit('a spare in the last frame gets a one roll bonus that is counted once', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 7, 3, 7,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(17)\n })\n\n xit('a strike earns ten points in a frame with a single roll', () => {\n const rolls = [10, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(10)\n })\n\n xit('points scored in the two rolls after a strike are counted twice as a bonus', () => {\n const rolls = [10, 5, 3, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(26)\n })\n\n xit('consecutive strikes each get the two roll bonus', () => {\n const rolls = [10, 10, 10, 5, 3, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(81)\n })\n\n xit('a strike in the last frame gets a two roll bonues that is counted once', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 7, 1,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(18)\n })\n\n xit('rolling a spare with the two roll bonus does not get a bonus roll', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 7, 3,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(20)\n })\n\n xit('strikes with the two roll bonus do not get bonus rolls', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 10, 10,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(30)\n })\n\n xit('last two strikes followed by only last bonus with non strike points', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 10, 0, 1,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(31)\n })\n\n xit('a strike with the one roll bonus after a spare in the last frame does not get a bonus', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 7, 3, 10,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(20)\n })\n\n xit('all strikes is a perfect game', () => {\n const rolls = [10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10, 10]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(300)\n })\n })\n\n describe('Check game rules.', () => {\n xit('rolls cannot score negative points', () => {\n const bowling = new Bowling()\n expect(() => {\n bowling.roll(-1)\n }).toThrow(new Error('Negative roll is invalid'))\n })\n\n xit('a roll cannot score more than 10 points', () => {\n const bowling = new Bowling()\n expect(() => {\n bowling.roll(11)\n }).toThrow(new Error('Pin count exceeds pins on the lane'))\n })\n\n xit('two rolls in a frame cannot score more than 10 points', () => {\n const bowling = new Bowling()\n bowling.roll(5)\n expect(() => {\n bowling.roll(6)\n }).toThrow(new Error('Pin count exceeds pins on the lane'))\n })\n\n xit('bonus roll after a strike in the last frame cannot score more than 10 points', () => {\n const rolls = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.roll(11)\n }).toThrow(new Error('Pin count exceeds pins on the lane'))\n })\n\n xit('two bonus rolls after a strike in the last frame cannot score more than 10 points', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 5,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.roll(6)\n }).toThrow(new Error('Pin count exceeds pins on the lane'))\n })\n\n xit('two bonus rolls after a strike in the last frame can score more than 10 points if one is a strike', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 10, 6,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(bowling.score()).toEqual(26)\n })\n\n xit('the second bonus rolls after a strike in the last frame cannot be a strike if the first one is not a strike', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 6,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.roll(10)\n }).toThrow(new Error('Pin count exceeds pins on the lane'))\n })\n\n xit('second bonus roll after a strike in the last frame cannot score more than 10 points', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 10,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.roll(11)\n }).toThrow(new Error('Pin count exceeds pins on the lane'))\n })\n\n xit('an unstarted game cannot be scored', () => {\n const bowling = new Bowling()\n expect(() => {\n bowling.score()\n }).toThrow(new Error('Score cannot be taken until the end of the game'))\n })\n\n xit('an incomplete game cannot be scored', () => {\n const rolls = [0, 0]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.score()\n }).toThrow(new Error('Score cannot be taken until the end of the game'))\n })\n\n xit('cannot roll if game already has ten frames', () => {\n const rolls = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.roll(0)\n }).toThrow(new Error('Cannot roll after game is over'))\n })\n\n xit('bonus rolls for a strike in the last frame must be rolled before score can be calculated', () => {\n const rolls = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.score()\n }).toThrow(new Error('Score cannot be taken until the end of the game'))\n })\n\n xit('both bonus rolls for a strike in the last frame must be rolled before score can be calculated', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 10,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.score()\n }).toThrow(new Error('Score cannot be taken until the end of the game'))\n })\n\n xit('bonus roll for a spare in the last frame must be rolled before score can be calculated', () => {\n const rolls = [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 7, 3]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.score()\n }).toThrow(new Error('Score cannot be taken until the end of the game'))\n })\n\n xit('cannot roll after bonus roll for spare', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 7, 3, 2,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.roll(2)\n }).toThrow(new Error('Cannot roll after game is over'))\n })\n\n xit('cannot roll after bonus rolls for strike', () => {\n const rolls = [\n 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 3, 2,\n ]\n const bowling = new Bowling()\n rolls.forEach((roll) => {\n bowling.roll(roll)\n })\n expect(() => {\n bowling.roll(2)\n }).toThrow(new Error('Cannot roll after game is over'))\n })\n })\n})\n" }, { "path": "exercises/practice/bowling/bowling.ts", "content": "export class Bowling {\n public roll(pins: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public score(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/bowling/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/bowling/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/bowling/package.json", "content": "{\n \"name\": \"@exercism/typescript-bowling\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/bowling/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/bowling/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/camicia/.docs/instructions.md", "content": "# Instructions\n\nIn this exercise, you will simulate a game very similar to the classic card game **Camicia**.\nYour program will receive the initial configuration of two players' decks and must simulate the game until it ends (or detect that it will never end).\n\n## Rules\n\n- The deck is split between **two players**.\n The player's cards are read from left to right, where the leftmost card is the top of the deck.\n- A round consists of both players playing at least one card.\n- Players take turns placing the **top card** of their deck onto a central pile.\n- If the card is a **number card** (2-10), play simply passes to the other player.\n- If the card is a **payment card**, a penalty must be paid:\n - **J** ā†’ opponent must pay 1 card\n - **Q** ā†’ opponent must pay 2 cards\n - **K** ā†’ opponent must pay 3 cards\n - **A** ā†’ opponent must pay 4 cards\n- If the player paying a penalty reveals another payment card, that player stops paying the penalty.\n The other player must then pay a penalty based on the new payment card.\n- If the penalty is fully paid without interruption, the player who placed the **last payment card** collects the central pile and places it at the bottom of their deck.\n That player then starts the next round.\n- If a player runs out of cards and is unable to play a card (either while paying a penalty or when it is their turn), the other player collects the central pile.\n- The moment when a player collects cards from the central pile is called a **trick**.\n- If a player has all the cards in their possession after a trick, the game **ends**.\n- The game **enters a loop** as soon as the decks are identical to what they were earlier during the game, **not** counting number cards!\n\n## Examples\n\nA small example of a match that ends.\n\n| Round | Player A | Player B | Pile | Penalty Due |\n| :---- | :----------- | :------------------------- | :------------------------- | :---------- |\n| 1 | 2 A 7 8 Q 10 | 3 4 5 6 K 9 J | | - |\n| 1 | A 7 8 Q 10 | 3 4 5 6 K 9 J | 2 | - |\n| 1 | A 7 8 Q 10 | 4 5 6 K 9 J | 2 3 | - |\n| 1 | 7 8 Q 10 | 4 5 6 K 9 J | 2 3 A | Player B: 4 |\n| 1 | 7 8 Q 10 | 5 6 K 9 J | 2 3 A 4 | Player B: 3 |\n| 1 | 7 8 Q 10 | 6 K 9 J | 2 3 A 4 5 | Player B: 2 |\n| 1 | 7 8 Q 10 | K 9 J | 2 3 A 4 5 6 | Player B: 1 |\n| 1 | 7 8 Q 10 | 9 J | 2 3 A 4 5 6 K | Player A: 3 |\n| 1 | 8 Q 10 | 9 J | 2 3 A 4 5 6 K 7 | Player A: 2 |\n| 1 | Q 10 | 9 J | 2 3 A 4 5 6 K 7 8 | Player A: 1 |\n| 1 | 10 | 9 J | 2 3 A 4 5 6 K 7 8 Q | Player B: 2 |\n| 1 | 10 | J | 2 3 A 4 5 6 K 7 8 Q 9 | Player B: 1 |\n| 1 | 10 | - | 2 3 A 4 5 6 K 7 8 Q 9 J | Player A: 1 |\n| 1 | - | - | 2 3 A 4 5 6 K 7 8 Q 9 J 10 | - |\n| 2 | - | 2 3 A 4 5 6 K 7 8 Q 9 J 10 | - | - |\n\nstatus: `\"finished\"`, cards: 13, tricks: 1\n\nThis is a small example of a match that loops.\n\n| Round | Player A | Player B | Pile | Penalty Due |\n| :---- | :------- | :------- | :---- | :---------- |\n| 1 | J 2 3 | 4 J 5 | - | - |\n| 1 | 2 3 | 4 J 5 | J | Player B: 1 |\n| 1 | 2 3 | J 5 | J 4 | - |\n| 2 | 2 3 J 4 | J 5 | - | - |\n| 2 | 3 J 4 | J 5 | 2 | - |\n| 2 | 3 J 4 | 5 | 2 J | Player A: 1 |\n| 2 | J 4 | 5 | 2 J 3 | - |\n| 3 | J 4 | 5 2 J 3 | - | - |\n| 3 | J 4 | 2 J 3 | 5 | - |\n| 3 | 4 | 2 J 3 | 5 J | Player B: 1 |\n| 3 | 4 | J 3 | 5 J 2 | - |\n| 4 | 4 5 J 2 | J 3 | - | - |\n\nThe start of round 4 matches the start of round 2.\nRecall, the value of the number cards does not matter.\n\nstatus: `\"loop\"`, cards: 8, tricks: 3\n\n## Your Task\n\n- Using the input, simulate the game following the rules above.\n- Determine the following information regarding the game:\n - **Status**: `\"finished\"` or `\"loop\"`\n - **Cards**: total number of cards played throughout the game\n - **Tricks**: number of times the central pile was collected\n\n~~~~exercism/advanced\nFor those who want to take on a more exciting challenge, the hunt for other records for the longest game with an end is still open.\nThere are 653,534,134,886,878,245,000 (approximately 654 quintillion) possibilities, and we haven't calculated them all yet!\n~~~~\n" }, { "path": "exercises/practice/camicia/.docs/introduction.md", "content": "# Introduction\n\nOne rainy afternoon, you sit at the kitchen table playing cards with your grandmother.\nThe game is her take on [Camicia][bmn].\n\nAt first it feels like just another friendly match: cards slapped down, laughter across the table, the occasional victorious grin from Nonna.\nBut as the game stretches on, something strange happens.\nThe same cards keep cycling back.\nYou play card after card, yet the end never seems to come.\n\nYou start to wonder.\n_Will this game ever finish?\nOr could we keep playing forever?_\n\nLater, driven by curiosity, you search online and to your surprise you discover that what happened wasn't just bad luck.\nYou and your grandmother may have stumbled upon one of the longest possible sequences!\nSuddenly, you're hooked.\nWhat began as a casual game has turned into a quest: _how long can such a game really last?_\n_Can you find a sequence even longer than the one you played at the kitchen table?_\n_Perhaps even long enough to set a new world record?_\n\nAnd so, armed with nothing but a deck of cards and some algorithmic ingenuity, you decide to investigate...\n\n[bmn]: https://en.wikipedia.org/wiki/Beggar-my-neighbour\n" }, { "path": "exercises/practice/camicia/.meta/config.json", "content": "{\n \"authors\": [\n \"BNAndras\"\n ],\n \"files\": {\n \"solution\": [\n \"camicia.ts\"\n ],\n \"test\": [\n \"camicia.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Simulate the card game and determine whether the match ends or enters an infinite loop.\",\n \"source\": \"Beggar-My-Neighbour\",\n \"source_url\": \"https://www.richardpmann.com/beggar-my-neighbour-records.html\"\n}\n" }, { "path": "exercises/practice/camicia/.meta/proof.ci.ts", "content": "export const simulateGame = (\n playerA: string[],\n playerB: string[]\n): { status: string; tricks: number; cards: number } => {\n const getCardValue = (card: string): number => {\n if (card === 'J') return 1\n if (card === 'Q') return 2\n if (card === 'K') return 3\n if (card === 'A') return 4\n return 0\n }\n\n const handA = playerA.map(getCardValue)\n const handB = playerB.map(getCardValue)\n let turn = 'A'\n let pile = []\n const seen = new Set()\n let totalTricks = 0\n let cardsPlayed = 0\n let currentDebt = 0\n\n while (true) {\n if (pile.length === 0) {\n const round = JSON.stringify([handA, handB, turn])\n if (seen.has(round)) {\n return { status: 'loop', tricks: totalTricks, cards: cardsPlayed }\n }\n seen.add(round)\n }\n\n const activeHand = turn === 'A' ? handA : handB\n const otherHand = turn === 'A' ? handB : handA\n\n if (activeHand.length === 0) {\n const extraTrick = pile.length === 0 ? 0 : 1\n return {\n status: 'finished',\n tricks: totalTricks + extraTrick,\n cards: cardsPlayed,\n }\n }\n\n const cardVal = activeHand.shift()!\n pile.push(cardVal)\n cardsPlayed += 1\n\n // payment card so debt is either forgiven for player or assigned to opponent\n if (cardVal > 0) {\n currentDebt = cardVal\n turn = turn === 'A' ? 'B' : 'A'\n } else {\n // time to pay up!\n if (currentDebt > 0) {\n currentDebt -= 1\n if (currentDebt === 0) {\n // penalty paid off\n otherHand.push(...pile)\n pile = []\n totalTricks += 1\n currentDebt = 0\n\n if (handA.length === 0 || handB.length === 0) {\n return {\n status: 'finished',\n tricks: totalTricks,\n cards: cardsPlayed,\n }\n }\n turn = turn === 'A' ? 'B' : 'A'\n }\n } else {\n turn = turn === 'A' ? 'B' : 'A'\n }\n }\n }\n}\n" }, { "path": "exercises/practice/camicia/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[0b7f737c-3ecd-4a55-b34d-e65c62a85c28]\ndescription = \"two cards, one trick\"\n\n[27c19d75-53a5-48e5-b33b-232c3884d4f3]\ndescription = \"three cards, one trick\"\n\n[9b02dd49-efaf-4b71-adca-a05c18a7c5b0]\ndescription = \"four cards, one trick\"\n\n[fa3f4479-466a-4734-a001-ab79bfe27260]\ndescription = \"the ace reigns supreme\"\n\n[07629689-f589-4f54-a6d1-8ce22776ce72]\ndescription = \"the king beats ace\"\n\n[54d4a1c5-76fb-4d1e-8358-0e0296ac0601]\ndescription = \"the queen seduces the king\"\n\n[c875500c-ff3d-47a4-bd1e-b60b90da80aa]\ndescription = \"the jack betrays the queen\"\n\n[436875da-96ca-4149-be22-0b78173b8125]\ndescription = \"the 10 just wants to put on a show\"\n\n[5be39bb6-1b34-4ce6-a1cd-0fcc142bb272]\ndescription = \"simple loop with decks of 3 cards\"\n\n[2795dc21-0a2a-4c38-87c2-5a42e1ff15eb]\ndescription = \"the story is starting to get a bit complicated\"\n\n[6999dfac-3fdc-41e2-b64b-38f4be228712]\ndescription = \"two tricks\"\n\n[83dcd4f3-e089-4d54-855a-73f5346543a3]\ndescription = \"more tricks\"\n\n[3107985a-f43e-486a-9ce8-db51547a9941]\ndescription = \"simple loop with decks of 4 cards\"\n\n[dca32c31-11ed-49f6-b078-79ab912c1f7b]\ndescription = \"easy card combination\"\n\n[1f8488d0-48d3-45ae-b819-59cedad0a5f4]\ndescription = \"easy card combination, inverted decks\"\n\n[98878d35-623a-4d05-b81a-7bdc569eb88d]\ndescription = \"mirrored decks\"\n\n[3e0ba597-ca10-484b-87a3-31a7df7d6da3]\ndescription = \"opposite decks\"\n\n[92334ddb-aaa7-47fa-ab36-e928a8a6a67c]\ndescription = \"random decks #1\"\n\n[30477523-9651-4860-84a3-e1ac461bb7fa]\ndescription = \"random decks #2\"\n\n[20967de8-9e94-4e0e-9010-14bc1c157432]\ndescription = \"Kleber 1999\"\n\n[9f2fdfe8-27f3-4323-816d-6bce98a9c6f7]\ndescription = \"Collins 2006\"\n\n[c90b6f8d-7013-49f3-b5cb-14ea006cca1d]\ndescription = \"Mann and Wu 2007\"\n\n[a3f1fbc5-1d0b-499a-92a5-22932dfc6bc8]\ndescription = \"Nessler 2012\"\n\n[9cefb1ba-e6d1-4ab7-9d8f-76d8e0976d5f]\ndescription = \"Anderson 2013\"\n\n[d37c0318-5be6-48d0-ab72-a7aaaff86179]\ndescription = \"Rucklidge 2014\"\n\n[4305e479-ba87-432f-8a29-cd2bd75d2f05]\ndescription = \"Nessler 2021\"\n\n[252f5cc3-b86d-4251-87ce-f920b7a6a559]\ndescription = \"Nessler 2022\"\n\n[b9efcfa4-842f-4542-8112-8389c714d958]\ndescription = \"Casella 2024, first infinite game found\"\n" }, { "path": "exercises/practice/camicia/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/camicia/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/camicia/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/camicia/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/camicia/camicia.test.ts", "content": "import { describe, expect, it, xit } from '@jest/globals'\nimport { simulateGame } from './camicia.ts'\n\ndescribe('Camicia', () => {\n it('two cards, one trick', () => {\n const playerA = ['2']\n const playerB = ['3']\n const expected = { status: 'finished', cards: 2, tricks: 1 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('three cards, one trick', () => {\n const playerA = ['2', '4']\n const playerB = ['3']\n const expected = { status: 'finished', cards: 3, tricks: 1 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('four cards, one trick', () => {\n const playerA = ['2', '4']\n const playerB = ['3', '5', '6']\n const expected = { status: 'finished', cards: 4, tricks: 1 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('the ace reigns supreme', () => {\n const playerA = ['2', 'A']\n const playerB = ['3', '4', '5', '6', '7']\n const expected = { status: 'finished', cards: 7, tricks: 1 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('the king beats ace', () => {\n const playerA = ['2', 'A']\n const playerB = ['3', '4', '5', '6', 'K']\n const expected = { status: 'finished', cards: 7, tricks: 1 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('the queen seduces the king', () => {\n const playerA = ['2', 'A', '7', '8', 'Q']\n const playerB = ['3', '4', '5', '6', 'K']\n const expected = { status: 'finished', cards: 10, tricks: 1 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('the jack betrays the queen', () => {\n const playerA = ['2', 'A', '7', '8', 'Q']\n const playerB = ['3', '4', '5', '6', 'K', '9', 'J']\n const expected = { status: 'finished', cards: 12, tricks: 1 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('the 10 just wants to put on a show', () => {\n const playerA = ['2', 'A', '7', '8', 'Q', '10']\n const playerB = ['3', '4', '5', '6', 'K', '9', 'J']\n const expected = { status: 'finished', cards: 13, tricks: 1 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('simple loop with decks of 3 cards', () => {\n const playerA = ['J', '2', '3']\n const playerB = ['4', 'J', '5']\n const expected = { status: 'loop', cards: 8, tricks: 3 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('the story is starting to get a bit complicated', () => {\n const playerA = [\n '2', '6', '6', 'J', '4', 'K', 'Q', '10', 'K', 'J',\n 'Q', '2', '3', 'K', '5', '6', 'Q', 'Q', 'A', 'A',\n '6', '9', 'K', 'A', '8', 'K', '2', 'A', '9', 'A',\n 'Q', '4', 'K', 'K', 'K', '3', '5', 'K', '8', 'Q',\n '3', 'Q', '7', 'J', 'K', 'J', '9', 'J', '3', '3',\n 'K', 'K', 'Q', 'A', 'K', '7', '10', 'A', 'Q', '7',\n '10', 'J', '4', '5', 'J', '9', '10', 'Q', 'J', 'J',\n 'K', '6', '10', 'J', '6', 'Q', 'J', '5', 'J', 'Q',\n 'Q', '8', '3', '8', 'A', '2', '6', '9', 'K', '7',\n 'J', 'K', 'K', '8', 'K', 'Q', '6', '10', 'J', '10',\n 'J', 'Q', 'J', '10', '3', '8', 'K', 'A', '6', '9',\n 'K', '2', 'A', 'A', '10', 'J', '6', 'A', '4', 'J',\n 'A', 'J', 'J', '6', '2', 'J', '3', 'K', '2', '5',\n '9', 'J', '9', '6', 'K', 'A', '5', 'Q', 'J', '2',\n 'Q', 'K', 'A', '3', 'K', 'J', 'K', '2', '5', '6',\n 'Q', 'J', 'Q', 'Q', 'J', '2', 'J', '9', 'Q', '7',\n '7', 'A', 'Q', '7', 'Q', 'J', 'K', 'J', 'A', '7',\n '7', '8', 'Q', '10', 'J', '10', 'J', 'J', '9', '2',\n 'A', '2',\n ]\n const playerB = [\n '7', '2', '10', 'K', '8', '2', 'J', '9', 'A', '5',\n '6', 'J', 'Q', '6', 'K', '6', '5', 'A', '4', 'Q',\n '7', 'J', '7', '10', '2', 'Q', '8', '2', '2', 'K',\n 'J', 'A', '5', '5', 'A', '4', 'Q', '6', 'Q', 'K',\n '10', '8', 'Q', '2', '10', 'J', 'A', 'Q', '8', 'Q',\n 'Q', 'J', 'J', 'A', 'A', '9', '10', 'J', 'K', '4',\n 'Q', '10', '10', 'J', 'K', '10', '2', 'J', '7', 'A',\n 'K', 'K', 'J', 'A', 'J', '10', '8', 'K', 'A', '7',\n 'Q', 'Q', 'J', '3', 'Q', '4', 'A', '3', 'A', 'Q',\n 'Q', 'Q', '5', '4', 'K', 'J', '10', 'A', 'Q', 'J',\n '6', 'J', 'A', '10', 'A', '5', '8', '3', 'K', '5',\n '9', 'Q', '8', '7', '7', 'J', '7', 'Q', 'Q', 'Q',\n 'A', '7', '8', '9', 'A', 'Q', 'A', 'K', '8', 'A',\n 'A', 'J', '8', '4', '8', 'K', 'J', 'A', '10', 'Q',\n '8', 'J', '8', '6', '10', 'Q', 'J', 'J', 'A', 'A',\n 'J', '5', 'Q', '6', 'J', 'K', 'Q', '8', 'K', '4',\n 'Q', 'Q', '6', 'J', 'K', '4', '7', 'J', 'J', '9',\n '9', 'A', 'Q', 'Q', 'K', 'A', '6', '5', 'K',\n ]\n const expected = { status: 'finished', cards: 361, tricks: 1 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('two tricks', () => {\n const playerA = ['J']\n const playerB = ['3', 'J']\n const expected = { status: 'finished', cards: 5, tricks: 2 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('more tricks', () => {\n const playerA = ['J', '2', '4']\n const playerB = ['3', 'J', 'A']\n const expected = { status: 'finished', cards: 12, tricks: 4 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n xit('simple loop with decks of 4 cards', () => {\n const playerA = ['2', '3', 'J', '6']\n const playerB = ['K', '5', 'J', '7']\n const expected = { status: 'loop', cards: 16, tricks: 4 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('easy card combination', () => {\n const playerA = [\n '4', '8', '7', '5', '4', '10', '3', '9', '7', '3',\n '10', '10', '6', '8', '2', '8', '5', '4', '5', '9',\n '6', '5', '2', '8', '10', '9',\n ]\n const playerB = [\n '6', '9', '4', '7', '2', '2', '3', '6', '7', '3',\n 'A', 'A', 'A', 'A', 'K', 'K', 'K', 'K', 'Q', 'Q',\n 'Q', 'Q', 'J', 'J', 'J', 'J',\n ]\n const expected = { status: 'finished', cards: 40, tricks: 4 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('easy card combination, inverted decks', () => {\n const playerA = [\n '3', '3', '5', '7', '3', '2', '10', '7', '6', '7',\n 'A', 'A', 'A', 'A', 'K', 'K', 'K', 'K', 'Q', 'Q',\n 'Q', 'Q', 'J', 'J', 'J', 'J',\n ]\n const playerB = [\n '5', '10', '8', '2', '6', '7', '2', '4', '9', '2',\n '6', '10', '10', '5', '4', '8', '4', '8', '6', '9',\n '8', '5', '9', '3', '4', '9',\n ]\n const expected = { status: 'finished', cards: 40, tricks: 4 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('mirrored decks', () => {\n const playerA = [\n '2', 'A', '3', 'A', '3', 'K', '4', 'K', '2', 'Q',\n '2', 'Q', '10', 'J', '5', 'J', '6', '10', '2', '9',\n '10', '7', '3', '9', '6', '9',\n ]\n const playerB = [\n '6', 'A', '4', 'A', '7', 'K', '4', 'K', '7', 'Q',\n '7', 'Q', '5', 'J', '8', 'J', '4', '5', '8', '9',\n '10', '6', '8', '3', '8', '5',\n ]\n const expected = { status: 'finished', cards: 59, tricks: 4 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('opposite decks', () => {\n const playerA = [\n '4', 'A', '9', 'A', '4', 'K', '9', 'K', '6', 'Q',\n '8', 'Q', '8', 'J', '10', 'J', '9', '8', '4', '6',\n '3', '6', '5', '2', '4', '3',\n ]\n const playerB = [\n '10', '7', '3', '2', '9', '2', '7', '8', '7', '5',\n 'J', '7', 'J', '10', 'Q', '10', 'Q', '3', 'K', '5',\n 'K', '6', 'A', '2', 'A', '5',\n ]\n const expected = { status: 'finished', cards: 151, tricks: 21 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('random decks #1', () => {\n const playerA = [\n 'K', '10', '9', '8', 'J', '8', '6', '9', '7', 'A',\n 'K', '5', '4', '4', 'J', '5', 'J', '4', '3', '5',\n '8', '6', '7', '7', '4', '9',\n ]\n const playerB = [\n '6', '3', 'K', 'A', 'Q', '10', 'A', '2', 'Q', '8',\n '2', '10', '10', '2', 'Q', '3', 'K', '9', '7', 'A',\n '3', 'Q', '5', 'J', '2', '6',\n ]\n const expected = { status: 'finished', cards: 542, tricks: 76 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('random decks #2', () => {\n const playerA = [\n '8', 'A', '4', '8', '5', 'Q', 'J', '2', '6', '2',\n '9', '7', 'K', 'A', '8', '10', 'K', '8', '10', '9',\n 'K', '6', '7', '3', 'K', '9',\n ]\n const playerB = [\n '10', '5', '2', '6', 'Q', 'J', 'A', '9', '5', '5',\n '3', '7', '3', 'J', 'A', '2', 'Q', '3', 'J', 'Q',\n '4', '10', '4', '7', '4', '6',\n ]\n const expected = { status: 'finished', cards: 327, tricks: 42 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('Kleber 1999', () => {\n const playerA = [\n '4', '8', '9', 'J', 'Q', '8', '5', '5', 'K', '2',\n 'A', '9', '8', '5', '10', 'A', '4', 'J', '3', 'K',\n '6', '9', '2', 'Q', 'K', '7',\n ]\n const playerB = [\n '10', 'J', '3', '2', '4', '10', '4', '7', '5', '3',\n '6', '6', '7', 'A', 'J', 'Q', 'A', '7', '2', '10',\n '3', 'K', '9', '6', '8', 'Q',\n ]\n const expected = { status: 'finished', cards: 5790, tricks: 805 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('Collins 2006', () => {\n const playerA = [\n 'A', '8', 'Q', 'K', '9', '10', '3', '7', '4', '2',\n 'Q', '3', '2', '10', '9', 'K', 'A', '8', '7', '7',\n '4', '5', 'J', '9', '2', '10',\n ]\n const playerB = [\n '4', 'J', 'A', 'K', '8', '5', '6', '6', 'A', '6',\n '5', 'Q', '4', '6', '10', '8', 'J', '2', '5', '7',\n 'Q', 'J', '3', '3', 'K', '9',\n ]\n const expected = { status: 'finished', cards: 6913, tricks: 960 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('Mann and Wu 2007', () => {\n const playerA = [\n 'K', '2', 'K', 'K', '3', '3', '6', '10', 'K', '6',\n 'A', '2', '5', '5', '7', '9', 'J', 'A', 'A', '3',\n '4', 'Q', '4', '8', 'J', '6',\n ]\n const playerB = [\n '4', '5', '2', 'Q', '7', '9', '9', 'Q', '7', 'J',\n '9', '8', '10', '3', '10', 'J', '4', '10', '8', '6',\n '8', '7', 'A', 'Q', '5', '2',\n ]\n const expected = { status: 'finished', cards: 7157, tricks: 1007 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('Nessler 2012', () => {\n const playerA = [\n '10', '3', '6', '7', 'Q', '2', '9', '8', '2', '8',\n '4', 'A', '10', '6', 'K', '2', '10', 'A', '5', 'A',\n '2', '4', 'Q', 'J', 'K', '4',\n ]\n const playerB = [\n '10', 'Q', '4', '6', 'J', '9', '3', 'J', '9', '3',\n '3', 'Q', 'K', '5', '9', '5', 'K', '6', '5', '7',\n '8', 'J', 'A', '7', '8', '7',\n ]\n const expected = { status: 'finished', cards: 7207, tricks: 1015 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('Anderson 2013', () => {\n const playerA = [\n '6', '7', 'A', '3', 'Q', '3', '5', 'J', '3', '2',\n 'J', '7', '4', '5', 'Q', '10', '5', 'A', 'J', '2',\n 'K', '8', '9', '9', 'K', '3',\n ]\n const playerB = [\n '4', 'J', '6', '9', '8', '5', '10', '7', '9', 'Q',\n '2', '7', '10', '8', '4', '10', 'A', '6', '4', 'A',\n '6', '8', 'Q', 'K', 'K', '2',\n ]\n const expected = { status: 'finished', cards: 7225, tricks: 1016 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('Rucklidge 2014', () => {\n const playerA = [\n '8', 'J', '2', '9', '4', '4', '5', '8', 'Q', '3',\n '9', '3', '6', '2', '8', 'A', 'A', 'A', '9', '4',\n '7', '2', '5', 'Q', 'Q', '3',\n ]\n const playerB = [\n 'K', '7', '10', '6', '3', 'J', 'A', '7', '6', '5',\n '5', '8', '10', '9', '10', '4', '2', '7', 'K', 'Q',\n '10', 'K', '6', 'J', 'J', 'K',\n ]\n const expected = { status: 'finished', cards: 7959, tricks: 1122 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('Nessler 2021', () => {\n const playerA = [\n '7', '2', '3', '4', 'K', '9', '6', '10', 'A', '8',\n '9', 'Q', '7', 'A', '4', '8', 'J', 'J', 'A', '4',\n '3', '2', '5', '6', '6', 'J',\n ]\n const playerB = [\n '3', '10', '8', '9', '8', 'K', 'K', '2', '5', '5',\n '7', '6', '4', '3', '5', '7', 'A', '9', 'J', 'K',\n '2', 'Q', '10', 'Q', '10', 'Q',\n ]\n const expected = { status: 'finished', cards: 7972, tricks: 1106 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('Nessler 2022', () => {\n const playerA = [\n '2', '10', '10', 'A', 'J', '3', '8', 'Q', '2', '5',\n '5', '5', '9', '2', '4', '3', '10', 'Q', 'A', 'K',\n 'Q', 'J', 'J', '9', 'Q', 'K',\n ]\n const playerB = [\n '10', '7', '6', '3', '6', 'A', '8', '9', '4', '3',\n 'K', 'J', '6', 'K', '4', '9', '7', '8', '5', '7',\n '8', '2', 'A', '7', '4', '6',\n ]\n const expected = { status: 'finished', cards: 8344, tricks: 1164 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n\n // prettier-ignore\n xit('Casella 2024, first infinite game found', () => {\n const playerA = [\n '2', '8', '4', 'K', '5', '2', '3', 'Q', '6', 'K',\n 'Q', 'A', 'J', '3', '5', '9', '8', '3', 'A', 'A',\n 'J', '4', '4', 'J', '7', '5',\n ]\n const playerB = [\n '7', '7', '8', '6', '10', '10', '6', '10', '7', '2',\n 'Q', '6', '3', '2', '4', 'K', 'Q', '10', 'J', '5',\n '9', '8', '9', '9', 'K', 'A',\n ]\n const expected = { status: 'loop', cards: 474, tricks: 66 }\n expect(simulateGame(playerA, playerB)).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/camicia/camicia.ts", "content": "export const simulateGame = (playerA: unknown, playerB: unknown): unknown => {\n throw new Error('Remove this statement and implement this function')\n}\n" }, { "path": "exercises/practice/camicia/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/camicia/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/camicia/package.json", "content": "{\n \"name\": \"@exercism/typescript-camicia\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/camicia/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/camicia/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/circular-buffer/.docs/instructions.md", "content": "# Instructions\n\nA circular buffer, cyclic buffer or ring buffer is a data structure that uses a single, fixed-size buffer as if it were connected end-to-end.\n\nA circular buffer first starts empty and of some predefined length.\nFor example, this is a 7-element buffer:\n\n```text\n[ ][ ][ ][ ][ ][ ][ ]\n```\n\nAssume that a 1 is written into the middle of the buffer (exact starting location does not matter in a circular buffer):\n\n```text\n[ ][ ][ ][1][ ][ ][ ]\n```\n\nThen assume that two more elements are added ā€” 2 & 3 ā€” which get appended after the 1:\n\n```text\n[ ][ ][ ][1][2][3][ ]\n```\n\nIf two elements are then removed from the buffer, the oldest values inside the buffer are removed.\nThe two elements removed, in this case, are 1 & 2, leaving the buffer with just a 3:\n\n```text\n[ ][ ][ ][ ][ ][3][ ]\n```\n\nIf the buffer has 7 elements then it is completely full:\n\n```text\n[5][6][7][8][9][3][4]\n```\n\nWhen the buffer is full an error will be raised, alerting the client that further writes are blocked until a slot becomes free.\n\nWhen the buffer is full, the client can opt to overwrite the oldest data with a forced write.\nIn this case, two more elements ā€” A & B ā€” are added and they overwrite the 3 & 4:\n\n```text\n[5][6][7][8][9][A][B]\n```\n\n3 & 4 have been replaced by A & B making 5 now the oldest data in the buffer.\nFinally, if two elements are removed then what would be returned is 5 & 6 yielding the buffer:\n\n```text\n[ ][ ][7][8][9][A][B]\n```\n\nBecause there is space available, if the client again uses overwrite to store C & D then the space where 5 & 6 were stored previously will be used not the location of 7 & 8.\n7 is still the oldest element and the buffer is once again full.\n\n```text\n[C][D][7][8][9][A][B]\n```\n" }, { "path": "exercises/practice/circular-buffer/.meta/config.json", "content": "{\n \"authors\": [\n \"jspengeman\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"circular-buffer.ts\"\n ],\n \"test\": [\n \"circular-buffer.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"A data structure that uses a single, fixed-size buffer as if it were connected end-to-end.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Circular_buffer\"\n}\n" }, { "path": "exercises/practice/circular-buffer/.meta/proof.ci.ts", "content": "interface Buffer {\n read(): T | undefined\n write(value: T): void\n clear(): void\n}\n\nexport class BufferFullError extends Error {\n constructor() {\n super('Buffer is full.')\n }\n}\n\nexport class BufferEmptyError extends Error {\n constructor() {\n super('Buffer is empty.')\n }\n}\n\nexport default class CircularBuffer implements Buffer {\n private capacity: number\n private buffer: T[] = []\n\n constructor(capacity: number) {\n this.capacity = capacity\n }\n\n public read(): T | undefined {\n if (this.buffer.length === 0) {\n throw new BufferEmptyError()\n }\n return this.buffer.shift()\n }\n\n public write(value: T): void {\n if (this.buffer.length + 1 > this.capacity) {\n throw new BufferFullError()\n }\n this.buffer.push(value)\n }\n\n public forceWrite(value: T): void {\n if (this.buffer.length === this.capacity) {\n this.read()\n }\n this.buffer.push(value)\n }\n\n public clear(): void {\n this.buffer = []\n }\n}\n" }, { "path": "exercises/practice/circular-buffer/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[28268ed4-4ff3-45f3-820e-895b44d53dfa]\ndescription = \"reading empty buffer should fail\"\n\n[2e6db04a-58a1-425d-ade8-ac30b5f318f3]\ndescription = \"can read an item just written\"\n\n[90741fe8-a448-45ce-be2b-de009a24c144]\ndescription = \"each item may only be read once\"\n\n[be0e62d5-da9c-47a8-b037-5db21827baa7]\ndescription = \"items are read in the order they are written\"\n\n[2af22046-3e44-4235-bfe6-05ba60439d38]\ndescription = \"full buffer can't be written to\"\n\n[547d192c-bbf0-4369-b8fa-fc37e71f2393]\ndescription = \"a read frees up capacity for another write\"\n\n[04a56659-3a81-4113-816b-6ecb659b4471]\ndescription = \"read position is maintained even across multiple writes\"\n\n[60c3a19a-81a7-43d7-bb0a-f07242b1111f]\ndescription = \"items cleared out of buffer can't be read\"\n\n[45f3ae89-3470-49f3-b50e-362e4b330a59]\ndescription = \"clear frees up capacity for another write\"\n\n[e1ac5170-a026-4725-bfbe-0cf332eddecd]\ndescription = \"clear does nothing on empty buffer\"\n\n[9c2d4f26-3ec7-453f-a895-7e7ff8ae7b5b]\ndescription = \"overwrite acts like write on non-full buffer\"\n\n[880f916b-5039-475c-bd5c-83463c36a147]\ndescription = \"overwrite replaces the oldest item on full buffer\"\n\n[bfecab5b-aca1-4fab-a2b0-cd4af2b053c3]\ndescription = \"overwrite replaces the oldest item remaining in buffer following a read\"\n\n[9cebe63a-c405-437b-8b62-e3fdc1ecec5a]\ndescription = \"initial clear does not affect wrapping around\"\n" }, { "path": "exercises/practice/circular-buffer/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/circular-buffer/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/circular-buffer/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/circular-buffer/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/circular-buffer/circular-buffer.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport CircularBuffer, {\n BufferFullError,\n BufferEmptyError,\n} from './circular-buffer.ts'\n\ndescribe('CircularBuffer', () => {\n it('reading an empty buffer throws a BufferEmptyError', () => {\n const buffer = new CircularBuffer(1)\n expect(() => buffer.read()).toThrow(BufferEmptyError)\n })\n\n xit('write and read back one item', () => {\n const buffer = new CircularBuffer(1)\n buffer.write('1')\n expect(buffer.read()).toBe('1')\n expect(() => buffer.read()).toThrow(BufferEmptyError)\n })\n\n xit('write and read back multiple items', () => {\n const buffer = new CircularBuffer(2)\n buffer.write('1')\n buffer.write('2')\n expect(buffer.read()).toBe('1')\n expect(buffer.read()).toBe('2')\n expect(() => buffer.read()).toThrow(BufferEmptyError)\n })\n\n xit('clearing a buffer', () => {\n const buffer = new CircularBuffer(2)\n buffer.write('1')\n buffer.write('2')\n buffer.clear()\n expect(() => buffer.read()).toThrow(BufferEmptyError)\n buffer.write('3')\n buffer.write('4')\n expect(buffer.read()).toBe('3')\n expect(buffer.read()).toBe('4')\n })\n\n xit('alternate write and read', () => {\n const buffer = new CircularBuffer(2)\n buffer.write('1')\n expect(buffer.read()).toBe('1')\n buffer.write('2')\n expect(buffer.read()).toBe('2')\n })\n\n xit('reads back oldest item', () => {\n const buffer = new CircularBuffer(3)\n buffer.write('1')\n buffer.write('2')\n buffer.read()\n buffer.write('3')\n expect(buffer.read()).toBe('2')\n expect(buffer.read()).toBe('3')\n })\n\n xit('writing to a full buffer throws a BufferFullError', () => {\n const buffer = new CircularBuffer(2)\n buffer.write('1')\n buffer.write('2')\n expect(() => buffer.write('A')).toThrow(BufferFullError)\n })\n\n xit('forced writes over write oldest item in a full buffer', () => {\n const buffer = new CircularBuffer(2)\n buffer.write('1')\n buffer.write('2')\n buffer.forceWrite('A')\n expect(buffer.read()).toBe('2')\n expect(buffer.read()).toBe('A')\n expect(() => buffer.read()).toThrow(BufferEmptyError)\n })\n\n xit('forced writes act like write in a non-full buffer', () => {\n const buffer = new CircularBuffer(2)\n buffer.write('1')\n buffer.forceWrite('2')\n expect(buffer.read()).toBe('1')\n expect(buffer.read()).toBe('2')\n expect(() => buffer.read()).toThrow(BufferEmptyError)\n })\n\n xit('alternate force write and read into full buffer', () => {\n const buffer = new CircularBuffer(5)\n buffer.write('1')\n buffer.write('2')\n buffer.write('3')\n buffer.read()\n buffer.read()\n buffer.write('4')\n buffer.read()\n buffer.write('5')\n buffer.write('6')\n buffer.write('7')\n buffer.write('8')\n buffer.forceWrite('A')\n buffer.forceWrite('B')\n expect(buffer.read()).toBe('6')\n expect(buffer.read()).toBe('7')\n expect(buffer.read()).toBe('8')\n expect(buffer.read()).toBe('A')\n expect(buffer.read()).toBe('B')\n expect(() => buffer.read()).toThrow(BufferEmptyError)\n })\n})\n" }, { "path": "exercises/practice/circular-buffer/circular-buffer.ts", "content": "export default class CircularBuffer {\n constructor(initial: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n write(value: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n read(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n forceWrite(value: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n clear(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n\nexport class BufferFullError extends Error {\n constructor() {\n super()\n throw new Error('Remove this line and implement the function')\n }\n}\n\nexport class BufferEmptyError extends Error {\n constructor() {\n super()\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/circular-buffer/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/circular-buffer/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/circular-buffer/package.json", "content": "{\n \"name\": \"@exercism/typescript-circular-buffer\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/circular-buffer/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/circular-buffer/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/clock/.docs/instructions.md", "content": "# Instructions\n\nImplement a clock that handles times without dates.\n\nYou should be able to add and subtract minutes to it.\n\nTwo clocks that represent the same time should be equal to each other.\n" }, { "path": "exercises/practice/clock/.meta/config.json", "content": "{\n \"authors\": [\n \"rwaskiewicz\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"clock.ts\"\n ],\n \"test\": [\n \"clock.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement a clock that handles times without dates.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Pairing session with Erin Drummond\"\n}\n" }, { "path": "exercises/practice/clock/.meta/proof.ci.ts", "content": "export class Clock {\n private hour!: number\n private minute!: number\n\n constructor(hour: number, minute: number = 0) {\n this.reset()\n const totalMinutes = hour * 60 + minute\n this.adjustTime(totalMinutes)\n }\n\n private reset(): void {\n this.hour = 0\n this.minute = 0\n }\n\n public getHour(): number {\n return this.hour\n }\n\n public getMinute(): number {\n return this.minute\n }\n\n public toString(): string {\n return `${this.formatNumber(this.hour)}:${this.formatNumber(this.minute)}`\n }\n\n private formatNumber(numberToFormat: number): string {\n const numberString = numberToFormat.toString()\n return numberString.length === 1 ? `0${numberString}` : numberString\n }\n\n public plus(minutes: number): Clock {\n this.adjustTime(minutes)\n return this\n }\n\n public minus(minutes: number): Clock {\n this.adjustTime(-1 * minutes)\n return this\n }\n\n public equals(clock: Clock): boolean {\n return this.hour === clock.getHour() && this.minute === clock.getMinute()\n }\n\n private adjustTime(delta: number): void {\n const minutesPerDay = 1440\n const minutesPerHour = 60\n const hoursPerDay = 24\n\n delta = Math.abs(delta) >= minutesPerDay ? delta % minutesPerDay : delta\n\n const currentMinutes = this.hour * minutesPerHour + this.minute\n let newMinutes = (currentMinutes + delta) % minutesPerDay\n\n newMinutes = newMinutes < 0 ? (newMinutes += minutesPerDay) : newMinutes\n\n this.hour = Math.floor(newMinutes / minutesPerHour) % hoursPerDay\n this.minute = newMinutes - this.hour * minutesPerHour\n }\n}\n" }, { "path": "exercises/practice/clock/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[a577bacc-106b-496e-9792-b3083ea8705e]\ndescription = \"on the hour\"\n\n[b5d0c360-3b88-489b-8e84-68a1c7a4fa23]\ndescription = \"past the hour\"\n\n[473223f4-65f3-46ff-a9f7-7663c7e59440]\ndescription = \"midnight is zero hours\"\n\n[ca95d24a-5924-447d-9a96-b91c8334725c]\ndescription = \"hour rolls over\"\n\n[f3826de0-0925-4d69-8ac8-89aea7e52b78]\ndescription = \"hour rolls over continuously\"\n\n[a02f7edf-dfd4-4b11-b21a-86de3cc6a95c]\ndescription = \"sixty minutes is next hour\"\n\n[8f520df6-b816-444d-b90f-8a477789beb5]\ndescription = \"minutes roll over\"\n\n[c75c091b-47ac-4655-8d40-643767fc4eed]\ndescription = \"minutes roll over continuously\"\n\n[06343ecb-cf39-419d-a3f5-dcbae0cc4c57]\ndescription = \"hour and minutes roll over\"\n\n[be60810e-f5d9-4b58-9351-a9d1e90e660c]\ndescription = \"hour and minutes roll over continuously\"\n\n[1689107b-0b5c-4bea-aad3-65ec9859368a]\ndescription = \"hour and minutes roll over to exactly midnight\"\n\n[d3088ee8-91b7-4446-9e9d-5e2ad6219d91]\ndescription = \"negative hour\"\n\n[77ef6921-f120-4d29-bade-80d54aa43b54]\ndescription = \"negative hour rolls over\"\n\n[359294b5-972f-4546-bb9a-a85559065234]\ndescription = \"negative hour rolls over continuously\"\n\n[509db8b7-ac19-47cc-bd3a-a9d2f30b03c0]\ndescription = \"negative minutes\"\n\n[5d6bb225-130f-4084-84fd-9e0df8996f2a]\ndescription = \"negative minutes roll over\"\n\n[d483ceef-b520-4f0c-b94a-8d2d58cf0484]\ndescription = \"negative minutes roll over continuously\"\n\n[1cd19447-19c6-44bf-9d04-9f8305ccb9ea]\ndescription = \"negative sixty minutes is previous hour\"\n\n[9d3053aa-4f47-4afc-bd45-d67a72cef4dc]\ndescription = \"negative hour and minutes both roll over\"\n\n[51d41fcf-491e-4ca0-9cae-2aa4f0163ad4]\ndescription = \"negative hour and minutes both roll over continuously\"\n\n[d098e723-ad29-4ef9-997a-2693c4c9d89a]\ndescription = \"add minutes\"\n\n[b6ec8f38-e53e-4b22-92a7-60dab1f485f4]\ndescription = \"add no minutes\"\n\n[efd349dd-0785-453e-9ff8-d7452a8e7269]\ndescription = \"add to next hour\"\n\n[749890f7-aba9-4702-acce-87becf4ef9fe]\ndescription = \"add more than one hour\"\n\n[da63e4c1-1584-46e3-8d18-c9dc802c1713]\ndescription = \"add more than two hours with carry\"\n\n[be167a32-3d33-4cec-a8bc-accd47ddbb71]\ndescription = \"add across midnight\"\n\n[6672541e-cdae-46e4-8be7-a820cc3be2a8]\ndescription = \"add more than one day (1500 min = 25 hrs)\"\n\n[1918050d-c79b-4cb7-b707-b607e2745c7e]\ndescription = \"add more than two days\"\n\n[37336cac-5ede-43a5-9026-d426cbe40354]\ndescription = \"subtract minutes\"\n\n[0aafa4d0-3b5f-4b12-b3af-e3a9e09c047b]\ndescription = \"subtract to previous hour\"\n\n[9b4e809c-612f-4b15-aae0-1df0acb801b9]\ndescription = \"subtract more than an hour\"\n\n[8b04bb6a-3d33-4e6c-8de9-f5de6d2c70d6]\ndescription = \"subtract across midnight\"\n\n[07c3bbf7-ce4d-4658-86e8-4a77b7a5ccd9]\ndescription = \"subtract more than two hours\"\n\n[90ac8a1b-761c-4342-9c9c-cdc3ed5db097]\ndescription = \"subtract more than two hours with borrow\"\n\n[2149f985-7136-44ad-9b29-ec023a97a2b7]\ndescription = \"subtract more than one day (1500 min = 25 hrs)\"\n\n[ba11dbf0-ac27-4acb-ada9-3b853ec08c97]\ndescription = \"subtract more than two days\"\n\n[f2fdad51-499f-4c9b-a791-b28c9282e311]\ndescription = \"clocks with same time\"\n\n[5d409d4b-f862-4960-901e-ec430160b768]\ndescription = \"clocks a minute apart\"\n\n[a6045fcf-2b52-4a47-8bb2-ef10a064cba5]\ndescription = \"clocks an hour apart\"\n\n[66b12758-0be5-448b-a13c-6a44bce83527]\ndescription = \"clocks with hour overflow\"\n\n[2b19960c-212e-4a71-9aac-c581592f8111]\ndescription = \"clocks with hour overflow by several days\"\n\n[6f8c6541-afac-4a92-b0c2-b10d4e50269f]\ndescription = \"clocks with negative hour\"\n\n[bb9d5a68-e324-4bf5-a75e-0e9b1f97a90d]\ndescription = \"clocks with negative hour that wraps\"\n\n[56c0326d-565b-4d19-a26f-63b3205778b7]\ndescription = \"clocks with negative hour that wraps multiple times\"\n\n[c90b9de8-ddff-4ffe-9858-da44a40fdbc2]\ndescription = \"clocks with minute overflow\"\n\n[533a3dc5-59a7-491b-b728-a7a34fe325de]\ndescription = \"clocks with minute overflow by several days\"\n\n[fff49e15-f7b7-4692-a204-0f6052d62636]\ndescription = \"clocks with negative minute\"\n\n[605c65bb-21bd-43eb-8f04-878edf508366]\ndescription = \"clocks with negative minute that wraps\"\n\n[b87e64ed-212a-4335-91fd-56da8421d077]\ndescription = \"clocks with negative minute that wraps multiple times\"\n\n[822fbf26-1f3b-4b13-b9bf-c914816b53dd]\ndescription = \"clocks with negative hours and minutes\"\n\n[e787bccd-cf58-4a1d-841c-ff80eaaccfaa]\ndescription = \"clocks with negative hours and minutes that wrap\"\n\n[96969ca8-875a-48a1-86ae-257a528c44f5]\ndescription = \"full clock and zeroed clock\"\n" }, { "path": "exercises/practice/clock/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/clock/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/clock/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/clock/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/clock/clock.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { Clock } from './clock.ts'\n\ndescribe('Clock', () => {\n describe('Creating a new clock with an initial time', () => {\n it('on the hour', () => {\n expect(new Clock(8).toString()).toEqual('08:00')\n })\n\n xit('past the hour', () => {\n expect(new Clock(11, 9).toString()).toEqual('11:09')\n })\n\n xit('midnight is zero hours', () => {\n expect(new Clock(24, 0).toString()).toEqual('00:00')\n })\n\n xit('hour rolls over', () => {\n expect(new Clock(25, 0).toString()).toEqual('01:00')\n })\n\n xit('hour rolls over continuously', () => {\n expect(new Clock(100, 0).toString()).toEqual('04:00')\n })\n\n xit('sixty minutes is next hour', () => {\n expect(new Clock(1, 60).toString()).toEqual('02:00')\n })\n\n xit('minutes roll over', () => {\n expect(new Clock(0, 160).toString()).toEqual('02:40')\n })\n\n xit('minutes roll over continuously', () => {\n expect(new Clock(0, 1723).toString()).toEqual('04:43')\n })\n\n xit('hour and minutes roll over', () => {\n expect(new Clock(25, 160).toString()).toEqual('03:40')\n })\n\n xit('hour and minutes roll over continuously', () => {\n expect(new Clock(201, 3001).toString()).toEqual('11:01')\n })\n\n xit('hour and minutes roll over to exactly midnight', () => {\n expect(new Clock(72, 8640).toString()).toEqual('00:00')\n })\n\n xit('negative hour', () => {\n expect(new Clock(-1, 15).toString()).toEqual('23:15')\n })\n\n xit('negative hour rolls over', () => {\n expect(new Clock(-25, 0).toString()).toEqual('23:00')\n })\n\n xit('negative hour rolls over continuously', () => {\n expect(new Clock(-91, 0).toString()).toEqual('05:00')\n })\n\n xit('negative minutes', () => {\n expect(new Clock(1, -40).toString()).toEqual('00:20')\n })\n\n xit('negative minutes rolls over', () => {\n expect(new Clock(1, -160).toString()).toEqual('22:20')\n })\n\n xit('negative minutes rolls over continuously', () => {\n expect(new Clock(1, -4820).toString()).toEqual('16:40')\n })\n\n xit('negative hour and minutes both roll over', () => {\n expect(new Clock(-25, -160).toString()).toEqual('20:20')\n })\n\n xit('negative hour and minutes both roll over continuously', () => {\n expect(new Clock(-121, -5810).toString()).toEqual('22:10')\n })\n\n xdescribe('Adding and subtracting minutes', () => {\n xit('add minutes', () => {\n expect(new Clock(10, 0).plus(3).toString()).toEqual('10:03')\n })\n\n xit('add no minutes', () => {\n expect(new Clock(6, 41).plus(0).toString()).toEqual('06:41')\n })\n\n xit('add to next hour', () => {\n expect(new Clock(0, 45).plus(40).toString()).toEqual('01:25')\n })\n\n xit('add more than one hour', () => {\n expect(new Clock(10, 0).plus(61).toString()).toEqual('11:01')\n })\n\n xit('add more than two hours with carry', () => {\n expect(new Clock(0, 45).plus(160).toString()).toEqual('03:25')\n })\n\n xit('add across midnight', () => {\n expect(new Clock(23, 59).plus(2).toString()).toEqual('00:01')\n })\n\n xit('add more than one day (1500 min = 25 hrs)', () => {\n expect(new Clock(5, 32).plus(1500).toString()).toEqual('06:32')\n })\n\n xit('add more than two days', () => {\n expect(new Clock(1, 1).plus(3500).toString()).toEqual('11:21')\n })\n\n xit('subtract minutes', () => {\n expect(new Clock(10, 3).minus(3).toString()).toEqual('10:00')\n })\n\n xit('subtract to previous hour', () => {\n expect(new Clock(10, 3).minus(30).toString()).toEqual('09:33')\n })\n\n xit('subtract more than an hour', () => {\n expect(new Clock(10, 3).minus(70).toString()).toEqual('08:53')\n })\n\n xit('subtract across midnight', () => {\n expect(new Clock(0, 3).minus(4).toString()).toEqual('23:59')\n })\n\n xit('subtract more than two hours', () => {\n expect(new Clock(0, 0).minus(160).toString()).toEqual('21:20')\n })\n\n xit('subtract more than two hours with borrow', () => {\n expect(new Clock(6, 15).minus(160).toString()).toEqual('03:35')\n })\n\n xit('subtract more than one day (1500 min = 25 hrs)', () => {\n expect(new Clock(5, 32).minus(1500).toString()).toEqual('04:32')\n })\n\n xit('subtract more than two days', () => {\n expect(new Clock(2, 20).minus(3000).toString()).toEqual('00:20')\n })\n })\n\n xdescribe('Construct two separate clocks, set times, test if they are equal', () => {\n xit('clocks with same time', () => {\n expect(new Clock(15, 37).equals(new Clock(15, 37))).toBeTruthy()\n })\n\n xit('clocks a minute apart', () => {\n expect(new Clock(15, 36).equals(new Clock(15, 37))).toBeFalsy()\n })\n\n xit('clocks an hour apart', () => {\n expect(new Clock(14, 37).equals(new Clock(15, 37))).toBeFalsy()\n })\n\n xit('clocks with hour overflow', () => {\n expect(new Clock(10, 37).equals(new Clock(34, 37))).toBeTruthy()\n })\n\n xit('clocks with hour overflow by several days', () => {\n expect(new Clock(3, 11).equals(new Clock(99, 11))).toBeTruthy()\n })\n\n xit('clocks with negative hour', () => {\n expect(new Clock(22, 40).equals(new Clock(-2, 40))).toBeTruthy()\n })\n\n xit('clocks with negative hour that wraps', () => {\n expect(new Clock(17, 3).equals(new Clock(-31, 3))).toBeTruthy()\n })\n\n xit('clocks with negative hour that wraps multiple times', () => {\n expect(new Clock(13, 49).equals(new Clock(-83, 49))).toBeTruthy()\n })\n\n xit('clocks with minute overflow', () => {\n expect(new Clock(0, 1).equals(new Clock(0, 1441))).toBeTruthy()\n })\n\n xit('clocks with minute overflow by several days', () => {\n expect(new Clock(2, 2).equals(new Clock(2, 4322))).toBeTruthy()\n })\n\n xit('clocks with negative minute', () => {\n expect(new Clock(2, 40).equals(new Clock(3, -20))).toBeTruthy()\n })\n\n xit('clocks with negative minute that wraps', () => {\n expect(new Clock(4, 10).equals(new Clock(5, -1490))).toBeTruthy()\n })\n\n xit('clocks with negative minute that wraps multiple times', () => {\n expect(new Clock(6, 15).equals(new Clock(6, -4305))).toBeTruthy()\n })\n\n xit('clocks with negative hours and minutes', () => {\n expect(new Clock(7, 32).equals(new Clock(-12, -268))).toBeTruthy()\n })\n\n xit('clocks with negative hours and minutes that wrap', () => {\n expect(new Clock(18, 7).equals(new Clock(-54, -11513))).toBeTruthy()\n })\n })\n })\n})\n" }, { "path": "exercises/practice/clock/clock.ts", "content": "export class Clock {\n constructor(hour: unknown, minute?: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public toString(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public plus(minutes: unknown): Clock {\n throw new Error('Remove this line and implement the function')\n }\n\n public minus(minutes: unknown): Clock {\n throw new Error('Remove this line and implement the function')\n }\n\n public equals(other: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/clock/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/clock/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/clock/package.json", "content": "{\n \"name\": \"@exercism/typescript-clock\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/clock/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/clock/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/collatz-conjecture/.docs/instructions.md", "content": "# Instructions\n\nGiven a positive integer, return the number of steps it takes to reach 1 according to the rules of the Collatz Conjecture.\n" }, { "path": "exercises/practice/collatz-conjecture/.docs/introduction.md", "content": "# Introduction\n\nOne evening, you stumbled upon an old notebook filled with cryptic scribbles, as though someone had been obsessively chasing an idea.\nOn one page, a single question stood out: **Can every number find its way to 1?**\nIt was tied to something called the **Collatz Conjecture**, a puzzle that has baffled thinkers for decades.\n\nThe rules were deceptively simple.\nPick any positive integer.\n\n- If it's even, divide it by 2.\n- If it's odd, multiply it by 3 and add 1.\n\nThen, repeat these steps with the result, continuing indefinitely.\n\nCurious, you picked number 12 to test and began the journey:\n\n12 āžœ 6 āžœ 3 āžœ 10 āžœ 5 āžœ 16 āžœ 8 āžœ 4 āžœ 2 āžœ 1\n\nCounting from the second number (6), it took 9 steps to reach 1, and each time the rules repeated, the number kept changing.\nAt first, the sequence seemed unpredictable ā€” jumping up, down, and all over.\nYet, the conjecture claims that no matter the starting number, we'll always end at 1.\n\nIt was fascinating, but also puzzling.\nWhy does this always seem to work?\nCould there be a number where the process breaks down, looping forever or escaping into infinity?\nThe notebook suggested solving this could reveal something profound ā€” and with it, fame, [fortune][collatz-prize], and a place in history awaits whoever could unlock its secrets.\n\n[collatz-prize]: https://mathprize.net/posts/collatz-conjecture/\n" }, { "path": "exercises/practice/collatz-conjecture/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"collatz-conjecture.ts\"\n ],\n \"test\": [\n \"collatz-conjecture.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Calculate the number of steps to reach 1 using the Collatz conjecture.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Collatz_conjecture\"\n}\n" }, { "path": "exercises/practice/collatz-conjecture/.meta/proof.ci.ts", "content": "export function steps(n: number): number {\n if (n <= 0 || !Number.isInteger(n)) {\n throw new Error('Only positive integers are allowed')\n }\n return calculateStepsRecursively(n, 0)\n}\n\nfunction calculateStepsRecursively(n: number, count: number): number {\n if (n === 1) {\n return count\n } else if (n % 2 === 0) {\n return calculateStepsRecursively(n / 2, ++count)\n } else {\n return calculateStepsRecursively(n * 3 + 1, ++count)\n }\n}\n" }, { "path": "exercises/practice/collatz-conjecture/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[540a3d51-e7a6-47a5-92a3-4ad1838f0bfd]\ndescription = \"zero steps for one\"\n\n[3d76a0a6-ea84-444a-821a-f7857c2c1859]\ndescription = \"divide if even\"\n\n[754dea81-123c-429e-b8bc-db20b05a87b9]\ndescription = \"even and odd steps\"\n\n[ecfd0210-6f85-44f6-8280-f65534892ff6]\ndescription = \"large number of even and odd steps\"\n\n[7d4750e6-def9-4b86-aec7-9f7eb44f95a3]\ndescription = \"zero is an error\"\ninclude = false\n\n[2187673d-77d6-4543-975e-66df6c50e2da]\ndescription = \"zero is an error\"\nreimplements = \"7d4750e6-def9-4b86-aec7-9f7eb44f95a3\"\n\n[c6c795bf-a288-45e9-86a1-841359ad426d]\ndescription = \"negative value is an error\"\ninclude = false\n\n[ec11f479-56bc-47fd-a434-bcd7a31a7a2e]\ndescription = \"negative value is an error\"\nreimplements = \"c6c795bf-a288-45e9-86a1-841359ad426d\"\n" }, { "path": "exercises/practice/collatz-conjecture/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/collatz-conjecture/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/collatz-conjecture/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/collatz-conjecture/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/collatz-conjecture/collatz-conjecture.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { steps } from './collatz-conjecture.ts'\n\ndescribe('CollatzConjecture', () => {\n it('zero steps for one', () => {\n const expected = 0\n expect(steps(1)).toBe(expected)\n })\n\n xit('divide if even', () => {\n const expected = 4\n expect(steps(16)).toBe(expected)\n })\n\n xit('even and odd steps', () => {\n const expected = 9\n expect(steps(12)).toBe(expected)\n })\n\n xit('Large number of even and odd steps', () => {\n const expected = 152\n expect(steps(1000000)).toBe(expected)\n })\n\n xit('zero is an error', () => {\n const expected = 'Only positive integers are allowed'\n expect(() => {\n steps(0)\n }).toThrow(expected)\n })\n\n xit('negative value is an error', () => {\n const expected = 'Only positive integers are allowed'\n expect(() => {\n steps(-15)\n }).toThrow(expected)\n })\n\n xit('non-integer value is an error', () => {\n const expected = 'Only positive integers are allowed'\n expect(() => {\n steps(3.1415)\n }).toThrow(expected)\n })\n})\n" }, { "path": "exercises/practice/collatz-conjecture/collatz-conjecture.ts", "content": "export function steps(count: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/collatz-conjecture/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/collatz-conjecture/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/collatz-conjecture/package.json", "content": "{\n \"name\": \"@exercism/typescript-collatz-conjecture\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/collatz-conjecture/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/collatz-conjecture/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/complex-numbers/.docs/instructions.md", "content": "# Instructions\n\nA **complex number** is expressed in the form `z = a + b * i`, where:\n\n- `a` is the **real part** (a real number),\n\n- `b` is the **imaginary part** (also a real number), and\n\n- `i` is the **imaginary unit** satisfying `i^2 = -1`.\n\n## Operations on Complex Numbers\n\n### Conjugate\n\nThe conjugate of the complex number `z = a + b * i` is given by:\n\n```text\nzc = a - b * i\n```\n\n### Absolute Value\n\nThe absolute value (or modulus) of `z` is defined as:\n\n```text\n|z| = sqrt(a^2 + b^2)\n```\n\nThe square of the absolute value is computed as the product of `z` and its conjugate `zc`:\n\n```text\n|z|^2 = z * zc = a^2 + b^2\n```\n\n### Addition\n\nThe sum of two complex numbers `z1 = a + b * i` and `z2 = c + d * i` is computed by adding their real and imaginary parts separately:\n\n```text\nz1 + z2 = (a + b * i) + (c + d * i)\n = (a + c) + (b + d) * i\n```\n\n### Subtraction\n\nThe difference of two complex numbers is obtained by subtracting their respective parts:\n\n```text\nz1 - z2 = (a + b * i) - (c + d * i)\n = (a - c) + (b - d) * i\n```\n\n### Multiplication\n\nThe product of two complex numbers is defined as:\n\n```text\nz1 * z2 = (a + b * i) * (c + d * i)\n = (a * c - b * d) + (b * c + a * d) * i\n```\n\n### Reciprocal\n\nThe reciprocal of a non-zero complex number is given by:\n\n```text\n1 / z = 1 / (a + b * i)\n = a / (a^2 + b^2) - b / (a^2 + b^2) * i\n```\n\n### Division\n\nThe division of one complex number by another is given by:\n\n```text\nz1 / z2 = z1 * (1 / z2)\n = (a + b * i) / (c + d * i)\n = (a * c + b * d) / (c^2 + d^2) + (b * c - a * d) / (c^2 + d^2) * i\n```\n\n### Exponentiation\n\nRaising _e_ (the base of the natural logarithm) to a complex exponent can be expressed using Euler's formula:\n\n```text\ne^(a + b * i) = e^a * e^(b * i)\n = e^a * (cos(b) + i * sin(b))\n```\n\n## Implementation Requirements\n\nGiven that you should not use built-in support for complex numbers, implement the following operations:\n\n- **addition** of two complex numbers\n- **subtraction** of two complex numbers\n- **multiplication** of two complex numbers\n- **division** of two complex numbers\n- **conjugate** of a complex number\n- **absolute value** of a complex number\n- **exponentiation** of _e_ (the base of the natural logarithm) to a complex number\n" }, { "path": "exercises/practice/complex-numbers/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"complex-numbers.ts\"\n ],\n \"test\": [\n \"complex-numbers.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement complex numbers.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Complex_number\"\n}\n" }, { "path": "exercises/practice/complex-numbers/.meta/proof.ci.ts", "content": "export class ComplexNumber {\n public readonly real: number\n public readonly imag: number\n\n constructor(real: number, imag: number) {\n this.real = real\n this.imag = imag\n }\n\n public add(other: ComplexNumber): ComplexNumber {\n return new ComplexNumber(this.real + other.real, this.imag + other.imag)\n }\n\n public sub(other: ComplexNumber): ComplexNumber {\n return new ComplexNumber(this.real - other.real, this.imag - other.imag)\n }\n\n public mul(other: ComplexNumber): ComplexNumber {\n return new ComplexNumber(\n this.real * other.real - this.imag * other.imag,\n this.imag * other.real + this.real * other.imag\n )\n }\n\n public div(other: ComplexNumber): ComplexNumber {\n return new ComplexNumber(\n (this.real * other.real + this.imag * other.imag) /\n (other.real * other.real + other.imag * other.imag),\n (this.imag * other.real - this.real * other.imag) /\n (other.real * other.real + other.imag * other.imag)\n )\n }\n\n public get abs(): number {\n return Math.sqrt(this.real * this.real + this.imag * this.imag)\n }\n\n public get conj(): ComplexNumber {\n return new ComplexNumber(this.real, this.imag !== 0 ? -this.imag : 0)\n }\n\n public get exp(): ComplexNumber {\n return new ComplexNumber(\n Math.exp(this.real) * Math.cos(this.imag),\n Math.exp(this.real) * Math.sin(this.imag)\n )\n }\n}\n" }, { "path": "exercises/practice/complex-numbers/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[9f98e133-eb7f-45b0-9676-cce001cd6f7a]\ndescription = \"Real part of a purely real number\"\n\n[07988e20-f287-4bb7-90cf-b32c4bffe0f3]\ndescription = \"Real part of a purely imaginary number\"\n\n[4a370e86-939e-43de-a895-a00ca32da60a]\ndescription = \"Real part of a number with real and imaginary part\"\n\n[9b3fddef-4c12-4a99-b8f8-e3a42c7ccef6]\ndescription = \"Imaginary part of a purely real number\"\n\n[a8dafedd-535a-4ed3-8a39-fda103a2b01e]\ndescription = \"Imaginary part of a purely imaginary number\"\n\n[0f998f19-69ee-4c64-80ef-01b086feab80]\ndescription = \"Imaginary part of a number with real and imaginary part\"\n\n[a39b7fd6-6527-492f-8c34-609d2c913879]\ndescription = \"Imaginary unit\"\n\n[9a2c8de9-f068-4f6f-b41c-82232cc6c33e]\ndescription = \"Add purely real numbers\"\n\n[657c55e1-b14b-4ba7-bd5c-19db22b7d659]\ndescription = \"Add purely imaginary numbers\"\n\n[4e1395f5-572b-4ce8-bfa9-9a63056888da]\ndescription = \"Add numbers with real and imaginary part\"\n\n[1155dc45-e4f7-44b8-af34-a91aa431475d]\ndescription = \"Subtract purely real numbers\"\n\n[f95e9da8-acd5-4da4-ac7c-c861b02f774b]\ndescription = \"Subtract purely imaginary numbers\"\n\n[f876feb1-f9d1-4d34-b067-b599a8746400]\ndescription = \"Subtract numbers with real and imaginary part\"\n\n[8a0366c0-9e16-431f-9fd7-40ac46ff4ec4]\ndescription = \"Multiply purely real numbers\"\n\n[e560ed2b-0b80-4b4f-90f2-63cefc911aaf]\ndescription = \"Multiply purely imaginary numbers\"\n\n[4d1d10f0-f8d4-48a0-b1d0-f284ada567e6]\ndescription = \"Multiply numbers with real and imaginary part\"\n\n[b0571ddb-9045-412b-9c15-cd1d816d36c1]\ndescription = \"Divide purely real numbers\"\n\n[5bb4c7e4-9934-4237-93cc-5780764fdbdd]\ndescription = \"Divide purely imaginary numbers\"\n\n[c4e7fef5-64ac-4537-91c2-c6529707701f]\ndescription = \"Divide numbers with real and imaginary part\"\n\n[c56a7332-aad2-4437-83a0-b3580ecee843]\ndescription = \"Absolute value of a positive purely real number\"\n\n[cf88d7d3-ee74-4f4e-8a88-a1b0090ecb0c]\ndescription = \"Absolute value of a negative purely real number\"\n\n[bbe26568-86c1-4bb4-ba7a-da5697e2b994]\ndescription = \"Absolute value of a purely imaginary number with positive imaginary part\"\n\n[3b48233d-468e-4276-9f59-70f4ca1f26f3]\ndescription = \"Absolute value of a purely imaginary number with negative imaginary part\"\n\n[fe400a9f-aa22-4b49-af92-51e0f5a2a6d3]\ndescription = \"Absolute value of a number with real and imaginary part\"\n\n[fb2d0792-e55a-4484-9443-df1eddfc84a2]\ndescription = \"Conjugate a purely real number\"\n\n[e37fe7ac-a968-4694-a460-66cb605f8691]\ndescription = \"Conjugate a purely imaginary number\"\n\n[f7704498-d0be-4192-aaf5-a1f3a7f43e68]\ndescription = \"Conjugate a number with real and imaginary part\"\n\n[6d96d4c6-2edb-445b-94a2-7de6d4caaf60]\ndescription = \"Euler's identity/formula\"\n\n[2d2c05a0-4038-4427-a24d-72f6624aa45f]\ndescription = \"Exponential of 0\"\n\n[ed87f1bd-b187-45d6-8ece-7e331232c809]\ndescription = \"Exponential of a purely real number\"\n\n[08eedacc-5a95-44fc-8789-1547b27a8702]\ndescription = \"Exponential of a number with real and imaginary part\"\n" }, { "path": "exercises/practice/complex-numbers/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/complex-numbers/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/complex-numbers/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/complex-numbers/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/complex-numbers/complex-numbers.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { ComplexNumber } from './complex-numbers.ts'\n\ndescribe('Complex numbers', () => {\n it('Real part of a purely real number', () => {\n const expected = 1\n const actual = new ComplexNumber(1, 0).real\n\n expect(actual).toEqual(expected)\n })\n\n xit('Real part of a purely imaginary number', () => {\n const expected = 0\n const actual = new ComplexNumber(0, 1).real\n\n expect(actual).toEqual(expected)\n })\n\n xit('Real part of a number with real and imaginary part', () => {\n const expected = 1\n const actual = new ComplexNumber(1, 2).real\n\n expect(actual).toEqual(expected)\n })\n\n xit('Imaginary part of a purely real number', () => {\n const expected = 0\n const actual = new ComplexNumber(1, 0).imag\n\n expect(actual).toEqual(expected)\n })\n\n xit('Imaginary part of a purely imaginary number', () => {\n const expected = 1\n const actual = new ComplexNumber(0, 1).imag\n\n expect(actual).toEqual(expected)\n })\n\n xit('Imaginary part of a number with real and imaginary part', () => {\n const expected = 2\n const actual = new ComplexNumber(1, 2).imag\n\n expect(actual).toEqual(expected)\n })\n\n xit('Add purely real numbers', () => {\n const expected = new ComplexNumber(3, 0)\n const actual = new ComplexNumber(1, 0).add(new ComplexNumber(2, 0))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Add purely imaginary numbers', () => {\n const expected = new ComplexNumber(0, 3)\n const actual = new ComplexNumber(0, 1).add(new ComplexNumber(0, 2))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Add numbers with real and imaginary part', () => {\n const expected = new ComplexNumber(4, 6)\n const actual = new ComplexNumber(1, 2).add(new ComplexNumber(3, 4))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Subtract purely real numbers', () => {\n const expected = new ComplexNumber(-1, 0)\n const actual = new ComplexNumber(1, 0).sub(new ComplexNumber(2, 0))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Subtract purely imaginary numbers', () => {\n const expected = new ComplexNumber(0, -1)\n const actual = new ComplexNumber(0, 1).sub(new ComplexNumber(0, 2))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Subtract numbers with real and imaginary part', () => {\n const expected = new ComplexNumber(-2, -2)\n const actual = new ComplexNumber(1, 2).sub(new ComplexNumber(3, 4))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Multiply purely real numbers', () => {\n const expected = new ComplexNumber(2, 0)\n const actual = new ComplexNumber(1, 0).mul(new ComplexNumber(2, 0))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Multiply imaginary unit', () => {\n const expected = new ComplexNumber(-1, 0)\n const actual = new ComplexNumber(0, 1).mul(new ComplexNumber(0, 1))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Multiply purely imaginary numbers', () => {\n const expected = new ComplexNumber(-2, 0)\n const actual = new ComplexNumber(0, 1).mul(new ComplexNumber(0, 2))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Multiply numbers with real and imaginary part', () => {\n const expected = new ComplexNumber(-5, 10)\n const actual = new ComplexNumber(1, 2).mul(new ComplexNumber(3, 4))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Divide purely real numbers', () => {\n const expected = new ComplexNumber(0.5, 0)\n const actual = new ComplexNumber(1, 0).div(new ComplexNumber(2, 0))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Divide purely imaginary numbers', () => {\n const expected = new ComplexNumber(0.5, 0)\n const actual = new ComplexNumber(0, 1).div(new ComplexNumber(0, 2))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Divide numbers with real and imaginary part', () => {\n const expected = new ComplexNumber(0.44, 0.08)\n const actual = new ComplexNumber(1, 2).div(new ComplexNumber(3, 4))\n\n expect(actual).toEqual(expected)\n })\n\n xit('Absolute value of a positive purely real number', () => {\n const expected = 5\n const actual = new ComplexNumber(5, 0).abs\n\n expect(actual).toEqual(expected)\n })\n\n xit('Absolute value of a negative purely real number', () => {\n const expected = 5\n const actual = new ComplexNumber(-5, 0).abs\n\n expect(actual).toEqual(expected)\n })\n\n xit('Absolute value of a purely imaginary number with positive imaginary part', () => {\n const expected = 5\n const actual = new ComplexNumber(0, 5).abs\n\n expect(actual).toEqual(expected)\n })\n\n xit('Absolute value of a purely imaginary number with negative imaginary part', () => {\n const expected = 5\n const actual = new ComplexNumber(0, -5).abs\n\n expect(actual).toEqual(expected)\n })\n\n xit('Absolute value of a number with real and imaginary part', () => {\n const expected = 5\n const actual = new ComplexNumber(3, 4).abs\n\n expect(actual).toEqual(expected)\n })\n\n xit('Conjugate a purely real number', () => {\n const expected = new ComplexNumber(5, 0)\n const actual = new ComplexNumber(5, 0).conj\n\n expect(actual).toEqual(expected)\n })\n\n xit('Conjugate a purely imaginary number', () => {\n const expected = new ComplexNumber(0, -5)\n const actual = new ComplexNumber(0, 5).conj\n\n expect(actual).toEqual(expected)\n })\n\n xit('Conjugate a number with real and imaginary part', () => {\n const expected = new ComplexNumber(1, -1)\n const actual = new ComplexNumber(1, 1).conj\n\n expect(actual).toEqual(expected)\n })\n\n xit(\"Euler's identity/formula\", () => {\n const expected = new ComplexNumber(-1, 0)\n const actual = new ComplexNumber(0, Math.PI).exp\n\n expect(actual.real).toBeCloseTo(expected.real)\n expect(actual.imag).toBeCloseTo(expected.imag)\n })\n\n xit('Exponential of 0', () => {\n const expected = new ComplexNumber(1, 0)\n const actual = new ComplexNumber(0, 0).exp\n\n expect(actual.real).toBeCloseTo(expected.real)\n expect(actual.imag).toBeCloseTo(expected.imag)\n })\n\n xit('Exponential of a purely real number', () => {\n const expected = new ComplexNumber(Math.E, 0)\n const actual = new ComplexNumber(1, 0).exp\n\n expect(actual.real).toBeCloseTo(expected.real)\n expect(actual.imag).toBeCloseTo(expected.imag)\n })\n})\n" }, { "path": "exercises/practice/complex-numbers/complex-numbers.ts", "content": "export class ComplexNumber {\n constructor(real: unknown, imaginary: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public get real(): number {\n throw new Error('Remove this line and implement the function')\n }\n\n public get imag(): number {\n throw new Error('Remove this line and implement the function')\n }\n\n public add(other: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public sub(other: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public div(other: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public mul(other: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public get abs(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public get conj(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public get exp(): ComplexNumber {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/complex-numbers/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/complex-numbers/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/complex-numbers/package.json", "content": "{\n \"name\": \"@exercism/typescript-complex-numbers\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/complex-numbers/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/complex-numbers/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/connect/.docs/instructions.md", "content": "# Instructions\n\nCompute the result for a game of Hex / Polygon.\n\nThe abstract boardgame known as [Hex][hex] / Polygon / CON-TAC-TIX is quite simple in rules, though complex in practice.\nTwo players place stones on a parallelogram with hexagonal fields.\nThe player to connect his/her stones to the opposite side first wins.\nThe four sides of the parallelogram are divided between the two players (i.e. one player gets assigned a side and the side directly opposite it and the other player gets assigned the two other sides).\n\nYour goal is to build a program that given a simple representation of a board computes the winner (or lack thereof).\nNote that all games need not be \"fair\".\n(For example, players may have mismatched piece counts or the game's board might have a different width and height.)\n\nThe boards look like this:\n\n```text\n. O . X .\n . X X O .\n O O O X .\n . X O X O\n X O O O X\n```\n\n\"Player `O`\" plays from top to bottom, \"Player `X`\" plays from left to right.\nIn the above example `O` has made a connection from left to right but nobody has won since `O` didn't connect top and bottom.\n\n[hex]: https://en.wikipedia.org/wiki/Hex_%28board_game%29\n" }, { "path": "exercises/practice/connect/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"connect.ts\"\n ],\n \"test\": [\n \"connect.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Compute the result for a game of Hex / Polygon.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/connect/.meta/proof.ci.ts", "content": "/**\n * \"Player O\" plays from top to bottom, \"Player X\" plays from left to right.\n * @param board\n */\nexport class Board {\n private board: string[][]\n\n constructor(board: string[]) {\n this.board = board.map((b) => [...b])\n }\n\n public winner(): '' | 'X' | 'O' {\n const players = ['X', 'O'] as const\n for (const player of players) {\n if (this.checkWin(player)) {\n return player\n }\n }\n return ''\n }\n\n private checkWin(player: 'X' | 'O'): boolean {\n const positions = this.startPositions(player)\n for (const position of positions) {\n if (this.search(position, player, [])) {\n return true\n }\n }\n return false\n }\n\n private search(\n pos: { x: number; y: number },\n XorO: 'X' | 'O',\n checked: Array<{ x: number; y: number }>\n ): boolean {\n if (!this.matches(pos, XorO)) {\n return false\n }\n if (this.winningSpot(pos, XorO)) {\n return true\n }\n checked = checked.slice(0)\n checked.push(pos)\n const matches = this.neighbors(pos).filter(\n ({ x, y }) =>\n this.matches({ x, y }, XorO) &&\n checked.filter((spot) => spot.x === x && spot.y === y).length === 0\n )\n if (matches.length === 0) {\n return false\n }\n\n return matches.filter((spot) => this.search(spot, XorO, checked)).length > 0\n }\n\n private neighbors(pos: {\n x: number\n y: number\n }): Array<{ x: number; y: number }> {\n return [\n { x: pos.x, y: pos.y + 2 },\n { x: pos.x, y: pos.y - 2 },\n\n { x: pos.x + 1, y: pos.y + 1 },\n { x: pos.x - 1, y: pos.y + 1 },\n\n { x: pos.x + 1, y: pos.y - 1 },\n { x: pos.x - 1, y: pos.y - 1 },\n ]\n }\n\n private startPositions(XorO: 'X' | 'O'): Array<{ x: number; y: number }> {\n return XorO === 'X'\n ? this.board.map((_, i) => ({ x: i, y: i }))\n : this.board[0].map((_, i) => ({ x: 0, y: i }))\n }\n\n private winningSpot(pos: { x: number; y: number }, XorO: 'X' | 'O'): boolean {\n return XorO === 'X'\n ? pos.y === this.board[0].length - 1 + pos.x\n : pos.x === this.board.length - 1\n }\n\n private matches(pos: { x: number; y: number }, XorO: 'X' | 'O'): boolean {\n return this.board[pos.x] !== undefined && this.board[pos.x][pos.y] === XorO\n }\n}\n" }, { "path": "exercises/practice/connect/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[6eff0df4-3e92-478d-9b54-d3e8b354db56]\ndescription = \"an empty board has no winner\"\n\n[298b94c0-b46d-45d8-b34b-0fa2ea71f0a4]\ndescription = \"X can win on a 1x1 board\"\n\n[763bbae0-cb8f-4f28-bc21-5be16a5722dc]\ndescription = \"O can win on a 1x1 board\"\n\n[819fde60-9ae2-485e-a024-cbb8ea68751b]\ndescription = \"only edges does not make a winner\"\n\n[2c56a0d5-9528-41e5-b92b-499dfe08506c]\ndescription = \"illegal diagonal does not make a winner\"\n\n[41cce3ef-43ca-4963-970a-c05d39aa1cc1]\ndescription = \"nobody wins crossing adjacent angles\"\n\n[cd61c143-92f6-4a8d-84d9-cb2b359e226b]\ndescription = \"X wins crossing from left to right\"\n\n[73d1eda6-16ab-4460-9904-b5f5dd401d0b]\ndescription = \"O wins crossing from top to bottom\"\n\n[c3a2a550-944a-4637-8b3f-1e1bf1340a3d]\ndescription = \"X wins using a convoluted path\"\n\n[17e76fa8-f731-4db7-92ad-ed2a285d31f3]\ndescription = \"X wins using a spiral path\"\n" }, { "path": "exercises/practice/connect/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/connect/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/connect/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/connect/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/connect/connect.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Board } from './connect.ts'\n\ndescribe('Judging a game of connect', () => {\n it('an empty board has no winner', () => {\n const board = [\n '. . . . .',\n ' . . . . .',\n ' . . . . .',\n ' . . . . .',\n ' . . . . .',\n ]\n expect(new Board(board).winner()).toEqual('')\n })\n\n xit('X can win on a 1x1 board', () => {\n const board = ['X']\n expect(new Board(board).winner()).toEqual('X')\n })\n\n xit('O can win on a 1x1 board', () => {\n const board = ['O']\n expect(new Board(board).winner()).toEqual('O')\n })\n\n xit('only edges does not make a winner', () => {\n const board = ['O O O X', ' X . . X', ' X . . X', ' X O O O']\n expect(new Board(board).winner()).toEqual('')\n })\n\n xit('illegal diagonal does not make a winner', () => {\n const board = [\n 'X O . .',\n ' O X X X',\n ' O X O .',\n ' . O X .',\n ' X X O O',\n ]\n expect(new Board(board).winner()).toEqual('')\n })\n\n xit('nobody wins crossing adjacent angles', () => {\n const board = [\n 'X . . .',\n ' . X O .',\n ' O . X O',\n ' . O . X',\n ' . . O .',\n ]\n expect(new Board(board).winner()).toEqual('')\n })\n\n xit('X wins crossing from left to right', () => {\n const board = [\n '. O . .',\n ' O X X X',\n ' O X O .',\n ' X X O X',\n ' . O X .',\n ]\n expect(new Board(board).winner()).toEqual('X')\n })\n\n xit('O wins crossing from top to bottom', () => {\n const board = [\n '. O . .',\n ' O X X X',\n ' O O O .',\n ' X X O X',\n ' . O X .',\n ]\n expect(new Board(board).winner()).toEqual('O')\n })\n\n xit('X wins using a convoluted path', () => {\n const board = [\n '. X X . .',\n ' X . X . X',\n ' . X . X .',\n ' . X X . .',\n ' O O O O O',\n ]\n expect(new Board(board).winner()).toEqual('X')\n })\n\n xit('X wins using a spiral path', () => {\n const board = [\n 'O X X X X X X X X',\n ' O X O O O O O O O',\n ' O X O X X X X X O',\n ' O X O X O O O X O',\n ' O X O X X X O X O',\n ' O X O O O X O X O',\n ' O X X X X X O X O',\n ' O O O O O O O X O',\n ' X X X X X X X X O',\n ]\n expect(new Board(board).winner()).toEqual('X')\n })\n})\n" }, { "path": "exercises/practice/connect/connect.ts", "content": "export class Board {\n constructor(board: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public winner(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/connect/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/connect/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/connect/package.json", "content": "{\n \"name\": \"@exercism/typescript-connect\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/connect/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/connect/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/crypto-square/.docs/instructions.md", "content": "# Instructions\n\nImplement the classic method for composing secret messages called a square code.\n\nGiven an English text, output the encoded version of that text.\n\nFirst, the input is normalized: the spaces and punctuation are removed from the English text and the message is down-cased.\n\nThen, the normalized characters are broken into rows.\nThese rows can be regarded as forming a rectangle when printed with intervening newlines.\n\nFor example, the sentence\n\n```text\n\"If man was meant to stay on the ground, god would have given us roots.\"\n```\n\nis normalized to:\n\n```text\n\"ifmanwasmeanttostayonthegroundgodwouldhavegivenusroots\"\n```\n\nThe plaintext should be organized into a rectangle as square as possible.\nThe size of the rectangle should be decided by the length of the message.\n\nIf `c` is the number of columns and `r` is the number of rows, then for the rectangle `r` x `c` find the smallest possible integer `c` such that:\n\n- `r * c >= length of message`,\n- and `c >= r`,\n- and `c - r <= 1`.\n\nOur normalized text is 54 characters long, dictating a rectangle with `c = 8` and `r = 7`:\n\n```text\n\"ifmanwas\"\n\"meanttos\"\n\"tayonthe\"\n\"groundgo\"\n\"dwouldha\"\n\"vegivenu\"\n\"sroots \"\n```\n\nThe coded message is obtained by reading down the columns going left to right.\n\nThe message above is coded as:\n\n```text\n\"imtgdvsfearwermayoogoanouuiontnnlvtwttddesaohghnsseoau\"\n```\n\nOutput the encoded text in chunks that fill perfect rectangles `(r X c)`, with `c` chunks of `r` length, separated by spaces.\nFor phrases that are `n` characters short of the perfect rectangle, pad each of the last `n` chunks with a single trailing space.\n\n```text\n\"imtgdvs fearwer mayoogo anouuio ntnnlvt wttddes aohghn sseoau \"\n```\n\nNotice that were we to stack these, we could visually decode the ciphertext back in to the original message:\n\n```text\n\"imtgdvs\"\n\"fearwer\"\n\"mayoogo\"\n\"anouuio\"\n\"ntnnlvt\"\n\"wttddes\"\n\"aohghn \"\n\"sseoau \"\n```\n" }, { "path": "exercises/practice/crypto-square/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"crypto-square.ts\"\n ],\n \"test\": [\n \"crypto-square.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement the classic method for composing secret messages called a square code.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": true,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"J Dalbey's Programming Practice problems\",\n \"source_url\": \"https://users.csc.calpoly.edu/~jdalbey/103/Projects/ProgrammingPractice.html\"\n}\n" }, { "path": "exercises/practice/crypto-square/.meta/proof.ci.ts", "content": "export class Crypto {\n constructor(private readonly input: string) {}\n\n private get plaintext(): string {\n return this.input.toLowerCase().replace(/[^a-zA-Z0-9]/g, '')\n }\n\n public get ciphertext(): string {\n const chunkSize = this.size\n if (chunkSize === 0) {\n return ''\n }\n\n const splitRegex = new RegExp(`.{1,${chunkSize}}`, 'g')\n return this.ciphertextSegments()\n .join('')\n .match(splitRegex)\n .map((item) => item.padEnd(chunkSize, ' '))\n .join(' ')\n }\n\n public get size(): number {\n const realLength = Math.sqrt(this.plaintext.length)\n return Math.ceil(realLength)\n }\n\n private ciphertextSegments(): string[] {\n const textSegments = this.plaintextSegments()\n const columns: string[][] = []\n let i: number\n let j: number\n let currentSegment: RegExpMatchArray[number]\n let currentLetter: RegExpMatchArray[number][number]\n\n for (i = 0; i < this.size; i += 1) {\n columns.push([])\n }\n\n for (i = 0; i < textSegments.length; i += 1) {\n currentSegment = textSegments[i]\n\n for (j = 0; j < currentSegment.length; j += 1) {\n currentLetter = currentSegment[j]\n columns[j].push(currentLetter)\n }\n }\n\n const result: string[] = []\n for (i = 0; i < columns.length; i += 1) {\n result[i] = columns[i].join('')\n }\n\n return result\n }\n\n private plaintextSegments(): RegExpMatchArray {\n const plainText = this.plaintext\n const chunkSize = this.size\n\n const splitRegex = new RegExp(`.{1,${chunkSize}}`, 'g')\n return plainText.match(splitRegex)\n }\n}\n" }, { "path": "exercises/practice/crypto-square/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[407c3837-9aa7-4111-ab63-ec54b58e8e9f]\ndescription = \"empty plaintext results in an empty ciphertext\"\n\n[aad04a25-b8bb-4304-888b-581bea8e0040]\ndescription = \"normalization results in empty plaintext\"\n\n[64131d65-6fd9-4f58-bdd8-4a2370fb481d]\ndescription = \"Lowercase\"\n\n[63a4b0ed-1e3c-41ea-a999-f6f26ba447d6]\ndescription = \"Remove spaces\"\n\n[1b5348a1-7893-44c1-8197-42d48d18756c]\ndescription = \"Remove punctuation\"\n\n[8574a1d3-4a08-4cec-a7c7-de93a164f41a]\ndescription = \"9 character plaintext results in 3 chunks of 3 characters\"\n\n[a65d3fa1-9e09-43f9-bcec-7a672aec3eae]\ndescription = \"8 character plaintext results in 3 chunks, the last one with a trailing space\"\n\n[fbcb0c6d-4c39-4a31-83f6-c473baa6af80]\ndescription = \"54 character plaintext results in 7 chunks, the last two with trailing spaces\"\ninclude = false\n\n[33fd914e-fa44-445b-8f38-ff8fbc9fe6e6]\ndescription = \"54 character plaintext results in 8 chunks, the last two with trailing spaces\"\nreimplements = \"fbcb0c6d-4c39-4a31-83f6-c473baa6af80\"\n" }, { "path": "exercises/practice/crypto-square/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/crypto-square/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/crypto-square/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/crypto-square/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/crypto-square/crypto-square.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Crypto } from './crypto-square.ts'\n\ndescribe('Crypto', () => {\n it('empty plaintext results in an empty ciphertext', () => {\n const crypto = new Crypto('')\n expect(crypto.ciphertext).toEqual('')\n })\n\n xit('normalization results in empty plaintext', () => {\n const crypto = new Crypto('... --- ...')\n expect(crypto.ciphertext).toEqual('')\n })\n\n xit('Lowercase', () => {\n const crypto = new Crypto('A')\n expect(crypto.ciphertext).toEqual('a')\n })\n\n xit('Remove spaces', () => {\n const crypto = new Crypto(' b ')\n expect(crypto.ciphertext).toEqual('b')\n })\n\n xit('Remove punctuation', () => {\n const crypto = new Crypto('@1,%!')\n expect(crypto.ciphertext).toEqual('1')\n })\n\n xit('9 character plaintext results in 3 chunks of 3 characters', () => {\n const crypto = new Crypto('This is fun!')\n expect(crypto.ciphertext).toEqual('tsf hiu isn')\n })\n\n xit('8 character plaintext results in 3 chunks, the last one with a trailing space', () => {\n const crypto = new Crypto('Chill out.')\n expect(crypto.ciphertext).toEqual('clu hlt io ')\n })\n\n it.skip('54 character plaintext results in 8 chunks, the last two with trailing spaces', () => {\n const crypto = new Crypto(\n 'If man was meant to stay on the ground, god would have given us roots.'\n )\n expect(crypto.ciphertext).toEqual(\n 'imtgdvs fearwer mayoogo anouuio ntnnlvt wttddes aohghn sseoau '\n )\n })\n})\n" }, { "path": "exercises/practice/crypto-square/crypto-square.ts", "content": "export class Crypto {\n constructor(plainText: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n get ciphertext(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/crypto-square/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/crypto-square/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/crypto-square/package.json", "content": "{\n \"name\": \"@exercism/typescript-crypto-square\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/crypto-square/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/crypto-square/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/custom-set/.docs/instructions.md", "content": "# Instructions\n\nCreate a custom set type.\n\nSometimes it is necessary to define a custom data structure of some type, like a set.\nIn this exercise you will define your own set.\nHow it works internally doesn't matter, as long as it behaves like a set of unique elements.\n" }, { "path": "exercises/practice/custom-set/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"custom-set.ts\"\n ],\n \"test\": [\n \"custom-set.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Create a custom set type.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/custom-set/.meta/proof.ci.ts", "content": "export class CustomSet {\n private data: Set\n\n constructor(data: T[] = []) {\n this.data = new Set()\n data.forEach((el) => {\n this.add(el)\n })\n }\n\n public add(el: T): this {\n this.data.add(el)\n return this\n }\n\n public delete(el: T): this {\n this.data.delete(el)\n return this\n }\n\n public size(): number {\n return this.data.size\n }\n\n public empty(): boolean {\n return this.data.size === 0\n }\n\n public contains(el: T): boolean {\n return this.data.has(el)\n }\n\n public eql(other: CustomSet): boolean {\n if (this.data.size !== other.data.size) {\n return false\n }\n for (const item of this.data) {\n if (!other.data.has(item)) {\n return false\n }\n }\n return true\n }\n\n public difference(other: CustomSet): CustomSet {\n const result = new CustomSet()\n for (const item of this.data) {\n if (!other.data.has(item)) {\n result.add(item)\n }\n }\n return result\n }\n\n public disjoint(other: CustomSet): boolean {\n return this.size() === 0 || this.difference(other).size() === this.size()\n }\n\n public intersection(other: CustomSet): CustomSet {\n return this.difference(this.difference(other))\n }\n\n public union(other: CustomSet): CustomSet {\n const result = new CustomSet()\n for (const item of this.data) {\n result.add(item)\n }\n for (const item of other.data) {\n result.add(item)\n }\n return result\n }\n\n public subset(other: CustomSet): boolean {\n return this.eql(this.intersection(other))\n }\n\n public toList(): T[] {\n return Object.values(this.data) as T[]\n }\n}\n" }, { "path": "exercises/practice/custom-set/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[20c5f855-f83a-44a7-abdd-fe75c6cf022b]\ndescription = \"sets with no elements are empty\"\n\n[d506485d-5706-40db-b7d8-5ceb5acf88d2]\ndescription = \"sets with elements are not empty\"\n\n[759b9740-3417-44c3-8ca3-262b3c281043]\ndescription = \"nothing is contained in an empty set\"\n\n[f83cd2d1-2a85-41bc-b6be-80adbff4be49]\ndescription = \"when the element is in the set\"\n\n[93423fc0-44d0-4bc0-a2ac-376de8d7af34]\ndescription = \"when the element is not in the set\"\n\n[c392923a-637b-4495-b28e-34742cd6157a]\ndescription = \"empty set is a subset of another empty set\"\n\n[5635b113-be8c-4c6f-b9a9-23c485193917]\ndescription = \"empty set is a subset of non-empty set\"\n\n[832eda58-6d6e-44e2-92c2-be8cf0173cee]\ndescription = \"non-empty set is not a subset of empty set\"\n\n[c830c578-8f97-4036-b082-89feda876131]\ndescription = \"set is a subset of set with exact same elements\"\n\n[476a4a1c-0fd1-430f-aa65-5b70cbc810c5]\ndescription = \"set is a subset of larger set with same elements\"\n\n[d2498999-3e46-48e4-9660-1e20c3329d3d]\ndescription = \"set is not a subset of set that does not contain its elements\"\n\n[7d38155e-f472-4a7e-9ad8-5c1f8f95e4cc]\ndescription = \"the empty set is disjoint with itself\"\n\n[7a2b3938-64b6-4b32-901a-fe16891998a6]\ndescription = \"empty set is disjoint with non-empty set\"\n\n[589574a0-8b48-48ea-88b0-b652c5fe476f]\ndescription = \"non-empty set is disjoint with empty set\"\n\n[febeaf4f-f180-4499-91fa-59165955a523]\ndescription = \"sets are not disjoint if they share an element\"\n\n[0de20d2f-c952-468a-88c8-5e056740f020]\ndescription = \"sets are disjoint if they share no elements\"\n\n[4bd24adb-45da-4320-9ff6-38c044e9dff8]\ndescription = \"empty sets are equal\"\n\n[f65c0a0e-6632-4b2d-b82c-b7c6da2ec224]\ndescription = \"empty set is not equal to non-empty set\"\n\n[81e53307-7683-4b1e-a30c-7e49155fe3ca]\ndescription = \"non-empty set is not equal to empty set\"\n\n[d57c5d7c-a7f3-48cc-a162-6b488c0fbbd0]\ndescription = \"sets with the same elements are equal\"\n\n[dd61bafc-6653-42cc-961a-ab071ee0ee85]\ndescription = \"sets with different elements are not equal\"\n\n[06059caf-9bf4-425e-aaff-88966cb3ea14]\ndescription = \"set is not equal to larger set with same elements\"\n\n[8a677c3c-a658-4d39-bb88-5b5b1a9659f4]\ndescription = \"add to empty set\"\n\n[0903dd45-904d-4cf2-bddd-0905e1a8d125]\ndescription = \"add to non-empty set\"\n\n[b0eb7bb7-5e5d-4733-b582-af771476cb99]\ndescription = \"adding an existing element does not change the set\"\n\n[893d5333-33b8-4151-a3d4-8f273358208a]\ndescription = \"intersection of two empty sets is an empty set\"\n\n[d739940e-def2-41ab-a7bb-aaf60f7d782c]\ndescription = \"intersection of an empty set and non-empty set is an empty set\"\n\n[3607d9d8-c895-4d6f-ac16-a14956e0a4b7]\ndescription = \"intersection of a non-empty set and an empty set is an empty set\"\n\n[b5120abf-5b5e-41ab-aede-4de2ad85c34e]\ndescription = \"intersection of two sets with no shared elements is an empty set\"\n\n[af21ca1b-fac9-499c-81c0-92a591653d49]\ndescription = \"intersection of two sets with shared elements is a set of the shared elements\"\n\n[c5e6e2e4-50e9-4bc2-b89f-c518f015b57e]\ndescription = \"difference of two empty sets is an empty set\"\n\n[2024cc92-5c26-44ed-aafd-e6ca27d6fcd2]\ndescription = \"difference of empty set and non-empty set is an empty set\"\n\n[e79edee7-08aa-4c19-9382-f6820974b43e]\ndescription = \"difference of a non-empty set and an empty set is the non-empty set\"\n\n[c5ac673e-d707-4db5-8d69-7082c3a5437e]\ndescription = \"difference of two non-empty sets is a set of elements that are only in the first set\"\n\n[c45aed16-5494-455a-9033-5d4c93589dc6]\ndescription = \"union of empty sets is an empty set\"\n\n[9d258545-33c2-4fcb-a340-9f8aa69e7a41]\ndescription = \"union of an empty set and non-empty set is the non-empty set\"\n\n[3aade50c-80c7-4db8-853d-75bac5818b83]\ndescription = \"union of a non-empty set and empty set is the non-empty set\"\n\n[a00bb91f-c4b4-4844-8f77-c73e2e9df77c]\ndescription = \"union of non-empty sets contains all unique elements\"\n" }, { "path": "exercises/practice/custom-set/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/custom-set/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/custom-set/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/custom-set/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/custom-set/custom-set.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { CustomSet } from './custom-set.ts'\n\ndescribe('CustomSet', () => {\n describe('empty: returns true if the set contains no elements', () => {\n it('sets with no elements are empty', () => {\n const actual = new CustomSet().empty()\n expect(actual).toBeTruthy()\n })\n\n xit('sets with elements are not empty', () => {\n const actual = new CustomSet([1]).empty()\n expect(actual).toBeFalsy()\n })\n })\n\n xdescribe('contains: sets can report if they contain an element', () => {\n xit('nothing is contained in an empty set', () => {\n const actual = new CustomSet().contains(1)\n expect(actual).toBeFalsy()\n })\n\n xit('when the element is in the set', () => {\n const actual = new CustomSet([1, 2, 3]).contains(1)\n expect(actual).toBeTruthy()\n })\n\n xit('when the element is not in the set', () => {\n const actual = new CustomSet([1, 2, 3]).contains(4)\n expect(actual).toBeFalsy()\n })\n })\n\n xdescribe('subset: a set is a subset if all of its elements are contained in the other set', () => {\n xit('empty set is a subset of another empty set', () => {\n const actual = new CustomSet().subset(new CustomSet())\n expect(actual).toBeTruthy()\n })\n\n xit('empty set is a subset of non-empty set', () => {\n const actual = new CustomSet().subset(new CustomSet([1]))\n expect(actual).toBeTruthy()\n })\n\n xit('non-empty set is not a subset of empty set', () => {\n const actual = new CustomSet([1]).subset(new CustomSet())\n expect(actual).toBeFalsy()\n })\n\n xit('set is a subset of set with exact same elements', () => {\n const actual = new CustomSet([1, 2, 3]).subset(new CustomSet([1, 2, 3]))\n expect(actual).toBeTruthy()\n })\n\n xit('set is a subset of larger set with same elements', () => {\n const actual = new CustomSet([1, 2, 3]).subset(\n new CustomSet([4, 1, 2, 3])\n )\n expect(actual).toBeTruthy()\n })\n\n xit('set is not a subset of set that does not contain its elements', () => {\n const actual = new CustomSet([1, 2, 3]).subset(new CustomSet([4, 1, 3]))\n expect(actual).toBeFalsy()\n })\n })\n\n xdescribe('disjoint: sets are disjoint if they share no elements', () => {\n xit('the empty set is disjoint with itself', () => {\n const actual = new CustomSet().disjoint(new CustomSet([]))\n expect(actual).toBeTruthy()\n })\n\n xit('empty set is disjoint with non-empty set', () => {\n const actual = new CustomSet().disjoint(new CustomSet([1]))\n expect(actual).toBeTruthy()\n })\n\n xit('non-empty set is disjoint with empty set', () => {\n const actual = new CustomSet([1]).disjoint(new CustomSet([]))\n expect(actual).toBeTruthy()\n })\n\n xit('sets are not disjoint if they share an element', () => {\n const actual = new CustomSet([1, 2]).disjoint(new CustomSet([2, 3]))\n expect(actual).toBeFalsy()\n })\n\n xit('sets are disjoint if they share no elements', () => {\n const actual = new CustomSet([1, 2]).disjoint(new CustomSet([3, 4]))\n expect(actual).toBeTruthy()\n })\n })\n\n xdescribe('eql: sets with the same elements are equal', () => {\n xit('empty sets are equal', () => {\n const actual = new CustomSet().eql(new CustomSet())\n expect(actual).toBeTruthy()\n })\n\n xit('empty set is not equal to non-empty set', () => {\n const actual = new CustomSet().eql(new CustomSet([1, 2, 3]))\n expect(actual).toBeFalsy()\n })\n\n xit('non-empty set is not equal to empty set', () => {\n const actual = new CustomSet([1, 2, 3]).eql(new CustomSet())\n expect(actual).toBeFalsy()\n })\n\n xit('sets with the same elements are equal', () => {\n const actual = new CustomSet([1, 2]).eql(new CustomSet([2, 1]))\n expect(actual).toBeTruthy()\n })\n\n xit('sets with different elements are not equal', () => {\n const actual = new CustomSet([1, 2, 3]).eql(new CustomSet([1, 2, 4]))\n expect(actual).toBeFalsy()\n })\n })\n\n xdescribe('add: unique elements can be added to a set', () => {\n xit('add to empty set', () => {\n const actual = new CustomSet().add(3)\n const expected = new CustomSet([3])\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('add to non-empty set', () => {\n const actual = new CustomSet([1, 2, 4]).add(3)\n const expected = new CustomSet([1, 2, 3, 4])\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('adding an existing element does not change the set', () => {\n const actual = new CustomSet([1, 2, 3]).add(3)\n const expected = new CustomSet([1, 2, 3])\n expect(actual.eql(expected)).toBeTruthy()\n })\n })\n\n xdescribe('intersection: returns a set of all shared elements', () => {\n xit('intersection of two empty sets is an empty set', () => {\n const actual = new CustomSet().intersection(new CustomSet())\n const expected = new CustomSet()\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('intersection of an empty set and non-empty set is an empty set', () => {\n const actual = new CustomSet().intersection(new CustomSet([3, 2, 5]))\n const expected = new CustomSet([])\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('intersection of a non-empty set and an empty set is an empty set', () => {\n const actual = new CustomSet([1, 2, 3, 4]).intersection(new CustomSet([]))\n const expected = new CustomSet([])\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('intersection of two sets with no shared elements is an empty set', () => {\n const actual = new CustomSet([1, 2, 3]).intersection(\n new CustomSet([4, 5, 6])\n )\n const expected = new CustomSet([])\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('intersection of two sets with shared elements is a set of the shared elements', () => {\n const actual = new CustomSet([1, 2, 3, 4]).intersection(\n new CustomSet([3, 2, 5])\n )\n const expected = new CustomSet([2, 3])\n expect(actual.eql(expected)).toBeTruthy()\n })\n })\n\n xdescribe('difference of a set is a set of all elements that are only in the first set', () => {\n xit('difference of two empty sets is an empty set', () => {\n const actual = new CustomSet().difference(new CustomSet())\n const expected = new CustomSet()\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('difference of empty set and non-empty set is an empty set', () => {\n const actual = new CustomSet().difference(new CustomSet([3, 2, 5]))\n const expected = new CustomSet()\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('difference of a non-empty set and an empty set is the non-empty set', () => {\n const actual = new CustomSet([1, 2, 3, 4]).difference(new CustomSet())\n const expected = new CustomSet([1, 2, 3, 4])\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('difference of two non-empty sets is a set of elements that are only in the first set', () => {\n const actual = new CustomSet([3, 2, 1]).difference(new CustomSet([2, 4]))\n const expected = new CustomSet([1, 3])\n expect(actual.eql(expected)).toBeTruthy()\n })\n })\n\n xdescribe('union: returns a set of all elements in either set', () => {\n xit('union of empty sets is an empty set', () => {\n const actual = new CustomSet().union(new CustomSet())\n const expected = new CustomSet()\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('union of an empty set and non-empty set is the non-empty set', () => {\n const actual = new CustomSet().union(new CustomSet([2]))\n const expected = new CustomSet([2])\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('union of a non-empty set and empty set is the non-empty set', () => {\n const actual = new CustomSet([1, 3]).union(new CustomSet())\n const expected = new CustomSet([1, 3])\n expect(actual.eql(expected)).toBeTruthy()\n })\n\n xit('union of non-empty sets contains all unique elements', () => {\n const actual = new CustomSet([1, 3]).union(new CustomSet([2, 3]))\n const expected = new CustomSet([1, 2, 3])\n expect(actual.eql(expected)).toBeTruthy()\n })\n })\n})\n" }, { "path": "exercises/practice/custom-set/custom-set.ts", "content": "export class CustomSet {\n constructor(initial?: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n empty(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n contains(element: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n add(element: unknown): CustomSet {\n throw new Error('Remove this line and implement the function')\n }\n\n subset(other: unknown): CustomSet {\n throw new Error('Remove this line and implement the function')\n }\n\n disjoint(other: unknown): CustomSet {\n throw new Error('Remove this line and implement the function')\n }\n\n eql(other: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n union(other: unknown): CustomSet {\n throw new Error('Remove this line and implement the function')\n }\n\n intersection(other: unknown): CustomSet {\n throw new Error('Remove this line and implement the function')\n }\n\n difference(other: unknown): CustomSet {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/custom-set/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/custom-set/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/custom-set/package.json", "content": "{\n \"name\": \"@exercism/typescript-custom-set\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/custom-set/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/custom-set/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/darts/.docs/instructions.md", "content": "# Instructions\n\nCalculate the points scored in a single toss of a Darts game.\n\n[Darts][darts] is a game where players throw darts at a [target][darts-target].\n\nIn our particular instance of the game, the target rewards 4 different amounts of points, depending on where the dart lands:\n\n![Our dart scoreboard with values from a complete miss to a bullseye](https://assets.exercism.org/images/exercises/darts/darts-scoreboard.svg)\n\n- If the dart lands outside the target, player earns no points (0 points).\n- If the dart lands in the outer circle of the target, player earns 1 point.\n- If the dart lands in the middle circle of the target, player earns 5 points.\n- If the dart lands in the inner circle of the target, player earns 10 points.\n\nThe outer circle has a radius of 10 units (this is equivalent to the total radius for the entire target), the middle circle a radius of 5 units, and the inner circle a radius of 1.\nOf course, they are all centered at the same point ā€” that is, the circles are [concentric][] defined by the coordinates (0, 0).\n\nGiven a point in the target (defined by its [Cartesian coordinates][cartesian-coordinates] `x` and `y`, where `x` and `y` are [real][real-numbers]), calculate the correct score earned by a dart landing at that point.\n\n## Credit\n\nThe scoreboard image was created by [habere-et-dispertire][habere-et-dispertire] using [Inkscape][inkscape].\n\n[darts]: https://en.wikipedia.org/wiki/Darts\n[darts-target]: https://en.wikipedia.org/wiki/Darts#/media/File:Darts_in_a_dartboard.jpg\n[concentric]: https://mathworld.wolfram.com/ConcentricCircles.html\n[cartesian-coordinates]: https://www.mathsisfun.com/data/cartesian-coordinates.html\n[real-numbers]: https://www.mathsisfun.com/numbers/real-numbers.html\n[habere-et-dispertire]: https://exercism.org/profiles/habere-et-dispertire\n[inkscape]: https://en.wikipedia.org/wiki/Inkscape\n" }, { "path": "exercises/practice/darts/.meta/config.json", "content": "{\n \"authors\": [\n \"angelikatyborska\"\n ],\n \"contributors\": [\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"darts.ts\"\n ],\n \"test\": [\n \"darts.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Calculate the points scored in a single toss of a Darts game.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Inspired by an exercise created by a professor Della Paolera in Argentina\"\n}\n" }, { "path": "exercises/practice/darts/.meta/proof.ci.ts", "content": "export function score(x: number, y: number): number {\n // Use euclidean distance\n const distanceToDart = Math.sqrt(x * x + y * y)\n\n // Define points for each section of the target\n if (distanceToDart > 10) {\n return 0\n }\n\n if (distanceToDart > 5) {\n return 1\n }\n\n if (distanceToDart > 1) {\n return 5\n }\n return 10\n}\n" }, { "path": "exercises/practice/darts/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[9033f731-0a3a-4d9c-b1c0-34a1c8362afb]\ndescription = \"Missed target\"\n\n[4c9f6ff4-c489-45fd-be8a-1fcb08b4d0ba]\ndescription = \"On the outer circle\"\n\n[14378687-ee58-4c9b-a323-b089d5274be8]\ndescription = \"On the middle circle\"\n\n[849e2e63-85bd-4fed-bc3b-781ae962e2c9]\ndescription = \"On the inner circle\"\n\n[1c5ffd9f-ea66-462f-9f06-a1303de5a226]\ndescription = \"Exactly on center\"\n\n[b65abce3-a679-4550-8115-4b74bda06088]\ndescription = \"Near the center\"\n\n[66c29c1d-44f5-40cf-9927-e09a1305b399]\ndescription = \"Just within the inner circle\"\n\n[d1012f63-c97c-4394-b944-7beb3d0b141a]\ndescription = \"Just outside the inner circle\"\n\n[ab2b5666-b0b4-49c3-9b27-205e790ed945]\ndescription = \"Just within the middle circle\"\n\n[70f1424e-d690-4860-8caf-9740a52c0161]\ndescription = \"Just outside the middle circle\"\n\n[a7dbf8db-419c-4712-8a7f-67602b69b293]\ndescription = \"Just within the outer circle\"\n\n[e0f39315-9f9a-4546-96e4-a9475b885aa7]\ndescription = \"Just outside the outer circle\"\n\n[045d7d18-d863-4229-818e-b50828c75d19]\ndescription = \"Asymmetric position between the inner and middle circles\"\n" }, { "path": "exercises/practice/darts/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/darts/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/darts/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/darts/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/darts/darts.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { score } from './darts.ts'\n\ndescribe('Darts', () => {\n it('Missed target', () => {\n expect(score(-9, 9)).toEqual(0)\n })\n\n xit('On the outer circle', () => {\n expect(score(0, 10)).toEqual(1)\n })\n\n xit('On the middle circle', () => {\n expect(score(-5, 0)).toEqual(5)\n })\n\n xit('On the inner circle', () => {\n expect(score(0, -1)).toEqual(10)\n })\n\n xit('Exactly on centre', () => {\n expect(score(0, 0)).toEqual(10)\n })\n\n xit('Near the centre', () => {\n expect(score(-0.1, -0.1)).toEqual(10)\n })\n\n xit('Just within the inner circle', () => {\n expect(score(0.7, 0.7)).toEqual(10)\n })\n\n xit('Just outside the inner circle', () => {\n expect(score(0.8, -0.8)).toEqual(5)\n })\n\n xit('Just within the middle circle', () => {\n expect(score(-3.5, 3.5)).toEqual(5)\n })\n\n xit('Just outside the middle circle', () => {\n expect(score(-3.6, -3.6)).toEqual(1)\n })\n\n xit('Just within the outer circle', () => {\n expect(score(-7.0, 7.0)).toEqual(1)\n })\n\n xit('Just outside the outer circle', () => {\n expect(score(7.1, -7.1)).toEqual(0)\n })\n\n xit('Asymmetric position between the inner and middle circles', () => {\n expect(score(0.5, -4)).toEqual(5)\n })\n})\n" }, { "path": "exercises/practice/darts/darts.ts", "content": "export function score(x: unknown, y: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/darts/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/darts/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/darts/package.json", "content": "{\n \"name\": \"@exercism/typescript-darts\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/darts/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/darts/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/diamond/.docs/instructions.md", "content": "# Instructions\n\nThe diamond kata takes as its input a letter, and outputs it in a diamond shape.\nGiven a letter, it prints a diamond starting with 'A', with the supplied letter at the widest point.\n\n## Requirements\n\n- The first row contains one 'A'.\n- The last row contains one 'A'.\n- All rows, except the first and last, have exactly two identical letters.\n- All rows have as many trailing spaces as leading spaces. (This might be 0).\n- The diamond is horizontally symmetric.\n- The diamond is vertically symmetric.\n- The diamond has a square shape (width equals height).\n- The letters form a diamond shape.\n- The top half has the letters in ascending order.\n- The bottom half has the letters in descending order.\n- The four corners (containing the spaces) are triangles.\n\n## Examples\n\nIn the following examples, spaces are indicated by `Ā·` characters.\n\nDiamond for letter 'A':\n\n```text\nA\n```\n\nDiamond for letter 'C':\n\n```text\nĀ·Ā·AĀ·Ā·\nĀ·BĀ·BĀ·\nCĀ·Ā·Ā·C\nĀ·BĀ·BĀ·\nĀ·Ā·AĀ·Ā·\n```\n\nDiamond for letter 'E':\n\n```text\nĀ·Ā·Ā·Ā·AĀ·Ā·Ā·Ā·\nĀ·Ā·Ā·BĀ·BĀ·Ā·Ā·\nĀ·Ā·CĀ·Ā·Ā·CĀ·Ā·\nĀ·DĀ·Ā·Ā·Ā·Ā·DĀ·\nEĀ·Ā·Ā·Ā·Ā·Ā·Ā·E\nĀ·DĀ·Ā·Ā·Ā·Ā·DĀ·\nĀ·Ā·CĀ·Ā·Ā·CĀ·Ā·\nĀ·Ā·Ā·BĀ·BĀ·Ā·Ā·\nĀ·Ā·Ā·Ā·AĀ·Ā·Ā·Ā·\n```\n" }, { "path": "exercises/practice/diamond/.meta/config.json", "content": "{\n \"authors\": [\n \"njgingrich\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"diamond.ts\"\n ],\n \"test\": [\n \"diamond.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a letter, print a diamond starting with 'A' with the supplied letter at the widest point.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Seb Rose\",\n \"source_url\": \"https://web.archive.org/web/20220807163751/http://claysnow.co.uk/recycling-tests-in-tdd/\"\n}\n" }, { "path": "exercises/practice/diamond/.meta/proof.ci.ts", "content": "export function makeDiamond(input: string): string {\n // A = 0, Z = 25\n const inputIx = input.charCodeAt(0) - 65\n const lines = []\n for (let i = 0; i <= inputIx; i++) {\n lines.push(getLine(inputIx, i))\n }\n for (let i = inputIx - 1; i >= 0; i--) {\n lines.push(lines[i])\n }\n return lines.join('\\n') + '\\n'\n}\n\nfunction getAlphaString(index: number): string {\n if (index === 0) {\n return `A`\n }\n const char = String.fromCharCode(index + 65)\n const padding = ' '.repeat((index - 1) * 2 + 1)\n return `${char}${padding}${char}`\n}\n\nfunction getLine(inputIx: number, index: number): string {\n const difference = inputIx - index\n const alphaStr = getAlphaString(index)\n return `${padString(alphaStr, difference)}`\n}\n\nfunction padString(str: string, times: number): string {\n const spaces = ' '.repeat(times)\n return `${spaces}${str}${spaces}`\n}\n\n/*\nex: D ->\nloop:\n A: D=3, A=0 -> 3 spaces, A, 3 spaces (special case)\n B: D=3, B=1 -> 2 spaces, B, 1 space, B, 2 spaces\n C: D=3, C=2 -> 1 space, C, 3 spaces, C, 1 space\n D: D=3, D=3 -> 0 spaces, D, 5 spaces, D, 0 spaces\n A\n B B\n C C\nD D\n C C\n B B\n A\n*/\n" }, { "path": "exercises/practice/diamond/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[202fb4cc-6a38-4883-9193-a29d5cb92076]\ndescription = \"Degenerate case with a single 'A' row\"\n\n[bd6a6d78-9302-42e9-8f60-ac1461e9abae]\ndescription = \"Degenerate case with no row containing 3 distinct groups of spaces\"\n\n[af8efb49-14ed-447f-8944-4cc59ce3fd76]\ndescription = \"Smallest non-degenerate case with odd diamond side length\"\n\n[e0c19a95-9888-4d05-86a0-fa81b9e70d1d]\ndescription = \"Smallest non-degenerate case with even diamond side length\"\n\n[82ea9aa9-4c0e-442a-b07e-40204e925944]\ndescription = \"Largest possible diamond\"\n" }, { "path": "exercises/practice/diamond/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/diamond/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/diamond/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/diamond/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/diamond/diamond.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { makeDiamond } from './diamond.ts'\n\nfunction diamondify(parts: TemplateStringsArray): string {\n // prettier-ignore\n return (\n parts[0]\n .trim() // Remove leading and trailing whitespace\n .split('\\n') // Consider each row\n .map((line) => {\n return line\n .trim() // Remove whitespace at start (and end)\n .replace(/Ā·/g, ' ') // Use spaces instead of Ā·\n })\n .filter(Boolean) // Remove empty rows (if any)\n .join('\\n') + // Turn back into a single string\n '\\n' // Should have a final newline\n )\n}\n\ndescribe('Make diamond function', () => {\n it('test letter A', () => {\n const result = 'A\\n'\n expect(makeDiamond('A')).toEqual(result)\n })\n\n xit('test letter C', () => {\n const result = diamondify`\n Ā·Ā·AĀ·Ā·\n Ā·BĀ·BĀ·\n CĀ·Ā·Ā·C\n Ā·BĀ·BĀ·\n Ā·Ā·AĀ·Ā·\n `\n expect(makeDiamond('C')).toEqual(result)\n })\n\n xit('test letter E', () => {\n const result = diamondify`\n Ā·Ā·Ā·Ā·AĀ·Ā·Ā·Ā·\n Ā·Ā·Ā·BĀ·BĀ·Ā·Ā·\n Ā·Ā·CĀ·Ā·Ā·CĀ·Ā·\n Ā·DĀ·Ā·Ā·Ā·Ā·DĀ·\n EĀ·Ā·Ā·Ā·Ā·Ā·Ā·E\n Ā·DĀ·Ā·Ā·Ā·Ā·DĀ·\n Ā·Ā·CĀ·Ā·Ā·CĀ·Ā·\n Ā·Ā·Ā·BĀ·BĀ·Ā·Ā·\n Ā·Ā·Ā·Ā·AĀ·Ā·Ā·Ā·\n `\n expect(makeDiamond('E')).toEqual(result)\n })\n})\n" }, { "path": "exercises/practice/diamond/diamond.ts", "content": "export function makeDiamond(character: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/diamond/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/diamond/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/diamond/package.json", "content": "{\n \"name\": \"@exercism/typescript-diamond\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/diamond/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/diamond/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/difference-of-squares/.docs/instructions.md", "content": "# Instructions\n\nFind the difference between the square of the sum and the sum of the squares of the first N natural numbers.\n\nThe square of the sum of the first ten natural numbers is\n(1 + 2 + ... + 10)Ā² = 55Ā² = 3025.\n\nThe sum of the squares of the first ten natural numbers is\n1Ā² + 2Ā² + ... + 10Ā² = 385.\n\nHence the difference between the square of the sum of the first ten natural numbers and the sum of the squares of the first ten natural numbers is 3025 - 385 = 2640.\n\nYou are not expected to discover an efficient solution to this yourself from first principles; research is allowed, indeed, encouraged.\nFinding the best algorithm for the problem is a key skill in software engineering.\n" }, { "path": "exercises/practice/difference-of-squares/.meta/config.json", "content": "{\n \"authors\": [],\n \"contributors\": [\n \"masters3d\",\n \"Scientifica96\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"difference-of-squares.ts\"\n ],\n \"test\": [\n \"difference-of-squares.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Find the difference between the square of the sum and the sum of the squares of the first N natural numbers.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Problem 6 at Project Euler\",\n \"source_url\": \"https://projecteuler.net/problem=6\"\n}\n" }, { "path": "exercises/practice/difference-of-squares/.meta/proof.ci.ts", "content": "export class Squares {\n public readonly squareOfSum: number\n public readonly sumOfSquares: number\n public readonly difference: number\n\n constructor(int: number) {\n this.squareOfSum = this._squareOfSum(int)\n this.sumOfSquares = this._sumOfSquares(int)\n this.difference = this._difference()\n }\n\n private _squareOfSum(int: number): number {\n let sum = 0\n let i = 1\n\n while (i <= int) {\n sum += i\n i++\n }\n\n return sum * sum\n }\n\n private _sumOfSquares(int: number): number {\n let sum = 0\n let i = 1\n\n while (i <= int) {\n sum += i * i\n i++\n }\n\n return sum\n }\n\n private _difference(): number {\n return this.squareOfSum - this.sumOfSquares\n }\n}\n" }, { "path": "exercises/practice/difference-of-squares/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[e46c542b-31fc-4506-bcae-6b62b3268537]\ndescription = \"square of sum 1\"\n\n[9b3f96cb-638d-41ee-99b7-b4f9c0622948]\ndescription = \"square of sum 5\"\n\n[54ba043f-3c35-4d43-86ff-3a41625d5e86]\ndescription = \"square of sum 100\"\n\n[01d84507-b03e-4238-9395-dd61d03074b5]\ndescription = \"sum of squares 1\"\n\n[c93900cd-8cc2-4ca4-917b-dd3027023499]\ndescription = \"sum of squares 5\"\n\n[94807386-73e4-4d9e-8dec-69eb135b19e4]\ndescription = \"sum of squares 100\"\n\n[44f72ae6-31a7-437f-858d-2c0837adabb6]\ndescription = \"difference of squares 1\"\n\n[005cb2bf-a0c8-46f3-ae25-924029f8b00b]\ndescription = \"difference of squares 5\"\n\n[b1bf19de-9a16-41c0-a62b-1f02ecc0b036]\ndescription = \"difference of squares 100\"\n" }, { "path": "exercises/practice/difference-of-squares/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/difference-of-squares/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/difference-of-squares/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/difference-of-squares/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/difference-of-squares/difference-of-squares.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { Squares } from './difference-of-squares.ts'\n\ndescribe('Squares', () => {\n describe('up to 5', () => {\n const squares = new Squares(5)\n\n it('gets the square of sum', () => {\n expect(squares.squareOfSum).toBe(225)\n })\n\n xit('gets the sum of squares', () => {\n expect(squares.sumOfSquares).toBe(55)\n })\n\n xit('gets the difference', () => {\n expect(squares.difference).toBe(170)\n })\n })\n\n xdescribe('up to 10', () => {\n const squares = new Squares(10)\n\n xit('gets the square of sum', () => {\n expect(squares.squareOfSum).toBe(3025)\n })\n\n xit('gets the sum of squares', () => {\n expect(squares.sumOfSquares).toBe(385)\n })\n\n xit('gets the difference', () => {\n expect(squares.difference).toBe(2640)\n })\n })\n\n xdescribe('up to 100', () => {\n const squares = new Squares(100)\n\n xit('gets the square of sum', () => {\n expect(squares.squareOfSum).toBe(25502500)\n })\n\n xit('gets the sum of squares', () => {\n expect(squares.sumOfSquares).toBe(338350)\n })\n\n xit('gets the difference', () => {\n expect(squares.difference).toBe(25164150)\n })\n })\n})\n" }, { "path": "exercises/practice/difference-of-squares/difference-of-squares.ts", "content": "export class Squares {\n constructor(count: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n get sumOfSquares(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n get squareOfSum(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n get difference(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/difference-of-squares/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/difference-of-squares/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/difference-of-squares/package.json", "content": "{\n \"name\": \"@exercism/typescript-difference-of-squares\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/difference-of-squares/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/difference-of-squares/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/diffie-hellman/.docs/instructions.md", "content": "# Instructions\n\nDiffie-Hellman key exchange.\n\nAlice and Bob use Diffie-Hellman key exchange to share secrets.\nThey start with prime numbers, pick private keys, generate and share public keys, and then generate a shared secret key.\n\n## Step 0\n\nThe test program supplies prime numbers p and g.\n\n## Step 1\n\nAlice picks a private key, a, greater than 1 and less than p.\nBob does the same to pick a private key b.\n\n## Step 2\n\nAlice calculates a public key A.\n\n A = gįµƒ mod p\n\nUsing the same p and g, Bob similarly calculates a public key B from his private key b.\n\n## Step 3\n\nAlice and Bob exchange public keys.\nAlice calculates secret key s.\n\n s = Bįµƒ mod p\n\nBob calculates\n\n s = Aįµ‡ mod p\n\nThe calculations produce the same result!\nAlice and Bob now share secret s.\n" }, { "path": "exercises/practice/diffie-hellman/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"diffie-hellman.ts\"\n ],\n \"test\": [\n \"diffie-hellman.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Diffie-Hellman key exchange.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia, 1024 bit key from www.cryptopp.com/wiki.\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange\"\n}\n" }, { "path": "exercises/practice/diffie-hellman/.meta/proof.ci.ts", "content": "// array of first 1000 primes.\n// prettier-ignore\nconst PRIMES = [\n 2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71,\n 73, 79, 83, 89, 97, 101, 103, 107, 109, 113, 127, 131, 137, 139, 149, 151,\n 157, 163, 167, 173, 179, 181, 191, 193, 197, 199, 211, 223, 227, 229, 233,\n 239, 241, 251, 257, 263, 269, 271, 277, 281, 283, 293, 307, 311, 313, 317,\n 331, 337, 347, 349, 353, 359, 367, 373, 379, 383, 389, 397, 401, 409, 419,\n 421, 431, 433, 439, 443, 449, 457, 461, 463, 467, 479, 487, 491, 499, 503,\n 509, 521, 523, 541, 547, 557, 563, 569, 571, 577, 587, 593, 599, 601, 607,\n 613, 617, 619, 631, 641, 643, 647, 653, 659, 661, 673, 677, 683, 691, 701,\n 709, 719, 727, 733, 739, 743, 751, 757, 761, 769, 773, 787, 797, 809, 811,\n 821, 823, 827, 829, 839, 853, 857, 859, 863, 877, 881, 883, 887, 907, 911,\n 919, 929, 937, 941, 947, 953, 967, 971, 977, 983, 991, 997, 1009, 1013, 1019,\n 1021, 1031, 1033, 1039, 1049, 1051, 1061, 1063, 1069, 1087, 1091, 1093, 1097,\n 1103, 1109, 1117, 1123, 1129, 1151, 1153, 1163, 1171, 1181, 1187, 1193, 1201,\n 1213, 1217, 1223, 1229, 1231, 1237, 1249, 1259, 1277, 1279, 1283, 1289, 1291,\n 1297, 1301, 1303, 1307, 1319, 1321, 1327, 1361, 1367, 1373, 1381, 1399, 1409,\n 1423, 1427, 1429, 1433, 1439, 1447, 1451, 1453, 1459, 1471, 1481, 1483, 1487,\n 1489, 1493, 1499, 1511, 1523, 1531, 1543, 1549, 1553, 1559, 1567, 1571, 1579,\n 1583, 1597, 1601, 1607, 1609, 1613, 1619, 1621, 1627, 1637, 1657, 1663, 1667,\n 1669, 1693, 1697, 1699, 1709, 1721, 1723, 1733, 1741, 1747, 1753, 1759, 1777,\n 1783, 1787, 1789, 1801, 1811, 1823, 1831, 1847, 1861, 1867, 1871, 1873, 1877,\n 1879, 1889, 1901, 1907, 1913, 1931, 1933, 1949, 1951, 1973, 1979, 1987, 1993,\n 1997, 1999, 2003, 2011, 2017, 2027, 2029, 2039, 2053, 2063, 2069, 2081, 2083,\n 2087, 2089, 2099, 2111, 2113, 2129, 2131, 2137, 2141, 2143, 2153, 2161, 2179,\n 2203, 2207, 2213, 2221, 2237, 2239, 2243, 2251, 2267, 2269, 2273, 2281, 2287,\n 2293, 2297, 2309, 2311, 2333, 2339, 2341, 2347, 2351, 2357, 2371, 2377, 2381,\n 2383, 2389, 2393, 2399, 2411, 2417, 2423, 2437, 2441, 2447, 2459, 2467, 2473,\n 2477, 2503, 2521, 2531, 2539, 2543, 2549, 2551, 2557, 2579, 2591, 2593, 2609,\n 2617, 2621, 2633, 2647, 2657, 2659, 2663, 2671, 2677, 2683, 2687, 2689, 2693,\n 2699, 2707, 2711, 2713, 2719, 2729, 2731, 2741, 2749, 2753, 2767, 2777, 2789,\n 2791, 2797, 2801, 2803, 2819, 2833, 2837, 2843, 2851, 2857, 2861, 2879, 2887,\n 2897, 2903, 2909, 2917, 2927, 2939, 2953, 2957, 2963, 2969, 2971, 2999, 3001,\n 3011, 3019, 3023, 3037, 3041, 3049, 3061, 3067, 3079, 3083, 3089, 3109, 3119,\n 3121, 3137, 3163, 3167, 3169, 3181, 3187, 3191, 3203, 3209, 3217, 3221, 3229,\n 3251, 3253, 3257, 3259, 3271, 3299, 3301, 3307, 3313, 3319, 3323, 3329, 3331,\n 3343, 3347, 3359, 3361, 3371, 3373, 3389, 3391, 3407, 3413, 3433, 3449, 3457,\n 3461, 3463, 3467, 3469, 3491, 3499, 3511, 3517, 3527, 3529, 3533, 3539, 3541,\n 3547, 3557, 3559, 3571, 3581, 3583, 3593, 3607, 3613, 3617, 3623, 3631, 3637,\n 3643, 3659, 3671, 3673, 3677, 3691, 3697, 3701, 3709, 3719, 3727, 3733, 3739,\n 3761, 3767, 3769, 3779, 3793, 3797, 3803, 3821, 3823, 3833, 3847, 3851, 3853,\n 3863, 3877, 3881, 3889, 3907, 3911, 3917, 3919, 3923, 3929, 3931, 3943, 3947,\n 3967, 3989, 4001, 4003, 4007, 4013, 4019, 4021, 4027, 4049, 4051, 4057, 4073,\n 4079, 4091, 4093, 4099, 4111, 4127, 4129, 4133, 4139, 4153, 4157, 4159, 4177,\n 4201, 4211, 4217, 4219, 4229, 4231, 4241, 4243, 4253, 4259, 4261, 4271, 4273,\n 4283, 4289, 4297, 4327, 4337, 4339, 4349, 4357, 4363, 4373, 4391, 4397, 4409,\n 4421, 4423, 4441, 4447, 4451, 4457, 4463, 4481, 4483, 4493, 4507, 4513, 4517,\n 4519, 4523, 4547, 4549, 4561, 4567, 4583, 4591, 4597, 4603, 4621, 4637, 4639,\n 4643, 4649, 4651, 4657, 4663, 4673, 4679, 4691, 4703, 4721, 4723, 4729, 4733,\n 4751, 4759, 4783, 4787, 4789, 4793, 4799, 4801, 4813, 4817, 4831, 4861, 4871,\n 4877, 4889, 4903, 4909, 4919, 4931, 4933, 4937, 4943, 4951, 4957, 4967, 4969,\n 4973, 4987, 4993, 4999, 5003, 5009, 5011, 5021, 5023, 5039, 5051, 5059, 5077,\n 5081, 5087, 5099, 5101, 5107, 5113, 5119, 5147, 5153, 5167, 5171, 5179, 5189,\n 5197, 5209, 5227, 5231, 5233, 5237, 5261, 5273, 5279, 5281, 5297, 5303, 5309,\n 5323, 5333, 5347, 5351, 5381, 5387, 5393, 5399, 5407, 5413, 5417, 5419, 5431,\n 5437, 5441, 5443, 5449, 5471, 5477, 5479, 5483, 5501, 5503, 5507, 5519, 5521,\n 5527, 5531, 5557, 5563, 5569, 5573, 5581, 5591, 5623, 5639, 5641, 5647, 5651,\n 5653, 5657, 5659, 5669, 5683, 5689, 5693, 5701, 5711, 5717, 5737, 5741, 5743,\n 5749, 5779, 5783, 5791, 5801, 5807, 5813, 5821, 5827, 5839, 5843, 5849, 5851,\n 5857, 5861, 5867, 5869, 5879, 5881, 5897, 5903, 5923, 5927, 5939, 5953, 5981,\n 5987, 6007, 6011, 6029, 6037, 6043, 6047, 6053, 6067, 6073, 6079, 6089, 6091,\n 6101, 6113, 6121, 6131, 6133, 6143, 6151, 6163, 6173, 6197, 6199, 6203, 6211,\n 6217, 6221, 6229, 6247, 6257, 6263, 6269, 6271, 6277, 6287, 6299, 6301, 6311,\n 6317, 6323, 6329, 6337, 6343, 6353, 6359, 6361, 6367, 6373, 6379, 6389, 6397,\n 6421, 6427, 6449, 6451, 6469, 6473, 6481, 6491, 6521, 6529, 6547, 6551, 6553,\n 6563, 6569, 6571, 6577, 6581, 6599, 6607, 6619, 6637, 6653, 6659, 6661, 6673,\n 6679, 6689, 6691, 6701, 6703, 6709, 6719, 6733, 6737, 6761, 6763, 6779, 6781,\n 6791, 6793, 6803, 6823, 6827, 6829, 6833, 6841, 6857, 6863, 6869, 6871, 6883,\n 6899, 6907, 6911, 6917, 6947, 6949, 6959, 6961, 6967, 6971, 6977, 6983, 6991,\n 6997, 7001, 7013, 7019, 7027, 7039, 7043, 7057, 7069, 7079, 7103, 7109, 7121,\n 7127, 7129, 7151, 7159, 7177, 7187, 7193, 7207, 7211, 7213, 7219, 7229, 7237,\n 7243, 7247, 7253, 7283, 7297, 7307, 7309, 7321, 7331, 7333, 7349, 7351, 7369,\n 7393, 7411, 7417, 7433, 7451, 7457, 7459, 7477, 7481, 7487, 7489, 7499, 7507,\n 7517, 7523, 7529, 7537, 7541, 7547, 7549, 7559, 7561, 7573, 7577, 7583, 7589,\n 7591, 7603, 7607, 7621, 7639, 7643, 7649, 7669, 7673, 7681, 7687, 7691, 7699,\n 7703, 7717, 7723, 7727, 7741, 7753, 7757, 7759, 7789, 7793, 7817, 7823, 7829,\n 7841, 7853, 7867, 7873, 7877, 7879, 7883, 7901, 7907, 7919,\n]\n\nexport class DiffieHellman {\n constructor(\n private readonly p: number,\n private readonly g: number\n ) {\n if (!DiffieHellman.validateInitialArguments(p, g)) {\n throw Error('Constructor arguments are out of range or non-prime!')\n }\n }\n\n public getPublicKey(privateKey: number): number {\n if (privateKey <= 1 || privateKey > this.p - 1) {\n throw Error(\n 'Private key a must be greater than one but less than modulus parameter p!'\n )\n }\n return this.g ** privateKey % this.p\n }\n\n public getSecret(theirPublicKey: number, ourPrivateKey: number): number {\n return theirPublicKey ** ourPrivateKey % this.p\n }\n\n private static validateInitialArguments(p: number, g: number): boolean {\n const BIGGEST_PRIME = PRIMES[PRIMES.length - 1]\n\n return (\n p >= 2 &&\n g >= 2 &&\n p <= BIGGEST_PRIME &&\n g <= BIGGEST_PRIME &&\n PRIMES.includes(p) &&\n PRIMES.includes(g)\n )\n }\n}\n" }, { "path": "exercises/practice/diffie-hellman/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[1b97bf38-4307-418e-bfd2-446ffc77588d]\ndescription = \"private key is greater than 1 and less than p\"\n\n[68b2a5f7-7755-44c3-97b2-d28d21f014a9]\ndescription = \"private key is random\"\n\n[b4161d8e-53a1-4241-ae8f-48cc86527f22]\ndescription = \"can calculate public key using private key\"\n\n[0d25f8d7-4897-4338-a033-2d3d7a9af688]\ndescription = \"can calculate public key when given a different private key\"\n\n[cd02ad45-3f52-4510-99cc-5161dad948a8]\ndescription = \"can calculate secret using other party's public key\"\n\n[17f13c61-a111-4075-9a1f-c2d4636dfa60]\ndescription = \"key exchange\"\n" }, { "path": "exercises/practice/diffie-hellman/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/diffie-hellman/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/diffie-hellman/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/diffie-hellman/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/diffie-hellman/diffie-hellman.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { DiffieHellman } from './diffie-hellman.ts'\n\ndescribe('diffie-hellman', () => {\n it('throws an error if the constructor arguments are out of range', () => {\n expect(() => {\n new DiffieHellman(0, 9999)\n }).toThrow()\n })\n\n xit('throws an error if the constructor arguments are not prime', () => {\n expect(() => {\n new DiffieHellman(10, 13)\n }).toThrow()\n })\n\n xdescribe('input validation', () => {\n const p = 23\n const g = 5\n const diffieHellman = new DiffieHellman(p, g)\n\n xit('throws an error if private key is negative', () => {\n expect(() => {\n diffieHellman.getPublicKey(-1)\n }).toThrow()\n })\n\n xit('throws an error if private key is zero', () => {\n expect(() => {\n diffieHellman.getPublicKey(0)\n }).toThrow()\n })\n\n xit('throws an error if private key is one', () => {\n expect(() => {\n diffieHellman.getPublicKey(1)\n }).toThrow()\n })\n\n xit('throws an error if private key equals the modulus parameter p', () => {\n expect(() => {\n diffieHellman.getPublicKey(p)\n }).toThrow()\n })\n\n xit('throws an error if private key is greater than the modulus parameter p', () => {\n expect(() => {\n diffieHellman.getPublicKey(p + 1)\n }).toThrow()\n })\n })\n\n xdescribe('stateless calculation', () => {\n const diffieHellman = new DiffieHellman(23, 5)\n\n const alicePrivateKey = 6\n const alicePublicKey = 8\n\n const bobPrivateKey = 15\n const bobPublicKey = 19\n\n xit('can calculate public key using private key', () => {\n expect(diffieHellman.getPublicKey(alicePrivateKey)).toEqual(\n alicePublicKey\n )\n })\n\n xit('can calculate public key when given a different private key', () => {\n expect(diffieHellman.getPublicKey(bobPrivateKey)).toEqual(bobPublicKey)\n })\n })\n\n xit(\"can calculate secret using other party's public key\", () => {\n expect(new DiffieHellman(23, 5).getSecret(19, 6)).toEqual(2)\n })\n\n xit('key exchange', () => {\n const diffieHellman = new DiffieHellman(23, 5)\n\n const alicePrivateKey = 6\n const bobPrivateKey = 15\n const alicePublicKey = diffieHellman.getPublicKey(alicePrivateKey)\n const bobPublicKey = diffieHellman.getPublicKey(bobPrivateKey)\n\n const secretA = diffieHellman.getSecret(bobPublicKey, alicePrivateKey)\n const secretB = diffieHellman.getSecret(alicePublicKey, bobPrivateKey)\n\n expect(secretA).toEqual(secretB)\n })\n})\n" }, { "path": "exercises/practice/diffie-hellman/diffie-hellman.ts", "content": "export class DiffieHellman {\n constructor(p: unknown, g: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public getPublicKey(privateKey: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public getSecret(theirPublicKey: unknown, myPrivateKey: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/diffie-hellman/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/diffie-hellman/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/diffie-hellman/package.json", "content": "{\n \"name\": \"@exercism/typescript-diffie-hellman\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/diffie-hellman/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/diffie-hellman/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/dnd-character/.docs/instructions.md", "content": "# Instructions\n\nFor a game of [Dungeons & Dragons][dnd], each player starts by generating a character they can play with.\nThis character has, among other things, six abilities; strength, dexterity, constitution, intelligence, wisdom and charisma.\nThese six abilities have scores that are determined randomly.\nYou do this by rolling four 6-sided dice and recording the sum of the largest three dice.\nYou do this six times, once for each ability.\n\nYour character's initial hitpoints are 10 + your character's constitution modifier.\nYou find your character's constitution modifier by subtracting 10 from your character's constitution, divide by 2 and round down.\n\nWrite a random character generator that follows the above rules.\n\nFor example, the six throws of four dice may look like:\n\n- 5, 3, 1, 6: You discard the 1 and sum 5 + 3 + 6 = 14, which you assign to strength.\n- 3, 2, 5, 3: You discard the 2 and sum 3 + 5 + 3 = 11, which you assign to dexterity.\n- 1, 1, 1, 1: You discard the 1 and sum 1 + 1 + 1 = 3, which you assign to constitution.\n- 2, 1, 6, 6: You discard the 1 and sum 2 + 6 + 6 = 14, which you assign to intelligence.\n- 3, 5, 3, 4: You discard the 3 and sum 5 + 3 + 4 = 12, which you assign to wisdom.\n- 6, 6, 6, 6: You discard the 6 and sum 6 + 6 + 6 = 18, which you assign to charisma.\n\nBecause constitution is 3, the constitution modifier is -4 and the hitpoints are 6.\n\n~~~~exercism/note\nMost programming languages feature (pseudo-)random generators, but few programming languages are designed to roll dice.\nOne such language is [Troll][troll].\n\n[troll]: https://di.ku.dk/Ansatte/?pure=da%2Fpublications%2Ftroll-a-language-for-specifying-dicerolls(84a45ff0-068b-11df-825d-000ea68e967b)%2Fexport.html\n~~~~\n\n[dnd]: https://en.wikipedia.org/wiki/Dungeons_%26_Dragons\n" }, { "path": "exercises/practice/dnd-character/.docs/introduction.md", "content": "# Introduction\n\nAfter weeks of anticipation, you and your friends get together for your very first game of [Dungeons & Dragons][dnd] (D&D).\nSince this is the first session of the game, each player has to generate a character to play with.\nThe character's abilities are determined by rolling 6-sided dice, but where _are_ the dice?\nWith a shock, you realize that your friends are waiting for _you_ to produce the dice; after all it was your idea to play D&D!\nPanicking, you realize you forgot to bring the dice, which would mean no D&D game.\nAs you have some basic coding skills, you quickly come up with a solution: you'll write a program to simulate dice rolls.\n\n[dnd]: https://en.wikipedia.org/wiki/Dungeons_%26_Dragons\n" }, { "path": "exercises/practice/dnd-character/.meta/config.json", "content": "{\n \"authors\": [\n \"JoshiRaez\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"dnd-character.ts\"\n ],\n \"test\": [\n \"dnd-character.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Randomly generate Dungeons & Dragons characters.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Simon Shine, Erik Schierboom\",\n \"source_url\": \"https://github.com/exercism/problem-specifications/issues/616#issuecomment-437358945\"\n}\n" }, { "path": "exercises/practice/dnd-character/.meta/proof.ci.ts", "content": "export class DnDCharacter {\n public readonly hitpoints: number\n\n public readonly strength: number\n public readonly dexterity: number\n public readonly constitution: number\n public readonly intelligence: number\n public readonly wisdom: number\n public readonly charisma: number\n\n constructor() {\n this.strength = DnDCharacter.generateAbilityScore()\n this.dexterity = DnDCharacter.generateAbilityScore()\n this.constitution = DnDCharacter.generateAbilityScore()\n this.intelligence = DnDCharacter.generateAbilityScore()\n this.wisdom = DnDCharacter.generateAbilityScore()\n this.charisma = DnDCharacter.generateAbilityScore()\n\n this.hitpoints = 10 + DnDCharacter.getModifierFor(this.constitution)\n }\n\n public static generateAbilityScore(): number {\n return this.rollDice(4)\n .sort()\n .slice(1, 4)\n .reduce((acu, act) => acu + act, 0)\n }\n\n public static getModifierFor(abilityValue: number): number {\n return Math.floor((abilityValue - 10) / 2)\n }\n\n private static rollDice(quantity: number): number[] {\n return new Array(quantity).fill(0).map(() => this.rollDie())\n }\n\n private static rollDie(): number {\n return Math.floor(Math.random() * 6) + 1\n }\n}\n" }, { "path": "exercises/practice/dnd-character/.meta/tests.toml", "content": "[1e9ae1dc-35bd-43ba-aa08-e4b94c20fa37]\ndescription = \"Ability modifier for score 3 is -4\"\ninclude = true\n\n[cc9bb24e-56b8-4e9e-989d-a0d1a29ebb9c]\ndescription = \"Ability modifier for score 4 is -3\"\ninclude = true\n\n[5b519fcd-6946-41ee-91fe-34b4f9808326]\ndescription = \"Ability modifier for score 5 is -3\"\ninclude = true\n\n[dc2913bd-6d7a-402e-b1e2-6d568b1cbe21]\ndescription = \"Ability modifier for score 6 is -2\"\ninclude = true\n\n[099440f5-0d66-4b1a-8a10-8f3a03cc499f]\ndescription = \"Ability modifier for score 7 is -2\"\ninclude = true\n\n[cfda6e5c-3489-42f0-b22b-4acb47084df0]\ndescription = \"Ability modifier for score 8 is -1\"\ninclude = true\n\n[c70f0507-fa7e-4228-8463-858bfbba1754]\ndescription = \"Ability modifier for score 9 is -1\"\ninclude = true\n\n[6f4e6c88-1cd9-46a0-92b8-db4a99b372f7]\ndescription = \"Ability modifier for score 10 is 0\"\ninclude = true\n\n[e00d9e5c-63c8-413f-879d-cd9be9697097]\ndescription = \"Ability modifier for score 11 is 0\"\ninclude = true\n\n[eea06f3c-8de0-45e7-9d9d-b8cab4179715]\ndescription = \"Ability modifier for score 12 is 1\"\ninclude = true\n\n[9c51f6be-db72-4af7-92ac-b293a02c0dcd]\ndescription = \"Ability modifier for score 13 is 1\"\ninclude = true\n\n[94053a5d-53b6-4efc-b669-a8b5098f7762]\ndescription = \"Ability modifier for score 14 is 2\"\ninclude = true\n\n[8c33e7ca-3f9f-4820-8ab3-65f2c9e2f0e2]\ndescription = \"Ability modifier for score 15 is 2\"\ninclude = true\n\n[c3ec871e-1791-44d0-b3cc-77e5fb4cd33d]\ndescription = \"Ability modifier for score 16 is 3\"\ninclude = true\n\n[3d053cee-2888-4616-b9fd-602a3b1efff4]\ndescription = \"Ability modifier for score 17 is 3\"\ninclude = true\n\n[bafd997a-e852-4e56-9f65-14b60261faee]\ndescription = \"Ability modifier for score 18 is 4\"\ninclude = true\n\n[4f28f19c-2e47-4453-a46a-c0d365259c14]\ndescription = \"Random ability is within range\"\ninclude = true\n\n[385d7e72-864f-4e88-8279-81a7d75b04ad]\ndescription = \"Random character is valid\"\ninclude = true\n\n[2ca77b9b-c099-46c3-a02c-0d0f68ffa0fe]\ndescription = \"Each ability is only calculated once\"\ninclude = true\n\n" }, { "path": "exercises/practice/dnd-character/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/dnd-character/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/dnd-character/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/dnd-character/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/dnd-character/dnd-character.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { DnDCharacter } from './dnd-character.ts'\n\ndescribe('Ability modifier', () => {\n it('Ability modifier for score 3 is -4', () => {\n expect(DnDCharacter.getModifierFor(3)).toEqual(-4)\n })\n\n xit('Ability modifier for score 4 is -3', () => {\n expect(DnDCharacter.getModifierFor(4)).toEqual(-3)\n })\n\n xit('Ability modifier for score 5 is -3', () => {\n expect(DnDCharacter.getModifierFor(5)).toEqual(-3)\n })\n\n xit('Ability modifier for score 6 is -2', () => {\n expect(DnDCharacter.getModifierFor(6)).toEqual(-2)\n })\n\n xit('Ability modifier for score 7 is -2', () => {\n expect(DnDCharacter.getModifierFor(7)).toEqual(-2)\n })\n\n xit('Ability modifier for score 8 is -1', () => {\n expect(DnDCharacter.getModifierFor(8)).toEqual(-1)\n })\n\n xit('Ability modifier for score 9 is -1', () => {\n expect(DnDCharacter.getModifierFor(9)).toEqual(-1)\n })\n\n xit('Ability modifier for score 10 is 0', () => {\n expect(DnDCharacter.getModifierFor(10)).toEqual(0)\n })\n\n xit('Ability modifier for score 11 is 0', () => {\n expect(DnDCharacter.getModifierFor(11)).toEqual(0)\n })\n\n xit('Ability modifier for score 12 is 1', () => {\n expect(DnDCharacter.getModifierFor(12)).toEqual(1)\n })\n\n xit('Ability modifier for score 13 is 1', () => {\n expect(DnDCharacter.getModifierFor(13)).toEqual(1)\n })\n\n xit('Ability modifier for score 14 is 2', () => {\n expect(DnDCharacter.getModifierFor(14)).toEqual(2)\n })\n\n xit('Ability modifier for score 15 is 2', () => {\n expect(DnDCharacter.getModifierFor(15)).toEqual(2)\n })\n\n xit('Ability modifier for score 16 is 3', () => {\n expect(DnDCharacter.getModifierFor(16)).toEqual(3)\n })\n\n xit('Ability modifier for score 17 is 3', () => {\n expect(DnDCharacter.getModifierFor(17)).toEqual(3)\n })\n\n xit('Ability modifier for score 18 is 4', () => {\n expect(DnDCharacter.getModifierFor(18)).toEqual(4)\n })\n})\n\ndescribe('Ability generator', () => {\n xit('Random ability is within range', () => {\n const abilityScore = DnDCharacter.generateAbilityScore()\n expect(abilityScore).toBeGreaterThanOrEqual(3)\n expect(abilityScore).toBeLessThanOrEqual(18)\n })\n})\n\ndescribe('Character creation', () => {\n xit('Random character is valid - hitpoints', () => {\n const character = new DnDCharacter()\n\n expect(character.hitpoints).toEqual(\n 10 + DnDCharacter.getModifierFor(character.constitution)\n )\n })\n\n xit('Random character is valid - strength', () => {\n const character = new DnDCharacter()\n\n expect(character.strength).toBeGreaterThanOrEqual(3)\n expect(character.strength).toBeLessThanOrEqual(18)\n })\n\n xit('Random character is valid - dexterity', () => {\n const character = new DnDCharacter()\n\n expect(character.dexterity).toBeGreaterThanOrEqual(3)\n expect(character.dexterity).toBeLessThanOrEqual(18)\n })\n\n xit('Random character is valid - constitution', () => {\n const character = new DnDCharacter()\n\n expect(character.constitution).toBeGreaterThanOrEqual(3)\n expect(character.constitution).toBeLessThanOrEqual(18)\n })\n\n xit('Random character is valid - intelligence', () => {\n const character = new DnDCharacter()\n\n expect(character.intelligence).toBeGreaterThanOrEqual(3)\n expect(character.intelligence).toBeLessThanOrEqual(18)\n })\n\n xit('Random character is valid - wisdom', () => {\n const character = new DnDCharacter()\n\n expect(character.wisdom).toBeGreaterThanOrEqual(3)\n expect(character.wisdom).toBeLessThanOrEqual(18)\n })\n\n xit('Random character is valid - charisma', () => {\n const character = new DnDCharacter()\n\n expect(character.charisma).toBeGreaterThanOrEqual(3)\n expect(character.charisma).toBeLessThanOrEqual(18)\n })\n\n xit('Each ability is only calculated once', () => {\n const character = new DnDCharacter()\n\n expect(character.strength === character.strength).toBeTruthy()\n })\n})\n" }, { "path": "exercises/practice/dnd-character/dnd-character.ts", "content": "export class DnDCharacter {\n public static generateAbilityScore(): number {\n throw new Error('Remove this line and implement the function')\n }\n\n public static getModifierFor(abilityValue: number): number {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/dnd-character/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/dnd-character/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/dnd-character/package.json", "content": "{\n \"name\": \"@exercism/typescript-dnd-character\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism practice exercise on dnd-character\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/dnd-character/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/dnd-character/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/eliuds-eggs/.docs/instructions.md", "content": "# Instructions\n\nYour task is to count the number of 1 bits in the binary representation of a number.\n\n## Restrictions\n\nKeep your hands off that bit-count functionality provided by your standard library!\nSolve this one yourself using other basic tools instead.\n" }, { "path": "exercises/practice/eliuds-eggs/.docs/introduction.md", "content": "# Introduction\n\nYour friend Eliud inherited a farm from her grandma Tigist.\nHer granny was an inventor and had a tendency to build things in an overly complicated manner.\nThe chicken coop has a digital display showing an encoded number representing the positions of all eggs that could be picked up.\n\nEliud is asking you to write a program that shows the actual number of eggs in the coop.\n\nThe position information encoding is calculated as follows:\n\n1. Scan the potential egg-laying spots and mark down a `1` for an existing egg or a `0` for an empty spot.\n2. Convert the number from binary to decimal.\n3. Show the result on the display.\n\n## Example 1\n\n![Seven individual nest boxes arranged in a row whose first, third, fourth and seventh nests each have a single egg.](https://assets.exercism.org/images/exercises/eliuds-eggs/example-1-coop.svg)\n\n```text\n _ _ _ _ _ _ _\n|E| |E|E| | |E|\n```\n\n### Resulting Binary\n\n![1011001](https://assets.exercism.org/images/exercises/eliuds-eggs/example-1-binary.svg)\n\n```text\n _ _ _ _ _ _ _\n|1|0|1|1|0|0|1|\n```\n\n### Decimal number on the display\n\n89\n\n### Actual eggs in the coop\n\n4\n\n## Example 2\n\n![Seven individual nest boxes arranged in a row where only the fourth nest has an egg.](https://assets.exercism.org/images/exercises/eliuds-eggs/example-2-coop.svg)\n\n```text\n _ _ _ _ _ _ _\n| | | |E| | | |\n```\n\n### Resulting Binary\n\n![0001000](https://assets.exercism.org/images/exercises/eliuds-eggs/example-2-binary.svg)\n\n```text\n _ _ _ _ _ _ _\n|0|0|0|1|0|0|0|\n```\n\n### Decimal number on the display\n\n8\n\n### Actual eggs in the coop\n\n1\n" }, { "path": "exercises/practice/eliuds-eggs/.meta/config.json", "content": "{\n \"authors\": [\n \"therealowenrees\"\n ],\n \"files\": {\n \"solution\": [\n \"eliuds-eggs.ts\"\n ],\n \"test\": [\n \"eliuds-eggs.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Help Eliud count the number of eggs in her chicken coop by counting the number of 1 bits in a binary representation.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Christian Willner, Eric Willigers\",\n \"source_url\": \"https://forum.exercism.org/t/new-exercise-suggestion-pop-count/7632/5\"\n}\n" }, { "path": "exercises/practice/eliuds-eggs/.meta/proof.ci.ts", "content": "export const eggCount = (displayValue: number): number => {\n let count = 0\n\n while (displayValue !== 0) {\n count += displayValue & 1\n displayValue >>= 1\n }\n\n return count\n}\n" }, { "path": "exercises/practice/eliuds-eggs/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[559e789d-07d1-4422-9004-3b699f83bca3]\ndescription = \"0 eggs\"\n\n[97223282-f71e-490c-92f0-b3ec9e275aba]\ndescription = \"1 egg\"\n\n[1f8fd18f-26e9-4144-9a0e-57cdfc4f4ff5]\ndescription = \"4 eggs\"\n\n[0c18be92-a498-4ef2-bcbb-28ac4b06cb81]\ndescription = \"13 eggs\"\n" }, { "path": "exercises/practice/eliuds-eggs/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/eliuds-eggs/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/eliuds-eggs/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/eliuds-eggs/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/eliuds-eggs/eliuds-eggs.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { eggCount } from './eliuds-eggs.ts'\n\ndescribe('EliudsEggs', () => {\n it('0 eggs', () => {\n const expected = 0\n const actual = eggCount(0)\n expect(actual).toEqual(expected)\n })\n\n xit('1 egg', () => {\n const expected = 1\n const actual = eggCount(16)\n expect(actual).toEqual(expected)\n })\n\n xit('4 eggs', () => {\n const expected = 4\n const actual = eggCount(89)\n expect(actual).toEqual(expected)\n })\n\n xit('13 eggs', () => {\n const expected = 13\n const actual = eggCount(2000000000)\n expect(actual).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/eliuds-eggs/eliuds-eggs.ts", "content": "//\n// This is only a SKELETON file for the 'Pop Count' exercise. It's been provided as a\n// convenience to get you started writing code faster.\n//\n\nexport const eggCount = (displayValue: unknown): unknown => {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/eliuds-eggs/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/eliuds-eggs/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/eliuds-eggs/package.json", "content": "{\n \"name\": \"@exercism/typescript-eliuds-eggs\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/eliuds-eggs/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/eliuds-eggs/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/etl/.docs/instructions.md", "content": "# Instructions\n\nYour task is to change the data format of letters and their point values in the game.\n\nCurrently, letters are stored in groups based on their score, in a one-to-many mapping.\n\n- 1 point: \"A\", \"E\", \"I\", \"O\", \"U\", \"L\", \"N\", \"R\", \"S\", \"T\",\n- 2 points: \"D\", \"G\",\n- 3 points: \"B\", \"C\", \"M\", \"P\",\n- 4 points: \"F\", \"H\", \"V\", \"W\", \"Y\",\n- 5 points: \"K\",\n- 8 points: \"J\", \"X\",\n- 10 points: \"Q\", \"Z\",\n\nThis needs to be changed to store each individual letter with its score in a one-to-one mapping.\n\n- \"a\" is worth 1 point.\n- \"b\" is worth 3 points.\n- \"c\" is worth 3 points.\n- \"d\" is worth 2 points.\n- etc.\n\nAs part of this change, the team has also decided to change the letters to be lower-case rather than upper-case.\n\n~~~~exercism/note\nIf you want to look at how the data was previously structured and how it needs to change, take a look at the examples in the test suite.\n~~~~\n" }, { "path": "exercises/practice/etl/.docs/introduction.md", "content": "# Introduction\n\nYou work for a company that makes an online multiplayer game called Lexiconia.\n\nTo play the game, each player is given 13 letters, which they must rearrange to create words.\nDifferent letters have different point values, since it's easier to create words with some letters than others.\n\nThe game was originally launched in English, but it is very popular, and now the company wants to expand to other languages as well.\n\nDifferent languages need to support different point values for letters.\nThe point values are determined by how often letters are used, compared to other letters in that language.\n\nFor example, the letter 'C' is quite common in English, and is only worth 3 points.\nBut in Norwegian it's a very rare letter, and is worth 10 points.\n\nTo make it easier to add new languages, your team needs to change the way letters and their point values are stored in the game.\n" }, { "path": "exercises/practice/etl/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"pranasziaukas\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"etl.ts\"\n ],\n \"test\": [\n \"etl.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Change the data format for scoring a game to more easily add other languages.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Based on an exercise by the JumpstartLab team for students at The Turing School of Software and Design.\",\n \"source_url\": \"https://www.turing.edu/\"\n}\n" }, { "path": "exercises/practice/etl/.meta/proof.ci.ts", "content": "export function transform(input: { [key: string]: string[] }): {\n [key: string]: number\n} {\n const phase1: { [key: string]: number } = {}\n\n for (const key in input) {\n if (Object.prototype.hasOwnProperty.call(input, key)) {\n const value = input[key]\n for (const each of value) {\n phase1[each.toLowerCase()] = Number.parseInt(key, 10)\n }\n }\n }\n return phase1\n}\n" }, { "path": "exercises/practice/etl/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[78a7a9f9-4490-4a47-8ee9-5a38bb47d28f]\ndescription = \"single letter\"\n\n[60dbd000-451d-44c7-bdbb-97c73ac1f497]\ndescription = \"single score with multiple letters\"\n\n[f5c5de0c-301f-4fdd-a0e5-df97d4214f54]\ndescription = \"multiple scores with multiple letters\"\n\n[5db8ea89-ecb4-4dcd-902f-2b418cc87b9d]\ndescription = \"multiple scores with differing numbers of letters\"\n" }, { "path": "exercises/practice/etl/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/etl/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/etl/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/etl/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/etl/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/etl/etl.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { transform } from './etl.ts'\n\ndescribe('Transform', () => {\n it('transforms one value', () => {\n const old: { [key: string]: string[] } = { 1: ['A'] }\n const expected: { [key: string]: number } = { a: 1 }\n\n expect(transform(old)).toEqual(expected)\n })\n\n xit('transforms more values', () => {\n const old = { 1: ['A', 'E', 'I', 'O', 'U'] }\n const expected = { a: 1, e: 1, i: 1, o: 1, u: 1 }\n\n expect(transform(old)).toEqual(expected)\n })\n\n xit('transforms more keys', () => {\n const old = { 1: ['A', 'E'], 2: ['D', 'G'] }\n const expected = { a: 1, e: 1, d: 2, g: 2 }\n\n expect(transform(old)).toEqual(expected)\n })\n\n xit('transforms a full dataset', () => {\n const old = {\n 1: ['A', 'E', 'I', 'O', 'U', 'L', 'N', 'R', 'S', 'T'],\n 2: ['D', 'G'],\n 3: ['B', 'C', 'M', 'P'],\n 4: ['F', 'H', 'V', 'W', 'Y'],\n 5: ['K'],\n 8: ['J', 'X'],\n 10: ['Q', 'Z'],\n }\n const expected = {\n a: 1,\n b: 3,\n c: 3,\n d: 2,\n e: 1,\n f: 4,\n g: 2,\n h: 4,\n i: 1,\n j: 8,\n k: 5,\n l: 1,\n m: 3,\n n: 1,\n o: 1,\n p: 3,\n q: 10,\n r: 1,\n s: 1,\n t: 1,\n u: 1,\n v: 4,\n w: 4,\n x: 8,\n y: 4,\n z: 10,\n }\n\n expect(transform(old)).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/etl/etl.ts", "content": "export function transform(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/etl/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/etl/package.json", "content": "{\n \"name\": \"@exercism/typescript-etl\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/etl/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/etl/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/flatten-array/.docs/instructions.md", "content": "# Instructions\n\nTake a nested array of any depth and return a fully flattened array.\n\nNote that some language tracks may include null-like values in the input array, and the way these values are represented varies by track.\nSuch values should be excluded from the flattened array.\n\nAdditionally, the input may be of a different data type and contain different types, depending on the track.\n\nCheck the test suite for details.\n\n## Example\n\ninput: `[1, [2, 6, null], [[null, [4]], 5]]`\n\noutput: `[1, 2, 6, 4, 5]`\n" }, { "path": "exercises/practice/flatten-array/.docs/introduction.md", "content": "# Introduction\n\nA shipment of emergency supplies has arrived, but there's a problem.\nTo protect from damage, the items ā€” flashlights, first-aid kits, blankets ā€” are packed inside boxes, and some of those boxes are nested several layers deep inside other boxes!\n\nTo be prepared for an emergency, everything must be easily accessible in one box.\nCan you unpack all the supplies and place them into a single box, so they're ready when needed most?\n" }, { "path": "exercises/practice/flatten-array/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"flatten-array.ts\"\n ],\n \"test\": [\n \"flatten-array.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Take a nested list and return a single list with all values except nil/null.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Interview Question\",\n \"source_url\": \"https://reference.wolfram.com/language/ref/Flatten.html\"\n}\n" }, { "path": "exercises/practice/flatten-array/.meta/proof.ci.ts", "content": "export function flatten>(arr: T): A[] {\n return arr\n .reduce(\n (acc: A[], el) =>\n Array.isArray(el) ? acc.concat(flatten(el)) : acc.concat(el),\n []\n )\n .filter((el: A) => el !== null && el !== undefined)\n}\n" }, { "path": "exercises/practice/flatten-array/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[8c71dabd-da60-422d-a290-4a571471fb14]\ndescription = \"empty\"\n\n[d268b919-963c-442d-9f07-82b93f1b518c]\ndescription = \"no nesting\"\n\n[3f15bede-c856-479e-bb71-1684b20c6a30]\ndescription = \"flattens a nested array\"\n\n[c84440cc-bb3a-48a6-862c-94cf23f2815d]\ndescription = \"flattens array with just integers present\"\n\n[d3d99d39-6be5-44f5-a31d-6037d92ba34f]\ndescription = \"5 level nesting\"\n\n[d572bdba-c127-43ed-bdcd-6222ac83d9f7]\ndescription = \"6 level nesting\"\n\n[0705a8e5-dc86-4cec-8909-150c5e54fa9c]\ndescription = \"null values are omitted from the final result\"\n\n[c6cf26de-8ccd-4410-84bd-b9efd88fd2bc]\ndescription = \"consecutive null values at the front of the list are omitted from the final result\"\ninclude = false\n\n[bc72da10-5f55-4ada-baf3-50e4da02ec8e]\ndescription = \"consecutive null values at the front of the array are omitted from the final result\"\nreimplements = \"c6cf26de-8ccd-4410-84bd-b9efd88fd2bc\"\n\n[382c5242-587e-4577-b8ce-a5fb51e385a1]\ndescription = \"consecutive null values in the middle of the list are omitted from the final result\"\ninclude = false\n\n[6991836d-0d9b-4703-80a0-3f1f23eb5981]\ndescription = \"consecutive null values in the middle of the array are omitted from the final result\"\nreimplements = \"382c5242-587e-4577-b8ce-a5fb51e385a1\"\n\n[ef1d4790-1b1e-4939-a179-51ace0829dbd]\ndescription = \"6 level nest list with null values\"\ninclude = false\n\n[dc90a09c-5376-449c-a7b3-c2d20d540069]\ndescription = \"6 level nested array with null values\"\nreimplements = \"ef1d4790-1b1e-4939-a179-51ace0829dbd\"\n\n[85721643-705a-4150-93ab-7ae398e2942d]\ndescription = \"all values in nested list are null\"\ninclude = false\n\n[51f5d9af-8f7f-4fb5-a156-69e8282cb275]\ndescription = \"all values in nested array are null\"\nreimplements = \"85721643-705a-4150-93ab-7ae398e2942d\"\n" }, { "path": "exercises/practice/flatten-array/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/flatten-array/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/flatten-array/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/flatten-array/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/flatten-array/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/flatten-array/flatten-array.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { flatten } from './flatten-array.ts'\n\ndescribe('Flatten Array', () => {\n it('empty', () => {\n const arr = []\n const expected = []\n expect(flatten(arr)).toEqual(expected)\n })\n\n xit('no nesting', () => {\n const arr = [0, 1, 2]\n const expected = [0, 1, 2]\n expect(flatten(arr)).toEqual(expected)\n })\n\n xit('flattens a nested array', () => {\n const arr = [[[]]]\n const expected = []\n expect(flatten(arr)).toEqual(expected)\n })\n\n xit('flattens array with just integers present', () => {\n const arr = [1, [2, 3, 4, 5, 6, 7], 8]\n const expected = [1, 2, 3, 4, 5, 6, 7, 8]\n expect(flatten(arr)).toEqual(expected)\n })\n\n xit('5 level nesting', () => {\n const arr = [0, 2, [[2, 3], 8, 100, 4, [[[50]]]], -2]\n const expected = [0, 2, 2, 3, 8, 100, 4, 50, -2]\n expect(flatten(arr)).toEqual(expected)\n })\n\n xit('6 level nesting', () => {\n const arr = [1, [2, [[3]], [4, [[5]]], 6, 7], 8]\n const expected = [1, 2, 3, 4, 5, 6, 7, 8]\n expect(flatten(arr)).toEqual(expected)\n })\n\n xit('consecutive null values at the front of the array are omitted from the final result', () => {\n const arr = [undefined, undefined, 3]\n const expected = [3]\n expect(flatten(arr)).toEqual(expected)\n })\n\n xit('consecutive null values in the middle of the array are omitted from the final result', () => {\n const arr = [1, undefined, undefined, 4]\n const expected = [1, 4]\n expect(flatten(arr)).toEqual(expected)\n })\n\n xit('6 level nest array with null values', () => {\n const arr = [0, 2, [[2, 3], 8, [[100]], undefined, [[undefined]]], -2]\n const expected = [0, 2, 2, 3, 8, 100, -2]\n expect(flatten(arr)).toEqual(expected)\n })\n\n xit('all values in nested array are null', () => {\n const expected: number[] = []\n expect(\n flatten([\n undefined,\n [[[undefined]]],\n undefined,\n undefined,\n [[undefined, undefined], undefined],\n undefined,\n ])\n ).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/flatten-array/flatten-array.ts", "content": "export function flatten(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/flatten-array/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/flatten-array/package.json", "content": "{\n \"name\": \"@exercism/typescript-flatten-array\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/flatten-array/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/flatten-array/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/flower-field/.docs/instructions.md", "content": "# Instructions\n\nYour task is to add flower counts to empty squares in a completed Flower Field garden.\nThe garden itself is a rectangle board composed of squares that are either empty (`' '`) or a flower (`'*'`).\n\nFor each empty square, count the number of flowers adjacent to it (horizontally, vertically, diagonally).\nIf the empty square has no adjacent flowers, leave it empty.\nOtherwise replace it with the count of adjacent flowers.\n\nFor example, you may receive a 5 x 4 board like this (empty spaces are represented here with the 'Ā·' character for display on screen):\n\n```text\nĀ·*Ā·*Ā·\nĀ·Ā·*Ā·Ā·\nĀ·Ā·*Ā·Ā·\nĀ·Ā·Ā·Ā·Ā·\n```\n\nWhich your code should transform into this:\n\n```text\n1*3*1\n13*31\nĀ·2*2Ā·\nĀ·111Ā·\n```\n" }, { "path": "exercises/practice/flower-field/.docs/introduction.md", "content": "# Introduction\n\n[Flower Field][history] is a compassionate reimagining of the popular game Minesweeper.\nThe object of the game is to find all the flowers in the garden using numeric hints that indicate how many flowers are directly adjacent (horizontally, vertically, diagonally) to a square.\n\"Flower Field\" shipped in regional versions of Microsoft Windows in Italy, Germany, South Korea, Japan and Taiwan.\n\n[history]: https://web.archive.org/web/20020409051321fw_/http://rcm.usr.dsi.unimi.it/rcmweb/fnm/\n" }, { "path": "exercises/practice/flower-field/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"BNAndras\",\n \"iignatov\",\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"flower-field.ts\"\n ],\n \"test\": [\n \"flower-field.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Mark all the flowers in a garden.\"\n}\n" }, { "path": "exercises/practice/flower-field/.meta/proof.ci.ts", "content": "const FLOWER = '*'\n\nconst DELTAS = [\n [-1, -1],\n [-1, 0],\n [-1, 1],\n [1, 1],\n [1, 0],\n [1, -1],\n [0, 1],\n [0, -1],\n]\n\nexport function annotate(rows: string[]): string[] {\n if (noDataPresent(rows)) {\n return rows\n }\n\n const inputBoard = rows.map((row) => [...row])\n\n const result = inputBoard.map((row, x) =>\n [...row].map((cell, y) => cellToFlowerOrCount(cell, inputBoard, x, y))\n )\n\n return stringify(result as string[][])\n}\n\nfunction cellToFlowerOrCount(\n cell: string,\n inputBoard: string[][],\n x: number,\n y: number\n): number | '*' | ' ' {\n if (cell === FLOWER) {\n return FLOWER\n }\n return countAdjacentFlowers(inputBoard, x, y) || ' '\n}\n\nfunction countAdjacentFlowers(board: string[][], x: number, y: number): number {\n return DELTAS.filter((d) => adjacentSquareIsOnBoard(board, x, d)).filter(\n (d) => adjacentSquareHasFlower(board, x, y, d)\n ).length\n}\n\nfunction stringify(board: string[][]): string[] {\n return board.map((row) => row.join(''))\n}\n\nfunction noDataPresent(rows: string[]): boolean {\n return rows.length === 0 || rows[0].length === 0\n}\n\nfunction adjacentSquareIsOnBoard(\n board: string[][],\n x: number,\n d: number[]\n): string[] {\n return board[x + d[0]]\n}\n\nfunction adjacentSquareHasFlower(\n board: string[][],\n x: number,\n y: number,\n d: number[]\n): boolean {\n return board[x + d[0]][y + d[1]] === FLOWER\n}\n" }, { "path": "exercises/practice/flower-field/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[237ff487-467a-47e1-9b01-8a891844f86c]\ndescription = \"no rows\"\n\n[4b4134ec-e20f-439c-a295-664c38950ba1]\ndescription = \"no columns\"\n\n[d774d054-bbad-4867-88ae-069cbd1c4f92]\ndescription = \"no flowers\"\n\n[225176a0-725e-43cd-aa13-9dced501f16e]\ndescription = \"garden full of flowers\"\n\n[3f345495-f1a5-4132-8411-74bd7ca08c49]\ndescription = \"flower surrounded by spaces\"\n\n[6cb04070-4199-4ef7-a6fa-92f68c660fca]\ndescription = \"space surrounded by flowers\"\n\n[272d2306-9f62-44fe-8ab5-6b0f43a26338]\ndescription = \"horizontal line\"\n\n[c6f0a4b2-58d0-4bf6-ad8d-ccf4144f1f8e]\ndescription = \"horizontal line, flowers at edges\"\n\n[a54e84b7-3b25-44a8-b8cf-1753c8bb4cf5]\ndescription = \"vertical line\"\n\n[b40f42f5-dec5-4abc-b167-3f08195189c1]\ndescription = \"vertical line, flowers at edges\"\n\n[58674965-7b42-4818-b930-0215062d543c]\ndescription = \"cross\"\n\n[dd9d4ca8-9e68-4f78-a677-a2a70fd7a7b8]\ndescription = \"large garden\"\n\n[6e4ac13a-3e43-4728-a2e3-3551d4b1a996]\ndescription = \"multiple adjacent flowers\"\n" }, { "path": "exercises/practice/flower-field/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/flower-field/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/flower-field/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/flower-field/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/flower-field/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/flower-field/flower-field.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { annotate } from './flower-field.ts'\n\ndescribe('Flower Field annotate', () => {\n it('handles no rows', () => {\n expect(annotate([])).toEqual([])\n })\n\n xit('handles no columns', () => {\n expect(annotate([''])).toEqual([''])\n })\n\n xit('handles no flowers', () => {\n const input = [' ', ' ', ' ']\n const expected = [' ', ' ', ' ']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles garden full of flowers', () => {\n const input = ['***', '***', '***']\n const expected = ['***', '***', '***']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles flower surrounded by spaces', () => {\n const input = [' ', ' * ', ' ']\n const expected = ['111', '1*1', '111']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles space surrounded by flowers', () => {\n const input = ['***', '* *', '***']\n const expected = ['***', '*8*', '***']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles horizontal line', () => {\n const input = [' * * ']\n const expected = ['1*2*1']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles horizontal line, flowers at edges', () => {\n const input = ['* *']\n const expected = ['*1 1*']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles vertical line', () => {\n const input = [' ', '*', ' ', '*', ' ']\n const expected = ['1', '*', '2', '*', '1']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles vertical line, flowers at edges', () => {\n const input = ['*', ' ', ' ', ' ', '*']\n const expected = ['*', '1', ' ', '1', '*']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles cross', () => {\n const input = [' * ', ' * ', '*****', ' * ', ' * ']\n const expected = [' 2*2 ', '25*52', '*****', '25*52', ' 2*2 ']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles large gardem', () => {\n const input = [' * * ', ' * ', ' * ', ' * *', ' * * ', ' ']\n const expected = [\n '1*22*1',\n '12*322',\n ' 123*2',\n '112*4*',\n '1*22*2',\n '111111',\n ]\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('multiple adjacent flowers', () => {\n expect(annotate([' ** '])).toEqual(['1**1'])\n })\n})\n" }, { "path": "exercises/practice/flower-field/flower-field.ts", "content": "export function annotate(field: unknown): unknown {\n throw new Error('Remove this statement and implement this function')\n}\n" }, { "path": "exercises/practice/flower-field/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/flower-field/package.json", "content": "{\n \"name\": \"@exercism/typescript-flower-field\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/flower-field/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/flower-field/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/food-chain/.docs/instructions.md", "content": "# Instructions\n\nGenerate the lyrics of the song 'I Know an Old Lady Who Swallowed a Fly'.\n\nWhile you could copy/paste the lyrics, or read them from a file, this problem is much more interesting if you approach it algorithmically.\n\nThis is a [cumulative song][cumulative-song] of unknown origin.\n\nThis is one of many common variants.\n\n```text\nI know an old lady who swallowed a fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a spider.\nIt wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a bird.\nHow absurd to swallow a bird!\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a cat.\nImagine that, to swallow a cat!\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a dog.\nWhat a hog, to swallow a dog!\nShe swallowed the dog to catch the cat.\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a goat.\nJust opened her throat and swallowed a goat!\nShe swallowed the goat to catch the dog.\nShe swallowed the dog to catch the cat.\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a cow.\nI don't know how she swallowed a cow!\nShe swallowed the cow to catch the goat.\nShe swallowed the goat to catch the dog.\nShe swallowed the dog to catch the cat.\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a horse.\nShe's dead, of course!\n```\n\n[cumulative-song]: https://en.wikipedia.org/wiki/Cumulative_song\n" }, { "path": "exercises/practice/food-chain/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"food-chain.ts\"\n ],\n \"test\": [\n \"food-chain.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Generate the lyrics of the song 'I Know an Old Lady Who Swallowed a Fly'.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/There_Was_an_Old_Lady_Who_Swallowed_a_Fly\"\n}\n" }, { "path": "exercises/practice/food-chain/.meta/proof.ci.ts", "content": "const animals = [\n 'fly',\n 'spider',\n 'bird',\n 'cat',\n 'dog',\n 'goat',\n 'cow',\n 'horse',\n] as const\n\nexport function verses(start = 1, end = 8): string {\n if (end < start) {\n throw new Error('end should be smaller than the start')\n }\n let result = ''\n\n for (; start <= end; start += 1) {\n result += verse(start)\n if (start !== end) {\n result += '\\n'\n }\n }\n return result\n}\n\nexport function verse(num: number): string {\n let result = ''\n\n let index = num - 1\n result += `I know an old lady who swallowed a ${animals[index]}.\\n`\n\n switch (num) {\n case 2:\n result += 'It wriggled and jiggled and tickled inside her.\\n'\n break\n case 3:\n result += 'How absurd to swallow a bird!\\n'\n break\n case 4:\n result += 'Imagine that, to swallow a cat!\\n'\n break\n case 5:\n result += 'What a hog, to swallow a dog!\\n'\n break\n case 6:\n result += 'Just opened her throat and swallowed a goat!\\n'\n break\n case 7:\n result += \"I don't know how she swallowed a cow!\\n\"\n break\n case 8:\n result += \"She's dead, of course!\\n\"\n return result\n default:\n break\n }\n\n while (index >= 1) {\n result += `She swallowed the ${animals[index]} to catch the ${\n animals[index - 1]\n }`\n if (index === 2) {\n result += ' that wriggled and jiggled and tickled inside her'\n }\n result += '.\\n'\n index -= 1\n }\n result += \"I don't know why she swallowed the fly. Perhaps she'll die.\"\n\n return result + '\\n'\n}\n" }, { "path": "exercises/practice/food-chain/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[751dce68-9412-496e-b6e8-855998c56166]\ndescription = \"fly\"\n\n[6c56f861-0c5e-4907-9a9d-b2efae389379]\ndescription = \"spider\"\n\n[3edf5f33-bef1-4e39-ae67-ca5eb79203fa]\ndescription = \"bird\"\n\n[e866a758-e1ff-400e-9f35-f27f28cc288f]\ndescription = \"cat\"\n\n[3f02c30e-496b-4b2a-8491-bc7e2953cafb]\ndescription = \"dog\"\n\n[4b3fd221-01ea-46e0-825b-5734634fbc59]\ndescription = \"goat\"\n\n[1b707da9-7001-4fac-941f-22ad9c7a65d4]\ndescription = \"cow\"\n\n[3cb10d46-ae4e-4d2c-9296-83c9ffc04cdc]\ndescription = \"horse\"\n\n[22b863d5-17e4-4d1e-93e4-617329a5c050]\ndescription = \"multiple verses\"\n\n[e626b32b-745c-4101-bcbd-3b13456893db]\ndescription = \"full song\"\n" }, { "path": "exercises/practice/food-chain/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/food-chain/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/food-chain/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/food-chain/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/food-chain/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/food-chain/food-chain.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { verse, verses } from './food-chain.ts'\n\ndescribe('Food Chain', () => {\n it('fly', () => {\n const expected = `I know an old lady who swallowed a fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n`\n\n expect(verse(1)).toEqual(expected)\n })\n\n xit('spider', () => {\n const expected = `I know an old lady who swallowed a spider.\nIt wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n`\n\n expect(verse(2)).toEqual(expected)\n })\n\n xit('bird', () => {\n const expected = `I know an old lady who swallowed a bird.\nHow absurd to swallow a bird!\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n`\n\n expect(verse(3)).toEqual(expected)\n })\n\n xit('cat', () => {\n const expected = `I know an old lady who swallowed a cat.\nImagine that, to swallow a cat!\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n`\n\n expect(verse(4)).toEqual(expected)\n })\n\n xit('dog', () => {\n const expected = `I know an old lady who swallowed a dog.\nWhat a hog, to swallow a dog!\nShe swallowed the dog to catch the cat.\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n`\n\n expect(verse(5)).toEqual(expected)\n })\n\n xit('goat', () => {\n const expected = `I know an old lady who swallowed a goat.\nJust opened her throat and swallowed a goat!\nShe swallowed the goat to catch the dog.\nShe swallowed the dog to catch the cat.\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n`\n\n expect(verse(6)).toEqual(expected)\n })\n\n xit('cow', () => {\n const expected = `I know an old lady who swallowed a cow.\nI don't know how she swallowed a cow!\nShe swallowed the cow to catch the goat.\nShe swallowed the goat to catch the dog.\nShe swallowed the dog to catch the cat.\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n`\n\n expect(verse(7)).toEqual(expected)\n })\n\n xit('horse', () => {\n const expected = `I know an old lady who swallowed a horse.\nShe's dead, of course!\n`\n\n expect(verse(8)).toEqual(expected)\n })\n\n xit('multiple verses', () => {\n const expected = `I know an old lady who swallowed a fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a spider.\nIt wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n`\n\n expect(verses(1, 2)).toEqual(expected)\n })\n\n xit('the whole song', () => {\n const expected = `I know an old lady who swallowed a fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a spider.\nIt wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a bird.\nHow absurd to swallow a bird!\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a cat.\nImagine that, to swallow a cat!\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a dog.\nWhat a hog, to swallow a dog!\nShe swallowed the dog to catch the cat.\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a goat.\nJust opened her throat and swallowed a goat!\nShe swallowed the goat to catch the dog.\nShe swallowed the dog to catch the cat.\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a cow.\nI don't know how she swallowed a cow!\nShe swallowed the cow to catch the goat.\nShe swallowed the goat to catch the dog.\nShe swallowed the dog to catch the cat.\nShe swallowed the cat to catch the bird.\nShe swallowed the bird to catch the spider that wriggled and jiggled and tickled inside her.\nShe swallowed the spider to catch the fly.\nI don't know why she swallowed the fly. Perhaps she'll die.\n\nI know an old lady who swallowed a horse.\nShe's dead, of course!\n`\n expect(verses(1, 8)).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/food-chain/food-chain.ts", "content": "export function verse(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n}\n\nexport function verses(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/food-chain/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/food-chain/package.json", "content": "{\n \"name\": \"@exercism/typescript-food-chain\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/food-chain/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/food-chain/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/game-of-life/.docs/instructions.md", "content": "# Instructions\n\nAfter each generation, the cells interact with their eight neighbors, which are cells adjacent horizontally, vertically, or diagonally.\n\nThe following rules are applied to each cell:\n\n- Any live cell with two or three live neighbors lives on.\n- Any dead cell with exactly three live neighbors becomes a live cell.\n- All other cells die or stay dead.\n\nGiven a matrix of 1s and 0s (corresponding to live and dead cells), apply the rules to each cell, and return the next generation.\n" }, { "path": "exercises/practice/game-of-life/.docs/introduction.md", "content": "# Introduction\n\n[Conway's Game of Life][game-of-life] is a fascinating cellular automaton created by the British mathematician John Horton Conway in 1970.\n\nThe game consists of a two-dimensional grid of cells that can either be \"alive\" or \"dead.\"\n\nAfter each generation, the cells interact with their eight neighbors via a set of rules, which define the new generation.\n\n[game-of-life]: https://en.wikipedia.org/wiki/Conway%27s_Game_of_Life\n" }, { "path": "exercises/practice/game-of-life/.meta/config.json", "content": "{\n \"authors\": [\n \"BNAndras\"\n ],\n \"files\": {\n \"solution\": [\n \"game-of-life.ts\"\n ],\n \"test\": [\n \"game-of-life.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement Conway's Game of Life.\",\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Conway%27s_Game_of_Life\"\n}\n" }, { "path": "exercises/practice/game-of-life/.meta/proof.ci.ts", "content": "export class GameOfLife {\n constructor(private matrix: number[][]) {}\n\n public tick(): void {\n if (this.matrix.length === 0) {\n return\n }\n const rows = this.matrix.length\n const cols = this.matrix[0].length\n\n const newMatrix = JSON.parse(JSON.stringify(this.matrix)) as number[][]\n\n for (let row = 0; row < rows; row++) {\n for (let col = 0; col < cols; col++) {\n let liveNeighbors = 0\n for (let newRow = row - 1; newRow <= row + 1; newRow++) {\n for (let newCol = col - 1; newCol <= col + 1; newCol++) {\n if (newRow === row && newCol === col) {\n continue\n }\n if (newRow >= 0 && newRow < rows && newCol >= 0 && newCol < cols) {\n liveNeighbors += this.matrix[newRow][newCol]\n }\n }\n }\n\n let cell = this.matrix[row][col]\n if (cell === 1) {\n if (liveNeighbors < 2 || liveNeighbors > 3) {\n cell = 0\n }\n } else {\n if (liveNeighbors === 3) {\n cell = 1\n }\n }\n\n newMatrix[row][col] = cell\n }\n }\n\n this.matrix = newMatrix\n }\n\n public state(): number[][] {\n return this.matrix\n }\n}\n" }, { "path": "exercises/practice/game-of-life/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[ae86ea7d-bd07-4357-90b3-ac7d256bd5c5]\ndescription = \"empty matrix\"\n\n[4ea5ccb7-7b73-4281-954a-bed1b0f139a5]\ndescription = \"live cells with zero live neighbors die\"\n\n[df245adc-14ff-4f9c-b2ae-f465ef5321b2]\ndescription = \"live cells with only one live neighbor die\"\n\n[2a713b56-283c-48c8-adae-1d21306c80ae]\ndescription = \"live cells with two live neighbors stay alive\"\n\n[86d5c5a5-ab7b-41a1-8907-c9b3fc5e9dae]\ndescription = \"live cells with three live neighbors stay alive\"\n\n[015f60ac-39d8-4c6c-8328-57f334fc9f89]\ndescription = \"dead cells with three live neighbors become alive\"\n\n[2ee69c00-9d41-4b8b-89da-5832e735ccf1]\ndescription = \"live cells with four or more neighbors die\"\n\n[a79b42be-ed6c-4e27-9206-43da08697ef6]\ndescription = \"bigger matrix\"\n" }, { "path": "exercises/practice/game-of-life/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/game-of-life/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/game-of-life/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/game-of-life/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/game-of-life/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/game-of-life/game-of-life.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { GameOfLife } from './game-of-life.ts'\n\ndescribe('Game of Life', () => {\n // Empty matrix\n it('empty matrix', () => {\n const matrix: number[][] = []\n const game = new GameOfLife(matrix)\n game.tick()\n const expected: number[][] = []\n expect(game.state()).toEqual(expected)\n })\n\n // Live cells with zero live neighbors die\n xit('live cells with zero live neighbors die', () => {\n const matrix = [\n [0, 0, 0],\n [0, 1, 0],\n [0, 0, 0],\n ]\n const game = new GameOfLife(matrix)\n game.tick()\n const expected = [\n [0, 0, 0],\n [0, 0, 0],\n [0, 0, 0],\n ]\n expect(game.state()).toEqual(expected)\n })\n\n // Live cells with only one live neighbor die\n xit('live cells with only one live neighbor die', () => {\n const matrix = [\n [0, 0, 0],\n [0, 1, 0],\n [0, 1, 0],\n ]\n const game = new GameOfLife(matrix)\n game.tick()\n const expected = [\n [0, 0, 0],\n [0, 0, 0],\n [0, 0, 0],\n ]\n expect(game.state()).toEqual(expected)\n })\n\n // Live cells with two live neighbors stay alive\n xit('live cells with two live neighbors stay alive', () => {\n const matrix = [\n [1, 0, 1],\n [1, 0, 1],\n [1, 0, 1],\n ]\n const game = new GameOfLife(matrix)\n game.tick()\n const expected = [\n [0, 0, 0],\n [1, 0, 1],\n [0, 0, 0],\n ]\n expect(game.state()).toEqual(expected)\n })\n\n // Live cells with three live neighbors stay alive\n xit('live cells with three live neighbors stay alive', () => {\n const matrix = [\n [0, 1, 0],\n [1, 0, 0],\n [1, 1, 0],\n ]\n const game = new GameOfLife(matrix)\n game.tick()\n const expected = [\n [0, 0, 0],\n [1, 0, 0],\n [1, 1, 0],\n ]\n expect(game.state()).toEqual(expected)\n })\n\n // Dead cells with three live neighbors become alive\n xit('dead cells with three live neighbors become alive', () => {\n const matrix = [\n [1, 1, 0],\n [0, 0, 0],\n [1, 0, 0],\n ]\n const game = new GameOfLife(matrix)\n game.tick()\n const expected = [\n [0, 0, 0],\n [1, 1, 0],\n [0, 0, 0],\n ]\n expect(game.state()).toEqual(expected)\n })\n\n // Live cells with four or more neighbors die\n xit('live cells with four or more neighbors die', () => {\n const matrix = [\n [1, 1, 1],\n [1, 1, 1],\n [1, 1, 1],\n ]\n const game = new GameOfLife(matrix)\n game.tick()\n const expected = [\n [1, 0, 1],\n [0, 0, 0],\n [1, 0, 1],\n ]\n expect(game.state()).toEqual(expected)\n })\n\n // Bigger matrix\n xit('bigger matrix', () => {\n const matrix = [\n [1, 1, 0, 1, 1, 0, 0, 0],\n [1, 0, 1, 1, 0, 0, 0, 0],\n [1, 1, 1, 0, 0, 1, 1, 1],\n [0, 0, 0, 0, 0, 1, 1, 0],\n [1, 0, 0, 0, 1, 1, 0, 0],\n [1, 1, 0, 0, 0, 1, 1, 1],\n [0, 0, 1, 0, 1, 0, 0, 1],\n [1, 0, 0, 0, 0, 0, 1, 1],\n ]\n const game = new GameOfLife(matrix)\n game.tick()\n const expected = [\n [1, 1, 0, 1, 1, 0, 0, 0],\n [0, 0, 0, 0, 0, 1, 1, 0],\n [1, 0, 1, 1, 1, 1, 0, 1],\n [1, 0, 0, 0, 0, 0, 0, 1],\n [1, 1, 0, 0, 1, 0, 0, 1],\n [1, 1, 0, 1, 0, 0, 0, 1],\n [1, 0, 0, 0, 0, 0, 0, 0],\n [0, 0, 0, 0, 0, 0, 1, 1],\n ]\n expect(game.state()).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/game-of-life/game-of-life.ts", "content": "export class GameOfLife {\n constructor(matrix: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public tick(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public state(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/game-of-life/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/game-of-life/package.json", "content": "{\n \"name\": \"@exercism/typescript-game-of-life\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/game-of-life/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/game-of-life/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/gigasecond/.docs/instructions.md", "content": "# Instructions\n\nYour task is to determine the date and time one gigasecond after a certain date.\n\nA gigasecond is one thousand million seconds.\nThat is a one with nine zeros after it.\n\nIf you were born on _January 24th, 2015 at 22:00 (10:00:00pm)_, then you would be a gigasecond old on _October 2nd, 2046 at 23:46:40 (11:46:40pm)_.\n" }, { "path": "exercises/practice/gigasecond/.docs/introduction.md", "content": "# Introduction\n\nThe way we measure time is kind of messy.\nWe have 60 seconds in a minute, and 60 minutes in an hour.\nThis comes from ancient Babylon, where they used 60 as the basis for their number system.\nWe have 24 hours in a day, 7 days in a week, and how many days in a month?\nWell, for days in a month it depends not only on which month it is, but also on what type of calendar is used in the country you live in.\n\nWhat if, instead, we only use seconds to express time intervals?\nThen we can use metric system prefixes for writing large numbers of seconds in more easily comprehensible quantities.\n\n- A food recipe might explain that you need to let the brownies cook in the oven for two kiloseconds (that's two thousand seconds).\n- Perhaps you and your family would travel to somewhere exotic for two megaseconds (that's two million seconds).\n- And if you and your spouse were married for _a thousand million_ seconds, you would celebrate your one gigasecond anniversary.\n\n~~~~exercism/note\nIf we ever colonize Mars or some other planet, measuring time is going to get even messier.\nIf someone says \"year\" do they mean a year on Earth or a year on Mars?\n\nThe idea for this exercise came from the science fiction novel [\"A Deepness in the Sky\"][vinge-novel] by author Vernor Vinge.\nIn it the author uses the metric system as the basis for time measurements.\n\n[vinge-novel]: https://www.tor.com/2017/08/03/science-fiction-with-something-for-everyone-a-deepness-in-the-sky-by-vernor-vinge/\n~~~~\n" }, { "path": "exercises/practice/gigasecond/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"pranasziaukas\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"gigasecond.ts\"\n ],\n \"test\": [\n \"gigasecond.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a moment, determine the moment that would be after a gigasecond has passed.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Chapter 9 in Chris Pine's online Learn to Program tutorial.\",\n \"source_url\": \"https://pine.fm/LearnToProgram/chap_09.html\"\n}\n" }, { "path": "exercises/practice/gigasecond/.meta/proof.ci.ts", "content": "const gigamilisecond = 10 ** 12\n\nexport class Gigasecond {\n constructor(private readonly currentDate: Readonly) {}\n\n public date(): Date {\n return new Date(this.currentDate.valueOf() + gigamilisecond)\n }\n}\n" }, { "path": "exercises/practice/gigasecond/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[92fbe71c-ea52-4fac-bd77-be38023cacf7]\ndescription = \"date only specification of time\"\n\n[6d86dd16-6f7a-47be-9e58-bb9fb2ae1433]\ndescription = \"second test for date only specification of time\"\n\n[77eb8502-2bca-4d92-89d9-7b39ace28dd5]\ndescription = \"third test for date only specification of time\"\n\n[c9d89a7d-06f8-4e28-a305-64f1b2abc693]\ndescription = \"full time specified\"\n\n[09d4e30e-728a-4b52-9005-be44a58d9eba]\ndescription = \"full time with day roll-over\"\n\n[fcec307c-7529-49ab-b0fe-20309197618a]\ndescription = \"does not mutate the input\"\n" }, { "path": "exercises/practice/gigasecond/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/gigasecond/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/gigasecond/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/gigasecond/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/gigasecond/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/gigasecond/gigasecond.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Gigasecond } from './gigasecond.ts'\n\ndescribe('Gigasecond', () => {\n it('date only specification of time', () => {\n const gs = new Gigasecond(new Date(Date.parse('2011-04-25')))\n const expectedDate = new Date(Date.parse('2043-01-01T01:46:40Z'))\n expect(gs.date()).toEqual(expectedDate)\n })\n\n xit('second test for date only specification of time', () => {\n const gs = new Gigasecond(new Date(Date.parse('1977-06-13')))\n const expectedDate = new Date(Date.parse('2009-02-19T01:46:40Z'))\n expect(gs.date()).toEqual(expectedDate)\n })\n\n xit('third test for date only specification of time', () => {\n const gs = new Gigasecond(new Date(Date.parse('1959-07-19')))\n const expectedDate = new Date(Date.parse('1991-03-27T01:46:40Z'))\n expect(gs.date()).toEqual(expectedDate)\n })\n\n xit('full time specified', () => {\n const gs = new Gigasecond(new Date(Date.parse('2015-01-24T22:00:00Z')))\n const expectedDate = new Date(Date.parse('2046-10-02T23:46:40Z'))\n expect(gs.date()).toEqual(expectedDate)\n })\n\n xit('full time with day roll-over', () => {\n const gs = new Gigasecond(new Date(Date.parse('2015-01-24T23:59:59Z')))\n const expectedDate = new Date(Date.parse('2046-10-03T01:46:39Z'))\n expect(gs.date()).toEqual(expectedDate)\n })\n\n xit('does not mutate the input', () => {\n const gs = new Gigasecond(new Date(Date.parse('2015-01-24T23:59:59Z')))\n const expectedDate = new Date(Date.parse('2046-10-03T01:46:39Z'))\n gs.date()\n expect(gs.date()).toEqual(expectedDate)\n })\n})\n" }, { "path": "exercises/practice/gigasecond/gigasecond.ts", "content": "export class Gigasecond {\n public date(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/gigasecond/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/gigasecond/package.json", "content": "{\n \"name\": \"@exercism/typescript-gigasecond\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/gigasecond/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/gigasecond/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/grade-school/.docs/instructions.md", "content": "# Instructions\n\nGiven students' names along with the grade they are in, create a roster for the school.\n\nIn the end, you should be able to:\n\n- Add a student's name to the roster for a grade:\n - \"Add Jim to grade 2.\"\n - \"OK.\"\n- Get a list of all students enrolled in a grade:\n - \"Which students are in grade 2?\"\n - \"We've only got Jim right now.\"\n- Get a sorted list of all students in all grades.\n Grades should be sorted as 1, 2, 3, etc., and students within a grade should be sorted alphabetically by name.\n - \"Who is enrolled in school right now?\"\n - \"Let me think.\n We have Anna, Barb, and Charlie in grade 1, Alex, Peter, and Zoe in grade 2, and Jim in grade 5.\n So the answer is: Anna, Barb, Charlie, Alex, Peter, Zoe, and Jim.\"\n\nNote that all our students only have one name (it's a small town, what do you want?), and each student cannot be added more than once to a grade or the roster.\nIf a test attempts to add the same student more than once, your implementation should indicate that this is incorrect.\n" }, { "path": "exercises/practice/grade-school/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"pedrorolo\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"grade-school.ts\"\n ],\n \"test\": [\n \"grade-school.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given students' names along with the grade that they are in, create a roster for the school.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A pairing session with Phil Battos at gSchool\"\n}\n" }, { "path": "exercises/practice/grade-school/.meta/proof.ci.ts", "content": "type Student = string\ntype Grade = number\ntype StudentRooster = Record\ntype StudentGrades = Map\nexport class GradeSchool {\n private students: StudentGrades\n\n constructor() {\n this.students = new Map()\n }\n\n public add(student: Student, level: Grade): void {\n this.students.set(student, level)\n }\n\n public grade(level: Grade): Student[] {\n return Array.from(this.students.entries())\n .filter(([, studentGrade]) => studentGrade === level)\n .map(([student]) => student)\n .sort()\n }\n\n public roster(): StudentRooster {\n const result: StudentRooster = {}\n\n Array.from(this.students.entries()).forEach(([, studentGrade]) => {\n if (!result[studentGrade]) {\n result[studentGrade] = this.grade(studentGrade)\n }\n })\n\n return result\n }\n}\n" }, { "path": "exercises/practice/grade-school/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[6d0a30e4-1b4e-472e-8e20-c41702125667]\ndescription = \"Adding a student adds them to the sorted roster\"\n\n[233be705-dd58-4968-889d-fb3c7954c9cc]\ndescription = \"Adding more student adds them to the sorted roster\"\n\n[75a51579-d1d7-407c-a2f8-2166e984e8ab]\ndescription = \"Adding students to different grades adds them to the same sorted roster\"\n\n[a3f0fb58-f240-4723-8ddc-e644666b85cc]\ndescription = \"Roster returns an empty list if there are no students enrolled\"\n\n[180a8ff9-5b94-43fc-9db1-d46b4a8c93b6]\ndescription = \"Student names with grades are displayed in the same sorted roster\"\n\n[1bfbcef1-e4a3-49e8-8d22-f6f9f386187e]\ndescription = \"Grade returns the students in that grade in alphabetical order\"\n\n[5e67aa3c-a3c6-4407-a183-d8fe59cd1630]\ndescription = \"Grade returns an empty list if there are no students in that grade\"\n" }, { "path": "exercises/practice/grade-school/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/grade-school/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/grade-school/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/grade-school/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/grade-school/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/grade-school/grade-school.test.ts", "content": "import { beforeEach, describe, it, expect, xit } from '@jest/globals'\nimport { GradeSchool } from './grade-school.ts'\n\ndescribe('School', () => {\n let school: GradeSchool\n\n beforeEach(() => {\n school = new GradeSchool()\n })\n\n it('a new school has an empty roster', () => {\n expect(school.roster()).toEqual({})\n })\n\n xit('adding a student adds them to the roster for the given grade', () => {\n school.add('Aimee', 2)\n\n const expectedDb = { 2: ['Aimee'] }\n expect(school.roster()).toEqual(expectedDb)\n })\n\n xit('adding more students to the same grade adds them to the roster', () => {\n school.add('Blair', 2)\n school.add('James', 2)\n school.add('Paul', 2)\n\n const expectedDb = { 2: ['Blair', 'James', 'Paul'] }\n expect(school.roster()).toEqual(expectedDb)\n })\n\n xit('adding students to different grades adds them to the roster', () => {\n school.add('Chelsea', 3)\n school.add('Logan', 7)\n\n const expectedDb = { 3: ['Chelsea'], 7: ['Logan'] }\n expect(school.roster()).toEqual(expectedDb)\n })\n\n xit('grade returns the students in that grade in alphabetical order', () => {\n school.add('Franklin', 5)\n school.add('Bradley', 5)\n school.add('Jeff', 1)\n\n const expectedStudents = ['Bradley', 'Franklin']\n expect(school.grade(5)).toEqual(expectedStudents)\n })\n\n xit('grade returns an empty array if there are no students in that grade', () => {\n expect(school.grade(1)).toEqual([])\n })\n\n xit('the students names in each grade in the roster are sorted', () => {\n school.add('Jennifer', 4)\n school.add('Kareem', 6)\n school.add('Christopher', 4)\n school.add('Kyle', 3)\n\n const expectedSortedStudents = {\n 3: ['Kyle'],\n 4: ['Christopher', 'Jennifer'],\n 6: ['Kareem'],\n }\n expect(school.roster()).toEqual(expectedSortedStudents)\n })\n\n xit('roster cannot be modified outside of module', () => {\n school.add('Aimee', 2)\n const roster = school.roster()\n try {\n roster[2].push('Oops.')\n } catch {\n /* empty */\n }\n const expectedDb = { 2: ['Aimee'] }\n expect(school.roster()).toEqual(expectedDb)\n })\n\n xit('roster cannot be modified outside of module using grade()', () => {\n school.add('Aimee', 2)\n try {\n school.grade(2).push('Oops.')\n } catch {\n /* empty */\n }\n const expectedDb = { 2: ['Aimee'] }\n expect(school.roster()).toEqual(expectedDb)\n })\n\n xit(\"a student can't be in two different grades\", () => {\n school.add('Aimee', 2)\n school.add('Aimee', 1)\n\n expect(school.grade(2)).toEqual([])\n })\n})\n" }, { "path": "exercises/practice/grade-school/grade-school.ts", "content": "export class GradeSchool {\n roster() {\n throw new Error('Remove this line and implement the function')\n }\n\n add() {\n throw new Error('Remove this line and implement the function')\n }\n\n grade() {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/grade-school/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/grade-school/package.json", "content": "{\n \"name\": \"@exercism/typescript-grade-school\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/grade-school/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/grade-school/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/grains/.docs/instructions.md", "content": "# Instructions\n\nCalculate the number of grains of wheat on a chessboard.\n\nA chessboard has 64 squares.\nSquare 1 has one grain, square 2 has two grains, square 3 has four grains, and so on, doubling each time.\n\nWrite code that calculates:\n\n- the number of grains on a given square\n- the total number of grains on the chessboard\n" }, { "path": "exercises/practice/grains/.docs/introduction.md", "content": "# Introduction\n\nThere once was a wise servant who saved the life of a prince.\nThe king promised to pay whatever the servant could dream up.\nKnowing that the king loved chess, the servant told the king he would like to have grains of wheat.\nOne grain on the first square of a chessboard, with the number of grains doubling on each successive square.\n" }, { "path": "exercises/practice/grains/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"G-Rath\",\n \"masters3d\",\n \"SleeplessByte\",\n \"JoshiRaez\"\n ],\n \"files\": {\n \"solution\": [\n \"grains.ts\"\n ],\n \"test\": [\n \"grains.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Calculate the number of grains of wheat on a chessboard given that the number on each square doubles.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"The CodeRanch Cattle Drive, Assignment 6\",\n \"source_url\": \"https://web.archive.org/web/20240908084142/https://coderanch.com/wiki/718824/Grains\"\n}\n" }, { "path": "exercises/practice/grains/.meta/proof.ci.ts", "content": "export function square(n: number): bigint {\n if (n <= 0 || n >= 65) {\n throw new Error()\n }\n\n return 2n ** BigInt(n - 1)\n}\n\nexport function total(): bigint {\n let result = 0n\n\n for (let i = 1; i <= 64; i++) {\n result += square(i)\n }\n\n return result\n}\n" }, { "path": "exercises/practice/grains/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[9fbde8de-36b2-49de-baf2-cd42d6f28405]\ndescription = \"1\"\n\n[ee1f30c2-01d8-4298-b25d-c677331b5e6d]\ndescription = \"2\"\n\n[10f45584-2fc3-4875-8ec6-666065d1163b]\ndescription = \"3\"\n\n[a7cbe01b-36f4-4601-b053-c5f6ae055170]\ndescription = \"4\"\n\n[c50acc89-8535-44e4-918f-b848ad2817d4]\ndescription = \"16\"\n\n[acd81b46-c2ad-4951-b848-80d15ed5a04f]\ndescription = \"32\"\n\n[c73b470a-5efb-4d53-9ac6-c5f6487f227b]\ndescription = \"64\"\n\n[1d47d832-3e85-4974-9466-5bd35af484e3]\ndescription = \"square 0 raises an exception\"\n\n[61974483-eeb2-465e-be54-ca5dde366453]\ndescription = \"negative square raises an exception\"\n\n[a95e4374-f32c-45a7-a10d-ffec475c012f]\ndescription = \"square greater than 64 raises an exception\"\n\n[6eb07385-3659-4b45-a6be-9dc474222750]\ndescription = \"returns the total number of grains on the board\"\n" }, { "path": "exercises/practice/grains/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/grains/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/grains/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/grains/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/grains/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/grains/grains.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { square, total } from './grains.ts'\n\ndescribe('returns the number of grains on the square', () => {\n it('1', () => {\n const expected = 1n\n expect(square(1)).toEqual(expected)\n })\n\n xit('2', () => {\n const expected = 2n\n expect(square(2)).toEqual(expected)\n })\n\n xit('3', () => {\n const expected = 4n\n expect(square(3)).toEqual(expected)\n })\n\n xit('4', () => {\n const expected = 8n\n expect(square(4)).toEqual(expected)\n })\n\n xit('16', () => {\n const expected = 32768n\n expect(square(16)).toEqual(expected)\n })\n\n xit('32', () => {\n const expected = 2147483648n\n expect(square(32)).toEqual(expected)\n })\n\n xit('64', () => {\n const expected = 9223372036854775808n\n expect(square(64)).toEqual(expected)\n })\n\n xit('square 0 raises an exception', () => {\n expect(() => square(0)).toThrow()\n })\n\n xit('negative square raises an exception', () => {\n expect(() => square(-1)).toThrow()\n })\n\n xit('square greater than 64 raises an exception', () => {\n expect(() => square(65)).toThrow()\n })\n})\n\nxdescribe('returns the total number of grains on the board', () => {\n xit('total', () => {\n const expected = 18446744073709551615n\n expect(total()).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/grains/grains.ts", "content": "export const square = () => {\n throw new Error('Remove this line and implement the function')\n}\n\nexport const total = () => {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/grains/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/grains/package.json", "content": "{\n \"name\": \"@exercism/typescript-grains\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/grains/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/grains/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/hamming/.docs/instructions.md", "content": "# Instructions\n\nCalculate the Hamming distance between two DNA strands.\n\nWe read DNA using the letters C, A, G and T.\nTwo strands might look like this:\n\n GAGCCTACTAACGGGAT\n CATCGTAATGACGGCCT\n ^ ^ ^ ^ ^ ^^\n\nThey have 7 differences, and therefore the Hamming distance is 7.\n\n## Implementation notes\n\nThe Hamming distance is only defined for sequences of equal length, so an attempt to calculate it between sequences of different lengths should not work.\n" }, { "path": "exercises/practice/hamming/.docs/introduction.md", "content": "# Introduction\n\nYour body is made up of cells that contain DNA.\nThose cells regularly wear out and need replacing, which they achieve by dividing into daughter cells.\nIn fact, the average human body experiences about 10 quadrillion cell divisions in a lifetime!\n\nWhen cells divide, their DNA replicates too.\nSometimes during this process mistakes happen and single pieces of DNA get encoded with the incorrect information.\nIf we compare two strands of DNA and count the differences between them, we can see how many mistakes occurred.\nThis is known as the \"Hamming distance\".\n\nThe Hamming distance is useful in many areas of science, not just biology, so it's a nice phrase to be familiar with :)\n" }, { "path": "exercises/practice/hamming/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"hamming.ts\"\n ],\n \"test\": [\n \"hamming.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Calculate the Hamming distance between two DNA strands.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"The Calculating Point Mutations problem at Rosalind\",\n \"source_url\": \"https://rosalind.info/problems/hamm/\"\n}\n" }, { "path": "exercises/practice/hamming/.meta/proof.ci.ts", "content": "export function compute(left: string, right: string): number {\n if (left.length !== right.length) {\n throw new Error('DNA strands must be of equal length.')\n }\n const size = left.length\n const leftArray = left.split('')\n const rightArray = right.split('')\n let count = 0\n for (let i = 0; i < size; i += 1) {\n if (leftArray[i] !== rightArray[i]) {\n count += 1\n }\n }\n return count\n}\n" }, { "path": "exercises/practice/hamming/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[f6dcb64f-03b0-4b60-81b1-3c9dbf47e887]\ndescription = \"empty strands\"\n\n[54681314-eee2-439a-9db0-b0636c656156]\ndescription = \"single letter identical strands\"\n\n[294479a3-a4c8-478f-8d63-6209815a827b]\ndescription = \"single letter different strands\"\n\n[9aed5f34-5693-4344-9b31-40c692fb5592]\ndescription = \"long identical strands\"\n\n[cd2273a5-c576-46c8-a52b-dee251c3e6e5]\ndescription = \"long different strands\"\n\n[919f8ef0-b767-4d1b-8516-6379d07fcb28]\ndescription = \"disallow first strand longer\"\ninclude = false\n\n[b9228bb1-465f-4141-b40f-1f99812de5a8]\ndescription = \"disallow first strand longer\"\nreimplements = \"919f8ef0-b767-4d1b-8516-6379d07fcb28\"\n\n[8a2d4ed0-ead5-4fdd-924d-27c4cf56e60e]\ndescription = \"disallow second strand longer\"\ninclude = false\n\n[dab38838-26bb-4fff-acbe-3b0a9bfeba2d]\ndescription = \"disallow second strand longer\"\nreimplements = \"8a2d4ed0-ead5-4fdd-924d-27c4cf56e60e\"\n\n[5dce058b-28d4-4ca7-aa64-adfe4e17784c]\ndescription = \"disallow left empty strand\"\ninclude = false\n\n[db92e77e-7c72-499d-8fe6-9354d2bfd504]\ndescription = \"disallow left empty strand\"\ninclude = false\nreimplements = \"5dce058b-28d4-4ca7-aa64-adfe4e17784c\"\n\n[b764d47c-83ff-4de2-ab10-6cfe4b15c0f3]\ndescription = \"disallow empty first strand\"\nreimplements = \"db92e77e-7c72-499d-8fe6-9354d2bfd504\"\n\n[38826d4b-16fb-4639-ac3e-ba027dec8b5f]\ndescription = \"disallow right empty strand\"\ninclude = false\n\n[920cd6e3-18f4-4143-b6b8-74270bb8f8a3]\ndescription = \"disallow right empty strand\"\ninclude = false\nreimplements = \"38826d4b-16fb-4639-ac3e-ba027dec8b5f\"\n\n[9ab9262f-3521-4191-81f5-0ed184a5aa89]\ndescription = \"disallow empty second strand\"\nreimplements = \"920cd6e3-18f4-4143-b6b8-74270bb8f8a3\"\n" }, { "path": "exercises/practice/hamming/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/hamming/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/hamming/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/hamming/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/hamming/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/hamming/hamming.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { compute } from './hamming.ts'\n\ndescribe('Hamming', () => {\n it('empty strands', () => {\n expect(compute('', '')).toEqual(0)\n })\n\n xit('single letter identical strands', () => {\n expect(compute('A', 'A')).toEqual(0)\n })\n\n xit('single letter different strands', () => {\n expect(compute('G', 'T')).toEqual(1)\n })\n\n xit('long identical strands', () => {\n expect(compute('GGACTGAAATCTG', 'GGACTGAAATCTG')).toEqual(0)\n })\n\n xit('long different strands', () => {\n expect(compute('GGACGGATTCTG', 'AGGACGGATTCT')).toEqual(9)\n })\n\n xit('disallow first strand longer', () => {\n expect(() => {\n compute('AATG', 'AAA')\n }).toThrow('DNA strands must be of equal length.')\n })\n\n xit('disallow second strand longer', () => {\n expect(() => {\n compute('ATA', 'AGTG')\n }).toThrow('DNA strands must be of equal length.')\n })\n\n xit('disallow empty first strand', () => {\n expect(() => {\n compute('', 'G')\n }).toThrow('DNA strands must be of equal length.')\n })\n\n xit('disallow empty second strand', () => {\n expect(() => {\n compute('G', '')\n }).toThrow('DNA strands must be of equal length.')\n })\n})\n" }, { "path": "exercises/practice/hamming/hamming.ts", "content": "export function compute(left: unknown, right: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/hamming/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/hamming/package.json", "content": "{\n \"name\": \"@exercism/typescript-hamming\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/hamming/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/hamming/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/hello-world/.docs/instructions.append.md", "content": "# Instructions append\n\n## Setup\n\nGo through the setup instructions for TypeScript to\ninstall the necessary dependencies:\n\n[https://exercism.org/docs/tracks/typescript/installation](https://exercism.org/docs/tracks/typescript/installation)\n\n## Requirements\n\nInstall assignment dependencies:\n\n```bash\n$ yarn install\n```\n\n## Making the test suite pass\n\nExecute the tests with:\n\n```bash\n$ yarn test\n```\n\nIn many test suites all but the first test have been skipped.\n\nOnce you get a test passing, you can unskip the next one by\nchanging `xit` to `it`.\n\n## Tutorial\n\nThis section is a step-by-step guide to solving this exercise.\n\nThis exercise has two files:\n\n- hello-world.ts\n- hello-world.test.ts\n\nThe first file is where you will write your code.\nThe second is where the tests are defined.\n\nThe tests will check whether your code is doing the right thing.\nYou don't need to be able to write a test suite from scratch,\nbut it helps to understand what a test looks like, and what\nit is doing.\n\nOpen up the test file, hello-world.test.ts.\nThere is a single test inside:\n\n```typescript\nit('says hello world', () => {\n expect(hello()).toEqual('Hello, World!')\n})\n```\n\nRun the test now, with the following command on the command-line:\n\n```bash\n$ yarn test\n```\n\nThe test fails, which makes sense since you've not written any code yet.\n\nThe failure looks like this:\n\n```\n Ɨ says hello world (5ms)\n\n ā— Hello World ā€ŗ says hello world\n\n expect(received).toEqual(expected) // deep equality\n\n Expected: \"Hello, World!\"\n Received: \"Goodbye, Mars!\"\n\n 4 |\n 5 | it('says hello world', () => {\n > 6 | expect(hello()).toEqual('Hello, World!')\n | ^\n 7 | })\n 8 |\n 9 | })\n\n at Object.it (hello-world.test.ts:6:32)\n```\n\nAnd these are those code lines with probable defects in the `hello-world.test.ts` file:\n\nthe 6th line:\n\n```typescript\n expect(hello()).toEqual('Hello, World!')\n ^\n```\n\nHence the problem is with the `hello()` function call.\nWe can see that the test is expecting `'Hello, World!'` as output, but instead is getting `\"Goodbye, Mars!\"`.\n\nSo let's check now this function in the `hello-worlds.ts` file:\n\n```typescript\nexport function hello(): string {\n return 'Goodbye, Mars!'\n}\n```\n\nNow we see that the function returns the incorrect string, which is the reason for our failure. Let's fix this by changing the returned value:\n\n```typescript\nexport function hello(): string {\n return 'Hello, World!'\n}\n```\n\nRun the test again:\n\n```bash\n PASS ./hello-world.test.ts\n Hello World\n āˆš says hello world (4ms)\n```\n\nAnd it passes!\n" }, { "path": "exercises/practice/hello-world/.docs/instructions.md", "content": "# Instructions\n\nThe classical introductory exercise.\nJust say \"Hello, World!\".\n\n[\"Hello, World!\"][hello-world] is the traditional first program for beginning programming in a new language or environment.\n\nThe objectives are simple:\n\n- Modify the provided code so that it produces the string \"Hello, World!\".\n- Run the test suite and make sure that it succeeds.\n- Submit your solution and check it at the website.\n\nIf everything goes well, you will be ready to fetch your first real exercise.\n\n[hello-world]: https://en.wikipedia.org/wiki/%22Hello,_world!%22_program\n" }, { "path": "exercises/practice/hello-world/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"DFXLuna\",\n \"iHiD\",\n \"kytrinyx\",\n \"lukaszklis\",\n \"porkostomus\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"hello-world.ts\"\n ],\n \"test\": [\n \"hello-world.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Exercism's classic introductory exercise. Just say \\\"Hello, World!\\\".\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"This is an exercise to introduce users to using Exercism\",\n \"source_url\": \"https://en.wikipedia.org/wiki/%22Hello,_world!%22_program\"\n}\n" }, { "path": "exercises/practice/hello-world/.meta/proof.ci.ts", "content": "export function hello(): string {\n return 'Hello, World!'\n}\n" }, { "path": "exercises/practice/hello-world/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[af9ffe10-dc13-42d8-a742-e7bdafac449d]\ndescription = \"Say Hi!\"\n" }, { "path": "exercises/practice/hello-world/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/hello-world/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/hello-world/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/hello-world/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/hello-world/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/hello-world/hello-world.test.ts", "content": "import { describe, it, expect } from '@jest/globals'\nimport { hello } from './hello-world.ts'\n\ndescribe('Hello World', () => {\n it('says hello world', () => {\n expect(hello()).toEqual('Hello, World!')\n })\n})\n" }, { "path": "exercises/practice/hello-world/hello-world.ts", "content": "export function hello(): string {\n return 'Goodbye, Mars!'\n}\n" }, { "path": "exercises/practice/hello-world/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/hello-world/package.json", "content": "{\n \"name\": \"@exercism/typescript-hello-world\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/hello-world/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/hello-world/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/house/.docs/instructions.md", "content": "# Instructions\n\nRecite the nursery rhyme 'This is the House that Jack Built'.\n\n> [The] process of placing a phrase of clause within another phrase of clause is called embedding.\n> It is through the processes of recursion and embedding that we are able to take a finite number of forms (words and phrases) and construct an infinite number of expressions.\n> Furthermore, embedding also allows us to construct an infinitely long structure, in theory anyway.\n\n- [papyr.com][papyr]\n\nThe nursery rhyme reads as follows:\n\n```text\nThis is the house that Jack built.\n\nThis is the malt\nthat lay in the house that Jack built.\n\nThis is the rat\nthat ate the malt\nthat lay in the house that Jack built.\n\nThis is the cat\nthat killed the rat\nthat ate the malt\nthat lay in the house that Jack built.\n\nThis is the dog\nthat worried the cat\nthat killed the rat\nthat ate the malt\nthat lay in the house that Jack built.\n\nThis is the cow with the crumpled horn\nthat tossed the dog\nthat worried the cat\nthat killed the rat\nthat ate the malt\nthat lay in the house that Jack built.\n\nThis is the maiden all forlorn\nthat milked the cow with the crumpled horn\nthat tossed the dog\nthat worried the cat\nthat killed the rat\nthat ate the malt\nthat lay in the house that Jack built.\n\nThis is the man all tattered and torn\nthat kissed the maiden all forlorn\nthat milked the cow with the crumpled horn\nthat tossed the dog\nthat worried the cat\nthat killed the rat\nthat ate the malt\nthat lay in the house that Jack built.\n\nThis is the priest all shaven and shorn\nthat married the man all tattered and torn\nthat kissed the maiden all forlorn\nthat milked the cow with the crumpled horn\nthat tossed the dog\nthat worried the cat\nthat killed the rat\nthat ate the malt\nthat lay in the house that Jack built.\n\nThis is the rooster that crowed in the morn\nthat woke the priest all shaven and shorn\nthat married the man all tattered and torn\nthat kissed the maiden all forlorn\nthat milked the cow with the crumpled horn\nthat tossed the dog\nthat worried the cat\nthat killed the rat\nthat ate the malt\nthat lay in the house that Jack built.\n\nThis is the farmer sowing his corn\nthat kept the rooster that crowed in the morn\nthat woke the priest all shaven and shorn\nthat married the man all tattered and torn\nthat kissed the maiden all forlorn\nthat milked the cow with the crumpled horn\nthat tossed the dog\nthat worried the cat\nthat killed the rat\nthat ate the malt\nthat lay in the house that Jack built.\n\nThis is the horse and the hound and the horn\nthat belonged to the farmer sowing his corn\nthat kept the rooster that crowed in the morn\nthat woke the priest all shaven and shorn\nthat married the man all tattered and torn\nthat kissed the maiden all forlorn\nthat milked the cow with the crumpled horn\nthat tossed the dog\nthat worried the cat\nthat killed the rat\nthat ate the malt\nthat lay in the house that Jack built.\n```\n\n[papyr]: https://papyr.com/hypertextbooks/grammar/ph_noun.htm\n" }, { "path": "exercises/practice/house/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"house.ts\"\n ],\n \"test\": [\n \"house.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Output the nursery rhyme 'This is the House that Jack Built'.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"British nursery rhyme\",\n \"source_url\": \"https://en.wikipedia.org/wiki/This_Is_The_House_That_Jack_Built\"\n}\n" }, { "path": "exercises/practice/house/.meta/proof.ci.ts", "content": "const OBJECTS = [\n 'house',\n 'malt',\n 'rat',\n 'cat',\n 'dog',\n 'cow with the crumpled horn',\n 'maiden all forlorn',\n 'man all tattered and torn',\n 'priest all shaven and shorn',\n 'rooster that crowed in the morn',\n 'farmer sowing his corn',\n 'horse and the hound and the horn',\n] as const\n\nconst ACTIONS = [\n 'Jack built',\n 'lay in',\n 'ate',\n 'killed',\n 'worried',\n 'tossed',\n 'milked',\n 'kissed',\n 'married',\n 'woke',\n 'kept',\n 'belonged to',\n] as const\n\nexport function verse(verseNumber: number): string[] {\n const lines = []\n const totalLines = verseNumber\n let itemIndex = verseNumber - 1\n for (let lineNumber = 1; lineNumber <= totalLines; lineNumber += 1) {\n let lineText = ''\n if (lineNumber === 1) {\n lineText += 'This is'\n } else {\n lineText += `that ${ACTIONS[itemIndex]}`\n itemIndex -= 1\n }\n\n lineText += ` the ${OBJECTS[itemIndex]}`\n if (lineNumber === totalLines) {\n lineText += ` that ${ACTIONS[itemIndex]}.`\n }\n lines.push(lineText)\n }\n\n return lines\n}\n\nexport function verses(start: number, end: number): string[] {\n let lines: string[] = []\n for (let i = start; i <= end; i += 1) {\n const verseLines = verse(i)\n lines = lines.concat(verseLines)\n if (i < end) {\n lines.push('')\n }\n }\n return lines\n}\n" }, { "path": "exercises/practice/house/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[28a540ff-f765-4348-9d57-ae33f25f41f2]\ndescription = \"verse one - the house that jack built\"\n\n[ebc825ac-6e2b-4a5e-9afd-95732191c8da]\ndescription = \"verse two - the malt that lay\"\n\n[1ed8bb0f-edb8-4bd1-b6d4-b64754fe4a60]\ndescription = \"verse three - the rat that ate\"\n\n[64b0954e-8b7d-4d14-aad0-d3f6ce297a30]\ndescription = \"verse four - the cat that killed\"\n\n[1e8d56bc-fe31-424d-9084-61e6111d2c82]\ndescription = \"verse five - the dog that worried\"\n\n[6312dc6f-ab0a-40c9-8a55-8d4e582beac4]\ndescription = \"verse six - the cow with the crumpled horn\"\n\n[68f76d18-6e19-4692-819c-5ff6a7f92feb]\ndescription = \"verse seven - the maiden all forlorn\"\n\n[73872564-2004-4071-b51d-2e4326096747]\ndescription = \"verse eight - the man all tattered and torn\"\n\n[0d53d743-66cb-4351-a173-82702f3338c9]\ndescription = \"verse nine - the priest all shaven and shorn\"\n\n[452f24dc-8fd7-4a82-be1a-3b4839cfeb41]\ndescription = \"verse 10 - the rooster that crowed in the morn\"\n\n[97176f20-2dd3-4646-ac72-cffced91ea26]\ndescription = \"verse 11 - the farmer sowing his corn\"\n\n[09824c29-6aad-4dcd-ac98-f61374a6a8b7]\ndescription = \"verse 12 - the horse and the hound and the horn\"\n\n[d2b980d3-7851-49e1-97ab-1524515ec200]\ndescription = \"multiple verses\"\n\n[0311d1d0-e085-4f23-8ae7-92406fb3e803]\ndescription = \"full rhyme\"\n" }, { "path": "exercises/practice/house/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/house/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/house/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/house/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/house/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/house/house.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { verse, verses } from './house.ts'\n\ndescribe('House', () => {\n it('verse one - the house that jack built', () => {\n const lyrics = ['This is the house that Jack built.']\n expect(verse(1)).toEqual(lyrics)\n })\n\n xit('verse two - the malt that lay', () => {\n const lyrics = [\n 'This is the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(2)).toEqual(lyrics)\n })\n\n xit('verse three - the rat that ate', () => {\n const lyrics = [\n 'This is the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(3)).toEqual(lyrics)\n })\n\n xit('verse four - the cat that killed', () => {\n const lyrics = [\n 'This is the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(4)).toEqual(lyrics)\n })\n\n xit('verse five - the dog that worried', () => {\n const lyrics = [\n 'This is the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(5)).toEqual(lyrics)\n })\n\n xit('verse six - the cow with the crumpled horn', () => {\n const lyrics = [\n 'This is the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(6)).toEqual(lyrics)\n })\n\n xit('verse seven - the maiden all forlorn', () => {\n const lyrics = [\n 'This is the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(7)).toEqual(lyrics)\n })\n\n xit('verse eight - the man all tattered and torn', () => {\n const lyrics = [\n 'This is the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(8)).toEqual(lyrics)\n })\n\n xit('verse nine - the priest all shaven and shorn', () => {\n const lyrics = [\n 'This is the priest all shaven and shorn',\n 'that married the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(9)).toEqual(lyrics)\n })\n\n xit('verse ten - the rooster that crowed in the morn', () => {\n const lyrics = [\n 'This is the rooster that crowed in the morn',\n 'that woke the priest all shaven and shorn',\n 'that married the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(10)).toEqual(lyrics)\n })\n\n xit('verse eleven - the farmer sowing his corn', () => {\n const lyrics = [\n 'This is the farmer sowing his corn',\n 'that kept the rooster that crowed in the morn',\n 'that woke the priest all shaven and shorn',\n 'that married the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(11)).toEqual(lyrics)\n })\n\n xit('verse twelve - the horse and the hound and the horn', () => {\n const lyrics = [\n 'This is the horse and the hound and the horn',\n 'that belonged to the farmer sowing his corn',\n 'that kept the rooster that crowed in the morn',\n 'that woke the priest all shaven and shorn',\n 'that married the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verse(12)).toEqual(lyrics)\n })\n\n xit('multiple verses', () => {\n const startVerse = 4\n const endVerse = 8\n const lyrics = [\n 'This is the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verses(startVerse, endVerse)).toEqual(lyrics)\n })\n\n xit('full rhyme', () => {\n const startVerse = 1\n const endVerse = 12\n const lyrics = [\n 'This is the house that Jack built.',\n '',\n 'This is the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the priest all shaven and shorn',\n 'that married the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the rooster that crowed in the morn',\n 'that woke the priest all shaven and shorn',\n 'that married the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the farmer sowing his corn',\n 'that kept the rooster that crowed in the morn',\n 'that woke the priest all shaven and shorn',\n 'that married the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n '',\n 'This is the horse and the hound and the horn',\n 'that belonged to the farmer sowing his corn',\n 'that kept the rooster that crowed in the morn',\n 'that woke the priest all shaven and shorn',\n 'that married the man all tattered and torn',\n 'that kissed the maiden all forlorn',\n 'that milked the cow with the crumpled horn',\n 'that tossed the dog',\n 'that worried the cat',\n 'that killed the rat',\n 'that ate the malt',\n 'that lay in the house that Jack built.',\n ]\n expect(verses(startVerse, endVerse)).toEqual(lyrics)\n })\n})\n" }, { "path": "exercises/practice/house/house.ts", "content": "export function verse(/* parameters go here */): unknown {\n throw new Error('Remove this line and implement the function')\n}\n\nexport function verses(/* parameters go here */): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/house/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/house/package.json", "content": "{\n \"name\": \"@exercism/typescript-house\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/house/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/house/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/isbn-verifier/.docs/instructions.md", "content": "# Instructions\n\nThe [ISBN-10 verification process][isbn-verification] is used to validate book identification numbers.\nThese normally contain dashes and look like: `3-598-21508-8`\n\n## ISBN\n\nThe ISBN-10 format is 9 digits (0 to 9) plus one check character (either a digit or an X only).\nIn the case the check character is an X, this represents the value '10'.\nThese may be communicated with or without hyphens, and can be checked for their validity by the following formula:\n\n```text\n(dā‚ * 10 + dā‚‚ * 9 + dā‚ƒ * 8 + dā‚„ * 7 + dā‚… * 6 + dā‚† * 5 + dā‚‡ * 4 + dā‚ˆ * 3 + dā‚‰ * 2 + dā‚ā‚€ * 1) mod 11 == 0\n```\n\nIf the result is 0, then it is a valid ISBN-10, otherwise it is invalid.\n\n## Example\n\nLet's take the ISBN-10 `3-598-21508-8`.\nWe plug it in to the formula, and get:\n\n```text\n(3 * 10 + 5 * 9 + 9 * 8 + 8 * 7 + 2 * 6 + 1 * 5 + 5 * 4 + 0 * 3 + 8 * 2 + 8 * 1) mod 11 == 0\n```\n\nSince the result is 0, this proves that our ISBN is valid.\n\n## Task\n\nGiven a string the program should check if the provided string is a valid ISBN-10.\nPutting this into place requires some thinking about preprocessing/parsing of the string prior to calculating the check digit for the ISBN.\n\nThe program should be able to verify ISBN-10 both with and without separating dashes.\n\n## Caveats\n\nConverting from strings to numbers can be tricky in certain languages.\nNow, it's even trickier since the check digit of an ISBN-10 may be 'X' (representing '10').\nFor instance `3-598-21507-X` is a valid ISBN-10.\n\n[isbn-verification]: https://en.wikipedia.org/wiki/International_Standard_Book_Number\n" }, { "path": "exercises/practice/isbn-verifier/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"isbn-verifier.ts\"\n ],\n \"test\": [\n \"isbn-verifier.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Check if a given string is a valid ISBN-10 number.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Converting a string into a number and some basic processing utilizing a relatable real world example.\",\n \"source_url\": \"https://en.wikipedia.org/wiki/International_Standard_Book_Number#ISBN-10_check_digit_calculation\"\n}\n" }, { "path": "exercises/practice/isbn-verifier/.meta/proof.ci.ts", "content": "export function isValid(input: string): boolean {\n const isbn = input.replace(/-/g, '')\n if (!isbn.match(/^(\\d{9}[\\dxX])$/)) {\n return false\n }\n\n const digits = [...isbn]\n if (digits[9].match(/[xX]/)) {\n digits[9] = '10'\n }\n\n const sum = digits.reduce(\n (acc, value, index) => acc + (10 - index) * parseInt(value, 10),\n 0\n )\n\n return sum % 11 === 0\n}\n" }, { "path": "exercises/practice/isbn-verifier/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[0caa3eac-d2e3-4c29-8df8-b188bc8c9292]\ndescription = \"valid isbn\"\n\n[19f76b53-7c24-45f8-87b8-4604d0ccd248]\ndescription = \"invalid isbn check digit\"\n\n[4164bfee-fb0a-4a1c-9f70-64c6a1903dcd]\ndescription = \"valid isbn with a check digit of 10\"\n\n[3ed50db1-8982-4423-a993-93174a20825c]\ndescription = \"check digit is a character other than X\"\n\n[9416f4a5-fe01-4b61-a07b-eb75892ef562]\ndescription = \"invalid check digit in isbn is not treated as zero\"\n\n[c19ba0c4-014f-4dc3-a63f-ff9aefc9b5ec]\ndescription = \"invalid character in isbn is not treated as zero\"\n\n[28025280-2c39-4092-9719-f3234b89c627]\ndescription = \"X is only valid as a check digit\"\n\n[8005b57f-f194-44ee-88d2-a77ac4142591]\ndescription = \"only one check digit is allowed\"\n\n[fdb14c99-4cf8-43c5-b06d-eb1638eff343]\ndescription = \"X is not substituted by the value 10\"\n\n[f6294e61-7e79-46b3-977b-f48789a4945b]\ndescription = \"valid isbn without separating dashes\"\n\n[185ab99b-3a1b-45f3-aeec-b80d80b07f0b]\ndescription = \"isbn without separating dashes and X as check digit\"\n\n[7725a837-ec8e-4528-a92a-d981dd8cf3e2]\ndescription = \"isbn without check digit and dashes\"\n\n[47e4dfba-9c20-46ed-9958-4d3190630bdf]\ndescription = \"too long isbn and no dashes\"\n\n[737f4e91-cbba-4175-95bf-ae630b41fb60]\ndescription = \"too short isbn\"\n\n[5458a128-a9b6-4ff8-8afb-674e74567cef]\ndescription = \"isbn without check digit\"\n\n[70b6ad83-d0a2-4ca7-a4d5-a9ab731800f7]\ndescription = \"check digit of X should not be used for 0\"\n\n[94610459-55ab-4c35-9b93-ff6ea1a8e562]\ndescription = \"empty isbn\"\n\n[7bff28d4-d770-48cc-80d6-b20b3a0fb46c]\ndescription = \"input is 9 characters\"\n\n[ed6e8d1b-382c-4081-8326-8b772c581fec]\ndescription = \"invalid characters are not ignored after checking length\"\n\n[daad3e58-ce00-4395-8a8e-e3eded1cdc86]\ndescription = \"invalid characters are not ignored before checking length\"\n\n[fb5e48d8-7c03-4bfb-a088-b101df16fdc3]\ndescription = \"input is too long but contains a valid isbn\"\n" }, { "path": "exercises/practice/isbn-verifier/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/isbn-verifier/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/isbn-verifier/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/isbn-verifier/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/isbn-verifier/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/isbn-verifier/isbn-verifier.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { isValid } from './isbn-verifier.ts'\n\ndescribe('ISBN Verifier', () => {\n it('valid isbn', () => {\n expect(isValid('3-598-21508-8')).toBeTruthy()\n })\n\n xit('invalid isbn check digit', () => {\n expect(isValid('3-598-21508-9')).toBeFalsy()\n })\n\n xit('valid isbn with a check digit of 10', () => {\n expect(isValid('3-598-21507-X')).toBeTruthy()\n })\n\n xit('check digit is a character other than X', () => {\n expect(isValid('3-598-21507-A')).toBeFalsy()\n })\n\n xit('invalid check digit in isbn is not treated as zero', () => {\n expect(isValid('4-598-21507-B')).toBeFalsy()\n })\n\n xit('invalid character in isbn is not treated as zero', () => {\n expect(isValid('3-598-2K507-0')).toBeFalsy()\n })\n\n xit('X is only valid as a check digit', () => {\n expect(isValid('3-598-2X507-9')).toBeFalsy()\n })\n\n xit('only one check digit is allowed', () => {\n expect(isValid('3-598-21508-96')).toBeFalsy()\n })\n\n xit('X is not substituted by the value 10', () => {\n expect(isValid('3-598-2X507-5')).toBeFalsy()\n })\n\n xit('valid isbn without separating dashes', () => {\n expect(isValid('3598215088')).toBeTruthy()\n })\n\n xit('isbn without separating dashes and X as check digit', () => {\n expect(isValid('359821507X')).toBeTruthy()\n })\n\n xit('isbn without check digit and dashes', () => {\n expect(isValid('359821507')).toBeFalsy()\n })\n\n xit('too long isbn', () => {\n expect(isValid('3-598-21507-XX')).toBeFalsy()\n })\n\n xit('too long isbn and no dashes', () => {\n expect(isValid('3598215078X')).toBeFalsy()\n })\n\n xit('too short isbn', () => {\n expect(isValid('00')).toBeFalsy()\n })\n\n xit('isbn without check digit', () => {\n expect(isValid('3-598-21507')).toBeFalsy()\n })\n\n xit('check digit of X should not be used for 0', () => {\n expect(isValid('3-598-21515-X')).toBeFalsy()\n })\n\n xit('empty isbn', () => {\n expect(isValid('')).toBeFalsy()\n })\n\n xit('input is 9 characters', () => {\n expect(isValid('134456729')).toBeFalsy()\n })\n\n xit('invalid characters are not ignored after checking length', () => {\n expect(isValid('3132P34035')).toBeFalsy()\n })\n\n xit('invalid characters are not ignored before checking length', () => {\n expect(isValid('3598P215088')).toBeFalsy()\n })\n\n xit('input is too long but contains a valid isbn', () => {\n expect(isValid('98245726788')).toBeFalsy()\n })\n})\n" }, { "path": "exercises/practice/isbn-verifier/isbn-verifier.ts", "content": "export function isValid(isbn: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/isbn-verifier/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/isbn-verifier/package.json", "content": "{\n \"name\": \"@exercism/typescript-isbn-verifier\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/isbn-verifier/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/isbn-verifier/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/isogram/.docs/instructions.md", "content": "# Instructions\n\nDetermine if a word or phrase is an isogram.\n\nAn isogram (also known as a \"non-pattern word\") is a word or phrase without a repeating letter, however spaces and hyphens are allowed to appear multiple times.\n\nExamples of isograms:\n\n- lumberjacks\n- background\n- downstream\n- six-year-old\n\nThe word _isograms_, however, is not an isogram, because the s repeats.\n" }, { "path": "exercises/practice/isogram/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"isogram.ts\"\n ],\n \"test\": [\n \"isogram.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Determine if a word or phrase is an isogram.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Isogram\"\n}\n" }, { "path": "exercises/practice/isogram/.meta/proof.ci.ts", "content": "export function isIsogram(phrase: string): boolean {\n const appearances = new Set()\n\n for (const letter of phrase) {\n if (isLetter(letter)) {\n if (appearances.has(letter.toLowerCase())) {\n return false\n } else {\n appearances.add(letter.toLowerCase())\n }\n } else {\n continue\n }\n }\n\n return true\n}\n\nfunction isLetter(letter: string): boolean {\n if (\n (letter.charCodeAt(0) >= 97 && letter.charCodeAt(0) <= 122) ||\n (letter.charCodeAt(0) >= 65 && letter.charCodeAt(0) <= 90)\n ) {\n return true\n } else {\n return false\n }\n}\n" }, { "path": "exercises/practice/isogram/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[a0e97d2d-669e-47c7-8134-518a1e2c4555]\ndescription = \"empty string\"\n\n[9a001b50-f194-4143-bc29-2af5ec1ef652]\ndescription = \"isogram with only lower case characters\"\n\n[8ddb0ca3-276e-4f8b-89da-d95d5bae78a4]\ndescription = \"word with one duplicated character\"\n\n[6450b333-cbc2-4b24-a723-0b459b34fe18]\ndescription = \"word with one duplicated character from the end of the alphabet\"\n\n[a15ff557-dd04-4764-99e7-02cc1a385863]\ndescription = \"longest reported english isogram\"\n\n[f1a7f6c7-a42f-4915-91d7-35b2ea11c92e]\ndescription = \"word with duplicated character in mixed case\"\n\n[14a4f3c1-3b47-4695-b645-53d328298942]\ndescription = \"word with duplicated character in mixed case, lowercase first\"\n\n[423b850c-7090-4a8a-b057-97f1cadd7c42]\ndescription = \"hypothetical isogrammic word with hyphen\"\n\n[93dbeaa0-3c5a-45c2-8b25-428b8eacd4f2]\ndescription = \"hypothetical word with duplicated character following hyphen\"\n\n[36b30e5c-173f-49c6-a515-93a3e825553f]\ndescription = \"isogram with duplicated hyphen\"\n\n[cdabafa0-c9f4-4c1f-b142-689c6ee17d93]\ndescription = \"made-up name that is an isogram\"\n\n[5fc61048-d74e-48fd-bc34-abfc21552d4d]\ndescription = \"duplicated character in the middle\"\n\n[310ac53d-8932-47bc-bbb4-b2b94f25a83e]\ndescription = \"same first and last characters\"\n\n[0d0b8644-0a1e-4a31-a432-2b3ee270d847]\ndescription = \"word with duplicated character and with two hyphens\"\n" }, { "path": "exercises/practice/isogram/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/isogram/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/isogram/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/isogram/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/isogram/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/isogram/isogram.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { isIsogram } from './isogram.ts'\n\ndescribe('Check if the given string is an isogram', () => {\n it('empty string', () => {\n const expected = true\n expect(isIsogram('')).toEqual(expected)\n })\n\n xit('isogram with only lower case characters', () => {\n const expected = true\n expect(isIsogram('isogram')).toEqual(expected)\n })\n\n xit('word with one duplicated character', () => {\n const expected = false\n expect(isIsogram('eleven')).toEqual(expected)\n })\n\n xit('word with one duplicated character from the end of the alphabet', () => {\n const expected = false\n expect(isIsogram('zzyzx')).toEqual(expected)\n })\n\n xit('longest reported english isogram', () => {\n const expected = true\n expect(isIsogram('subdermatoglyphic')).toEqual(expected)\n })\n\n xit('word with duplicated character in mixed case', () => {\n const expected = false\n expect(isIsogram('Alphabet')).toEqual(expected)\n })\n\n xit('word with duplicated character in mixed case, lowercase first', () => {\n const expected = false\n expect(isIsogram('alphAbet')).toEqual(expected)\n })\n\n xit('hypothetical isogrammic word with hyphen', () => {\n const expected = true\n expect(isIsogram('thumbscrew-japingly')).toEqual(expected)\n })\n\n xit('hypothetical word with duplicated character following hyphen', () => {\n const expected = false\n expect(isIsogram('thumbscrew-jappingly')).toEqual(expected)\n })\n\n xit('isogram with duplicated hyphen', () => {\n const expected = true\n expect(isIsogram('six-year-old')).toEqual(expected)\n })\n\n xit('made-up name that is an isogram', () => {\n const expected = true\n expect(isIsogram('Emily Jung Schwartzkopf')).toEqual(expected)\n })\n\n xit('duplicated character in the middle', () => {\n const expected = false\n expect(isIsogram('accentor')).toEqual(expected)\n })\n\n xit('same first and last characters', () => {\n const expected = false\n expect(isIsogram('angola')).toEqual(expected)\n })\n\n xit('word with duplicated character and with two hyphens', () => {\n const expected = false\n expect(isIsogram('up-to-date')).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/isogram/isogram.ts", "content": "export function isIsogram(/* parameters go here */): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/isogram/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/isogram/package.json", "content": "{\n \"name\": \"@exercism/typescript-isogram\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/isogram/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/isogram/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/kindergarten-garden/.docs/instructions.md", "content": "# Instructions\n\nYour task is to, given a diagram, determine which plants each child in the kindergarten class is responsible for.\n\nThere are 12 children in the class:\n\n- Alice, Bob, Charlie, David, Eve, Fred, Ginny, Harriet, Ileana, Joseph, Kincaid, and Larry.\n\nFour different types of seeds are planted:\n\n| Plant | Diagram encoding |\n| ------ | ---------------- |\n| Grass | G |\n| Clover | C |\n| Radish | R |\n| Violet | V |\n\nEach child gets four cups, two on each row:\n\n```text\n[window][window][window]\n........................ # each dot represents a cup\n........................\n```\n\nTheir teacher assigns cups to the children alphabetically by their names, which means that Alice comes first and Larry comes last.\n\nHere is an example diagram representing Alice's plants:\n\n```text\n[window][window][window]\nVR......................\nRG......................\n```\n\nIn the first row, nearest the windows, she has a violet and a radish.\nIn the second row she has a radish and some grass.\n\nYour program will be given the plants from left-to-right starting with the row nearest the windows.\nFrom this, it should be able to determine which plants belong to each student.\n\nFor example, if it's told that the garden looks like so:\n\n```text\n[window][window][window]\nVRCGVVRVCGGCCGVRGCVCGCGV\nVRCCCGCRRGVCGCRVVCVGCGCV\n```\n\nThen if asked for Alice's plants, it should provide:\n\n- Violets, radishes, violets, radishes\n\nWhile asking for Bob's plants would yield:\n\n- Clover, grass, clover, clover\n" }, { "path": "exercises/practice/kindergarten-garden/.docs/introduction.md", "content": "# Introduction\n\nThe kindergarten class is learning about growing plants.\nThe teacher thought it would be a good idea to give the class seeds to plant and grow in the dirt.\nTo this end, the children have put little cups along the window sills and planted one type of plant in each cup.\nThe children got to pick their favorites from four available types of seeds: grass, clover, radishes, and violets.\n" }, { "path": "exercises/practice/kindergarten-garden/.meta/config.json", "content": "{\n \"authors\": [\n \"fredrb\"\n ],\n \"contributors\": [\n \"CRivasGomez\",\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"kindergarten-garden.ts\"\n ],\n \"test\": [\n \"kindergarten-garden.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a diagram, determine which plants each child in the kindergarten class is responsible for.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Exercise by the JumpstartLab team for students at The Turing School of Software and Design.\",\n \"source_url\": \"https://www.turing.edu/\"\n}\n" }, { "path": "exercises/practice/kindergarten-garden/.meta/proof.ci.ts", "content": "const DEFAULT_STUDENTS: Student[] = [\n 'Alice',\n 'Bob',\n 'Charlie',\n 'David',\n 'Eve',\n 'Fred',\n 'Ginny',\n 'Harriet',\n 'Ileana',\n 'Joseph',\n 'Kincaid',\n 'Larry',\n]\n\nconst PLANT_CODES = {\n G: 'grass',\n V: 'violets',\n R: 'radishes',\n C: 'clover',\n} as const\n\ntype Student = string\ntype Plant = (typeof PLANT_CODES)[keyof typeof PLANT_CODES]\ntype Plants = Plant[]\ntype Pots = Plants[]\n\nfunction getPlants(pots: Pots, index: number): Plants {\n const plants: Plants = []\n\n const position = 2 * index\n plants.push(pots[0][position])\n plants.push(pots[0][position + 1])\n plants.push(pots[1][position])\n plants.push(pots[1][position + 1])\n\n return plants\n}\n\nfunction parse(diagram: string): Pots {\n return diagram\n .split('\\n')\n .map((row) =>\n [...row].map(\n (sign) => PLANT_CODES[sign as keyof typeof PLANT_CODES] as Plant\n )\n )\n}\nexport class Garden {\n private plots: Record\n\n constructor(\n diagram: string,\n private students = DEFAULT_STUDENTS\n ) {\n this.students.sort()\n\n this.plots = {}\n\n this.students.forEach((student, index) => {\n this.plots[student] = getPlants(parse(diagram), index)\n })\n }\n\n public plants(student: Student): Plants {\n return this.plots[student]\n }\n}\n" }, { "path": "exercises/practice/kindergarten-garden/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[1fc316ed-17ab-4fba-88ef-3ae78296b692]\ndescription = \"partial garden -> garden with single student\"\n\n[acd19dc1-2200-4317-bc2a-08f021276b40]\ndescription = \"partial garden -> different garden with single student\"\n\n[c376fcc8-349c-446c-94b0-903947315757]\ndescription = \"partial garden -> garden with two students\"\n\n[2d620f45-9617-4924-9d27-751c80d17db9]\ndescription = \"partial garden -> multiple students for the same garden with three students -> second student's garden\"\n\n[57712331-4896-4364-89f8-576421d69c44]\ndescription = \"partial garden -> multiple students for the same garden with three students -> third student's garden\"\n\n[149b4290-58e1-40f2-8ae4-8b87c46e765b]\ndescription = \"full garden -> for Alice, first student's garden\"\n\n[ba25dbbc-10bd-4a37-b18e-f89ecd098a5e]\ndescription = \"full garden -> for Bob, second student's garden\"\n\n[566b621b-f18e-4c5f-873e-be30544b838c]\ndescription = \"full garden -> for Charlie\"\n\n[3ad3df57-dd98-46fc-9269-1877abf612aa]\ndescription = \"full garden -> for David\"\n\n[0f0a55d1-9710-46ed-a0eb-399ba8c72db2]\ndescription = \"full garden -> for Eve\"\n\n[a7e80c90-b140-4ea1-aee3-f4625365c9a4]\ndescription = \"full garden -> for Fred\"\n\n[9d94b273-2933-471b-86e8-dba68694c615]\ndescription = \"full garden -> for Ginny\"\n\n[f55bc6c2-ade8-4844-87c4-87196f1b7258]\ndescription = \"full garden -> for Harriet\"\n\n[759070a3-1bb1-4dd4-be2c-7cce1d7679ae]\ndescription = \"full garden -> for Ileana\"\n\n[78578123-2755-4d4a-9c7d-e985b8dda1c6]\ndescription = \"full garden -> for Joseph\"\n\n[6bb66df7-f433-41ab-aec2-3ead6e99f65b]\ndescription = \"full garden -> for Kincaid, second to last student's garden\"\n\n[d7edec11-6488-418a-94e6-ed509e0fa7eb]\ndescription = \"full garden -> for Larry, last student's garden\"\n" }, { "path": "exercises/practice/kindergarten-garden/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/kindergarten-garden/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/kindergarten-garden/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/kindergarten-garden/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/kindergarten-garden/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/kindergarten-garden/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/kindergarten-garden/kindergarten-garden.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Garden } from './kindergarten-garden.ts'\n\ndescribe('partial Garden', () => {\n it('garden with single student', () => {\n expect(new Garden('RC\\nGG').plants('Alice')).toEqual([\n 'radishes',\n 'clover',\n 'grass',\n 'grass',\n ])\n })\n\n xit('different garden with single student', () => {\n expect(new Garden('VC\\nRC').plants('Alice')).toEqual([\n 'violets',\n 'clover',\n 'radishes',\n 'clover',\n ])\n })\n\n xit('garden with two students', () => {\n expect(new Garden('VVCG\\nVVRC').plants('Bob')).toEqual([\n 'clover',\n 'grass',\n 'radishes',\n 'clover',\n ])\n })\n\n describe('multiple students for the same garden with three students', () => {\n xit(\"second student's garden\", () => {\n expect(new Garden('VVCCGG\\nVVCCGG').plants('Bob')).toEqual([\n 'clover',\n 'clover',\n 'clover',\n 'clover',\n ])\n })\n\n xit(\"third student's garden\", () => {\n expect(new Garden('VVCCGG\\nVVCCGG').plants('Charlie')).toEqual([\n 'grass',\n 'grass',\n 'grass',\n 'grass',\n ])\n })\n })\n})\n\ndescribe('full garden', () => {\n const diagram = 'VRCGVVRVCGGCCGVRGCVCGCGV\\nVRCCCGCRRGVCGCRVVCVGCGCV'\n const garden = new Garden(diagram)\n\n xit(\"for Alice, first student's garden\", () => {\n expect(garden.plants('Alice')).toEqual([\n 'violets',\n 'radishes',\n 'violets',\n 'radishes',\n ])\n })\n\n xit(\"for Bob, second student's garden\", () => {\n expect(garden.plants('Bob')).toEqual([\n 'clover',\n 'grass',\n 'clover',\n 'clover',\n ])\n })\n\n xit('for Charlie', () => {\n expect(garden.plants('Charlie')).toEqual([\n 'violets',\n 'violets',\n 'clover',\n 'grass',\n ])\n })\n\n xit('for David', () => {\n expect(garden.plants('David')).toEqual([\n 'radishes',\n 'violets',\n 'clover',\n 'radishes',\n ])\n })\n\n xit('for Eve', () => {\n expect(garden.plants('Eve')).toEqual([\n 'clover',\n 'grass',\n 'radishes',\n 'grass',\n ])\n })\n\n xit('for Fred', () => {\n expect(garden.plants('Fred')).toEqual([\n 'grass',\n 'clover',\n 'violets',\n 'clover',\n ])\n })\n\n xit('for Ginny', () => {\n expect(garden.plants('Ginny')).toEqual([\n 'clover',\n 'grass',\n 'grass',\n 'clover',\n ])\n })\n\n xit('for Harriet', () => {\n expect(garden.plants('Harriet')).toEqual([\n 'violets',\n 'radishes',\n 'radishes',\n 'violets',\n ])\n })\n\n xit('for Ileana', () => {\n expect(garden.plants('Ileana')).toEqual([\n 'grass',\n 'clover',\n 'violets',\n 'clover',\n ])\n })\n\n xit('for Joseph', () => {\n expect(garden.plants('Joseph')).toEqual([\n 'violets',\n 'clover',\n 'violets',\n 'grass',\n ])\n })\n\n xit(\"for Kincaid, second to last student's garden\", () => {\n expect(garden.plants('Kincaid')).toEqual([\n 'grass',\n 'clover',\n 'clover',\n 'grass',\n ])\n })\n\n xit(\"for Larry, last student's garden\", () => {\n expect(garden.plants('Larry')).toEqual([\n 'grass',\n 'violets',\n 'clover',\n 'violets',\n ])\n })\n})\n\ndescribe('disordered class', () => {\n const diagram = 'VCRRGVRG\\nRVGCCGCV'\n const students = ['Samantha', 'Patricia', 'Xander', 'Roger']\n const garden = new Garden(diagram, students)\n\n xit('for Patricia', () => {\n expect(garden.plants('Patricia')).toEqual([\n 'violets',\n 'clover',\n 'radishes',\n 'violets',\n ])\n })\n\n xit('for Roger', () => {\n expect(garden.plants('Roger')).toEqual([\n 'radishes',\n 'radishes',\n 'grass',\n 'clover',\n ])\n })\n\n xit('for Samantha', () => {\n expect(garden.plants('Samantha')).toEqual([\n 'grass',\n 'violets',\n 'clover',\n 'grass',\n ])\n })\n\n xit('for Xander', () => {\n expect(garden.plants('Xander')).toEqual([\n 'radishes',\n 'grass',\n 'clover',\n 'violets',\n ])\n })\n})\n\ndescribe('Two gardens, different students', () => {\n const diagram = 'VCRRGVRG\\nRVGCCGCV'\n const garden1 = new Garden(diagram, ['Alice', 'Bob', 'Charlie', 'Dan'])\n const garden2 = new Garden(diagram, ['Bob', 'Charlie', 'Dan', 'Erin'])\n\n xit('Bob and Charlie for each garden', () => {\n expect(garden1.plants('Bob')).toEqual([\n 'radishes',\n 'radishes',\n 'grass',\n 'clover',\n ])\n expect(garden2.plants('Bob')).toEqual([\n 'violets',\n 'clover',\n 'radishes',\n 'violets',\n ])\n expect(garden1.plants('Charlie')).toEqual([\n 'grass',\n 'violets',\n 'clover',\n 'grass',\n ])\n expect(garden2.plants('Charlie')).toEqual([\n 'radishes',\n 'radishes',\n 'grass',\n 'clover',\n ])\n })\n})\n" }, { "path": "exercises/practice/kindergarten-garden/kindergarten-garden.ts", "content": "//\n// This is only a SKELETON file for the 'Kindergarten Garden' exercise.\n// It's been provided as a convenience to get you started writing code faster.\n//\n\nconst DEFAULT_STUDENTS: Student[] = [\n 'Alice',\n 'Bob',\n 'Charlie',\n 'David',\n 'Eve',\n 'Fred',\n 'Ginny',\n 'Harriet',\n 'Ileana',\n 'Joseph',\n 'Kincaid',\n 'Larry',\n]\n\nconst PLANT_CODES = {\n G: 'grass',\n V: 'violets',\n R: 'radishes',\n C: 'clover',\n} as const\n\ntype Student = string\ntype Plant = (typeof PLANT_CODES)[keyof typeof PLANT_CODES]\ntype Plants = Plant[]\ntype Pots = Plants[]\n\nexport class Garden {\n constructor(diagram: string, students = DEFAULT_STUDENTS) {\n throw new Error('Remove this line and implement the function')\n }\n\n public plants(student: Student): Plants {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/kindergarten-garden/package.json", "content": "{\n \"name\": \"@exercism/typescript-kindergarten-garden\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/kindergarten-garden/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/kindergarten-garden/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/knapsack/.docs/instructions.md", "content": "# Instructions\n\nYour task is to determine which items to take so that the total value of her selection is maximized, taking into account the knapsack's carrying capacity.\n\nItems will be represented as a list of items.\nEach item will have a weight and value.\nAll values given will be strictly positive.\nLhakpa can take only one of each item.\n\nFor example:\n\n```text\nItems: [\n { \"weight\": 5, \"value\": 10 },\n { \"weight\": 4, \"value\": 40 },\n { \"weight\": 6, \"value\": 30 },\n { \"weight\": 4, \"value\": 50 }\n]\n\nKnapsack Maximum Weight: 10\n```\n\nFor the above, the first item has weight 5 and value 10, the second item has weight 4 and value 40, and so on.\nIn this example, Lhakpa should take the second and fourth item to maximize her value, which, in this case, is 90.\nShe cannot get more than 90 as her knapsack has a weight limit of 10.\n" }, { "path": "exercises/practice/knapsack/.docs/introduction.md", "content": "# Introduction\n\nLhakpa is a [Sherpa][sherpa] mountain guide and porter.\nAfter months of careful planning, the expedition Lhakpa works for is about to leave.\nShe will be paid the value she carried to the base camp.\n\nIn front of her are many items, each with a value and weight.\nLhakpa would gladly take all of the items, but her knapsack can only hold so much weight.\n\n[sherpa]: https://en.wikipedia.org/wiki/Sherpa_people#Mountaineering\n" }, { "path": "exercises/practice/knapsack/.meta/config.json", "content": "{\n \"authors\": [\n \"JoshiRaez\"\n ],\n \"contributors\": [\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"knapsack.ts\"\n ],\n \"test\": [\n \"knapsack.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a knapsack that can only carry a certain weight, determine which items to put in the knapsack in order to maximize their combined value.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Knapsack_problem\"\n}\n" }, { "path": "exercises/practice/knapsack/.meta/proof.ci.ts", "content": "type Item = {\n weight: number\n value: number\n}\n\nexport function maximumValue({\n maximumWeight,\n items,\n}: {\n maximumWeight: number\n items: Item[]\n}): number {\n const maxValueForItemsSizeToWeight: number[][] = new Array(items.length + 1)\n .fill(undefined)\n .map(() => new Array(maximumWeight + 1))\n\n return solve(items.length, maximumWeight, items, maxValueForItemsSizeToWeight)\n}\n\nfunction solve(\n setItemsSize: number,\n maxWeight: number,\n items: Item[],\n maxValueForItemsSizeToWeight: number[][]\n): number {\n return memoizedMax(\n setItemsSize,\n maxWeight,\n items,\n maxValueForItemsSizeToWeight\n )\n}\n\nfunction memoizedMax(\n setItemsSize: number,\n maxWeight: number,\n items: Item[],\n maxValueForItemsSizeToWeight: number[][]\n): number {\n const alreadyKnownMaxValue =\n maxValueForItemsSizeToWeight[setItemsSize][maxWeight]\n if (alreadyKnownMaxValue || alreadyKnownMaxValue === 0)\n return alreadyKnownMaxValue\n\n const max = calculateMax(\n setItemsSize,\n maxWeight,\n items,\n maxValueForItemsSizeToWeight\n )\n maxValueForItemsSizeToWeight[setItemsSize][maxWeight] = max\n\n return max\n}\n\nfunction calculateMax(\n setItemsSize: number,\n maxWeight: number,\n items: Item[],\n maxValueForItemsSizeToWeight: number[][]\n): number {\n if (!setItemsSize) return 0\n\n return Math.max(\n ...Array.from(Array(maxWeight + 1).keys()).map(\n (checkingWeight) =>\n memoizedMax(\n setItemsSize - 1,\n checkingWeight,\n items,\n maxValueForItemsSizeToWeight\n ) +\n valueOfItemIfFits(maxWeight, checkingWeight, items[setItemsSize - 1])\n )\n )\n}\n\nfunction valueOfItemIfFits(\n maxWeight: number,\n alreadyInBagWeight: number,\n itemToFit: Item\n): number {\n if (alreadyInBagWeight + itemToFit.weight <= maxWeight) return itemToFit.value\n\n return 0\n}\n" }, { "path": "exercises/practice/knapsack/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[a4d7d2f0-ad8a-460c-86f3-88ba709d41a7]\ndescription = \"no items\"\ninclude = false\n\n[3993a824-c20e-493d-b3c9-ee8a7753ee59]\ndescription = \"no items\"\nreimplements = \"a4d7d2f0-ad8a-460c-86f3-88ba709d41a7\"\n\n[1d39e98c-6249-4a8b-912f-87cb12e506b0]\ndescription = \"one item, too heavy\"\n\n[833ea310-6323-44f2-9d27-a278740ffbd8]\ndescription = \"five items (cannot be greedy by weight)\"\n\n[277cdc52-f835-4c7d-872b-bff17bab2456]\ndescription = \"five items (cannot be greedy by value)\"\n\n[81d8e679-442b-4f7a-8a59-7278083916c9]\ndescription = \"example knapsack\"\n\n[f23a2449-d67c-4c26-bf3e-cde020f27ecc]\ndescription = \"8 items\"\n\n[7c682ae9-c385-4241-a197-d2fa02c81a11]\ndescription = \"15 items\"\n" }, { "path": "exercises/practice/knapsack/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/knapsack/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/knapsack/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/knapsack/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/knapsack/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/knapsack/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/knapsack/knapsack.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { maximumValue } from './knapsack.ts'\n\ndescribe('Check if max carriable value is returned', () => {\n it('No items', () => {\n const input = {\n maximumWeight: 100,\n items: [],\n }\n const expected = 0\n expect(maximumValue(input)).toEqual(expected)\n })\n\n xit('One item, but too heavy', () => {\n const input = {\n maximumWeight: 10,\n items: [{ weight: 100, value: 1 }],\n }\n const expected = 0\n expect(maximumValue(input)).toEqual(expected)\n })\n\n xit(\"Five items. Can't be greedy by weight\", () => {\n const input = {\n maximumWeight: 10,\n items: [\n { weight: 2, value: 5 },\n { weight: 2, value: 5 },\n { weight: 2, value: 5 },\n { weight: 2, value: 5 },\n { weight: 10, value: 21 },\n ],\n }\n const expected = 21\n expect(maximumValue(input)).toEqual(expected)\n })\n\n xit(\"Five items. Can't be greedy by value\", () => {\n const input = {\n maximumWeight: 10,\n items: [\n { weight: 2, value: 20 },\n { weight: 2, value: 20 },\n { weight: 2, value: 20 },\n { weight: 2, value: 20 },\n { weight: 10, value: 50 },\n ],\n }\n const expected = 80\n expect(maximumValue(input)).toEqual(expected)\n })\n\n xit('Example knapsack', () => {\n const input = {\n maximumWeight: 10,\n items: [\n { weight: 5, value: 10 },\n { weight: 4, value: 40 },\n { weight: 6, value: 30 },\n { weight: 4, value: 50 },\n ],\n }\n const expected = 90\n expect(maximumValue(input)).toEqual(expected)\n })\n\n xit('8 items', () => {\n const input = {\n maximumWeight: 104,\n items: [\n { weight: 25, value: 350 },\n { weight: 35, value: 400 },\n { weight: 45, value: 450 },\n { weight: 5, value: 20 },\n { weight: 25, value: 70 },\n { weight: 3, value: 8 },\n { weight: 2, value: 5 },\n { weight: 2, value: 5 },\n ],\n }\n const expected = 900\n expect(maximumValue(input)).toEqual(expected)\n })\n\n xit('15 items', () => {\n const input = {\n maximumWeight: 750,\n items: [\n { weight: 70, value: 135 },\n { weight: 73, value: 139 },\n { weight: 77, value: 149 },\n { weight: 80, value: 150 },\n { weight: 82, value: 156 },\n { weight: 87, value: 163 },\n { weight: 90, value: 173 },\n { weight: 94, value: 184 },\n { weight: 98, value: 192 },\n { weight: 106, value: 201 },\n { weight: 110, value: 210 },\n { weight: 113, value: 214 },\n { weight: 115, value: 221 },\n { weight: 118, value: 229 },\n { weight: 120, value: 240 },\n ],\n }\n const expected = 1458\n expect(maximumValue(input)).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/knapsack/knapsack.ts", "content": "type Item = {\n weight: number\n value: number\n}\n\nexport function maximumValue({\n maximumWeight,\n items,\n}: {\n maximumWeight: number\n items: Item[]\n}): number {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/knapsack/package.json", "content": "{\n \"name\": \"@exercism/typescript-knapsack\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism practice exercise on knapsack\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/knapsack/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/knapsack/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/largest-series-product/.docs/instructions.md", "content": "# Instructions\n\nYour task is to look for patterns in the long sequence of digits in the encrypted signal.\n\nThe technique you're going to use here is called the largest series product.\n\nLet's define a few terms, first.\n\n- **input**: the sequence of digits that you need to analyze\n- **series**: a sequence of adjacent digits (those that are next to each other) that is contained within the input\n- **span**: how many digits long each series is\n- **product**: what you get when you multiply numbers together\n\nLet's work through an example, with the input `\"63915\"`.\n\n- To form a series, take adjacent digits in the original input.\n- If you are working with a span of `3`, there will be three possible series:\n - `\"639\"`\n - `\"391\"`\n - `\"915\"`\n- Then we need to calculate the product of each series:\n - The product of the series `\"639\"` is 162 (`6 Ɨ 3 Ɨ 9 = 162`)\n - The product of the series `\"391\"` is 27 (`3 Ɨ 9 Ɨ 1 = 27`)\n - The product of the series `\"915\"` is 45 (`9 Ɨ 1 Ɨ 5 = 45`)\n- 162 is bigger than both 27 and 45, so the largest series product of `\"63915\"` is from the series `\"639\"`.\n So the answer is **162**.\n" }, { "path": "exercises/practice/largest-series-product/.docs/introduction.md", "content": "# Introduction\n\nYou work for a government agency that has intercepted a series of encrypted communication signals from a group of bank robbers.\nThe signals contain a long sequence of digits.\nYour team needs to use various digital signal processing techniques to analyze the signals and identify any patterns that may indicate the planning of a heist.\n" }, { "path": "exercises/practice/largest-series-product/.meta/config.json", "content": "{\n \"authors\": [\n \"deyshin\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"largest-series-product.ts\"\n ],\n \"test\": [\n \"largest-series-product.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a string of digits, calculate the largest product for a contiguous substring of digits of length n.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A variation on Problem 8 at Project Euler\",\n \"source_url\": \"https://projecteuler.net/problem=8\"\n}\n" }, { "path": "exercises/practice/largest-series-product/.meta/proof.ci.ts", "content": "export function largestProduct(digits: string, seriesLength: number): number {\n if (seriesLength === 0) {\n return 1\n }\n if (seriesLength > digits.length) {\n throw new Error('Span must not exceed string length')\n }\n if (seriesLength < 0) {\n throw new Error('Span must not be negative')\n }\n\n if (!/^[0-9]+$/g.test(digits)) {\n throw new Error('Digits input must only contain digits')\n }\n\n let result = 0\n for (let i = 0; i <= digits.length - seriesLength; i++) {\n const product = digits\n .substring(i, i + seriesLength)\n .split('')\n .map((digit) => Number(digit))\n .reduce((a, b) => a * b)\n if (product > result) {\n result = product\n }\n }\n return result\n}\n" }, { "path": "exercises/practice/largest-series-product/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[7c82f8b7-e347-48ee-8a22-f672323324d4]\ndescription = \"finds the largest product if span equals length\"\n\n[88523f65-21ba-4458-a76a-b4aaf6e4cb5e]\ndescription = \"can find the largest product of 2 with numbers in order\"\n\n[f1376b48-1157-419d-92c2-1d7e36a70b8a]\ndescription = \"can find the largest product of 2\"\n\n[46356a67-7e02-489e-8fea-321c2fa7b4a4]\ndescription = \"can find the largest product of 3 with numbers in order\"\n\n[a2dcb54b-2b8f-4993-92dd-5ce56dece64a]\ndescription = \"can find the largest product of 3\"\n\n[673210a3-33cd-4708-940b-c482d7a88f9d]\ndescription = \"can find the largest product of 5 with numbers in order\"\n\n[02acd5a6-3bbf-46df-8282-8b313a80a7c9]\ndescription = \"can get the largest product of a big number\"\n\n[76dcc407-21e9-424c-a98e-609f269622b5]\ndescription = \"reports zero if the only digits are zero\"\n\n[6ef0df9f-52d4-4a5d-b210-f6fae5f20e19]\ndescription = \"reports zero if all spans include zero\"\n\n[5d81aaf7-4f67-4125-bf33-11493cc7eab7]\ndescription = \"rejects span longer than string length\"\ninclude = false\n\n[0ae1ce53-d9ba-41bb-827f-2fceb64f058b]\ndescription = \"rejects span longer than string length\"\nreimplements = \"5d81aaf7-4f67-4125-bf33-11493cc7eab7\"\n\n[06bc8b90-0c51-4c54-ac22-3ec3893a079e]\ndescription = \"reports 1 for empty string and empty product (0 span)\"\ninclude = false\n\n[3ec0d92e-f2e2-4090-a380-70afee02f4c0]\ndescription = \"reports 1 for nonempty string and empty product (0 span)\"\ninclude = false\n\n[6d96c691-4374-4404-80ee-2ea8f3613dd4]\ndescription = \"rejects empty string and nonzero span\"\ninclude = false\n\n[6cf66098-a6af-4223-aab1-26aeeefc7402]\ndescription = \"rejects empty string and nonzero span\"\nreimplements = \"6d96c691-4374-4404-80ee-2ea8f3613dd4\"\n\n[7a38f2d6-3c35-45f6-8d6f-12e6e32d4d74]\ndescription = \"rejects invalid character in digits\"\n\n[5fe3c0e5-a945-49f2-b584-f0814b4dd1ef]\ndescription = \"rejects negative span\"\ninclude = false\n\n[c859f34a-9bfe-4897-9c2f-6d7f8598e7f0]\ndescription = \"rejects negative span\"\nreimplements = \"5fe3c0e5-a945-49f2-b584-f0814b4dd1ef\"\n" }, { "path": "exercises/practice/largest-series-product/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/largest-series-product/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/largest-series-product/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/largest-series-product/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/largest-series-product/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/largest-series-product/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/largest-series-product/largest-series-product.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { largestProduct } from './largest-series-product.ts'\n\ndescribe('Largest Series Product', () => {\n it('finds the largest product if span equals length', () => {\n expect(largestProduct('29', 2)).toEqual(18)\n })\n\n xit('can find the largest product of 2 with numbers in order', () => {\n expect(largestProduct('0123456789', 2)).toEqual(72)\n })\n\n xit('can find the largest product of 2', () => {\n expect(largestProduct('576802143', 2)).toEqual(48)\n })\n\n xit('can find the largest product of 3 with numbers in order', () => {\n expect(largestProduct('0123456789', 3)).toEqual(504)\n })\n\n xit('can find the largest product of 3', () => {\n expect(largestProduct('1027839564', 3)).toEqual(270)\n })\n\n xit('can find the largest product of 5 with numbers in order', () => {\n expect(largestProduct('0123456789', 5)).toEqual(15120)\n })\n\n xit('can get the largest product of a big number', () => {\n expect(\n largestProduct('73167176531330624919225119674426574742355349194934', 6)\n ).toEqual(23520)\n })\n\n xit('reports zero if the only digits are zero', () => {\n expect(largestProduct('0000', 2)).toEqual(0)\n })\n\n xit('reports zero if all spans include zero', () => {\n expect(largestProduct('99099', 3)).toEqual(0)\n })\n\n xit('rejects span longer than string length', () => {\n expect(() => largestProduct('123', 4)).toThrow(\n new Error('Span must not exceed string length')\n )\n })\n\n xit('rejects empty string and nonzero span', () => {\n expect(() => largestProduct('', 1)).toThrow(\n new Error('Span must not exceed string length')\n )\n })\n\n xit('rejects invalid character in digits', () => {\n expect(() => largestProduct('1234a5', 2)).toThrow(\n new Error('Digits input must only contain digits')\n )\n })\n\n xit('rejects negative span', () => {\n expect(() => largestProduct('12345', -1)).toThrow(\n new Error('Span must not be negative')\n )\n })\n})\n" }, { "path": "exercises/practice/largest-series-product/largest-series-product.ts", "content": "export const largestProduct = () => {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/largest-series-product/package.json", "content": "{\n \"name\": \"@exercism/typescript-largest-series-product\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/largest-series-product/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/largest-series-product/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/leap/.docs/instructions.md", "content": "# Instructions\n\nYour task is to determine whether a given year is a leap year.\n" }, { "path": "exercises/practice/leap/.docs/introduction.md", "content": "# Introduction\n\nA leap year (in the Gregorian calendar) occurs:\n\n- In every year that is evenly divisible by 4.\n- Unless the year is evenly divisible by 100, in which case it's only a leap year if the year is also evenly divisible by 400.\n\nSome examples:\n\n- 1997 was not a leap year as it's not divisible by 4.\n- 1900 was not a leap year as it's not divisible by 400.\n- 2000 was a leap year!\n\n~~~~exercism/note\nFor a delightful, four-minute explanation of the whole phenomenon of leap years, check out [this YouTube video](https://www.youtube.com/watch?v=xX96xng7sAE).\n~~~~\n" }, { "path": "exercises/practice/leap/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"DFXLuna\",\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"leap.ts\"\n ],\n \"test\": [\n \"leap.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Determine whether a given year is a leap year.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"CodeRanch Cattle Drive, Assignment 3\",\n \"source_url\": \"https://web.archive.org/web/20240907033714/https://coderanch.com/t/718816/Leap\"\n}\n" }, { "path": "exercises/practice/leap/.meta/proof.ci.ts", "content": "export function isLeap(year: number): boolean {\n return (year % 100 !== 0 && year % 4 === 0) || year % 400 === 0\n}\n" }, { "path": "exercises/practice/leap/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[6466b30d-519c-438e-935d-388224ab5223]\ndescription = \"year not divisible by 4 in common year\"\n\n[ac227e82-ee82-4a09-9eb6-4f84331ffdb0]\ndescription = \"year divisible by 2, not divisible by 4 in common year\"\n\n[4fe9b84c-8e65-489e-970b-856d60b8b78e]\ndescription = \"year divisible by 4, not divisible by 100 in leap year\"\n\n[7fc6aed7-e63c-48f5-ae05-5fe182f60a5d]\ndescription = \"year divisible by 4 and 5 is still a leap year\"\n\n[78a7848f-9667-4192-ae53-87b30c9a02dd]\ndescription = \"year divisible by 100, not divisible by 400 in common year\"\n\n[9d70f938-537c-40a6-ba19-f50739ce8bac]\ndescription = \"year divisible by 100 but not by 3 is still not a leap year\"\n\n[42ee56ad-d3e6-48f1-8e3f-c84078d916fc]\ndescription = \"year divisible by 400 in leap year\"\n\n[57902c77-6fe9-40de-8302-587b5c27121e]\ndescription = \"year divisible by 400 but not by 125 is still a leap year\"\n\n[c30331f6-f9f6-4881-ad38-8ca8c12520c1]\ndescription = \"year divisible by 200, not divisible by 400 in common year\"\n" }, { "path": "exercises/practice/leap/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/leap/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/leap/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/leap/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/leap/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/leap/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/leap/leap.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { isLeap } from './leap.ts'\n\ndescribe('A leap year', () => {\n it('year not divisible by 4 in common year', () => {\n expect(isLeap(2015)).toBe(false)\n })\n\n xit('year divisible by 2, not divisible by 4 in common year', () => {\n expect(isLeap(1970)).toBe(false)\n })\n\n xit('year divisible by 4, not divisible by 100 in leap year', () => {\n expect(isLeap(1996)).toBe(true)\n })\n\n xit('year divisible by 4 and 5 is still a leap year', () => {\n expect(isLeap(1960)).toBe(true)\n })\n\n xit('year divisible by 100, not divisible by 400 in common year', () => {\n expect(isLeap(2100)).toBe(false)\n })\n\n xit('year divisible by 100 but not by 3 is still not a leap year', () => {\n expect(isLeap(1900)).toBe(false)\n })\n\n xit('year divisible by 400 in leap year', () => {\n expect(isLeap(2000)).toBe(true)\n })\n\n xit('year divisible by 400 but not by 125 is still a leap year', () => {\n expect(isLeap(2400)).toBe(true)\n })\n\n xit('year divisible by 200, not divisible by 400 in common year', () => {\n expect(isLeap(1800)).toBe(false)\n })\n})\n" }, { "path": "exercises/practice/leap/leap.ts", "content": "export function isLeap() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/leap/package.json", "content": "{\n \"name\": \"@exercism/typescript-leap\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/leap/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/leap/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/line-up/.docs/instructions.md", "content": "# Instructions\n\nGiven a name and a number, your task is to produce a sentence using that name and that number as an [ordinal numeral][ordinal-numeral].\nYaŹ»qÅ«b expects to use numbers from 1 up to 999.\n\nRules:\n\n- Numbers ending in 1 (unless ending in 11) ā†’ `\"st\"`\n- Numbers ending in 2 (unless ending in 12) ā†’ `\"nd\"`\n- Numbers ending in 3 (unless ending in 13) ā†’ `\"rd\"`\n- All other numbers ā†’ `\"th\"`\n\nExamples:\n\n- `\"Mary\", 1` ā†’ `\"Mary, you are the 1st customer we serve today. Thank you!\"`\n- `\"John\", 12` ā†’ `\"John, you are the 12th customer we serve today. Thank you!\"`\n- `\"Dahir\", 162` ā†’ `\"Dahir, you are the 162nd customer we serve today. Thank you!\"`\n\n[ordinal-numeral]: https://en.wikipedia.org/wiki/Ordinal_numeral\n" }, { "path": "exercises/practice/line-up/.docs/introduction.md", "content": "# Introduction\n\nYour friend YaŹ»qÅ«b works the counter at a deli in town, slicing, weighing, and wrapping orders for a line of hungry customers that gets longer every day.\nWaiting customers are starting to lose track of who is next, so he wants numbered tickets they can use to track the order in which they arrive.\n\nTo make the customers feel special, he does not want the ticket to have only a number on it.\nThey shall get a proper English sentence with their name and number on it.\n" }, { "path": "exercises/practice/line-up/.meta/config.json", "content": "{\n \"authors\": [\n \"BNAndras\"\n ],\n \"files\": {\n \"solution\": [\n \"line-up.ts\"\n ],\n \"test\": [\n \"line-up.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Help lining up customers at YaŹ»qÅ«b's Deli.\",\n \"source\": \"mk-mxp, based on previous work from Exercism contributors codedge and neenjaw\",\n \"source_url\": \"https://forum.exercism.org/t/new-exercise-ordinal-numbers/19147\"\n}\n" }, { "path": "exercises/practice/line-up/.meta/proof.ci.ts", "content": "const getSuffix = (number: number): string => {\n const lastTwoDigits = number % 100\n const lastOneDigit = number % 10\n\n if (lastTwoDigits >= 11 && lastTwoDigits <= 13) {\n return 'th'\n }\n\n if (lastOneDigit === 1) {\n return 'st'\n }\n\n if (lastOneDigit === 2) {\n return 'nd'\n }\n\n if (lastOneDigit === 3) {\n return 'rd'\n }\n\n return 'th'\n}\n\nexport const format = (name: string, number: number): string =>\n `${name}, you are the ${number}${getSuffix(number)} customer we serve today. Thank you!`\n" }, { "path": "exercises/practice/line-up/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[7760d1b8-4864-4db4-953b-0fa7c047dbc0]\ndescription = \"format smallest non-exceptional ordinal numeral 4\"\n\n[e8b7c715-6baa-4f7b-8fb3-2fa48044ab7a]\ndescription = \"format greatest single digit non-exceptional ordinal numeral 9\"\n\n[f370aae9-7ae7-4247-90ce-e8ff8c6934df]\ndescription = \"format non-exceptional ordinal numeral 5\"\n\n[37f10dea-42a2-49de-bb92-0b690b677908]\ndescription = \"format non-exceptional ordinal numeral 6\"\n\n[d8dfb9a2-3a1f-4fee-9dae-01af3600054e]\ndescription = \"format non-exceptional ordinal numeral 7\"\n\n[505ec372-1803-42b1-9377-6934890fd055]\ndescription = \"format non-exceptional ordinal numeral 8\"\n\n[8267072d-be1f-4f70-b34a-76b7557a47b9]\ndescription = \"format exceptional ordinal numeral 1\"\n\n[4d8753cb-0364-4b29-84b8-4374a4fa2e3f]\ndescription = \"format exceptional ordinal numeral 2\"\n\n[8d44c223-3a7e-4f48-a0ca-78e67bf98aa7]\ndescription = \"format exceptional ordinal numeral 3\"\n\n[6c4f6c88-b306-4f40-bc78-97cdd583c21a]\ndescription = \"format smallest two digit non-exceptional ordinal numeral 10\"\n\n[e257a43f-d2b1-457a-97df-25f0923fc62a]\ndescription = \"format non-exceptional ordinal numeral 11\"\n\n[bb1db695-4d64-457f-81b8-4f5a2107e3f4]\ndescription = \"format non-exceptional ordinal numeral 12\"\n\n[60a3187c-9403-4835-97de-4f10ebfd63e2]\ndescription = \"format non-exceptional ordinal numeral 13\"\n\n[2bdcebc5-c029-4874-b6cc-e9bec80d603a]\ndescription = \"format exceptional ordinal numeral 21\"\n\n[74ee2317-0295-49d2-baf0-d56bcefa14e3]\ndescription = \"format exceptional ordinal numeral 62\"\n\n[b37c332d-7f68-40e3-8503-e43cbd67a0c4]\ndescription = \"format exceptional ordinal numeral 100\"\n\n[0375f250-ce92-4195-9555-00e28ccc4d99]\ndescription = \"format exceptional ordinal numeral 101\"\n\n[0d8a4974-9a8a-45a4-aca7-a9fb473c9836]\ndescription = \"format non-exceptional ordinal numeral 112\"\n\n[06b62efe-199e-4ce7-970d-4bf73945713f]\ndescription = \"format exceptional ordinal numeral 123\"\n" }, { "path": "exercises/practice/line-up/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/line-up/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/line-up/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/line-up/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/line-up/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/line-up/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/line-up/line-up.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { format } from './line-up.ts'\n\ndescribe('Line Up', () => {\n it('format smallest non-exceptional ordinal numeral 4', () => {\n expect(format('Gianna', 4)).toBe(\n 'Gianna, you are the 4th customer we serve today. Thank you!'\n )\n })\n\n xit('format greatest single digit non-exceptional ordinal numeral 9', () => {\n expect(format('Maarten', 9)).toBe(\n 'Maarten, you are the 9th customer we serve today. Thank you!'\n )\n })\n\n xit('format non-exceptional ordinal numeral 5', () => {\n expect(format('Petronila', 5)).toBe(\n 'Petronila, you are the 5th customer we serve today. Thank you!'\n )\n })\n\n xit('format non-exceptional ordinal numeral 6', () => {\n expect(format('Attakullakulla', 6)).toBe(\n 'Attakullakulla, you are the 6th customer we serve today. Thank you!'\n )\n })\n\n xit('format non-exceptional ordinal numeral 7', () => {\n expect(format('Kate', 7)).toBe(\n 'Kate, you are the 7th customer we serve today. Thank you!'\n )\n })\n\n xit('format non-exceptional ordinal numeral 8', () => {\n expect(format('Maximiliano', 8)).toBe(\n 'Maximiliano, you are the 8th customer we serve today. Thank you!'\n )\n })\n\n xit('format exceptional ordinal numeral 1', () => {\n expect(format('Mary', 1)).toBe(\n 'Mary, you are the 1st customer we serve today. Thank you!'\n )\n })\n\n xit('format exceptional ordinal numeral 2', () => {\n expect(format('Haruto', 2)).toBe(\n 'Haruto, you are the 2nd customer we serve today. Thank you!'\n )\n })\n\n xit('format exceptional ordinal numeral 3', () => {\n expect(format('Henriette', 3)).toBe(\n 'Henriette, you are the 3rd customer we serve today. Thank you!'\n )\n })\n\n xit('format smallest two digit non-exceptional ordinal numeral 10', () => {\n expect(format('Alvarez', 10)).toBe(\n 'Alvarez, you are the 10th customer we serve today. Thank you!'\n )\n })\n\n xit('format non-exceptional ordinal numeral 11', () => {\n expect(format('Jacqueline', 11)).toBe(\n 'Jacqueline, you are the 11th customer we serve today. Thank you!'\n )\n })\n\n xit('format non-exceptional ordinal numeral 12', () => {\n expect(format('Juan', 12)).toBe(\n 'Juan, you are the 12th customer we serve today. Thank you!'\n )\n })\n\n xit('format non-exceptional ordinal numeral 13', () => {\n expect(format('Patricia', 13)).toBe(\n 'Patricia, you are the 13th customer we serve today. Thank you!'\n )\n })\n\n xit('format exceptional ordinal numeral 21', () => {\n expect(format('Washi', 21)).toBe(\n 'Washi, you are the 21st customer we serve today. Thank you!'\n )\n })\n\n xit('format exceptional ordinal numeral 62', () => {\n expect(format('Nayra', 62)).toBe(\n 'Nayra, you are the 62nd customer we serve today. Thank you!'\n )\n })\n\n xit('format exceptional ordinal numeral 100', () => {\n expect(format('John', 100)).toBe(\n 'John, you are the 100th customer we serve today. Thank you!'\n )\n })\n\n xit('format exceptional ordinal numeral 101', () => {\n expect(format('Zeinab', 101)).toBe(\n 'Zeinab, you are the 101st customer we serve today. Thank you!'\n )\n })\n\n xit('format exceptional ordinal numeral 112', () => {\n expect(format('Knud', 112)).toBe(\n 'Knud, you are the 112th customer we serve today. Thank you!'\n )\n })\n\n xit('format exceptional ordinal numeral 123', () => {\n expect(format('Yma', 123)).toBe(\n 'Yma, you are the 123rd customer we serve today. Thank you!'\n )\n })\n})\n" }, { "path": "exercises/practice/line-up/line-up.ts", "content": "export function format(name: unknown, number: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/line-up/package.json", "content": "{\n \"name\": \"@exercism/typescript-line-up\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/line-up/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/line-up/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/linked-list/.docs/instructions.md", "content": "# Instructions\n\nYour team has decided to use a doubly linked list to represent each train route in the schedule.\nEach station along the train's route will be represented by a node in the linked list.\n\nYou don't need to worry about arrival and departure times at the stations.\nEach station will simply be represented by a number.\n\nRoutes can be extended, adding stations to the beginning or end of a route.\nThey can also be shortened by removing stations from the beginning or the end of a route.\n\nSometimes a station gets closed down, and in that case the station needs to be removed from the route, even if it is not at the beginning or end of the route.\n\nThe size of a route is measured not by how far the train travels, but by how many stations it stops at.\n\n~~~~exercism/note\nThe linked list is a fundamental data structure in computer science, often used in the implementation of other data structures.\nAs the name suggests, it is a list of nodes that are linked together.\nIt is a list of \"nodes\", where each node links to its neighbor or neighbors.\nIn a **singly linked list** each node links only to the node that follows it.\nIn a **doubly linked list** each node links to both the node that comes before, as well as the node that comes after.\n\nIf you want to dig deeper into linked lists, check out [this article][intro-linked-list] that explains it using nice drawings.\n\n[intro-linked-list]: https://medium.com/basecs/whats-a-linked-list-anyway-part-1-d8b7e6508b9d\n~~~~\n" }, { "path": "exercises/practice/linked-list/.docs/introduction.md", "content": "# Introduction\n\nYou are working on a project to develop a train scheduling system for a busy railway network.\n\nYou've been asked to develop a prototype for the train routes in the scheduling system.\nEach route consists of a sequence of train stations that a given train stops at.\n" }, { "path": "exercises/practice/linked-list/.meta/config.json", "content": "{\n \"authors\": [\n \"jspengeman\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"linked-list.ts\"\n ],\n \"test\": [\n \"linked-list.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement a doubly linked list.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Classic computer science topic\"\n}\n" }, { "path": "exercises/practice/linked-list/.meta/proof.ci.ts", "content": "class Node {\n private value: T\n private next: Node | undefined\n private prev: Node | undefined\n\n constructor(value: T) {\n this.value = value\n }\n\n public getNext(): Node | undefined {\n return this.next\n }\n\n public setNext(newNext: Node | undefined): void {\n this.next = newNext\n }\n\n public getPrev(): Node | undefined {\n return this.prev\n }\n\n public setPrev(newPrev: Node | undefined): void {\n this.prev = newPrev\n }\n\n public getValue(): T {\n return this.value\n }\n}\n\nexport class LinkedList {\n private head: Node | undefined\n private tail: Node | undefined\n\n public pop(): T | undefined {\n if (!this.head) {\n return undefined\n }\n\n const value = this.head.getValue()\n this.head = this.head.getNext()\n if (this.head) {\n this.head.setPrev(undefined)\n } else {\n this.head = this.tail = undefined\n }\n\n return value\n }\n\n public push(value: T): void {\n if (this.head) {\n const newHead = new Node(value)\n newHead.setNext(this.head)\n this.head.setPrev(newHead)\n this.head = newHead\n } else {\n this.head = new Node(value)\n this.tail = this.head\n }\n }\n\n public shift(): T | undefined {\n if (!this.tail) {\n return undefined\n }\n\n const value = this.tail.getValue()\n this.tail = this.tail.getPrev()\n if (this.tail) {\n this.tail.setNext(undefined)\n } else {\n this.head = this.tail = undefined\n }\n\n return value\n }\n\n public unshift(value: T): void {\n if (this.tail) {\n const newTail = new Node(value)\n newTail.setPrev(this.tail)\n this.tail.setNext(newTail)\n this.tail = newTail\n } else {\n this.tail = new Node(value)\n this.head = this.tail\n }\n }\n\n public count(): number {\n let count = 0\n let element: Node | undefined = this.head\n\n while (this.head && element) {\n count++\n element = element.getNext()\n }\n return count\n }\n\n public delete(value: T): void {\n let element = this.head\n while (element) {\n if (element.getValue() === value) {\n const nextNode = element.getNext()\n const prevNode = element.getPrev()\n\n if (nextNode) {\n nextNode.setPrev(prevNode)\n } else if (this.tail) {\n this.tail = this.tail.getPrev()\n }\n\n if (prevNode) {\n prevNode.setNext(nextNode)\n } else if (this.head) {\n this.head = this.head.getNext()\n }\n\n element = undefined\n } else {\n element = element.getNext()\n }\n }\n }\n}\n" }, { "path": "exercises/practice/linked-list/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/linked-list/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/linked-list/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/linked-list/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/linked-list/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/linked-list/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/linked-list/linked-list.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { LinkedList } from './linked-list.ts'\n\ndescribe('LinkedList', () => {\n it('add/extract elements to the end of the list with push/pop', () => {\n const list = new LinkedList()\n list.push(10)\n list.push(20)\n expect(list.pop()).toBe(20)\n expect(list.pop()).toBe(10)\n })\n\n xit('extract elements from the beginning of the list with shift', () => {\n const list = new LinkedList()\n list.push(10)\n list.push(20)\n expect(list.shift()).toBe(10)\n expect(list.shift()).toBe(20)\n })\n\n xit('add/extract elements from the beginning of the list with unshift/shift', () => {\n const list = new LinkedList()\n list.unshift(10)\n list.unshift(20)\n expect(list.shift()).toBe(20)\n expect(list.shift()).toBe(10)\n })\n\n xit('unshift/pop', () => {\n const list = new LinkedList()\n list.unshift(10)\n list.unshift(20)\n expect(list.pop()).toBe(10)\n expect(list.pop()).toBe(20)\n })\n\n xit('example', () => {\n const list = new LinkedList()\n list.push(10)\n list.push(20)\n expect(list.pop()).toBe(20)\n list.push(30)\n expect(list.shift()).toBe(10)\n list.unshift(40)\n list.push(50)\n expect(list.shift()).toBe(40)\n expect(list.pop()).toBe(50)\n expect(list.shift()).toBe(30)\n })\n\n xit('can count its elements', () => {\n const list = new LinkedList()\n expect(list.count()).toBe(0)\n list.push(10)\n expect(list.count()).toBe(1)\n list.push(20)\n expect(list.count()).toBe(2)\n })\n\n xit('sets head/tail after popping last element', () => {\n const list = new LinkedList()\n list.push(10)\n list.pop()\n list.unshift(20)\n expect(list.count()).toBe(1)\n expect(list.pop()).toBe(20)\n })\n\n xit('sets head/tail after shifting last element', () => {\n const list = new LinkedList()\n list.unshift(10)\n list.shift()\n list.push(20)\n expect(list.count()).toBe(1)\n expect(list.shift()).toBe(20)\n })\n\n xit('deletes the element with the specified value from the list', () => {\n const list = new LinkedList()\n list.push(10)\n list.push(20)\n list.push(30)\n list.delete(20)\n expect(list.count()).toBe(2)\n expect(list.pop()).toBe(30)\n expect(list.shift()).toBe(10)\n })\n\n xit('deletes the only element', () => {\n const list = new LinkedList()\n list.push(10)\n list.delete(10)\n expect(list.count()).toBe(0)\n })\n\n xit('delete does not modify the list if the element is not found', () => {\n const list = new LinkedList()\n list.push(10)\n list.delete(20)\n expect(list.count()).toBe(1)\n })\n})\n" }, { "path": "exercises/practice/linked-list/linked-list.ts", "content": "export class LinkedList {\n public push(element: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public pop(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public shift(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public unshift(element: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public delete(element: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n public count(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/linked-list/package.json", "content": "{\n \"name\": \"@exercism/typescript-linked-list\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/linked-list/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/linked-list/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/list-ops/.docs/instructions.append.md", "content": "# Instructions append\n\nUsing core language features to build and deconstruct arrays via destructuring, and using the array literal `[]` are allowed, but no functions from the `Array.prototype` should be used.\n\nIn order to be able to test your solution, ensure `forEach` is implemented.\n\n```typescript\nconst list = List.create(1, 2)\nlist.forEach((item) => console.log(item))\n// =>\n// 1\n// 2\n```\n" }, { "path": "exercises/practice/list-ops/.docs/instructions.md", "content": "# Instructions\n\nImplement basic list operations.\n\nIn functional languages list operations like `length`, `map`, and `reduce` are very common.\nImplement a series of basic list operations, without using existing functions.\n\nThe precise number and names of the operations to be implemented will be track dependent to avoid conflicts with existing names, but the general operations you will implement include:\n\n- `append` (_given two lists, add all items in the second list to the end of the first list_);\n- `concatenate` (_given a series of lists, combine all items in all lists into one flattened list_);\n- `filter` (_given a predicate and a list, return the list of all items for which `predicate(item)` is True_);\n- `length` (_given a list, return the total number of items within it_);\n- `map` (_given a function and a list, return the list of the results of applying `function(item)` on all items_);\n- `foldl` (_given a function, a list, and initial accumulator, fold (reduce) each item into the accumulator from the left_);\n- `foldr` (_given a function, a list, and an initial accumulator, fold (reduce) each item into the accumulator from the right_);\n- `reverse` (_given a list, return a list with all the original items, but in reversed order_).\n\nNote, the ordering in which arguments are passed to the fold functions (`foldl`, `foldr`) is significant.\n" }, { "path": "exercises/practice/list-ops/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"archanid\",\n \"masters3d\",\n \"paparomeo\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"list-ops.ts\"\n ],\n \"test\": [\n \"list-ops.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement basic list operations.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/list-ops/.meta/proof.ci.ts", "content": "const Null: Cons = {\n get value() {\n return undefined\n },\n get next() {\n return this\n },\n\n get() {\n return this.value\n },\n\n push(item: T): Cons {\n // eslint-disable-next-line @typescript-eslint/no-use-before-define\n return new Cons(item, this) as Cons\n },\n length() {\n return 0\n },\n append(other: Cons): Cons {\n return other\n },\n concatenate(): Cons {\n return this\n },\n forEach(): void {\n /* done */\n },\n foldl(\n _: (initial: TReturn, value: TValue) => TReturn,\n initial?: TReturn\n ): TReturn {\n return initial as TReturn\n },\n foldr(\n _: (initial: TReturn, value: TValue) => TReturn,\n initial?: TReturn\n ): TReturn {\n return initial as TReturn\n },\n filter(): Cons {\n return Null\n },\n reverse(): Cons {\n return this\n },\n map(): Cons {\n return this as Cons\n },\n}\nclass Cons {\n constructor(\n public readonly value: T,\n public next: Cons = Null as Cons\n ) {}\n\n public get(i: number): T | undefined {\n return i === 0 ? this.value : this.next.get(i - 1)\n }\n\n public push(item: T): this {\n this.next = this.next.push(item)\n return this\n }\n\n public length(): number {\n return 1 + this.next.length()\n }\n\n public append(other: Cons): Cons {\n return other.foldl((result, item) => result.push(item), this)\n }\n\n public concatenate(others: Cons>): Cons {\n return others.foldl>((result, other) => result.append(other), this)\n }\n\n public foldl(\n callback: (initial: TReturn, value: T) => TReturn\n ): TReturn\n public foldl(\n callback: (initial: TReturn, value: T) => TReturn,\n initial: TReturn\n ): TReturn\n public foldl(\n callback: (initial: TReturn | undefined, value: T) => TReturn,\n initial?: TReturn\n ): TReturn {\n return this.next.foldl(callback, callback(initial, this.value))\n }\n\n public forEach(callback: (value: T) => void): void {\n this.foldl((_, item) => callback(item))\n }\n\n public foldr(\n callback: (initial: TReturn, value: T) => TReturn\n ): TReturn\n public foldr(\n callback: (initial: TReturn, value: T) => TReturn,\n initial: TReturn\n ): TReturn\n public foldr(\n callback: (initial: TReturn, value: T) => TReturn,\n initial?: TReturn\n ): TReturn {\n return callback(\n this.next.foldr(\n callback as (initial: TReturn, value: T | undefined) => TReturn,\n initial as TReturn\n ),\n this.value\n )\n }\n\n public filter(predicate: (value: T) => boolean): Cons {\n return this.foldl>(\n (result, item) => (predicate(item) && result.push(item)) || result,\n Null as Cons\n )\n }\n\n public map(\n expression: (value: T) => TReturn\n ): Cons {\n return this.foldl(\n (result, item) => result.push(expression(item)),\n Null as Cons\n )\n }\n\n public reverse(): Cons {\n return this.next.reverse().push(this.value)\n }\n}\nexport class List {\n public static create(...values: T[]): Cons {\n const [head, ...tail] = values\n\n if (head === undefined) {\n return Null as Cons\n }\n\n return new Cons(head, List.create(...tail))\n }\n}\n" }, { "path": "exercises/practice/list-ops/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[485b9452-bf94-40f7-a3db-c3cf4850066a]\ndescription = \"append entries to a list and return the new list -> empty lists\"\n\n[2c894696-b609-4569-b149-8672134d340a]\ndescription = \"append entries to a list and return the new list -> list to empty list\"\n\n[e842efed-3bf6-4295-b371-4d67a4fdf19c]\ndescription = \"append entries to a list and return the new list -> empty list to list\"\n\n[71dcf5eb-73ae-4a0e-b744-a52ee387922f]\ndescription = \"append entries to a list and return the new list -> non-empty lists\"\n\n[28444355-201b-4af2-a2f6-5550227bde21]\ndescription = \"concatenate a list of lists -> empty list\"\n\n[331451c1-9573-42a1-9869-2d06e3b389a9]\ndescription = \"concatenate a list of lists -> list of lists\"\n\n[d6ecd72c-197f-40c3-89a4-aa1f45827e09]\ndescription = \"concatenate a list of lists -> list of nested lists\"\n\n[0524fba8-3e0f-4531-ad2b-f7a43da86a16]\ndescription = \"filter list returning only values that satisfy the filter function -> empty list\"\n\n[88494bd5-f520-4edb-8631-88e415b62d24]\ndescription = \"filter list returning only values that satisfy the filter function -> non-empty list\"\n\n[1cf0b92d-8d96-41d5-9c21-7b3c37cb6aad]\ndescription = \"returns the length of a list -> empty list\"\n\n[d7b8d2d9-2d16-44c4-9a19-6e5f237cb71e]\ndescription = \"returns the length of a list -> non-empty list\"\n\n[c0bc8962-30e2-4bec-9ae4-668b8ecd75aa]\ndescription = \"return a list of elements whose values equal the list value transformed by the mapping function -> empty list\"\n\n[11e71a95-e78b-4909-b8e4-60cdcaec0e91]\ndescription = \"return a list of elements whose values equal the list value transformed by the mapping function -> non-empty list\"\n\n[613b20b7-1873-4070-a3a6-70ae5f50d7cc]\ndescription = \"folds (reduces) the given list from the left with a function -> empty list\"\ninclude = false\n\n[e56df3eb-9405-416a-b13a-aabb4c3b5194]\ndescription = \"folds (reduces) the given list from the left with a function -> direction independent function applied to non-empty list\"\ninclude = false\n\n[d2cf5644-aee1-4dfc-9b88-06896676fe27]\ndescription = \"folds (reduces) the given list from the left with a function -> direction dependent function applied to non-empty list\"\ninclude = false\n\n[36549237-f765-4a4c-bfd9-5d3a8f7b07d2]\ndescription = \"folds (reduces) the given list from the left with a function -> empty list\"\nreimplements = \"613b20b7-1873-4070-a3a6-70ae5f50d7cc\"\n\n[7a626a3c-03ec-42bc-9840-53f280e13067]\ndescription = \"folds (reduces) the given list from the left with a function -> direction independent function applied to non-empty list\"\nreimplements = \"e56df3eb-9405-416a-b13a-aabb4c3b5194\"\n\n[d7fcad99-e88e-40e1-a539-4c519681f390]\ndescription = \"folds (reduces) the given list from the left with a function -> direction dependent function applied to non-empty list\"\nreimplements = \"d2cf5644-aee1-4dfc-9b88-06896676fe27\"\n\n[aeb576b9-118e-4a57-a451-db49fac20fdc]\ndescription = \"folds (reduces) the given list from the right with a function -> empty list\"\ninclude = false\n\n[c4b64e58-313e-4c47-9c68-7764964efb8e]\ndescription = \"folds (reduces) the given list from the right with a function -> direction independent function applied to non-empty list\"\ninclude = false\n\n[be396a53-c074-4db3-8dd6-f7ed003cce7c]\ndescription = \"folds (reduces) the given list from the right with a function -> direction dependent function applied to non-empty list\"\ninclude = false\n\n[17214edb-20ba-42fc-bda8-000a5ab525b0]\ndescription = \"folds (reduces) the given list from the right with a function -> empty list\"\nreimplements = \"aeb576b9-118e-4a57-a451-db49fac20fdc\"\n\n[e1c64db7-9253-4a3d-a7c4-5273b9e2a1bd]\ndescription = \"folds (reduces) the given list from the right with a function -> direction independent function applied to non-empty list\"\nreimplements = \"c4b64e58-313e-4c47-9c68-7764964efb8e\"\n\n[8066003b-f2ff-437e-9103-66e6df474844]\ndescription = \"folds (reduces) the given list from the right with a function -> direction dependent function applied to non-empty list\"\nreimplements = \"be396a53-c074-4db3-8dd6-f7ed003cce7c\"\n\n[94231515-050e-4841-943d-d4488ab4ee30]\ndescription = \"reverse the elements of the list -> empty list\"\n\n[fcc03d1e-42e0-4712-b689-d54ad761f360]\ndescription = \"reverse the elements of the list -> non-empty list\"\n\n[40872990-b5b8-4cb8-9085-d91fc0d05d26]\ndescription = \"reverse the elements of the list -> list of lists is not flattened\"\n" }, { "path": "exercises/practice/list-ops/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/list-ops/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/list-ops/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/list-ops/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/list-ops/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/list-ops/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/list-ops/list-ops.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { List } from './list-ops.ts'\nimport type { MatcherFunction } from 'expect'\n\ntype JestUtils = {\n utils: {\n printReceived(object: unknown): string\n }\n}\n\nconst toHaveValues: MatcherFunction = function (\n this: JestUtils,\n received: unknown,\n ...expected: unknown[]\n) {\n if (typeof received !== 'object' || received === null) {\n return {\n pass: false,\n message: () =>\n `Expected ${this.utils.printReceived(received)} to be a non-null object`,\n }\n }\n\n if (!('forEach' in received) || typeof received.forEach !== 'function') {\n return {\n pass: false,\n message: (): string => `Implement .forEach(callback) on your list`,\n }\n }\n\n const values: unknown[] = []\n // eslint-disable-next-line @typescript-eslint/no-unsafe-call\n received.forEach((item: unknown) => {\n values.push(item)\n })\n\n const pass = JSON.stringify(values) === JSON.stringify(expected)\n return {\n pass,\n message: (): string =>\n pass\n ? ''\n : `Expected to see the following values: ${JSON.stringify(\n expected\n )}, actual: ${JSON.stringify(values)}`,\n }\n}\n\nexpect.extend({\n toHaveValues,\n})\n\ndeclare module 'expect' {\n interface AsymmetricMatchers {\n toHaveValues(...expected: unknown[]): void\n }\n interface Matchers {\n toHaveValues(...expected: unknown[]): R\n }\n}\n\ndescribe('append entries to a list and return the new list', () => {\n it('empty lists', () => {\n const list1 = List.create()\n const list2 = List.create()\n expect(list1.append(list2)).toEqual(List.create())\n })\n\n xit('list to empty list', () => {\n const list1 = List.create()\n const list2 = List.create(1, 2, 3, 4)\n expect(list1.append(list2)).toEqual(list2)\n })\n\n xit('empty list to list', () => {\n const list1 = List.create(1, 2, 3, 4)\n const list2 = List.create()\n expect(list1.append(list2)).toEqual(list1)\n })\n\n xit('non-empty lists', () => {\n const list1 = List.create(1, 2)\n const list2 = List.create(2, 3, 4, 5)\n expect(list1.append(list2)).toHaveValues(1, 2, 2, 3, 4, 5)\n })\n})\n\ndescribe('concatenate lists and lists of lists into new list', () => {\n xit('empty list', () => {\n const list1 = List.create()\n const list2 = List.create>()\n expect(list1.concatenate(list2)).toHaveValues()\n })\n\n xit('list of lists', () => {\n const list1 = List.create(1, 2)\n const list2 = List.create(3)\n const list3 = List.create()\n const list4 = List.create(4, 5, 6)\n const listOfLists = List.create(list2, list3, list4)\n expect(list1.concatenate(listOfLists)).toHaveValues(1, 2, 3, 4, 5, 6)\n })\n})\n\ndescribe('filter list returning only values that satisfy the filter function', () => {\n xit('empty list', () => {\n const list1 = List.create()\n expect(list1.filter((el) => el % 2 === 1)).toHaveValues()\n })\n\n xit('non empty list', () => {\n const list1 = List.create(1, 2, 3, 5)\n expect(list1.filter((el) => el % 2 === 1)).toHaveValues(1, 3, 5)\n })\n})\n\ndescribe('returns the length of a list', () => {\n xit('empty list', () => {\n const list1 = List.create()\n expect(list1.length()).toEqual(0)\n })\n\n xit('non-empty list', () => {\n const list1 = List.create(1, 2, 3, 4)\n expect(list1.length()).toEqual(4)\n })\n})\n\ndescribe('returns a list of elements whose values equal the list value transformed by the mapping function', () => {\n xit('empty list', () => {\n const list1 = List.create()\n expect(list1.map((el) => ++el)).toHaveValues()\n })\n\n xit('non-empty list', () => {\n const list1 = List.create(1, 3, 5, 7)\n expect(list1.map((el) => ++el)).toHaveValues(2, 4, 6, 8)\n })\n})\n\ndescribe('folds (reduces) the given list from the left with a function', () => {\n xit('empty list', () => {\n const list1 = List.create()\n expect(list1.foldl((acc, el) => el * acc, 2)).toEqual(2)\n })\n\n xit('direction independent function applied to non-empty list', () => {\n const list1 = List.create(1, 2, 3, 4)\n expect(list1.foldl((acc, el) => acc + el, 5)).toEqual(15)\n })\n\n xit('direction dependent function applied to non-empty list', () => {\n const list1 = List.create(1, 2, 3, 4)\n expect(list1.foldl((acc, el) => el / acc, 24)).toEqual(64)\n })\n})\n\ndescribe('folds (reduces) the given list from the right with a function', () => {\n xit('empty list', () => {\n const list1 = List.create()\n expect(list1.foldr((acc, el) => el * acc, 2)).toEqual(2)\n })\n\n xit('direction independent function applied to non-empty list', () => {\n const list1 = List.create(1, 2, 3, 4)\n expect(list1.foldr((acc, el) => acc + el, 5)).toEqual(15)\n })\n\n xit('direction dependent function applied to non-empty list', () => {\n const list1 = List.create(1, 2, 3, 4)\n expect(list1.foldr((acc, el) => el / acc, 24)).toEqual(9)\n })\n})\n\ndescribe('reverse the elements of a list', () => {\n xit('empty list', () => {\n const list1 = List.create()\n expect(list1.reverse()).toHaveValues()\n })\n\n xit('non-empty list', () => {\n const list1 = List.create(1, 3, 5, 7)\n expect(list1.reverse()).toHaveValues(7, 5, 3, 1)\n })\n\n xit('list of lists is not flattened', () => {\n const list1 = List.create([1, 2], [3], [], [4, 5, 6])\n expect(list1.reverse()).toHaveValues([4, 5, 6], [], [3], [1, 2])\n })\n})\n" }, { "path": "exercises/practice/list-ops/list-ops.ts", "content": "export class List {\n public static create(...values: unknown[]): unknown {\n // Do *not* construct any array literal ([]) in your solution.\n // Do *not* construct any arrays through new Array in your solution.\n // DO *not* use any of the Array.prototype methods in your solution.\n\n // You may use the destructuring and spreading (...) syntax from Iterable.\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/list-ops/package.json", "content": "{\n \"name\": \"@exercism/typescript-list-ops\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/list-ops/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/list-ops/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/luhn/.docs/instructions.md", "content": "# Instructions\n\nDetermine whether a number is valid according to the [Luhn formula][luhn].\n\nThe number will be provided as a string.\n\n## Validating a number\n\nStrings of length 1 or less are not valid.\nSpaces are allowed in the input, but they should be stripped before checking.\nAll other non-digit characters are disallowed.\n\n## Examples\n\n### Valid credit card number\n\nThe number to be checked is `4539 3195 0343 6467`.\n\nThe first step of the Luhn algorithm is to start at the end of the number and double every second digit, beginning with the second digit from the right and moving left.\n\n```text\n4539 3195 0343 6467\nā†‘ ā†‘ ā†‘ ā†‘ ā†‘ ā†‘ ā†‘ ā†‘ (double these)\n```\n\nIf the result of doubling a digit is greater than 9, we subtract 9 from that result.\nWe end up with:\n\n```text\n8569 6195 0383 3437\n```\n\nFinally, we sum all digits.\nIf the sum is evenly divisible by 10, the original number is valid.\n\n```text\n8 + 5 + 6 + 9 + 6 + 1 + 9 + 5 + 0 + 3 + 8 + 3 + 3 + 4 + 3 + 7 = 80\n```\n\n80 is evenly divisible by 10, so number `4539 3195 0343 6467` is valid!\n\n### Invalid Canadian SIN\n\nThe number to be checked is `066 123 478`.\n\nWe start at the end of the number and double every second digit, beginning with the second digit from the right and moving left.\n\n```text\n066 123 478\n ā†‘ ā†‘ ā†‘ ā†‘ (double these)\n```\n\nIf the result of doubling a digit is greater than 9, we subtract 9 from that result.\nWe end up with:\n\n```text\n036 226 458\n```\n\nWe sum the digits:\n\n```text\n0 + 3 + 6 + 2 + 2 + 6 + 4 + 5 + 8 = 36\n```\n\n36 is not evenly divisible by 10, so number `066 123 478` is not valid!\n\n[luhn]: https://en.wikipedia.org/wiki/Luhn_algorithm\n" }, { "path": "exercises/practice/luhn/.docs/introduction.md", "content": "# Introduction\n\nAt the Global Verification Authority, you've just been entrusted with a critical assignment.\nAcross the city, from online purchases to secure logins, countless operations rely on the accuracy of numerical identifiers like credit card numbers, bank account numbers, transaction codes, and tracking IDs.\nThe Luhn algorithm is a simple checksum formula used to help identify mistyped numbers.\n\nA batch of identifiers has just arrived on your desk.\nAll of them must pass the Luhn test to ensure they're legitimate.\nIf any fail, they'll be flagged as invalid, preventing mistakes such as incorrect transactions or failed account verifications.\n\nCan you ensure this is done right? The integrity of many services depends on you.\n" }, { "path": "exercises/practice/luhn/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\",\n \"angelikatyborska\"\n ],\n \"files\": {\n \"solution\": [\n \"luhn.ts\"\n ],\n \"test\": [\n \"luhn.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a number determine whether or not it is valid per the Luhn formula.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"The Luhn Algorithm on Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Luhn_algorithm\"\n}\n" }, { "path": "exercises/practice/luhn/.meta/proof.ci.ts", "content": "export function valid(value: string): boolean {\n const valueWithoutSpaces = value.replace(/\\s/g, '')\n const digits = [...valueWithoutSpaces]\n\n const sum = digits\n // convert to integers\n .map((d) => parseInt(d, 10))\n .reverse()\n // double even positions (odd indexes)\n .map((d, i) => {\n if (i % 2 !== 0) {\n return d * 2\n }\n return d\n })\n // limit to digits less than 10\n .map((d) => {\n if (d > 9) {\n return d - 9\n }\n return d\n })\n // sum all digits\n .reduce((d, acc) => d + acc, 0)\n\n return valueWithoutSpaces.length > 1 && sum % 10 === 0\n}\n" }, { "path": "exercises/practice/luhn/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[792a7082-feb7-48c7-b88b-bbfec160865e]\ndescription = \"single digit strings can not be valid\"\n\n[698a7924-64d4-4d89-8daa-32e1aadc271e]\ndescription = \"a single zero is invalid\"\n\n[73c2f62b-9b10-4c9f-9a04-83cee7367965]\ndescription = \"a simple valid SIN that remains valid if reversed\"\n\n[9369092e-b095-439f-948d-498bd076be11]\ndescription = \"a simple valid SIN that becomes invalid if reversed\"\n\n[8f9f2350-1faf-4008-ba84-85cbb93ffeca]\ndescription = \"a valid Canadian SIN\"\n\n[1cdcf269-6560-44fc-91f6-5819a7548737]\ndescription = \"invalid Canadian SIN\"\n\n[656c48c1-34e8-4e60-9a5a-aad8a367810a]\ndescription = \"invalid credit card\"\n\n[20e67fad-2121-43ed-99a8-14b5b856adb9]\ndescription = \"invalid long number with an even remainder\"\n\n[7e7c9fc1-d994-457c-811e-d390d52fba5e]\ndescription = \"invalid long number with a remainder divisible by 5\"\n\n[ad2a0c5f-84ed-4e5b-95da-6011d6f4f0aa]\ndescription = \"valid number with an even number of digits\"\n\n[ef081c06-a41f-4761-8492-385e13c8202d]\ndescription = \"valid number with an odd number of spaces\"\n\n[bef66f64-6100-4cbb-8f94-4c9713c5e5b2]\ndescription = \"valid strings with a non-digit added at the end become invalid\"\n\n[2177e225-9ce7-40f6-b55d-fa420e62938e]\ndescription = \"valid strings with punctuation included become invalid\"\n\n[ebf04f27-9698-45e1-9afe-7e0851d0fe8d]\ndescription = \"valid strings with symbols included become invalid\"\n\n[08195c5e-ce7f-422c-a5eb-3e45fece68ba]\ndescription = \"single zero with space is invalid\"\n\n[12e63a3c-f866-4a79-8c14-b359fc386091]\ndescription = \"more than a single zero is valid\"\n\n[ab56fa80-5de8-4735-8a4a-14dae588663e]\ndescription = \"input digit 9 is correctly converted to output digit 9\"\n\n[b9887ee8-8337-46c5-bc45-3bcab51bc36f]\ndescription = \"very long input is valid\"\n\n[8a7c0e24-85ea-4154-9cf1-c2db90eabc08]\ndescription = \"valid luhn with an odd number of digits and non zero first digit\"\n\n[39a06a5a-5bad-4e0f-b215-b042d46209b1]\ndescription = \"using ascii value for non-doubled non-digit isn't allowed\"\n\n[f94cf191-a62f-4868-bc72-7253114aa157]\ndescription = \"using ascii value for doubled non-digit isn't allowed\"\n\n[8b72ad26-c8be-49a2-b99c-bcc3bf631b33]\ndescription = \"non-numeric, non-space char in the middle with a sum that's divisible by 10 isn't allowed\"\n" }, { "path": "exercises/practice/luhn/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/luhn/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/luhn/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/luhn/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/luhn/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/luhn/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/luhn/luhn.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { valid } from './luhn.ts'\n\ndescribe('Luhn', () => {\n it('single digit strings can not be valid', () => {\n expect(valid('1')).toBeFalsy()\n })\n\n xit('a single zero is invalid', () => {\n expect(valid('0')).toBeFalsy()\n })\n\n xit('a simple valid SIN that remains valid if reversed', () => {\n expect(valid('059')).toBeTruthy()\n })\n\n xit('a simple valid SIN that becomes invalid if reversed', () => {\n expect(valid('59')).toBeTruthy()\n })\n\n xit('a valid Canadian SIN', () => {\n expect(valid('055 444 285')).toBeTruthy()\n })\n\n xit('invalid Canadian SIN', () => {\n expect(valid('055 444 286')).toBeFalsy()\n })\n\n xit('invalid credit card', () => {\n expect(valid('8273 1232 7352 0569')).toBeFalsy()\n })\n\n xit('invalid long number with an even remainder', () => {\n expect(valid('1 2345 6789 1234 5678 9012')).toBeFalsy()\n })\n\n xit('invalid long number with a remainder divisible by 5', () => {\n expect(valid('1 2345 6789 1234 5678 9013')).toBeFalsy()\n })\n\n xit('valid number with an even number of digits', () => {\n expect(valid('095 245 88')).toBeTruthy()\n })\n\n xit('valid number with an odd number of spaces', () => {\n expect(valid('234 567 891 234')).toBeTruthy()\n })\n\n xit('valid strings with a non-digit added at the end become invalid', () => {\n expect(valid('059a')).toBeFalsy()\n })\n\n xit('valid strings with punctuation included become invalid', () => {\n expect(valid('055-444-285')).toBeFalsy()\n })\n\n xit('valid strings with symbols included become invalid', () => {\n expect(valid('055# 444$ 285')).toBeFalsy()\n })\n\n xit('single zero with space is invalid', () => {\n expect(valid(' 0')).toBeFalsy()\n })\n\n xit('more than a single zero is valid', () => {\n expect(valid('0000 0')).toBeTruthy()\n })\n\n xit('input digit 9 is correctly converted to output digit 9', () => {\n expect(valid('091')).toBeTruthy()\n })\n\n xit('very long input is valid', () => {\n expect(valid('9999999999 9999999999 9999999999 9999999999')).toBeTruthy()\n })\n\n xit('valid luhn with an odd number of digits and non zero first digit', () => {\n expect(valid('109')).toBeTruthy()\n })\n\n xit(\"using ascii value for non-doubled non-digit isn't allowed\", () => {\n expect(valid('055b 444 285')).toBeFalsy()\n })\n\n xit(\"using ascii value for doubled non-digit isn't allowed\", () => {\n expect(valid(':9')).toBeFalsy()\n })\n\n xit(\"non-numeric, non-space char in the middle with a sum that's divisible by 10 isn't allowed\", () => {\n expect(valid('59%59')).toBeFalsy()\n })\n})\n" }, { "path": "exercises/practice/luhn/luhn.ts", "content": "export function valid(digitString: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/luhn/package.json", "content": "{\n \"name\": \"@exercism/typescript-luhn\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/luhn/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/luhn/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/matching-brackets/.docs/instructions.md", "content": "# Instructions\n\nGiven a string containing brackets `[]`, braces `{}`, parentheses `()`, or any combination thereof, verify that any and all pairs are matched and nested correctly.\nAny other characters should be ignored.\nFor example, `\"{what is (42)}?\"` is balanced and `\"[text}\"` is not.\n" }, { "path": "exercises/practice/matching-brackets/.docs/introduction.md", "content": "# Introduction\n\nYou're given the opportunity to write software for the Bracketeerā„¢, an ancient but powerful mainframe.\nThe software that runs on it is written in a proprietary language.\nMuch of its syntax is familiar, but you notice _lots_ of brackets, braces and parentheses.\nDespite the Bracketeerā„¢ being powerful, it lacks flexibility.\nIf the source code has any unbalanced brackets, braces or parentheses, the Bracketeerā„¢ crashes and must be rebooted.\nTo avoid such a scenario, you start writing code that can verify that brackets, braces, and parentheses are balanced before attempting to run it on the Bracketeerā„¢.\n" }, { "path": "exercises/practice/matching-brackets/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"matching-brackets.ts\"\n ],\n \"test\": [\n \"matching-brackets.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Make sure the brackets and braces all match.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Ginna Baker\"\n}\n" }, { "path": "exercises/practice/matching-brackets/.meta/proof.ci.ts", "content": "type LeftBracket = '(' | '[' | '{'\ntype RightBracket = ')' | ']' | '}'\ntype AnyBracket = LeftBracket | RightBracket\n\nfunction bracketsAreMatching(\n leftBracket: AnyBracket,\n rightBracket: AnyBracket\n): boolean {\n return (\n (leftBracket === '(' && rightBracket === ')') ||\n (leftBracket === '[' && rightBracket === ']') ||\n (leftBracket === '{' && rightBracket === '}')\n )\n}\n\nexport function isPaired(input: string): boolean {\n const brackets = input.replace(/[^{([\\])}]/g, '')\n\n const openBrackets: AnyBracket[] = []\n\n for (const letter of brackets) {\n const bracket = letter as AnyBracket\n if (openBrackets.length >= 1) {\n const lastBracket = openBrackets[openBrackets.length - 1]\n if (bracketsAreMatching(lastBracket, bracket)) {\n openBrackets.pop()\n } else {\n openBrackets.push(bracket)\n }\n } else {\n openBrackets.push(bracket)\n }\n }\n return openBrackets.length === 0\n}\n" }, { "path": "exercises/practice/matching-brackets/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[81ec11da-38dd-442a-bcf9-3de7754609a5]\ndescription = \"paired square brackets\"\n\n[287f0167-ac60-4b64-8452-a0aa8f4e5238]\ndescription = \"empty string\"\n\n[6c3615a3-df01-4130-a731-8ef5f5d78dac]\ndescription = \"unpaired brackets\"\n\n[9d414171-9b98-4cac-a4e5-941039a97a77]\ndescription = \"wrong ordered brackets\"\n\n[f0f97c94-a149-4736-bc61-f2c5148ffb85]\ndescription = \"wrong closing bracket\"\n\n[754468e0-4696-4582-a30e-534d47d69756]\ndescription = \"paired with whitespace\"\n\n[ba84f6ee-8164-434a-9c3e-b02c7f8e8545]\ndescription = \"partially paired brackets\"\n\n[3c86c897-5ff3-4a2b-ad9b-47ac3a30651d]\ndescription = \"simple nested brackets\"\n\n[2d137f2c-a19e-4993-9830-83967a2d4726]\ndescription = \"several paired brackets\"\n\n[2e1f7b56-c137-4c92-9781-958638885a44]\ndescription = \"paired and nested brackets\"\n\n[84f6233b-e0f7-4077-8966-8085d295c19b]\ndescription = \"unopened closing brackets\"\n\n[9b18c67d-7595-4982-b2c5-4cb949745d49]\ndescription = \"unpaired and nested brackets\"\n\n[a0205e34-c2ac-49e6-a88a-899508d7d68e]\ndescription = \"paired and wrong nested brackets\"\n\n[1d5c093f-fc84-41fb-8c2a-e052f9581602]\ndescription = \"paired and wrong nested brackets but innermost are correct\"\n\n[ef47c21b-bcfd-4998-844c-7ad5daad90a8]\ndescription = \"paired and incomplete brackets\"\n\n[a4675a40-a8be-4fc2-bc47-2a282ce6edbe]\ndescription = \"too many closing brackets\"\n\n[a345a753-d889-4b7e-99ae-34ac85910d1a]\ndescription = \"early unexpected brackets\"\n\n[21f81d61-1608-465a-b850-baa44c5def83]\ndescription = \"early mismatched brackets\"\n\n[99255f93-261b-4435-a352-02bdecc9bdf2]\ndescription = \"math expression\"\n\n[8e357d79-f302-469a-8515-2561877256a1]\ndescription = \"complex latex expression\"\n" }, { "path": "exercises/practice/matching-brackets/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/matching-brackets/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/matching-brackets/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/matching-brackets/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/matching-brackets/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/matching-brackets/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/matching-brackets/matching-brackets.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { isPaired } from './matching-brackets.ts'\n\ndescribe('Matching Brackets', () => {\n it('paired square brackets', () => {\n expect(isPaired('[]')).toEqual(true)\n })\n\n xit('empty string', () => {\n expect(isPaired('')).toEqual(true)\n })\n\n xit('unpaired brackets', () => {\n expect(isPaired('[[')).toEqual(false)\n })\n\n xit('wrong ordered brackets', () => {\n expect(isPaired('}{')).toEqual(false)\n })\n\n xit('wrong closing bracket', () => {\n expect(isPaired('{]')).toEqual(false)\n })\n\n xit('paired with whitespace', () => {\n expect(isPaired('{ }')).toEqual(true)\n })\n\n xit('partially paired brackets', () => {\n expect(isPaired('{[])')).toEqual(false)\n })\n\n xit('simple nested brackets', () => {\n expect(isPaired('{[]}')).toEqual(true)\n })\n\n xit('several paired brackets', () => {\n expect(isPaired('{}[]')).toEqual(true)\n })\n\n xit('paired and nested brackets', () => {\n expect(isPaired('([{}({}[])])')).toEqual(true)\n })\n\n xit('unopened closing brackets', () => {\n expect(isPaired('{[)][]}')).toEqual(false)\n })\n\n xit('unpaired and nested brackets', () => {\n expect(isPaired('([{])')).toEqual(false)\n })\n\n xit('paired and wrong nested brackets', () => {\n expect(isPaired('[({]})')).toEqual(false)\n })\n\n xit('paired and wrong nested brackets but innermost are correct', () => {\n expect(isPaired('[({}])')).toEqual(false)\n })\n\n xit('paired and incomplete brackets', () => {\n expect(isPaired('{}[')).toEqual(false)\n })\n\n xit('too many closing brackets', () => {\n expect(isPaired('[]]')).toEqual(false)\n })\n\n xit('early unexpected brackets', () => {\n expect(isPaired(')()')).toEqual(false)\n })\n\n xit('early mismatched brackets', () => {\n expect(isPaired('{)()')).toEqual(false)\n })\n\n xit('math expression', () => {\n expect(isPaired('(((185 + 223.85) * 15) - 543)/2')).toEqual(true)\n })\n\n xit('complex latex expression', () => {\n expect(\n isPaired(\n '\\\\left(\\\\begin{array}{cc} \\\\frac{1}{3} & x\\\\\\\\ \\\\mathrm{e}^{x} &... x^2 \\\\end{array}\\\\right)'\n )\n ).toEqual(true)\n })\n})\n" }, { "path": "exercises/practice/matching-brackets/matching-brackets.ts", "content": "export function isPaired(input: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/matching-brackets/package.json", "content": "{\n \"name\": \"@exercism/typescript-matching-brackets\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/matching-brackets/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/matching-brackets/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/matrix/.docs/instructions.md", "content": "# Instructions\n\nGiven a string representing a matrix of numbers, return the rows and columns of that matrix.\n\nSo given a string with embedded newlines like:\n\n```text\n9 8 7\n5 3 2\n6 6 7\n```\n\nrepresenting this matrix:\n\n```text\n 1 2 3\n |---------\n1 | 9 8 7\n2 | 5 3 2\n3 | 6 6 7\n```\n\nyour code should be able to spit out:\n\n- A list of the rows, reading each row left-to-right while moving top-to-bottom across the rows,\n- A list of the columns, reading each column top-to-bottom while moving from left-to-right.\n\nThe rows for our example matrix:\n\n- 9, 8, 7\n- 5, 3, 2\n- 6, 6, 7\n\nAnd its columns:\n\n- 9, 5, 6\n- 8, 3, 6\n- 7, 2, 7\n" }, { "path": "exercises/practice/matrix/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"matrix.ts\"\n ],\n \"test\": [\n \"matrix.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a string representing a matrix of numbers, return the rows and columns of that matrix.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Exercise by the JumpstartLab team for students at The Turing School of Software and Design.\",\n \"source_url\": \"https://www.turing.edu/\"\n}\n" }, { "path": "exercises/practice/matrix/.meta/proof.ci.ts", "content": "export class Matrix {\n private description: string\n public rows: number[][] = new Array()\n public columns: number[][] = new Array()\n\n constructor(description: string) {\n this.description = description\n this.parseMatrix()\n }\n\n private parseMatrix(): void {\n this.parseRows()\n this.parseColumns()\n }\n\n private parseRows(): void {\n this.rows = this.description.split('\\n').map((row) => {\n return row.split(' ').map((char) => {\n return parseInt(char, 10)\n })\n })\n }\n\n private parseColumns(): void {\n const rowsLength = this.rows.length\n const columnsLength = this.rows[0].length\n for (let i = 0; i < columnsLength; i++) {\n this.columns.push([])\n for (let j = 0; j < rowsLength; j++) {\n this.columns[i].push(this.rows[j][i])\n }\n }\n }\n}\n" }, { "path": "exercises/practice/matrix/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[ca733dab-9d85-4065-9ef6-a880a951dafd]\ndescription = \"extract row from one number matrix\"\n\n[5c93ec93-80e1-4268-9fc2-63bc7d23385c]\ndescription = \"can extract row\"\n\n[2f1aad89-ad0f-4bd2-9919-99a8bff0305a]\ndescription = \"extract row where numbers have different widths\"\n\n[68f7f6ba-57e2-4e87-82d0-ad09889b5204]\ndescription = \"can extract row from non-square matrix with no corresponding column\"\n\n[e8c74391-c93b-4aed-8bfe-f3c9beb89ebb]\ndescription = \"extract column from one number matrix\"\n\n[7136bdbd-b3dc-48c4-a10c-8230976d3727]\ndescription = \"can extract column\"\n\n[ad64f8d7-bba6-4182-8adf-0c14de3d0eca]\ndescription = \"can extract column from non-square matrix with no corresponding row\"\n\n[9eddfa5c-8474-440e-ae0a-f018c2a0dd89]\ndescription = \"extract column where numbers have different widths\"\n" }, { "path": "exercises/practice/matrix/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/matrix/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/matrix/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/matrix/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/matrix/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/matrix/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/matrix/matrix.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Matrix } from './matrix.ts'\n\ndescribe('Matrix', () => {\n it('extract row from one number matrix', () => {\n const expected = [1]\n expect(new Matrix('1').rows[0]).toEqual(expected)\n })\n\n xit('can extract row', () => {\n const expected = [3, 4]\n expect(new Matrix('1 2\\n3 4').rows[1]).toEqual(expected)\n })\n\n xit('extract row where numbers have different widths', () => {\n const expected = [10, 20]\n expect(new Matrix('1 2\\n10 20').rows[1]).toEqual(expected)\n })\n\n xit('can extract row from non-square matrix', () => {\n const expected = [7, 8, 9]\n expect(new Matrix('1 2 3\\n4 5 6\\n7 8 9\\n8 7 6').rows[2]).toEqual(expected)\n })\n\n xit('extract column from one number matrix', () => {\n const expected = [1]\n expect(new Matrix('1').columns[0]).toEqual(expected)\n })\n\n xit('can extract column', () => {\n const expected = [3, 6, 9]\n expect(new Matrix('1 2 3\\n4 5 6\\n7 8 9').columns[2]).toEqual(expected)\n })\n\n xit('can extract column from non-square matrix', () => {\n const expected = [3, 6, 9, 6]\n expect(new Matrix('1 2 3\\n4 5 6\\n7 8 9\\n8 7 6').columns[2]).toEqual(\n expected\n )\n })\n\n xit('extract column where numbers have different widths', () => {\n const expected = [1903, 3, 4]\n expect(new Matrix('89 1903 3\\n18 3 1\\n9 4 800').columns[1]).toEqual(\n expected\n )\n })\n})\n" }, { "path": "exercises/practice/matrix/matrix.ts", "content": "export class Matrix {\n constructor() {\n throw new Error('Remove this line and implement the function')\n }\n\n get rows(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n get columns(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/matrix/package.json", "content": "{\n \"name\": \"@exercism/typescript-matrix\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/matrix/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/matrix/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/minesweeper/.docs/instructions.md", "content": "# Instructions\n\nYour task is to add the mine counts to empty squares in a completed Minesweeper board.\nThe board itself is a rectangle composed of squares that are either empty (`' '`) or a mine (`'*'`).\n\nFor each empty square, count the number of mines adjacent to it (horizontally, vertically, diagonally).\nIf the empty square has no adjacent mines, leave it empty.\nOtherwise replace it with the adjacent mines count.\n\nFor example, you may receive a 5 x 4 board like this (empty spaces are represented here with the 'Ā·' character for display on screen):\n\n```text\nĀ·*Ā·*Ā·\nĀ·Ā·*Ā·Ā·\nĀ·Ā·*Ā·Ā·\nĀ·Ā·Ā·Ā·Ā·\n```\n\nWhich your code should transform into this:\n\n```text\n1*3*1\n13*31\nĀ·2*2Ā·\nĀ·111Ā·\n```\n" }, { "path": "exercises/practice/minesweeper/.docs/introduction.md", "content": "# Introduction\n\n[Minesweeper][wikipedia] is a popular game where the user has to find the mines using numeric hints that indicate how many mines are directly adjacent (horizontally, vertically, diagonally) to a square.\n\n[wikipedia]: https://en.wikipedia.org/wiki/Minesweeper_(video_game)\n" }, { "path": "exercises/practice/minesweeper/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"iignatov\",\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"minesweeper.ts\"\n ],\n \"test\": [\n \"minesweeper.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Add the numbers to a minesweeper board.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/minesweeper/.meta/proof.ci.ts", "content": "const MINE = '*'\n\nconst DELTAS = [\n [-1, -1],\n [-1, 0],\n [-1, 1],\n [1, 1],\n [1, 0],\n [1, -1],\n [0, 1],\n [0, -1],\n]\n\nexport function annotate(rows: string[]): string[] {\n if (noDataPresent(rows)) {\n return rows\n }\n\n const inputBoard = rows.map((row) => [...row])\n\n const result = inputBoard.map((row, x) =>\n [...row].map((cell, y) => cellToMineOrCount(cell, inputBoard, x, y))\n )\n\n return stringify(result as string[][])\n}\n\nfunction cellToMineOrCount(\n cell: string,\n inputBoard: string[][],\n x: number,\n y: number\n): number | '*' | ' ' {\n if (cell === MINE) {\n return MINE\n }\n return countAdjacentMines(inputBoard, x, y) || ' '\n}\n\nfunction countAdjacentMines(board: string[][], x: number, y: number): number {\n return DELTAS.filter((d) => adjacentSquareIsOnBoard(board, x, d)).filter(\n (d) => adjacentSquareHasMine(board, x, y, d)\n ).length\n}\n\nfunction stringify(board: string[][]): string[] {\n return board.map((row) => row.join(''))\n}\n\nfunction noDataPresent(rows: string[]): boolean {\n return rows.length === 0 || rows[0].length === 0\n}\n\nfunction adjacentSquareIsOnBoard(\n board: string[][],\n x: number,\n d: number[]\n): string[] {\n return board[x + d[0]]\n}\n\nfunction adjacentSquareHasMine(\n board: string[][],\n x: number,\n y: number,\n d: number[]\n): boolean {\n return board[x + d[0]][y + d[1]] === MINE\n}\n" }, { "path": "exercises/practice/minesweeper/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[0c5ec4bd-dea7-4138-8651-1203e1cb9f44]\ndescription = \"no rows\"\n\n[650ac4c0-ad6b-4b41-acde-e4ea5852c3b8]\ndescription = \"no columns\"\n\n[6fbf8f6d-a03b-42c9-9a58-b489e9235478]\ndescription = \"no mines\"\n\n[61aff1c4-fb31-4078-acad-cd5f1e635655]\ndescription = \"minefield with only mines\"\n\n[84167147-c504-4896-85d7-246b01dea7c5]\ndescription = \"mine surrounded by spaces\"\n\n[cb878f35-43e3-4c9d-93d9-139012cccc4a]\ndescription = \"space surrounded by mines\"\n\n[7037f483-ddb4-4b35-b005-0d0f4ef4606f]\ndescription = \"horizontal line\"\n\n[e359820f-bb8b-4eda-8762-47b64dba30a6]\ndescription = \"horizontal line, mines at edges\"\n\n[c5198b50-804f-47e9-ae02-c3b42f7ce3ab]\ndescription = \"vertical line\"\n\n[0c79a64d-703d-4660-9e90-5adfa5408939]\ndescription = \"vertical line, mines at edges\"\n\n[4b098563-b7f3-401c-97c6-79dd1b708f34]\ndescription = \"cross\"\n\n[04a260f1-b40a-4e89-839e-8dd8525abe0e]\ndescription = \"large minefield\"\n" }, { "path": "exercises/practice/minesweeper/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/minesweeper/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/minesweeper/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/minesweeper/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/minesweeper/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/minesweeper/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/minesweeper/minesweeper.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { annotate } from './minesweeper.ts'\n\ndescribe('Minesweeper annotate', () => {\n it('handles no rows', () => {\n expect(annotate([])).toEqual([])\n })\n\n xit('handles no columns', () => {\n expect(annotate([''])).toEqual([''])\n })\n\n xit('handles no mines', () => {\n const input = [' ', ' ', ' ']\n const expected = [' ', ' ', ' ']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles board with only mines', () => {\n const input = ['***', '***', '***']\n const expected = ['***', '***', '***']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles mine surrounded by spaces', () => {\n const input = [' ', ' * ', ' ']\n const expected = ['111', '1*1', '111']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles space surrounded by mines', () => {\n const input = ['***', '* *', '***']\n const expected = ['***', '*8*', '***']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles horizontal line', () => {\n const input = [' * * ']\n const expected = ['1*2*1']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles horizontal line, mines at edges', () => {\n const input = ['* *']\n const expected = ['*1 1*']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles vertical line', () => {\n const input = [' ', '*', ' ', '*', ' ']\n const expected = ['1', '*', '2', '*', '1']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles vertical line, mines at edges', () => {\n const input = ['*', ' ', ' ', ' ', '*']\n const expected = ['*', '1', ' ', '1', '*']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles cross', () => {\n const input = [' * ', ' * ', '*****', ' * ', ' * ']\n const expected = [' 2*2 ', '25*52', '*****', '25*52', ' 2*2 ']\n expect(annotate(input)).toEqual(expected)\n })\n\n xit('handles large board', () => {\n const input = [' * * ', ' * ', ' * ', ' * *', ' * * ', ' ']\n const expected = [\n '1*22*1',\n '12*322',\n ' 123*2',\n '112*4*',\n '1*22*2',\n '111111',\n ]\n expect(annotate(input)).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/minesweeper/minesweeper.ts", "content": "export function annotate(field: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/minesweeper/package.json", "content": "{\n \"name\": \"@exercism/typescript-minesweeper\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/minesweeper/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/minesweeper/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/nth-prime/.docs/instructions.md", "content": "# Instructions\n\nGiven a number n, determine what the nth prime is.\n\nBy listing the first six prime numbers: 2, 3, 5, 7, 11, and 13, we can see that the 6th prime is 13.\n\nIf your language provides methods in the standard library to deal with prime numbers, pretend they don't exist and implement them yourself.\n" }, { "path": "exercises/practice/nth-prime/.meta/config.json", "content": "{\n \"authors\": [],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"nth-prime.ts\"\n ],\n \"test\": [\n \"nth-prime.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a number n, determine what the nth prime is.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A variation on Problem 7 at Project Euler\",\n \"source_url\": \"https://projecteuler.net/problem=7\"\n}\n" }, { "path": "exercises/practice/nth-prime/.meta/proof.ci.ts", "content": "const isPrime = (n: number): boolean => {\n for (let i = 2; i * i <= n; i++) {\n if (n % i === 0) {\n return false\n }\n }\n return true\n}\n\nconst range = (min: number, max: number): number[] => {\n const result: number[] = []\n for (let i = min; i < max; i++) {\n result.push(i)\n }\n return result\n}\n\nexport function nth(nthPrime: number): number {\n if (nthPrime === 0) {\n throw new Error('Prime is not possible')\n }\n\n return range(2, 2e6).filter(isPrime)[nthPrime - 1]\n}\n" }, { "path": "exercises/practice/nth-prime/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[75c65189-8aef-471a-81de-0a90c728160c]\ndescription = \"first prime\"\n\n[2c38804c-295f-4701-b728-56dea34fd1a0]\ndescription = \"second prime\"\n\n[56692534-781e-4e8c-b1f9-3e82c1640259]\ndescription = \"sixth prime\"\n\n[fce1e979-0edb-412d-93aa-2c744e8f50ff]\ndescription = \"big prime\"\n\n[bd0a9eae-6df7-485b-a144-80e13c7d55b2]\ndescription = \"there is no zeroth prime\"\n" }, { "path": "exercises/practice/nth-prime/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/nth-prime/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/nth-prime/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/nth-prime/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/nth-prime/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/nth-prime/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/nth-prime/nth-prime.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { nth } from './nth-prime.ts'\n\ndescribe('Prime', () => {\n it('first', () => {\n expect(nth(1)).toEqual(2)\n })\n\n xit('second', () => {\n expect(nth(2)).toEqual(3)\n })\n\n xit('sixth', () => {\n expect(nth(6)).toEqual(13)\n })\n\n xit('big prime', () => {\n expect(nth(10001)).toEqual(104743)\n })\n\n xit('weird case', () => {\n expect(() => nth(0)).toThrow('Prime is not possible')\n })\n})\n" }, { "path": "exercises/practice/nth-prime/nth-prime.ts", "content": "export function nth() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/nth-prime/package.json", "content": "{\n \"name\": \"@exercism/typescript-nth-prime\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/nth-prime/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/nth-prime/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/nucleotide-count/.docs/instructions.md", "content": "# Instructions\n\nEach of us inherits from our biological parents a set of chemical instructions known as DNA that influence how our bodies are constructed.\nAll known life depends on DNA!\n\n> Note: You do not need to understand anything about nucleotides or DNA to complete this exercise.\n\nDNA is a long chain of other chemicals and the most important are the four nucleotides, adenine, cytosine, guanine and thymine.\nA single DNA chain can contain billions of these four nucleotides and the order in which they occur is important!\nWe call the order of these nucleotides in a bit of DNA a \"DNA sequence\".\n\nWe represent a DNA sequence as an ordered collection of these four nucleotides and a common way to do that is with a string of characters such as \"ATTACG\" for a DNA sequence of 6 nucleotides.\n'A' for adenine, 'C' for cytosine, 'G' for guanine, and 'T' for thymine.\n\nGiven a string representing a DNA sequence, count how many of each nucleotide is present.\nIf the string contains characters that aren't A, C, G, or T then it is invalid and you should signal an error.\n\nFor example:\n\n```text\n\"GATTACA\" -> 'A': 3, 'C': 1, 'G': 1, 'T': 2\n\"INVALID\" -> error\n```\n" }, { "path": "exercises/practice/nucleotide-count/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"nucleotide-count.ts\"\n ],\n \"test\": [\n \"nucleotide-count.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a DNA string, compute how many times each nucleotide occurs in the string.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"The Calculating DNA Nucleotides_problem at Rosalind\",\n \"source_url\": \"https://rosalind.info/problems/dna/\"\n}\n" }, { "path": "exercises/practice/nucleotide-count/.meta/proof.ci.ts", "content": "type Counts = Record<'A' | 'C' | 'G' | 'T', number>\n\nexport function nucleotideCounts(strand: string): Counts {\n const nucleotideOccurrences: Counts = {\n A: 0,\n C: 0,\n G: 0,\n T: 0,\n }\n\n strand.split('').forEach((nucleotide) => {\n if (nucleotide in nucleotideOccurrences) {\n if (nucleotide === 'A') {\n nucleotideOccurrences.A++\n }\n if (nucleotide === 'C') {\n nucleotideOccurrences.C++\n }\n if (nucleotide === 'G') {\n nucleotideOccurrences.G++\n }\n if (nucleotide === 'T') {\n nucleotideOccurrences.T++\n }\n } else {\n throw new Error('Invalid nucleotide in strand')\n }\n })\n\n return nucleotideOccurrences\n}\n" }, { "path": "exercises/practice/nucleotide-count/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[3e5c30a8-87e2-4845-a815-a49671ade970]\ndescription = \"empty strand\"\n\n[a0ea42a6-06d9-4ac6-828c-7ccaccf98fec]\ndescription = \"can count one nucleotide in single-character input\"\n\n[eca0d565-ed8c-43e7-9033-6cefbf5115b5]\ndescription = \"strand with repeated nucleotide\"\n\n[40a45eac-c83f-4740-901a-20b22d15a39f]\ndescription = \"strand with multiple nucleotides\"\n\n[b4c47851-ee9e-4b0a-be70-a86e343bd851]\ndescription = \"strand with invalid nucleotides\"\n" }, { "path": "exercises/practice/nucleotide-count/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/nucleotide-count/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/nucleotide-count/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/nucleotide-count/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/nucleotide-count/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/nucleotide-count/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/nucleotide-count/nucleotide-count.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { nucleotideCounts } from './nucleotide-count.ts'\n\ndescribe('count all nucleotides in a strand', () => {\n it('empty strand', () => {\n const expected = {\n A: 0,\n C: 0,\n G: 0,\n T: 0,\n }\n expect(nucleotideCounts('')).toEqual(expected)\n })\n\n xit('can count one nucleotide in single-character input', () => {\n const expected = {\n A: 0,\n C: 0,\n G: 1,\n T: 0,\n }\n expect(nucleotideCounts('G')).toEqual(expected)\n })\n\n xit('strand with repeated nucleotide', () => {\n const expected = {\n A: 0,\n C: 0,\n G: 7,\n T: 0,\n }\n expect(nucleotideCounts('GGGGGGG')).toEqual(expected)\n })\n\n xit('strand with multiple nucleotides', () => {\n const expected = {\n A: 20,\n C: 12,\n G: 17,\n T: 21,\n }\n expect(\n nucleotideCounts(\n 'AGCTTTTCATTCTGACTGCAACGGGCAATATGTCTCTGTGTGGATTAAAAAAAGAGTGTCTGATAGCAGC'\n )\n ).toEqual(expected)\n })\n\n xit('strand with invalid nucleotides', () => {\n const expected = 'Invalid nucleotide in strand'\n expect(() => {\n nucleotideCounts('AGXXACT')\n }).toThrow(expected)\n })\n})\n" }, { "path": "exercises/practice/nucleotide-count/nucleotide-count.ts", "content": "export function nucleotideCounts(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/nucleotide-count/package.json", "content": "{\n \"name\": \"@exercism/typescript-nucleotide-count\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/nucleotide-count/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/nucleotide-count/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/ocr-numbers/.docs/instructions.md", "content": "# Instructions\n\nOptical Character Recognition or OCR is software that converts images of text into machine-readable text.\nGiven a grid of characters representing some digits, convert the grid to a string of digits.\nIf the grid has multiple rows of cells, the rows should be separated in the output with a `\",\"`.\n\n- The grid is made of one of more lines of cells.\n- Each line of the grid is made of one or more cells.\n- Each cell is three columns wide and four rows high (3x4) and represents one digit.\n- Digits are drawn using pipes (`\"|\"`), underscores (`\"_\"`), and spaces (`\" \"`).\n\n## Edge cases\n\n- If the input is not a valid size, your program should indicate there is an error.\n- If the input is the correct size, but a cell is not recognizable, your program should output a `\"?\"` for that character.\n\n## Examples\n\nThe following input (without the comments) is converted to `\"1234567890\"`.\n\n```text\n _ _ _ _ _ _ _ _ #\n | _| _||_||_ |_ ||_||_|| | # Decimal numbers.\n ||_ _| | _||_| ||_| _||_| #\n # The fourth line is always blank,\n```\n\nThe following input is converted to `\"123,456,789\"`.\n\n\n\n```text\n _ _ \n | _| _|\n ||_ _|\n \n _ _ \n|_||_ |_ \n | _||_|\n \n _ _ _ \n ||_||_|\n ||_| _|\n \n```\n\n\n" }, { "path": "exercises/practice/ocr-numbers/.docs/introduction.md", "content": "# Introduction\n\nYour best friend Marta recently landed their dream job working with a local history museum's collections.\nKnowing of your interests in programming, they confide in you about an issue at work for an upcoming exhibit on computing history.\nA local university's math department had donated several boxes of historical printouts, but given the poor condition of the documents, the decision has been made to digitize the text.\nHowever, the university's old printer had some quirks in how text was represented, and your friend could use your help to extract the data successfully.\n" }, { "path": "exercises/practice/ocr-numbers/.meta/config.json", "content": "{\n \"authors\": [\n \"mdowds\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"ocr-numbers.ts\"\n ],\n \"test\": [\n \"ocr-numbers.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a 3 x 4 grid of pipes, underscores, and spaces, determine which number is represented, or whether it is garbled.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Inspired by the Bank OCR kata\",\n \"source_url\": \"https://codingdojo.org/kata/BankOCR/\"\n}\n" }, { "path": "exercises/practice/ocr-numbers/.meta/proof.ci.ts", "content": "interface Patterns {\n [key: number]: string[]\n}\n\nconst PATTERNS: Patterns = {\n 0: [' _ ', '| |', '|_|', ' '],\n 1: [' ', ' |', ' |', ' '],\n 2: [' _ ', ' _|', '|_ ', ' '],\n 3: [' _ ', ' _|', ' _|', ' '],\n 4: [' ', '|_|', ' |', ' '],\n 5: [' _ ', '|_ ', ' _|', ' '],\n 6: [' _ ', '|_ ', '|_|', ' '],\n 7: [' _ ', ' |', ' |', ' '],\n 8: [' _ ', '|_|', '|_|', ' '],\n 9: [' _ ', '|_|', ' _|', ' '],\n}\n\ntype Digit = number | '?'\n\nconst splitIntoRows = (text: string): string[] => {\n const rows: string[] = []\n const lines = text.split('\\n')\n for (let rowNumber = 0; rowNumber < lines.length; rowNumber += 4) {\n let row = ''\n for (let rowLine = 0; rowLine < 4; rowLine += 1) {\n row += `${lines[rowNumber + rowLine]}\\n`\n }\n rows.push(row.slice(0, -1))\n }\n return rows\n}\n\nconst splitIntoDigits = (row: string): string[] => {\n const digits: string[] = []\n const rows = row.split('\\n')\n for (let digitNumber = 0; digitNumber < rows[0].length; digitNumber += 3) {\n let digit = ''\n for (let rowNumber = 0; rowNumber < rows.length; rowNumber += 1) {\n digit += rows[rowNumber].substr(digitNumber, 3)\n }\n digits.push(digit)\n }\n return digits\n}\n\nconst getDigit = (text: string): Digit => {\n const digit = (\n Object.values(PATTERNS) as (typeof PATTERNS)[keyof typeof PATTERNS][]\n )\n .map((x) => x.join(''))\n .indexOf(text)\n if (digit === -1) {\n return '?'\n }\n return digit\n}\n\nconst valuesInRow = (row: string): string =>\n splitIntoDigits(row).map(getDigit).join('')\n\nexport const convert = (text: string): string =>\n splitIntoRows(text).map(valuesInRow).join(',')\n" }, { "path": "exercises/practice/ocr-numbers/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[5ee54e1a-b554-4bf3-a056-9a7976c3f7e8]\ndescription = \"Recognizes 0\"\n\n[027ada25-17fd-4d78-aee6-35a19623639d]\ndescription = \"Recognizes 1\"\n\n[3cce2dbd-01d9-4f94-8fae-419a822e89bb]\ndescription = \"Unreadable but correctly sized inputs return ?\"\n\n[cb19b733-4e36-4cf9-a4a1-6e6aac808b9a]\ndescription = \"Input with a number of lines that is not a multiple of four raises an error\"\n\n[235f7bd1-991b-4587-98d4-84206eec4cc6]\ndescription = \"Input with a number of columns that is not a multiple of three raises an error\"\n\n[4a841794-73c9-4da9-a779-1f9837faff66]\ndescription = \"Recognizes 110101100\"\n\n[70c338f9-85b1-4296-a3a8-122901cdfde8]\ndescription = \"Garbled numbers in a string are replaced with ?\"\n\n[ea494ff4-3610-44d7-ab7e-72fdef0e0802]\ndescription = \"Recognizes 2\"\n\n[1acd2c00-412b-4268-93c2-bd7ff8e05a2c]\ndescription = \"Recognizes 3\"\n\n[eaec6a15-be17-4b6d-b895-596fae5d1329]\ndescription = \"Recognizes 4\"\n\n[440f397a-f046-4243-a6ca-81ab5406c56e]\ndescription = \"Recognizes 5\"\n\n[f4c9cf6a-f1e2-4878-bfc3-9b85b657caa0]\ndescription = \"Recognizes 6\"\n\n[e24ebf80-c611-41bb-a25a-ac2c0f232df5]\ndescription = \"Recognizes 7\"\n\n[b79cad4f-e264-4818-9d9e-77766792e233]\ndescription = \"Recognizes 8\"\n\n[5efc9cfc-9227-4688-b77d-845049299e66]\ndescription = \"Recognizes 9\"\n\n[f60cb04a-42be-494e-a535-3451c8e097a4]\ndescription = \"Recognizes string of decimal numbers\"\n\n[b73ecf8b-4423-4b36-860d-3710bdb8a491]\ndescription = \"Numbers separated by empty lines are recognized. Lines are joined by commas.\"\n" }, { "path": "exercises/practice/ocr-numbers/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/ocr-numbers/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/ocr-numbers/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/ocr-numbers/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/ocr-numbers/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/ocr-numbers/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/ocr-numbers/ocr-numbers.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { convert } from './ocr-numbers.ts'\n\ndescribe('ocr', () => {\n it('recognizes zero', () => {\n expect(convert(' _ \\n' + '| |\\n' + '|_|\\n' + ' ')).toBe('0')\n })\n\n xit('recognizes one', () => {\n expect(convert(' \\n' + ' |\\n' + ' |\\n' + ' ')).toBe('1')\n })\n\n xit('recognizes two', () => {\n expect(convert(' _ \\n' + ' _|\\n' + '|_ \\n' + ' ')).toBe('2')\n })\n\n xit('recognizes three', () => {\n expect(convert(' _ \\n' + ' _|\\n' + ' _|\\n' + ' ')).toBe('3')\n })\n\n xit('recognizes four', () => {\n expect(convert(' \\n' + '|_|\\n' + ' |\\n' + ' ')).toBe('4')\n })\n\n xit('recognizes five', () => {\n expect(convert(' _ \\n' + '|_ \\n' + ' _|\\n' + ' ')).toBe('5')\n })\n\n xit('recognizes six', () => {\n expect(convert(' _ \\n' + '|_ \\n' + '|_|\\n' + ' ')).toBe('6')\n })\n\n xit('recognizes seven', () => {\n expect(convert(' _ \\n' + ' |\\n' + ' |\\n' + ' ')).toBe('7')\n })\n\n xit('recognizes eight', () => {\n expect(convert(' _ \\n' + '|_|\\n' + '|_|\\n' + ' ')).toBe('8')\n })\n\n xit('recognizes nine', () => {\n expect(convert(' _ \\n' + '|_|\\n' + ' _|\\n' + ' ')).toBe('9')\n })\n\n xit('recognizes ten', () => {\n expect(convert(' _ \\n' + ' || |\\n' + ' ||_|\\n' + ' ')).toBe('10')\n })\n\n xit('identifies garble', () => {\n expect(convert(' \\n' + '| |\\n' + '| |\\n' + ' ')).toBe('?')\n })\n\n xit('converts 110101100', () => {\n expect(\n convert(\n ' _ _ _ _ \\n' +\n ' | || | || | | || || |\\n' +\n ' | ||_| ||_| | ||_||_|\\n' +\n ' '\n )\n ).toBe('110101100')\n })\n\n xit('identifies garble mixed in', () => {\n expect(\n convert(\n ' _ _ _ \\n' +\n ' | || | || | || || |\\n' +\n ' | | _| ||_| | ||_||_|\\n' +\n ' '\n )\n ).toBe('11?10?1?0')\n })\n\n xit('converts 1234567890', () => {\n expect(\n convert(\n ' _ _ _ _ _ _ _ _ \\n' +\n ' | _| _||_||_ |_ ||_||_|| |\\n' +\n ' ||_ _| | _||_| ||_| _||_|\\n' +\n ' '\n )\n ).toBe('1234567890')\n })\n\n xit('converts 123 456 789', () => {\n expect(\n convert(\n ' _ _ \\n' +\n ' | _| _|\\n' +\n ' ||_ _|\\n' +\n ' \\n' +\n ' _ _ \\n' +\n '|_||_ |_ \\n' +\n ' | _||_|\\n' +\n ' \\n' +\n ' _ _ _ \\n' +\n ' ||_||_|\\n' +\n ' ||_| _|\\n' +\n ' '\n )\n ).toBe('123,456,789')\n })\n})\n" }, { "path": "exercises/practice/ocr-numbers/ocr-numbers.ts", "content": "export function convert(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/ocr-numbers/package.json", "content": "{\n \"name\": \"@exercism/typescript-ocr-numbers\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/ocr-numbers/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/ocr-numbers/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/palindrome-products/.docs/instructions.md", "content": "# Instructions\n\nDetect palindrome products in a given range.\n\nA palindromic number is a number that remains the same when its digits are reversed.\nFor example, `121` is a palindromic number but `112` is not.\n\nGiven a range of numbers, find the largest and smallest palindromes which\nare products of two numbers within that range.\n\nYour solution should return the largest and smallest palindromes, along with the factors of each within the range.\nIf the largest or smallest palindrome has more than one pair of factors within the range, then return all the pairs.\n\n## Example 1\n\nGiven the range `[1, 9]` (both inclusive)...\n\nAnd given the list of all possible products within this range:\n`[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 14, 16, 18, 15, 21, 24, 27, 20, 28, 32, 36, 25, 30, 35, 40, 45, 42, 48, 54, 49, 56, 63, 64, 72, 81]`\n\nThe palindrome products are all single digit numbers (in this case):\n`[1, 2, 3, 4, 5, 6, 7, 8, 9]`\n\nThe smallest palindrome product is `1`.\nIts factors are `(1, 1)`.\nThe largest palindrome product is `9`.\nIts factors are `(1, 9)` and `(3, 3)`.\n\n## Example 2\n\nGiven the range `[10, 99]` (both inclusive)...\n\nThe smallest palindrome product is `121`.\nIts factors are `(11, 11)`.\nThe largest palindrome product is `9009`.\nIts factors are `(91, 99)`.\n" }, { "path": "exercises/practice/palindrome-products/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"averaart\",\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"palindrome-products.ts\"\n ],\n \"test\": [\n \"palindrome-products.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Detect palindrome products in a given range.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": true,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Problem 4 at Project Euler\",\n \"source_url\": \"https://projecteuler.net/problem=4\"\n}\n" }, { "path": "exercises/practice/palindrome-products/.meta/proof.ci.ts", "content": "interface Input {\n maxFactor: number\n minFactor?: number\n}\n\ntype Factors = [number, number][]\ninterface PalindromeShape {\n value: number | null\n factors: Factors\n}\n\nconst reverseString = (str: string): string => str.split('').reverse().join('')\n\nclass Palindrome implements PalindromeShape {\n public readonly value: number\n public readonly factors: Factors\n\n constructor(factor1: number, factor2: number) {\n this.value = factor1 * factor2\n this.factors = [[factor1, factor2].sort() as [number, number]]\n }\n\n public withFactors(factors: Factors[number]): this {\n this.factors.push(factors.sort())\n this.factors.sort()\n\n return this\n }\n\n public valid(): boolean {\n const s = `${this.value}`\n return s === reverseString(s)\n }\n\n public merge(other: Palindrome): this {\n other.factors.forEach((f) => {\n this.factors.push(f)\n })\n this.factors.sort()\n\n return this\n }\n}\nclass Palindromes {\n constructor(\n public maxFactor: number,\n public minFactor = 1\n ) {}\n\n public get largest(): PalindromeShape {\n let best = new Palindrome(this.minFactor, this.minFactor)\n for (let m = this.maxFactor; m >= this.minFactor; m -= 1) {\n let p = null\n for (let n = m; n >= this.minFactor && (!p || !p.valid()); n -= 1) {\n p = new Palindrome(m, n)\n if (p.valid()) {\n if (best.value < p.value) {\n best = p\n } else if (best.value === p.value) {\n best = p.merge(best)\n }\n }\n }\n }\n if (best.valid()) {\n return best\n }\n\n return { value: null, factors: [] }\n }\n\n public get smallest(): PalindromeShape {\n let smallest: PalindromeShape = { value: null, factors: [] }\n for (let m = this.minFactor; m <= this.maxFactor; m += 1) {\n for (let n = this.minFactor; n <= this.maxFactor; n += 1) {\n const p = new Palindrome(m, n)\n if (p.valid() && (!smallest.value || smallest.value > p.value)) {\n smallest = p\n }\n }\n }\n\n return smallest\n }\n}\n\nexport function generate(params: Input): Palindromes {\n if ((params.minFactor || 1) > params.maxFactor) {\n throw new Error('min must be <= max')\n }\n return new Palindromes(params.maxFactor, params.minFactor || 1)\n}\n" }, { "path": "exercises/practice/palindrome-products/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[5cff78fe-cf02-459d-85c2-ce584679f887]\ndescription = \"find the smallest palindrome from single digit factors\"\n\n[0853f82c-5fc4-44ae-be38-fadb2cced92d]\ndescription = \"find the largest palindrome from single digit factors\"\n\n[66c3b496-bdec-4103-9129-3fcb5a9063e1]\ndescription = \"find the smallest palindrome from double digit factors\"\n\n[a10682ae-530a-4e56-b89d-69664feafe53]\ndescription = \"find the largest palindrome from double digit factors\"\n\n[cecb5a35-46d1-4666-9719-fa2c3af7499d]\ndescription = \"find the smallest palindrome from triple digit factors\"\n\n[edab43e1-c35f-4ea3-8c55-2f31dddd92e5]\ndescription = \"find the largest palindrome from triple digit factors\"\n\n[4f802b5a-9d74-4026-a70f-b53ff9234e4e]\ndescription = \"find the smallest palindrome from four digit factors\"\n\n[787525e0-a5f9-40f3-8cb2-23b52cf5d0be]\ndescription = \"find the largest palindrome from four digit factors\"\n\n[58fb1d63-fddb-4409-ab84-a7a8e58d9ea0]\ndescription = \"empty result for smallest if no palindrome in the range\"\n\n[9de9e9da-f1d9-49a5-8bfc-3d322efbdd02]\ndescription = \"empty result for largest if no palindrome in the range\"\n\n[12e73aac-d7ee-4877-b8aa-2aa3dcdb9f8a]\ndescription = \"error result for smallest if min is more than max\"\n\n[eeeb5bff-3f47-4b1e-892f-05829277bd74]\ndescription = \"error result for largest if min is more than max\"\n\n[16481711-26c4-42e0-9180-e2e4e8b29c23]\ndescription = \"smallest product does not use the smallest factor\"\n" }, { "path": "exercises/practice/palindrome-products/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/palindrome-products/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/palindrome-products/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/palindrome-products/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/palindrome-products/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/palindrome-products/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/palindrome-products/package.json", "content": "{\n \"name\": \"@exercism/typescript-palindrome-products\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/palindrome-products/palindrome-products.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { generate } from './palindrome-products.ts'\n\ndescribe('Palindromes', () => {\n it('smallest palindrome from single digit factors', () => {\n const palindromes = generate({ maxFactor: 9, minFactor: 1 })\n const smallest = palindromes.smallest\n const expected = { value: 1, factors: [[1, 1]] }\n\n expect(smallest.value).toEqual(expected.value)\n expect(sortFactors(smallest.factors)).toEqual(expected.factors)\n })\n\n xit('largest palindrome from single digit factors', () => {\n const palindromes = generate({ maxFactor: 9, minFactor: 1 })\n const largest = palindromes.largest\n const expected = {\n value: 9,\n factors: [\n [1, 9],\n [3, 3],\n ],\n }\n\n expect(largest.value).toEqual(expected.value)\n expect(sortFactors(largest.factors)).toEqual(expected.factors)\n })\n\n xit('smallest palindrome from double digit factors', () => {\n const palindromes = generate({ maxFactor: 99, minFactor: 10 })\n const smallest = palindromes.smallest\n const expected = { value: 121, factors: [[11, 11]] }\n\n expect(smallest.value).toEqual(expected.value)\n expect(sortFactors(smallest.factors)).toEqual(expected.factors)\n })\n\n xit('largest palindrome from double digit factors', () => {\n const palindromes = generate({ maxFactor: 99, minFactor: 10 })\n const largest = palindromes.largest\n const expected = { value: 9009, factors: [[91, 99]] }\n\n expect(largest.value).toEqual(expected.value)\n expect(sortFactors(largest.factors)).toEqual(expected.factors)\n })\n\n xit('smallest palindrome from triple digit factors', () => {\n const palindromes = generate({\n maxFactor: 999,\n minFactor: 100,\n })\n const smallest = palindromes.smallest\n const expected = { value: 10201, factors: [[101, 101]] }\n\n expect(smallest.value).toEqual(expected.value)\n expect(sortFactors(smallest.factors)).toEqual(expected.factors)\n })\n\n xit('largest palindrome from triple digit factors', () => {\n const palindromes = generate({\n maxFactor: 999,\n minFactor: 100,\n })\n const largest = palindromes.largest\n const expected = { value: 906609, factors: [[913, 993]] }\n\n expect(largest.value).toEqual(expected.value)\n expect(sortFactors(largest.factors)).toEqual(expected.factors)\n })\n\n xit('smallest palindrome from four digit factors', () => {\n const palindromes = generate({\n maxFactor: 9999,\n minFactor: 1000,\n })\n const smallest = palindromes.smallest\n const expected = { value: 1002001, factors: [[1001, 1001]] }\n\n expect(smallest.value).toEqual(expected.value)\n expect(sortFactors(smallest.factors)).toEqual(expected.factors)\n })\n\n xit('largest palindrome from four digit factors', () => {\n const palindromes = generate({\n maxFactor: 9999,\n minFactor: 1000,\n })\n const largest = palindromes.largest\n const expected = { value: 99000099, factors: [[9901, 9999]] }\n\n expect(largest.value).toEqual(expected.value)\n expect(sortFactors(largest.factors)).toEqual(expected.factors)\n })\n\n xit('empty result for smallest if no palindrome in range', () => {\n const palindromes = generate({\n maxFactor: 1003,\n minFactor: 1002,\n })\n const smallest = palindromes.smallest\n\n expect(smallest.value).toBe(null)\n expect(smallest.factors).toEqual([])\n })\n\n xit('empty result for largest if no palindrome in range', () => {\n const palindromes = generate({ maxFactor: 15, minFactor: 15 })\n const largest = palindromes.largest\n\n expect(largest.value).toBe(null)\n expect(largest.factors).toEqual([])\n })\n\n xit('error for smallest if min is more than max', () => {\n expect(() => {\n const palindromes = generate({\n maxFactor: 1,\n minFactor: 10000,\n })\n\n // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n palindromes.smallest\n }).toThrow(new Error('min must be <= max'))\n })\n\n xit('error for largest if min is more than max', () => {\n expect(() => {\n const palindromes = generate({ maxFactor: 1, minFactor: 2 })\n\n // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n palindromes.largest\n }).toThrow(new Error('min must be <= max'))\n })\n\n xit('smallest product does not use the smallest factor', () => {\n const palindromes = generate({\n maxFactor: 4000,\n minFactor: 3215,\n })\n const smallest = palindromes.smallest\n const expected = { value: 10988901, factors: [[3297, 3333]] }\n\n expect(smallest.value).toEqual(expected.value)\n expect(sortFactors(smallest.factors)).toEqual(expected.factors)\n })\n})\n\ntype Factors = ReturnType['smallest']['factors']\nfunction sortFactors(factors: Factors): Factors {\n return factors.map((f) => f.sort()).sort()\n}\n" }, { "path": "exercises/practice/palindrome-products/palindrome-products.ts", "content": "interface Input {\n maxFactor: number\n minFactor?: number\n}\n\nexport function generate(params: Input): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/palindrome-products/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/palindrome-products/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/pangram/.docs/instructions.md", "content": "# Instructions\n\nYour task is to figure out if a sentence is a pangram.\n\nA pangram is a sentence using every letter of the alphabet at least once.\nIt is case insensitive, so it doesn't matter if a letter is lower-case (e.g. `k`) or upper-case (e.g. `K`).\n\nFor this exercise, a sentence is a pangram if it contains each of the 26 letters in the English alphabet.\n" }, { "path": "exercises/practice/pangram/.docs/introduction.md", "content": "# Introduction\n\nYou work for a company that sells fonts through their website.\nThey'd like to show a different sentence each time someone views a font on their website.\nTo give a comprehensive sense of the font, the random sentences should use **all** the letters in the English alphabet.\n\nThey're running a competition to get suggestions for sentences that they can use.\nYou're in charge of checking the submissions to see if they are valid.\n\n~~~~exercism/note\nPangram comes from Greek, Ļ€Ī±Ī½ Ī³ĻĪ¬Ī¼Ī¼Ī±, pan gramma, which means \"every letter\".\n\nThe best known English pangram is:\n\n> The quick brown fox jumps over the lazy dog.\n~~~~\n" }, { "path": "exercises/practice/pangram/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"CRivasGomez\",\n \"DFXLuna\",\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"pangram.ts\"\n ],\n \"test\": [\n \"pangram.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Determine if a sentence is a pangram.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Pangram\"\n}\n" }, { "path": "exercises/practice/pangram/.meta/proof.ci.ts", "content": "const aToZ = [...Array(26)].map((_, index) => {\n return String.fromCharCode(index + 65)\n})\n\nexport function isPangram(value: string): boolean {\n const myMap = new Map()\n aToZ.forEach((key: string) => {\n myMap.set(key.toLowerCase(), 0)\n })\n\n for (const each of value) {\n const item = myMap.get(each) || 0\n myMap.set(each.toLowerCase(), item + 1)\n }\n\n for (const each of myMap.values()) {\n if (each === 0) {\n return false\n }\n }\n return true\n}\n" }, { "path": "exercises/practice/pangram/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[64f61791-508e-4f5c-83ab-05de042b0149]\ndescription = \"empty sentence\"\n\n[74858f80-4a4d-478b-8a5e-c6477e4e4e84]\ndescription = \"perfect lower case\"\n\n[61288860-35ca-4abe-ba08-f5df76ecbdcd]\ndescription = \"only lower case\"\n\n[6564267d-8ac5-4d29-baf2-e7d2e304a743]\ndescription = \"missing the letter 'x'\"\n\n[c79af1be-d715-4cdb-a5f2-b2fa3e7e0de0]\ndescription = \"missing the letter 'h'\"\n\n[d835ec38-bc8f-48e4-9e36-eb232427b1df]\ndescription = \"with underscores\"\n\n[8cc1e080-a178-4494-b4b3-06982c9be2a8]\ndescription = \"with numbers\"\n\n[bed96b1c-ff95-45b8-9731-fdbdcb6ede9a]\ndescription = \"missing letters replaced by numbers\"\n\n[938bd5d8-ade5-40e2-a2d9-55a338a01030]\ndescription = \"mixed case and punctuation\"\n\n[2577bf54-83c8-402d-a64b-a2c0f7bb213a]\ndescription = \"case insensitive\"\ninclude = false\n\n[7138e389-83e4-4c6e-8413-1e40a0076951]\ndescription = \"a-m and A-M are 26 different characters but not a pangram\"\nreimplements = \"2577bf54-83c8-402d-a64b-a2c0f7bb213a\"\n" }, { "path": "exercises/practice/pangram/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/pangram/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/pangram/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/pangram/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/pangram/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/pangram/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/pangram/package.json", "content": "{\n \"name\": \"@exercism/typescript-pangram\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/pangram/pangram.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { isPangram } from './pangram.ts'\n\ndescribe('Pangram()', () => {\n it('empty sentence', () => {\n expect(isPangram('')).toBe(false)\n })\n\n xit('perfect lower case', () => {\n expect(isPangram('abcdefghijklmnopqrstuvwxyz')).toBe(true)\n })\n\n xit('only lower case', () => {\n expect(isPangram('the quick brown fox jumps over the lazy dog')).toBe(true)\n })\n\n xit(\"missing the letter 'x'\", () => {\n expect(\n isPangram('a quick movement of the enemy will jeopardize five gunboats')\n ).toBe(false)\n })\n\n xit(\"missing the letter 'h'\", () => {\n expect(isPangram('five boxing wizards jump quickly at it')).toBe(false)\n })\n\n xit('with underscores', () => {\n expect(isPangram('the_quick_brown_fox_jumps_over_the_lazy_dog')).toBe(true)\n })\n\n xit('with numbers', () => {\n expect(isPangram('the 1 quick brown fox jumps over the 2 lazy dogs')).toBe(\n true\n )\n })\n\n xit('missing letters replaced by numbers', () => {\n expect(isPangram('7h3 qu1ck brown fox jumps ov3r 7h3 lazy dog')).toBe(false)\n })\n\n xit('mixed case and punctuation', () => {\n expect(isPangram('\"Five quacking Zephyrs jolt my wax bed.\"')).toBe(true)\n })\n\n xit('a-m and A-M are 26 different characters but not a pangram', () => {\n expect(isPangram('abcdefghijklm ABCDEFGHIJKLM')).toBe(false)\n })\n})\n" }, { "path": "exercises/practice/pangram/pangram.ts", "content": "export function isPangram() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/pangram/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/pangram/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/pascals-triangle/.docs/instructions.md", "content": "# Instructions\n\nYour task is to output the first N rows of Pascal's triangle.\n\n[Pascal's triangle][wikipedia] is a triangular array of positive integers.\n\nIn Pascal's triangle, the number of values in a row is equal to its row number (which starts at one).\nTherefore, the first row has one value, the second row has two values, and so on.\n\nThe first (topmost) row has a single value: `1`.\nSubsequent rows' values are computed by adding the numbers directly to the right and left of the current position in the previous row.\n\nIf the previous row does _not_ have a value to the left or right of the current position (which only happens for the leftmost and rightmost positions), treat that position's value as zero (effectively \"ignoring\" it in the summation).\n\n## Example\n\nLet's look at the first 5 rows of Pascal's Triangle:\n\n```text\n 1\n 1 1\n 1 2 1\n 1 3 3 1\n1 4 6 4 1\n```\n\nThe topmost row has one value, which is `1`.\n\nThe leftmost and rightmost values have only one preceding position to consider, which is the position to its right respectively to its left.\nWith the topmost value being `1`, it follows from this that all the leftmost and rightmost values are also `1`.\n\nThe other values all have two positions to consider.\nFor example, the fifth row's (`1 4 6 4 1`) middle value is `6`, as the values to its left and right in the preceding row are `3` and `3`:\n\n[wikipedia]: https://en.wikipedia.org/wiki/Pascal%27s_triangle\n" }, { "path": "exercises/practice/pascals-triangle/.docs/introduction.md", "content": "# Introduction\n\nWith the weather being great, you're not looking forward to spending an hour in a classroom.\nAnnoyed, you enter the class room, where you notice a strangely satisfying triangle shape on the blackboard.\nWhilst waiting for your math teacher to arrive, you can't help but notice some patterns in the triangle: the outer values are all ones, each subsequent row has one more value than its previous row and the triangle is symmetrical.\nWeird!\n\nNot long after you sit down, your teacher enters the room and explains that this triangle is the famous [Pascal's triangle][wikipedia].\n\nOver the next hour, your teacher reveals some amazing things hidden in this triangle:\n\n- It can be used to compute how many ways you can pick K elements from N values.\n- It contains the Fibonacci sequence.\n- If you color odd and even numbers differently, you get a beautiful pattern called the [Sierpiński triangle][wikipedia-sierpinski-triangle].\n\nThe teacher implores you and your classmates to look up other uses, and assures you that there are lots more!\nAt that moment, the school bell rings.\nYou realize that for the past hour, you were completely absorbed in learning about Pascal's triangle.\nYou quickly grab your laptop from your bag and go outside, ready to enjoy both the sunshine _and_ the wonders of Pascal's triangle.\n\n[wikipedia]: https://en.wikipedia.org/wiki/Pascal%27s_triangle\n[wikipedia-sierpinski-triangle]: https://en.wikipedia.org/wiki/Sierpi%C5%84ski_triangle\n" }, { "path": "exercises/practice/pascals-triangle/.meta/config.json", "content": "{\n \"authors\": [\n \"anuragsoni\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"pascals-triangle.ts\"\n ],\n \"test\": [\n \"pascals-triangle.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Compute Pascal's triangle up to a given number of rows.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Pascal's Triangle at Wolfram Math World\",\n \"source_url\": \"https://www.wolframalpha.com/input/?i=Pascal%27s+triangle\"\n}\n" }, { "path": "exercises/practice/pascals-triangle/.meta/proof.ci.ts", "content": "export class Triangle {\n public readonly rows: number[][]\n public readonly lastRow: number[]\n\n constructor(rows: number) {\n this.rows = this.fillRows(rows)\n this.lastRow = this.rows[this.rows.length - 1]\n }\n\n private newRow(prevRow: number[]): number[] {\n let prev = 0\n const nextRow = []\n for (const x of prevRow) {\n nextRow.push(prev + x)\n prev = x\n }\n nextRow.push(1)\n return nextRow\n }\n\n private fillRows(rows: number): number[][] {\n const result = []\n let prevRow: number[] = []\n for (let x = 0; x < rows; x++) {\n const nextRow = this.newRow(prevRow)\n result.push(nextRow)\n prevRow = nextRow\n }\n return result\n }\n}\n" }, { "path": "exercises/practice/pascals-triangle/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[9920ce55-9629-46d5-85d6-4201f4a4234d]\ndescription = \"zero rows\"\n\n[70d643ce-a46d-4e93-af58-12d88dd01f21]\ndescription = \"single row\"\n\n[a6e5a2a2-fc9a-4b47-9f4f-ed9ad9fbe4bd]\ndescription = \"two rows\"\n\n[97206a99-79ba-4b04-b1c5-3c0fa1e16925]\ndescription = \"three rows\"\n\n[565a0431-c797-417c-a2c8-2935e01ce306]\ndescription = \"four rows\"\n\n[06f9ea50-9f51-4eb2-b9a9-c00975686c27]\ndescription = \"five rows\"\n\n[c3912965-ddb4-46a9-848e-3363e6b00b13]\ndescription = \"six rows\"\n\n[6cb26c66-7b57-4161-962c-81ec8c99f16b]\ndescription = \"ten rows\"\n" }, { "path": "exercises/practice/pascals-triangle/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/pascals-triangle/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/pascals-triangle/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/pascals-triangle/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/pascals-triangle/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/pascals-triangle/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/pascals-triangle/package.json", "content": "{\n \"name\": \"@exercism/typescript-pascals-triangle\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/pascals-triangle/pascals-triangle.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Triangle } from './pascals-triangle.ts'\n\ndescribe('Triangle', () => {\n it('with one row', () => {\n expect(new Triangle(1).rows).toEqual([[1]])\n })\n\n xit('with two rows', () => {\n expect(new Triangle(2).rows).toEqual([[1], [1, 1]])\n })\n\n xit('with three rows', () => {\n expect(new Triangle(3).rows).toEqual([[1], [1, 1], [1, 2, 1]])\n })\n\n xit('last row', () => {\n expect(new Triangle(4).lastRow).toEqual([1, 3, 3, 1])\n })\n\n xit('fifth row', () => {\n expect(new Triangle(5).lastRow).toEqual([1, 4, 6, 4, 1])\n })\n\n xit('twentieth row', () => {\n const twentieth = [\n 1, 19, 171, 969, 3876, 11628, 27132, 50388, 75582, 92378, 92378, 75582,\n 50388, 27132, 11628, 3876, 969, 171, 19, 1,\n ]\n expect(new Triangle(20).lastRow).toEqual(twentieth)\n })\n})\n" }, { "path": "exercises/practice/pascals-triangle/pascals-triangle.ts", "content": "export class Triangle {}\n" }, { "path": "exercises/practice/pascals-triangle/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/pascals-triangle/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/perfect-numbers/.docs/instructions.md", "content": "# Instructions\n\nDetermine if a number is perfect, abundant, or deficient based on Nicomachus' (60 - 120 CE) classification scheme for positive integers.\n\nThe Greek mathematician [Nicomachus][nicomachus] devised a classification scheme for positive integers, identifying each as belonging uniquely to the categories of [perfect](#perfect), [abundant](#abundant), or [deficient](#deficient) based on their [aliquot sum][aliquot-sum].\nThe _aliquot sum_ is defined as the sum of the factors of a number not including the number itself.\nFor example, the aliquot sum of `15` is `1 + 3 + 5 = 9`.\n\n## Perfect\n\nA number is perfect when it equals its aliquot sum.\nFor example:\n\n- `6` is a perfect number because `1 + 2 + 3 = 6`\n- `28` is a perfect number because `1 + 2 + 4 + 7 + 14 = 28`\n\n## Abundant\n\nA number is abundant when it is less than its aliquot sum.\nFor example:\n\n- `12` is an abundant number because `1 + 2 + 3 + 4 + 6 = 16`\n- `24` is an abundant number because `1 + 2 + 3 + 4 + 6 + 8 + 12 = 36`\n\n## Deficient\n\nA number is deficient when it is greater than its aliquot sum.\nFor example:\n\n- `8` is a deficient number because `1 + 2 + 4 = 7`\n- Prime numbers are deficient\n\n## Task\n\nImplement a way to determine whether a given number is [perfect](#perfect).\nDepending on your language track, you may also need to implement a way to determine whether a given number is [abundant](#abundant) or [deficient](#deficient).\n\n[nicomachus]: https://en.wikipedia.org/wiki/Nicomachus\n[aliquot-sum]: https://en.wikipedia.org/wiki/Aliquot_sum\n" }, { "path": "exercises/practice/perfect-numbers/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"G-Rath\",\n \"masters3d\",\n \"SleeplessByte\",\n \"vjba\"\n ],\n \"files\": {\n \"solution\": [\n \"perfect-numbers.ts\"\n ],\n \"test\": [\n \"perfect-numbers.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Determine if a number is perfect, abundant, or deficient based on Nicomachus' (60 - 120 CE) classification scheme for positive integers.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Taken from Chapter 2 of Functional Thinking by Neal Ford.\",\n \"source_url\": \"https://www.oreilly.com/library/view/functional-thinking/9781449365509/\"\n}\n" }, { "path": "exercises/practice/perfect-numbers/.meta/proof.ci.ts", "content": "export function classify(n: number): string {\n let i\n let sum\n let result\n\n // Check if the input is valid\n if (n <= 0) {\n throw new Error('Classification is only possible for natural numbers.')\n }\n\n // Factorize the current number.\n const divsArray = getDivisors(n)\n\n // Sum the factors.\n sum = 0\n for (i = 0; i < divsArray.length; i++) {\n sum = sum + divsArray[i]\n }\n\n // Check if the number is perfect.\n if (sum === n) {\n result = 'perfect'\n } else if (sum > n) {\n result = 'abundant'\n } else {\n result = 'deficient'\n }\n\n return result\n}\n\nfunction getDivisors(n: number): number[] {\n const divs: number[] = []\n\n // Accepts only natural numbers greater than 1.\n if (n <= 1) {\n return divs\n }\n\n // 1 always divides everyone!\n divs.push(1)\n\n // Calculate the divisors up the the half of the number + 1\n for (let i = 2; i <= n / 2; i++) {\n if (n % i === 0) {\n divs.push(i)\n }\n }\n\n return divs\n}\n" }, { "path": "exercises/practice/perfect-numbers/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[163e8e86-7bfd-4ee2-bd68-d083dc3381a3]\ndescription = \"Perfect numbers -> Smallest perfect number is classified correctly\"\n\n[169a7854-0431-4ae0-9815-c3b6d967436d]\ndescription = \"Perfect numbers -> Medium perfect number is classified correctly\"\n\n[ee3627c4-7b36-4245-ba7c-8727d585f402]\ndescription = \"Perfect numbers -> Large perfect number is classified correctly\"\n\n[80ef7cf8-9ea8-49b9-8b2d-d9cb3db3ed7e]\ndescription = \"Abundant numbers -> Smallest abundant number is classified correctly\"\n\n[3e300e0d-1a12-4f11-8c48-d1027165ab60]\ndescription = \"Abundant numbers -> Medium abundant number is classified correctly\"\n\n[ec7792e6-8786-449c-b005-ce6dd89a772b]\ndescription = \"Abundant numbers -> Large abundant number is classified correctly\"\n\n[05f15b93-849c-45e9-9c7d-1ea131ef7d10]\ndescription = \"Abundant numbers -> Perfect square abundant number is classified correctly\"\n\n[e610fdc7-2b6e-43c3-a51c-b70fb37413ba]\ndescription = \"Deficient numbers -> Smallest prime deficient number is classified correctly\"\n\n[0beb7f66-753a-443f-8075-ad7fbd9018f3]\ndescription = \"Deficient numbers -> Smallest non-prime deficient number is classified correctly\"\n\n[1c802e45-b4c6-4962-93d7-1cad245821ef]\ndescription = \"Deficient numbers -> Medium deficient number is classified correctly\"\n\n[47dd569f-9e5a-4a11-9a47-a4e91c8c28aa]\ndescription = \"Deficient numbers -> Large deficient number is classified correctly\"\n\n[a696dec8-6147-4d68-afad-d38de5476a56]\ndescription = \"Deficient numbers -> Edge case (no factors other than itself) is classified correctly\"\n\n[72445cee-660c-4d75-8506-6c40089dc302]\ndescription = \"Invalid inputs -> Zero is rejected (as it is not a positive integer)\"\n\n[2d72ce2c-6802-49ac-8ece-c790ba3dae13]\ndescription = \"Invalid inputs -> Negative integer is rejected (as it is not a positive integer)\"\n" }, { "path": "exercises/practice/perfect-numbers/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/perfect-numbers/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/perfect-numbers/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/perfect-numbers/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/perfect-numbers/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/perfect-numbers/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/perfect-numbers/package.json", "content": "{\n \"name\": \"@exercism/typescript-perfect-numbers\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/perfect-numbers/perfect-numbers.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { classify } from './perfect-numbers.ts'\n\ndescribe('Perfect numbers', () => {\n it('Smallest perfect number is classified correctly', () => {\n const expected = 'perfect'\n expect(classify(6)).toEqual(expected)\n })\n\n xit('Medium perfect number is classified correctly', () => {\n const expected = 'perfect'\n expect(classify(28)).toEqual(expected)\n })\n\n xit('Large perfect number is classified correctly', () => {\n const expected = 'perfect'\n expect(classify(33550336)).toEqual(expected)\n })\n})\n\ndescribe('Abundant numbers', () => {\n xit('Smallest abundant number is classified correctly', () => {\n const expected = 'abundant'\n expect(classify(12)).toEqual(expected)\n })\n\n xit('Medium abundant number is classified correctly', () => {\n const expected = 'abundant'\n expect(classify(30)).toEqual(expected)\n })\n\n xit('Large abundant number is classified correctly', () => {\n const expected = 'abundant'\n expect(classify(33550335)).toEqual(expected)\n })\n\n xit('Perfect square abundant number is classified correctly', () => {\n const expected = 'abundant'\n expect(classify(196)).toEqual(expected)\n })\n})\n\ndescribe('Deficient numbers', () => {\n xit('Smallest prime deficient number is classified correctly', () => {\n const expected = 'deficient'\n expect(classify(2)).toEqual(expected)\n })\n\n xit('Smallest non-prime deficient number is classified correctly', () => {\n const expected = 'deficient'\n expect(classify(4)).toEqual(expected)\n })\n\n xit('Medium deficient number is classified correctly', () => {\n const expected = 'deficient'\n expect(classify(32)).toEqual(expected)\n })\n\n xit('Large deficient number is classified correctly', () => {\n const expected = 'deficient'\n expect(classify(33550337)).toEqual(expected)\n })\n\n xit('Edge case (no factors other than itself) is classified correctly', () => {\n const expected = 'deficient'\n expect(classify(1)).toEqual(expected)\n })\n})\n\ndescribe('Invalid inputs', () => {\n xit('Zero is rejected (not a natural number)', () => {\n expect(() => {\n classify(0)\n }).toThrow('Classification is only possible for natural numbers.')\n })\n\n xit('Negative integer is rejected (not a natural number)', () => {\n expect(() => {\n classify(-1)\n }).toThrow('Classification is only possible for natural numbers.')\n })\n})\n" }, { "path": "exercises/practice/perfect-numbers/perfect-numbers.ts", "content": "export function classify() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/perfect-numbers/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/perfect-numbers/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/phone-number/.docs/instructions.md", "content": "# Instructions\n\nClean up phone numbers so that they can be sent SMS messages.\n\nThe **North American Numbering Plan (NANP)** is a telephone numbering system used by many countries in North America like the United States, Canada or Bermuda.\nAll NANP-countries share the same international country code: `1`.\n\nNANP numbers are ten-digit numbers consisting of a three-digit Numbering Plan Area code, commonly known as _area code_, followed by a seven-digit local number.\nThe first three digits of the local number represent the _exchange code_, followed by the unique four-digit number which is the _subscriber number_.\n\nThe format is usually represented as\n\n```text\nNXX NXX-XXXX\n```\n\nwhere `N` is any digit from 2 through 9 and `X` is any digit from 0 through 9.\n\nSometimes they also have the country code (represented as `1` or `+1`) prefixed.\n\nYour task is to clean up differently formatted telephone numbers by removing punctuation and the country code if present.\n\nFor example, the inputs\n\n- `+1 (613)-995-0253`\n- `613-995-0253`\n- `1 613 995 0253`\n- `613.995.0253`\n\nshould all produce the output\n\n`6139950253`\n\n**Note:** As this exercise only deals with telephone numbers used in NANP-countries, only 1 is considered a valid country code.\n" }, { "path": "exercises/practice/phone-number/.docs/introduction.md", "content": "# Introduction\n\nYou've joined LinkLine, a leading communications company working to ensure reliable connections for everyone.\nThe team faces a big challenge: users submit phone numbers in all sorts of formats ā€” dashes, spaces, dots, parentheses, and even prefixes.\nSome numbers are valid, while others are impossible to use.\n\nYour mission is to turn this chaos into order.\nYou'll clean up valid numbers, formatting them appropriately for use in the system.\nAt the same time, you'll identify and filter out any invalid entries.\n\nThe success of LinkLine's operations depends on your ability to separate the useful from the unusable.\nAre you ready to take on the challenge and keep the connections running smoothly?\n" }, { "path": "exercises/practice/phone-number/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"ffflorian\",\n \"lukaszklis\",\n \"SleeplessByte\",\n \"snowfrogdev\"\n ],\n \"files\": {\n \"solution\": [\n \"phone-number.ts\"\n ],\n \"test\": [\n \"phone-number.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Clean up user-entered phone numbers so that they can be sent SMS messages.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Exercise by the JumpstartLab team for students at The Turing School of Software and Design.\",\n \"source_url\": \"https://www.turing.edu/\"\n}\n" }, { "path": "exercises/practice/phone-number/.meta/proof.ci.ts", "content": "export const clean = (number: string): string => {\n if (/[a-zA-Z]/.test(number)) {\n throw new Error('Letters not permitted')\n } else if (/[@:!]/.test(number)) {\n throw new Error('Punctuations not permitted')\n }\n\n let strippedNumber = number.replace(/\\D/g, '')\n const numberLength = strippedNumber.length\n\n if (numberLength === 11) {\n if (strippedNumber.substring(0, 1) !== '1') {\n throw new Error('11 digits must start with 1')\n } else {\n strippedNumber = strippedNumber.substring(1)\n }\n }\n\n if (numberLength < 10) {\n throw new Error('Must not be fewer than 10 digits')\n }\n\n if (numberLength > 11) {\n throw new Error('Must not be greater than 11 digits')\n }\n\n if (strippedNumber.substring(0, 1) === '0') {\n throw new Error('Area code cannot start with zero')\n } else if (strippedNumber.substring(0, 1) === '1') {\n throw new Error('Area code cannot start with one')\n }\n\n if (strippedNumber.substring(3, 4) === '0') {\n throw new Error('Exchange code cannot start with zero')\n } else if (strippedNumber.substring(3, 4) === '1') {\n throw new Error('Exchange code cannot start with one')\n }\n\n return strippedNumber\n}\n" }, { "path": "exercises/practice/phone-number/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[79666dce-e0f1-46de-95a1-563802913c35]\ndescription = \"cleans the number\"\n\n[c360451f-549f-43e4-8aba-fdf6cb0bf83f]\ndescription = \"cleans numbers with dots\"\n\n[08f94c34-9a37-46a2-a123-2a8e9727395d]\ndescription = \"cleans numbers with multiple spaces\"\n\n[598d8432-0659-4019-a78b-1c6a73691d21]\ndescription = \"invalid when 9 digits\"\ninclude = false\n\n[2de74156-f646-42b5-8638-0ef1d8b58bc2]\ndescription = \"invalid when 9 digits\"\nreimplements = \"598d8432-0659-4019-a78b-1c6a73691d21\"\n\n[57061c72-07b5-431f-9766-d97da7c4399d]\ndescription = \"invalid when 11 digits does not start with a 1\"\n\n[9962cbf3-97bb-4118-ba9b-38ff49c64430]\ndescription = \"valid when 11 digits and starting with 1\"\n\n[fa724fbf-054c-4d91-95da-f65ab5b6dbca]\ndescription = \"valid when 11 digits and starting with 1 even with punctuation\"\n\n[c6a5f007-895a-4fc5-90bc-a7e70f9b5cad]\ndescription = \"invalid when more than 11 digits\"\ninclude = false\n\n[4a1509b7-8953-4eec-981b-c483358ff531]\ndescription = \"invalid when more than 11 digits\"\nreimplements = \"c6a5f007-895a-4fc5-90bc-a7e70f9b5cad\"\n\n[63f38f37-53f6-4a5f-bd86-e9b404f10a60]\ndescription = \"invalid with letters\"\ninclude = false\n\n[eb8a1fc0-64e5-46d3-b0c6-33184208e28a]\ndescription = \"invalid with letters\"\nreimplements = \"63f38f37-53f6-4a5f-bd86-e9b404f10a60\"\n\n[4bd97d90-52fd-45d3-b0db-06ab95b1244e]\ndescription = \"invalid with punctuations\"\ninclude = false\n\n[065f6363-8394-4759-b080-e6c8c351dd1f]\ndescription = \"invalid with punctuations\"\nreimplements = \"4bd97d90-52fd-45d3-b0db-06ab95b1244e\"\n\n[d77d07f8-873c-4b17-8978-5f66139bf7d7]\ndescription = \"invalid if area code starts with 0\"\n\n[c7485cfb-1e7b-4081-8e96-8cdb3b77f15e]\ndescription = \"invalid if area code starts with 1\"\n\n[4d622293-6976-413d-b8bf-dd8a94d4e2ac]\ndescription = \"invalid if exchange code starts with 0\"\n\n[4cef57b4-7d8e-43aa-8328-1e1b89001262]\ndescription = \"invalid if exchange code starts with 1\"\n\n[9925b09c-1a0d-4960-a197-5d163cbe308c]\ndescription = \"invalid if area code starts with 0 on valid 11-digit number\"\n\n[3f809d37-40f3-44b5-ad90-535838b1a816]\ndescription = \"invalid if area code starts with 1 on valid 11-digit number\"\n\n[e08e5532-d621-40d4-b0cc-96c159276b65]\ndescription = \"invalid if exchange code starts with 0 on valid 11-digit number\"\n\n[57b32f3d-696a-455c-8bf1-137b6d171cdf]\ndescription = \"invalid if exchange code starts with 1 on valid 11-digit number\"\n" }, { "path": "exercises/practice/phone-number/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/phone-number/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/phone-number/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/phone-number/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/phone-number/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/phone-number/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/phone-number/package.json", "content": "{\n \"name\": \"@exercism/typescript-phone-number\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/phone-number/phone-number.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { clean } from './phone-number.ts'\n\ndescribe('Phone Number', () => {\n describe('Cleanup user-entered phone numbers', () => {\n it('cleans the number', () => {\n expect(clean('(223) 456-7890')).toEqual('2234567890')\n })\n\n xit('cleans numbers with dots', () => {\n expect(clean('223.456.7890')).toEqual('2234567890')\n })\n\n xit('cleans numbers with multiple spaces', () => {\n expect(clean('223 456 7890 ')).toEqual('2234567890')\n })\n\n xit('invalid when 9 digits', () => {\n expect(() => clean('123456789')).toThrow(\n new Error('Must not be fewer than 10 digits')\n )\n })\n\n xit('invalid when 11 digits does not start with a 1', () => {\n expect(() => clean('22234567890')).toThrow(\n new Error('11 digits must start with 1')\n )\n })\n\n xit('valid when 11 digits and starting with 1', () => {\n expect(clean('12234567890')).toEqual('2234567890')\n })\n\n xit('valid when 11 digits and starting with 1 even with punctuation', () => {\n expect(clean('+1 (223) 456-7890')).toEqual('2234567890')\n })\n\n xit('invalid when more than 11 digits', () => {\n expect(() => clean('321234567890')).toThrow(\n new Error('Must not be greater than 11 digits')\n )\n })\n\n xit('invalid with letters', () => {\n expect(() => clean('523-abc-7890')).toThrow(\n new Error('Letters not permitted')\n )\n })\n\n xit('invalid with punctuations', () => {\n expect(() => clean('523-@:!-7890')).toThrow(\n new Error('Punctuations not permitted')\n )\n })\n\n xit('invalid if area code starts with 0', () => {\n expect(() => clean('(023) 456-7890')).toThrow(\n new Error('Area code cannot start with zero')\n )\n })\n\n xit('invalid if area code starts with 1', () => {\n expect(() => clean('(123) 456-7890')).toThrow(\n new Error('Area code cannot start with one')\n )\n })\n\n xit('invalid if exchange code starts with 0', () => {\n expect(() => clean('(223) 056-7890')).toThrow(\n new Error('Exchange code cannot start with zero')\n )\n })\n\n xit('invalid if exchange code starts with 1', () => {\n expect(() => clean('(223) 156-7890')).toThrow(\n new Error('Exchange code cannot start with one')\n )\n })\n\n xit('invalid if area code starts with 0 on valid 11-digit number', () => {\n expect(() => clean('1 (023) 456-7890')).toThrow(\n new Error('Area code cannot start with zero')\n )\n })\n\n xit('invalid if area code starts with 1 on valid 11-digit number', () => {\n expect(() => clean('1 (123) 456-7890')).toThrow(\n new Error('Area code cannot start with one')\n )\n })\n\n xit('invalid if exchange code starts with 0 on valid 11-digit number', () => {\n expect(() => clean('1 (223) 056-7890')).toThrow(\n new Error('Exchange code cannot start with zero')\n )\n })\n\n xit('invalid if exchange code starts with 1 on valid 11-digit number', () => {\n expect(() => clean('1 (223) 156-7890')).toThrow(\n new Error('Exchange code cannot start with one')\n )\n })\n })\n})\n" }, { "path": "exercises/practice/phone-number/phone-number.ts", "content": "export function clean() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/phone-number/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/phone-number/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/pig-latin/.docs/instructions.md", "content": "# Instructions\n\nYour task is to translate text from English to Pig Latin.\nThe translation is defined using four rules, which look at the pattern of vowels and consonants at the beginning of a word.\nThese rules look at each word's use of vowels and consonants:\n\n- vowels: the letters `a`, `e`, `i`, `o`, and `u`\n- consonants: the other 21 letters of the English alphabet\n\n## Rule 1\n\nIf a word begins with a vowel, or starts with `\"xr\"` or `\"yt\"`, add an `\"ay\"` sound to the end of the word.\n\nFor example:\n\n- `\"apple\"` -> `\"appleay\"` (starts with vowel)\n- `\"xray\"` -> `\"xrayay\"` (starts with `\"xr\"`)\n- `\"yttria\"` -> `\"yttriaay\"` (starts with `\"yt\"`)\n\n## Rule 2\n\nIf a word begins with one or more consonants, first move those consonants to the end of the word and then add an `\"ay\"` sound to the end of the word.\n\nFor example:\n\n- `\"pig\"` -> `\"igp\"` -> `\"igpay\"` (starts with single consonant)\n- `\"chair\"` -> `\"airch\"` -> `\"airchay\"` (starts with multiple consonants)\n- `\"thrush\"` -> `\"ushthr\"` -> `\"ushthray\"` (starts with multiple consonants)\n\n## Rule 3\n\nIf a word starts with zero or more consonants followed by `\"qu\"`, first move those consonants (if any) and the `\"qu\"` part to the end of the word, and then add an `\"ay\"` sound to the end of the word.\n\nFor example:\n\n- `\"quick\"` -> `\"ickqu\"` -> `\"ickquay\"` (starts with `\"qu\"`, no preceding consonants)\n- `\"square\"` -> `\"aresqu\"` -> `\"aresquay\"` (starts with one consonant followed by `\"qu`\")\n\n## Rule 4\n\nIf a word starts with one or more consonants followed by `\"y\"`, first move the consonants preceding the `\"y\"`to the end of the word, and then add an `\"ay\"` sound to the end of the word.\n\nSome examples:\n\n- `\"my\"` -> `\"ym\"` -> `\"ymay\"` (starts with single consonant followed by `\"y\"`)\n- `\"rhythm\"` -> `\"ythmrh\"` -> `\"ythmrhay\"` (starts with multiple consonants followed by `\"y\"`)\n" }, { "path": "exercises/practice/pig-latin/.docs/introduction.md", "content": "# Introduction\n\nYour parents have challenged you and your sibling to a game of two-on-two basketball.\nConfident they'll win, they let you score the first couple of points, but then start taking over the game.\nNeeding a little boost, you start speaking in [Pig Latin][pig-latin], which is a made-up children's language that's difficult for non-children to understand.\nThis will give you the edge to prevail over your parents!\n\n[pig-latin]: https://en.wikipedia.org/wiki/Pig_latin\n" }, { "path": "exercises/practice/pig-latin/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"pig-latin.ts\"\n ],\n \"test\": [\n \"pig-latin.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement a program that translates from English to Pig Latin.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"The Pig Latin exercise at Test First Teaching by Ultrasaurus\",\n \"source_url\": \"https://github.com/ultrasaurus/test-first-teaching/tree/master/learn_ruby/pig_latin\"\n}\n" }, { "path": "exercises/practice/pig-latin/.meta/proof.ci.ts", "content": "export function translate(phrase: string): string {\n const words = phrase.split(' ')\n const translated: string[] = []\n\n words.forEach((word) => {\n const parts = word.match(/^([^aeiou]?qu|[^aeiou]*)(.+)/)\n const beginning = parts![1]\n const ending = parts![2]\n\n if (beginning.length === 0) {\n translated.push(`${word}ay`)\n } else {\n translated.push(`${ending}${beginning}ay`)\n }\n })\n\n return translated.join(' ')\n}\n" }, { "path": "exercises/practice/pig-latin/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[11567f84-e8c6-4918-aedb-435f0b73db57]\ndescription = \"ay is added to words that start with vowels -> word beginning with a\"\n\n[f623f581-bc59-4f45-9032-90c3ca9d2d90]\ndescription = \"ay is added to words that start with vowels -> word beginning with e\"\n\n[7dcb08b3-23a6-4e8a-b9aa-d4e859450d58]\ndescription = \"ay is added to words that start with vowels -> word beginning with i\"\n\n[0e5c3bff-266d-41c8-909f-364e4d16e09c]\ndescription = \"ay is added to words that start with vowels -> word beginning with o\"\n\n[614ba363-ca3c-4e96-ab09-c7320799723c]\ndescription = \"ay is added to words that start with vowels -> word beginning with u\"\n\n[bf2538c6-69eb-4fa7-a494-5a3fec911326]\ndescription = \"ay is added to words that start with vowels -> word beginning with a vowel and followed by a qu\"\n\n[e5be8a01-2d8a-45eb-abb4-3fcc9582a303]\ndescription = \"first letter and ay are moved to the end of words that start with consonants -> word beginning with p\"\n\n[d36d1e13-a7ed-464d-a282-8820cb2261ce]\ndescription = \"first letter and ay are moved to the end of words that start with consonants -> word beginning with k\"\n\n[d838b56f-0a89-4c90-b326-f16ff4e1dddc]\ndescription = \"first letter and ay are moved to the end of words that start with consonants -> word beginning with x\"\n\n[bce94a7a-a94e-4e2b-80f4-b2bb02e40f71]\ndescription = \"first letter and ay are moved to the end of words that start with consonants -> word beginning with q without a following u\"\n\n[e59dbbe8-ccee-4619-a8e9-ce017489bfc0]\ndescription = \"first letter and ay are moved to the end of words that start with consonants -> word beginning with consonant and vowel containing qu\"\n\n[c01e049a-e3e2-451c-bf8e-e2abb7e438b8]\ndescription = \"some letter clusters are treated like a single consonant -> word beginning with ch\"\n\n[9ba1669e-c43f-4b93-837a-cfc731fd1425]\ndescription = \"some letter clusters are treated like a single consonant -> word beginning with qu\"\n\n[92e82277-d5e4-43d7-8dd3-3a3b316c41f7]\ndescription = \"some letter clusters are treated like a single consonant -> word beginning with qu and a preceding consonant\"\n\n[79ae4248-3499-4d5b-af46-5cb05fa073ac]\ndescription = \"some letter clusters are treated like a single consonant -> word beginning with th\"\n\n[e0b3ae65-f508-4de3-8999-19c2f8e243e1]\ndescription = \"some letter clusters are treated like a single consonant -> word beginning with thr\"\n\n[20bc19f9-5a35-4341-9d69-1627d6ee6b43]\ndescription = \"some letter clusters are treated like a single consonant -> word beginning with sch\"\n\n[54b796cb-613d-4509-8c82-8fbf8fc0af9e]\ndescription = \"some letter clusters are treated like a single vowel -> word beginning with yt\"\n\n[8c37c5e1-872e-4630-ba6e-d20a959b67f6]\ndescription = \"some letter clusters are treated like a single vowel -> word beginning with xr\"\n\n[a4a36d33-96f3-422c-a233-d4021460ff00]\ndescription = \"position of y in a word determines if it is a consonant or a vowel -> y is treated like a consonant at the beginning of a word\"\n\n[adc90017-1a12-4100-b595-e346105042c7]\ndescription = \"position of y in a word determines if it is a consonant or a vowel -> y is treated like a vowel at the end of a consonant cluster\"\n\n[29b4ca3d-efe5-4a95-9a54-8467f2e5e59a]\ndescription = \"position of y in a word determines if it is a consonant or a vowel -> y as second letter in two letter word\"\n\n[44616581-5ce3-4a81-82d0-40c7ab13d2cf]\ndescription = \"phrases are translated -> a whole phrase\"\n" }, { "path": "exercises/practice/pig-latin/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/pig-latin/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/pig-latin/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/pig-latin/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/pig-latin/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/pig-latin/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/pig-latin/package.json", "content": "{\n \"name\": \"@exercism/typescript-pig-latin\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/pig-latin/pig-latin.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { translate } from './pig-latin.ts'\n\ndescribe('ay is added to words that start with vowels', () => {\n it('word beginning with a', () => {\n const expected = 'appleay'\n expect(translate('apple')).toEqual(expected)\n })\n\n xit('word beginning with e', () => {\n const expected = 'earay'\n expect(translate('ear')).toEqual(expected)\n })\n\n xit('word beginning with i', () => {\n const expected = 'iglooay'\n expect(translate('igloo')).toEqual(expected)\n })\n\n xit('word beginning with o', () => {\n const expected = 'objectay'\n expect(translate('object')).toEqual(expected)\n })\n\n xit('word beginning with u', () => {\n const expected = 'underay'\n expect(translate('under')).toEqual(expected)\n })\n\n xit('word beginning with a vowel and followed by a qu', () => {\n const expected = 'equalay'\n expect(translate('equal')).toEqual(expected)\n })\n})\n\nxdescribe('first letter and ay are moved to the end of words that start with consonants', () => {\n xit('word beginning with p', () => {\n const expected = 'igpay'\n expect(translate('pig')).toEqual(expected)\n })\n\n xit('word beginning with k', () => {\n const expected = 'oalakay'\n expect(translate('koala')).toEqual(expected)\n })\n\n xit('word beginning with x', () => {\n const expected = 'enonxay'\n expect(translate('xenon')).toEqual(expected)\n })\n\n xit('word beginning with q without a following u', () => {\n const expected = 'atqay'\n expect(translate('qat')).toEqual(expected)\n })\n\n xit('word beginning with consonant and vowel containing qu', () => {\n const expected = 'iquidlay'\n expect(translate('liquid')).toEqual(expected)\n })\n})\n\nxdescribe('some letter clusters are treated like a single consonant', () => {\n xit('word beginning with ch', () => {\n const expected = 'airchay'\n expect(translate('chair')).toEqual(expected)\n })\n\n xit('word beginning with qu', () => {\n const expected = 'eenquay'\n expect(translate('queen')).toEqual(expected)\n })\n\n xit('word beginning with qu and a preceding consonant', () => {\n const expected = 'aresquay'\n expect(translate('square')).toEqual(expected)\n })\n\n xit('word beginning with th', () => {\n const expected = 'erapythay'\n expect(translate('therapy')).toEqual(expected)\n })\n\n xit('word beginning with thr', () => {\n const expected = 'ushthray'\n expect(translate('thrush')).toEqual(expected)\n })\n\n xit('word beginning with sch', () => {\n const expected = 'oolschay'\n expect(translate('school')).toEqual(expected)\n })\n})\n\nxdescribe('position of y in a word determines if it is a consonant or a vowel', () => {\n xit('y is treated like a consonant at the beginning of a word', () => {\n const expected = 'ellowyay'\n expect(translate('yellow')).toEqual(expected)\n })\n\n xit('y as second letter in two letter word', () => {\n const expected = 'ymay'\n expect(translate('my')).toEqual(expected)\n })\n})\n\nxdescribe('phrases are translated', () => {\n xit('a whole phrase', () => {\n const expected = 'ickquay astfay unray'\n expect(translate('quick fast run')).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/pig-latin/pig-latin.ts", "content": "export function translate() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/pig-latin/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/pig-latin/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/prime-factors/.docs/instructions.md", "content": "# Instructions\n\nCompute the prime factors of a given natural number.\n\nA prime number is only evenly divisible by itself and 1.\n\nNote that 1 is not a prime number.\n\n## Example\n\nWhat are the prime factors of 60?\n\n- Our first divisor is 2.\n 2 goes into 60, leaving 30.\n- 2 goes into 30, leaving 15.\n - 2 doesn't go cleanly into 15.\n So let's move on to our next divisor, 3.\n- 3 goes cleanly into 15, leaving 5.\n - 3 does not go cleanly into 5.\n The next possible factor is 4.\n - 4 does not go cleanly into 5.\n The next possible factor is 5.\n- 5 does go cleanly into 5.\n- We're left only with 1, so now, we're done.\n\nOur successful divisors in that computation represent the list of prime factors of 60: 2, 2, 3, and 5.\n\nYou can check this yourself:\n\n```text\n2 * 2 * 3 * 5\n= 4 * 15\n= 60\n```\n\nSuccess!\n" }, { "path": "exercises/practice/prime-factors/.meta/config.json", "content": "{\n \"authors\": [\n \"jspengeman\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"prime-factors.ts\"\n ],\n \"test\": [\n \"prime-factors.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Compute the prime factors of a given natural number.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"The Prime Factors Kata by Uncle Bob\",\n \"source_url\": \"https://web.archive.org/web/20221026171801/http://butunclebob.com/ArticleS.UncleBob.ThePrimeFactorsKata\"\n}\n" }, { "path": "exercises/practice/prime-factors/.meta/proof.ci.ts", "content": "export function calculatePrimeFactors(num: number): number[] {\n const factors = []\n let currentFactor = 2\n while (num !== 1) {\n if (num % currentFactor === 0) {\n factors.push(currentFactor)\n num /= currentFactor\n currentFactor = 2\n } else {\n currentFactor++\n }\n }\n return factors\n}\n" }, { "path": "exercises/practice/prime-factors/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[924fc966-a8f5-4288-82f2-6b9224819ccd]\ndescription = \"no factors\"\n\n[17e30670-b105-4305-af53-ddde182cb6ad]\ndescription = \"prime number\"\n\n[238d57c8-4c12-42ef-af34-ae4929f94789]\ndescription = \"another prime number\"\n\n[f59b8350-a180-495a-8fb1-1712fbee1158]\ndescription = \"square of a prime\"\n\n[756949d3-3158-4e3d-91f2-c4f9f043ee70]\ndescription = \"product of first prime\"\n\n[bc8c113f-9580-4516-8669-c5fc29512ceb]\ndescription = \"cube of a prime\"\n\n[7d6a3300-a4cb-4065-bd33-0ced1de6cb44]\ndescription = \"product of second prime\"\n\n[073ac0b2-c915-4362-929d-fc45f7b9a9e4]\ndescription = \"product of third prime\"\n\n[6e0e4912-7fb6-47f3-a9ad-dbcd79340c75]\ndescription = \"product of first and second prime\"\n\n[00485cd3-a3fe-4fbe-a64a-a4308fc1f870]\ndescription = \"product of primes and non-primes\"\n\n[02251d54-3ca1-4a9b-85e1-b38f4b0ccb91]\ndescription = \"product of primes\"\n\n[070cf8dc-e202-4285-aa37-8d775c9cd473]\ndescription = \"factors include a large prime\"\n" }, { "path": "exercises/practice/prime-factors/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/prime-factors/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/prime-factors/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/prime-factors/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/prime-factors/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/prime-factors/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/prime-factors/package.json", "content": "{\n \"name\": \"@exercism/typescript-prime-factors\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/prime-factors/prime-factors.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { calculatePrimeFactors } from './prime-factors.ts'\n\ndescribe('calculatePrimeFactors', () => {\n it('returns an empty array for 1', () =>\n expect(calculatePrimeFactors(1)).toEqual([]))\n\n xit('factors 2', () => expect(calculatePrimeFactors(2)).toEqual([2]))\n\n xit('factors 3', () => expect(calculatePrimeFactors(3)).toEqual([3]))\n\n xit('factors 4', () => expect(calculatePrimeFactors(4)).toEqual([2, 2]))\n\n xit('factors 6', () => expect(calculatePrimeFactors(6)).toEqual([2, 3]))\n\n xit('factors 8', () => expect(calculatePrimeFactors(8)).toEqual([2, 2, 2]))\n\n xit('factors 9', () => expect(calculatePrimeFactors(9)).toEqual([3, 3]))\n\n xit('factors 12', () => expect(calculatePrimeFactors(12)).toEqual([2, 2, 3]))\n\n xit('factors 27', () => expect(calculatePrimeFactors(27)).toEqual([3, 3, 3]))\n\n xit('factors 625', () =>\n expect(calculatePrimeFactors(625)).toEqual([5, 5, 5, 5]))\n\n xit('factors 901255', () =>\n expect(calculatePrimeFactors(901255)).toEqual([5, 17, 23, 461]))\n\n xit('factors 93819012551', () =>\n expect(calculatePrimeFactors(93819012551)).toEqual([11, 9539, 894119]))\n})\n" }, { "path": "exercises/practice/prime-factors/prime-factors.ts", "content": "export function calculatePrimeFactors() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/prime-factors/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/prime-factors/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/prism/.docs/instructions.md", "content": "# Instructions\n\nBefore activating the laser array, you must predict the exact order in which crystals will be hit, identified by their sample IDs.\n\n## Example Test Case\n\nConsider this crystal array configuration:\n\n```json\n{\n \"start\": { \"x\": 0, \"y\": 0, \"angle\": 0 },\n \"prisms\": [\n { \"id\": 3, \"x\": 30, \"y\": 10, \"angle\": 45 },\n { \"id\": 1, \"x\": 10, \"y\": 10, \"angle\": -90 },\n { \"id\": 2, \"x\": 10, \"y\": 0, \"angle\": 90 },\n { \"id\": 4, \"x\": 20, \"y\": 0, \"angle\": 0 }\n ]\n}\n```\n\n## What's Happening\n\nThe laser starts at the origin `(0, 0)` and fires horizontally to the right at angle 0Ā°.\nHere's the step-by-step beam path:\n\n**Step 1**: The beam travels along the x-axis (y = 0) and first encounters **Crystal #2** at position `(10, 0)`.\nThis crystal has a refraction angle of 90Ā°, which means it bends the beam perpendicular to its current path.\nThe beam, originally traveling at 0Ā°, is now redirected to 90Ā° (straight up).\n\n**Step 2**: The beam now travels vertically upward from position `(10, 0)` and strikes **Crystal #1** at position `(10, 10)`.\nThis crystal has a refraction angle of -90Ā°, bending the beam by -90Ā° relative to its current direction.\nThe beam was traveling at 90Ā°, so after refraction it's now at 0Ā° (90Ā° + (-90Ā°) = 0Ā°), traveling horizontally to the right again.\n\n**Step 3**: From position `(10, 10)`, the beam travels horizontally and encounters **Crystal #3** at position `(30, 10)`.\nThis crystal refracts the beam by 45Ā°, changing its direction to 45Ā°.\nThe beam continues into empty space beyond the array.\n" }, { "path": "exercises/practice/prism/.docs/introduction.md", "content": "# Introduction\n\nYou're a researcher at **PRISM** (Precariously Redirected Illumination Safety Management), working with a precision laser calibration system that tests experimental crystal prisms.\nThese crystals are being developed for next-generation optical computers, and each one has unique refractive properties based on its molecular structure.\nThe lab's laser system can damage crystals if they receive unexpected illumination, so precise path prediction is critical.\n" }, { "path": "exercises/practice/prism/.meta/config.json", "content": "{\n \"authors\": [\n \"BNAndras\"\n ],\n \"files\": {\n \"solution\": [\n \"prism.ts\"\n ],\n \"test\": [\n \"prism.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Calculate the path of a laser through reflective prisms.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"FraSanga\",\n \"source_url\": \"https://github.com/exercism/problem-specifications/pull/2625\"\n}\n" }, { "path": "exercises/practice/prism/.meta/proof.ci.ts", "content": "type Point = {\n x: number\n y: number\n angle: number\n}\n\ntype Prism = Point & {\n id: number\n}\n\nexport const findSequence = (start: Point, prisms: Prism[]): number[] => {\n let { x, y, angle } = start\n const sequence = []\n\n while (true) {\n const rad = (angle * Math.PI) / 180\n const dirX = Math.cos(rad)\n const dirY = Math.sin(rad)\n\n let nearest: Prism\n let nearestDist = Infinity\n\n for (const prism of prisms) {\n const dx = prism.x - x\n const dy = prism.y - y\n\n const dist = dx * dirX + dy * dirY\n const baseTolerance = 1e-6\n if (dist <= baseTolerance) continue\n\n const crossProductSquared =\n (dx - dist * dirX) ** 2 + (dy - dist * dirY) ** 2\n const relativeTolerance = baseTolerance * Math.max(1, dist * dist)\n if (crossProductSquared >= relativeTolerance) continue\n\n if (dist < nearestDist) {\n nearestDist = dist\n nearest = prism\n }\n }\n\n if (!nearest) break\n\n sequence.push(nearest.id)\n x = nearest.x\n y = nearest.y\n angle = (angle + nearest.angle) % 360\n }\n\n return sequence\n}\n" }, { "path": "exercises/practice/prism/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[ec65d3b3-f7bf-4015-8156-0609c141c4c4]\ndescription = \"zero prisms\"\n\n[ec0ca17c-0c5f-44fb-89ba-b76395bdaf1c]\ndescription = \"one prism one hit\"\n\n[0db955f2-0a27-4c82-ba67-197bd6202069]\ndescription = \"one prism zero hits\"\n\n[8d92485b-ebc0-4ee9-9b88-cdddb16b52da]\ndescription = \"going up zero hits\"\n\n[78295b3c-7438-492d-8010-9c63f5c223d7]\ndescription = \"going down zero hits\"\n\n[acc723ea-597b-4a50-8d1b-b980fe867d4c]\ndescription = \"going left zero hits\"\n\n[3f19b9df-9eaa-4f18-a2db-76132f466d17]\ndescription = \"negative angle\"\n\n[96dacffb-d821-4cdf-aed8-f152ce063195]\ndescription = \"large angle\"\n\n[513a7caa-957f-4c5d-9820-076842de113c]\ndescription = \"upward refraction two hits\"\n\n[d452b7c7-9761-4ea9-81a9-2de1d73eb9ef]\ndescription = \"downward refraction two hits\"\n\n[be1a2167-bf4c-4834-acc9-e4d68e1a0203]\ndescription = \"same prism twice\"\n\n[df5a60dd-7c7d-4937-ac4f-c832dae79e2e]\ndescription = \"simple path\"\n\n[8d9a3cc8-e846-4a3b-a137-4bfc4aa70bd1]\ndescription = \"multiple prisms floating point precision\"\n\n[e077fc91-4e4a-46b3-a0f5-0ba00321da56]\ndescription = \"complex path with multiple prisms floating point precision\"\n" }, { "path": "exercises/practice/prism/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/prism/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/prism/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/prism/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/prism/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/prism/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/prism/package.json", "content": "{\n \"name\": \"@exercism/typescript-prism\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/prism/prism.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { findSequence } from './prism.ts'\n\ndescribe('Prism', () => {\n it('zero prisms', () => {\n const start = { x: 0, y: 0, angle: 0 }\n const prisms: { id: number; x: number; y: number; angle: number }[] = []\n const result = findSequence(start, prisms)\n const expected: number[] = []\n expect(result).toEqual(expected)\n })\n\n xit('one prism one hit', () => {\n const start = { x: 0, y: 0, angle: 0 }\n const prisms = [{ id: 1, x: 10, y: 0, angle: 0 }]\n const result = findSequence(start, prisms)\n const expected = [1]\n expect(result).toEqual(expected)\n })\n\n xit('one prism zero hits', () => {\n const start = { x: 0, y: 0, angle: 0 }\n const prisms = [{ id: 1, x: -10, y: 0, angle: 0 }]\n const result = findSequence(start, prisms)\n const expected: number[] = []\n expect(result).toEqual(expected)\n })\n\n xit('going up zero hits', () => {\n const start = { x: 0, y: 0, angle: 90 }\n const prisms = [\n { id: 3, x: 0, y: -10, angle: 0 },\n { id: 1, x: -10, y: 0, angle: 0 },\n { id: 2, x: 10, y: 0, angle: 0 },\n ]\n const result = findSequence(start, prisms)\n const expected: number[] = []\n expect(result).toEqual(expected)\n })\n\n xit('going down zero hits', () => {\n const start = { x: 0, y: 0, angle: -90 }\n const prisms = [\n { id: 1, x: 10, y: 0, angle: 0 },\n { id: 2, x: 0, y: 10, angle: 0 },\n { id: 3, x: -10, y: 0, angle: 0 },\n ]\n const result = findSequence(start, prisms)\n const expected: number[] = []\n expect(result).toEqual(expected)\n })\n\n xit('going left zero hits', () => {\n const start = { x: 0, y: 0, angle: 180 }\n const prisms = [\n { id: 2, x: 0, y: 10, angle: 0 },\n { id: 3, x: 10, y: 0, angle: 0 },\n { id: 1, x: 0, y: -10, angle: 0 },\n ]\n const result = findSequence(start, prisms)\n const expected: number[] = []\n expect(result).toEqual(expected)\n })\n\n xit('negative angle', () => {\n const start = { x: 0, y: 0, angle: -180 }\n const prisms = [\n { id: 1, x: 0, y: -10, angle: 0 },\n { id: 2, x: 0, y: 10, angle: 0 },\n { id: 3, x: 10, y: 0, angle: 0 },\n ]\n const result = findSequence(start, prisms)\n const expected: number[] = []\n expect(result).toEqual(expected)\n })\n\n xit('large angle', () => {\n const start = { x: 0, y: 0, angle: 2340 }\n const prisms = [{ id: 1, x: 10, y: 0, angle: 0 }]\n const result = findSequence(start, prisms)\n const expected: number[] = []\n expect(result).toEqual(expected)\n })\n\n xit('upward refraction two hits', () => {\n const start = { x: 0, y: 0, angle: 0 }\n const prisms = [\n { id: 1, x: 10, y: 10, angle: 0 },\n { id: 2, x: 10, y: 0, angle: 90 },\n ]\n const result = findSequence(start, prisms)\n const expected = [2, 1]\n expect(result).toEqual(expected)\n })\n\n xit('downward refraction two hits', () => {\n const start = { x: 0, y: 0, angle: 0 }\n const prisms = [\n { id: 1, x: 10, y: 0, angle: -90 },\n { id: 2, x: 10, y: -10, angle: 0 },\n ]\n const result = findSequence(start, prisms)\n const expected = [1, 2]\n expect(result).toEqual(expected)\n })\n\n xit('same prism twice', () => {\n const start = { x: 0, y: 0, angle: 0 }\n const prisms = [\n { id: 2, x: 10, y: 0, angle: 0 },\n { id: 1, x: 20, y: 0, angle: -180 },\n ]\n const result = findSequence(start, prisms)\n const expected = [2, 1, 2]\n expect(result).toEqual(expected)\n })\n\n xit('simple path', () => {\n const start = { x: 0, y: 0, angle: 0 }\n const prisms = [\n { id: 3, x: 30, y: 10, angle: 45 },\n { id: 1, x: 10, y: 10, angle: -90 },\n { id: 2, x: 10, y: 0, angle: 90 },\n { id: 4, x: 20, y: 0, angle: 0 },\n ]\n const result = findSequence(start, prisms)\n const expected = [2, 1, 3]\n expect(result).toEqual(expected)\n })\n\n xit('multiple prisms floating point precision', () => {\n const start = { x: 0, y: 0, angle: -6.429 }\n const prisms = [\n { id: 26, x: 5.8, y: 73.4, angle: 6.555 },\n { id: 24, x: 36.2, y: 65.2, angle: -0.304 },\n { id: 20, x: 20.4, y: 82.8, angle: 45.17 },\n { id: 31, x: -20.2, y: 48.8, angle: 30.615 },\n { id: 30, x: 24.0, y: 0.6, angle: 28.771 },\n { id: 29, x: 31.4, y: 79.4, angle: 61.327 },\n { id: 28, x: 36.4, y: 31.4, angle: -18.157 },\n { id: 22, x: 47.0, y: 57.8, angle: 54.745 },\n { id: 38, x: 36.4, y: 79.2, angle: 49.05 },\n { id: 10, x: 37.8, y: 55.2, angle: 11.978 },\n { id: 18, x: -26.0, y: 42.6, angle: 22.661 },\n { id: 25, x: 38.8, y: 76.2, angle: 51.958 },\n { id: 2, x: 0.0, y: 42.4, angle: -21.817 },\n { id: 35, x: 21.4, y: 44.8, angle: -171.579 },\n { id: 7, x: 14.2, y: -1.6, angle: 19.081 },\n { id: 33, x: 11.2, y: 44.4, angle: -165.941 },\n { id: 11, x: 15.4, y: 82.6, angle: 66.262 },\n { id: 16, x: 30.8, y: 6.6, angle: 35.852 },\n { id: 15, x: -3.0, y: 79.2, angle: 53.782 },\n { id: 4, x: 29.0, y: 75.4, angle: 17.016 },\n { id: 23, x: 41.6, y: 59.8, angle: 70.763 },\n { id: 8, x: -10.0, y: 15.8, angle: -9.24 },\n { id: 13, x: 48.6, y: 51.8, angle: 45.812 },\n { id: 1, x: 13.2, y: 77.0, angle: 17.937 },\n { id: 34, x: -8.8, y: 36.8, angle: -4.199 },\n { id: 21, x: 24.4, y: 75.8, angle: 20.783 },\n { id: 17, x: -4.4, y: 74.6, angle: 24.709 },\n { id: 9, x: 30.8, y: 41.8, angle: -165.413 },\n { id: 32, x: 4.2, y: 78.6, angle: 40.892 },\n { id: 37, x: -15.8, y: 47.0, angle: 33.29 },\n { id: 6, x: 1.0, y: 80.6, angle: 51.295 },\n { id: 36, x: -27.0, y: 47.8, angle: 92.52 },\n { id: 14, x: -2.0, y: 34.4, angle: -52.001 },\n { id: 5, x: 23.2, y: 80.2, angle: 31.866 },\n { id: 27, x: -5.6, y: 32.8, angle: -75.303 },\n { id: 12, x: -1.0, y: 0.2, angle: 0.0 },\n { id: 3, x: -6.6, y: 3.2, angle: 46.72 },\n { id: 19, x: -13.8, y: 24.2, angle: -9.205 },\n ]\n const result = findSequence(start, prisms)\n const expected = [\n 7, 30, 16, 28, 13, 22, 23, 10, 9, 24, 25, 38, 29, 4, 35, 21, 5, 20, 11, 1,\n 33, 26, 32, 6, 15, 17, 2, 14, 27, 34, 37, 31, 36, 18, 19, 8, 3, 12,\n ]\n expect(result).toEqual(expected)\n })\n\n xit('complex path with multiple prisms floating point precision', () => {\n const start = { x: 0, y: 0, angle: 0.0 }\n const prisms = [\n { id: 46, x: 37.4, y: 20.6, angle: -88.332 },\n { id: 72, x: -24.2, y: 23.4, angle: -90.774 },\n { id: 25, x: 78.6, y: 7.8, angle: 98.562 },\n { id: 60, x: -58.8, y: 31.6, angle: 115.56 },\n { id: 22, x: 75.2, y: 28.0, angle: 63.515 },\n { id: 2, x: 89.8, y: 27.8, angle: 91.176 },\n { id: 23, x: 9.8, y: 30.8, angle: 30.829 },\n { id: 69, x: 22.8, y: 20.6, angle: -88.315 },\n { id: 44, x: -0.8, y: 15.6, angle: -116.565 },\n { id: 36, x: -24.2, y: 8.2, angle: -90.0 },\n { id: 53, x: -1.2, y: 0.0, angle: 0.0 },\n { id: 52, x: 14.2, y: 24.0, angle: -143.896 },\n { id: 5, x: -65.2, y: 21.6, angle: 93.128 },\n { id: 66, x: 5.4, y: 15.6, angle: 31.608 },\n { id: 51, x: -72.6, y: 21.0, angle: -100.976 },\n { id: 65, x: 48.0, y: 10.2, angle: 87.455 },\n { id: 21, x: -41.8, y: 0.0, angle: 68.352 },\n { id: 18, x: -46.2, y: 19.2, angle: -128.362 },\n { id: 10, x: 74.4, y: 0.4, angle: 90.939 },\n { id: 15, x: 67.6, y: 0.4, angle: 84.958 },\n { id: 35, x: 14.8, y: -0.4, angle: 89.176 },\n { id: 1, x: 83.0, y: 0.2, angle: 89.105 },\n { id: 68, x: 14.6, y: 28.0, angle: -29.867 },\n { id: 67, x: 79.8, y: 18.6, angle: -136.643 },\n { id: 38, x: 53.0, y: 14.6, angle: -90.848 },\n { id: 31, x: -58.0, y: 6.6, angle: -61.837 },\n { id: 74, x: -30.8, y: 0.4, angle: 85.966 },\n { id: 48, x: -4.6, y: 10.0, angle: -161.222 },\n { id: 12, x: 59.0, y: 5.0, angle: -91.164 },\n { id: 33, x: -16.4, y: 18.4, angle: 90.734 },\n { id: 4, x: 82.6, y: 27.6, angle: 71.127 },\n { id: 75, x: -10.2, y: 30.6, angle: -1.108 },\n { id: 28, x: 38.0, y: 0.0, angle: 86.863 },\n { id: 11, x: 64.4, y: -0.2, angle: 92.353 },\n { id: 9, x: -51.4, y: 31.6, angle: 67.249 },\n { id: 26, x: -39.8, y: 30.8, angle: 61.113 },\n { id: 30, x: -34.2, y: 0.6, angle: 111.33 },\n { id: 56, x: -51.0, y: 0.2, angle: 70.445 },\n { id: 41, x: -12.0, y: 0.0, angle: 91.219 },\n { id: 24, x: 63.8, y: 14.4, angle: 86.586 },\n { id: 70, x: -72.8, y: 13.4, angle: -87.238 },\n { id: 3, x: 22.4, y: 7.0, angle: -91.685 },\n { id: 13, x: 34.4, y: 7.0, angle: 90.0 },\n { id: 16, x: -47.4, y: 11.4, angle: -136.02 },\n { id: 6, x: 90.0, y: 0.2, angle: 90.415 },\n { id: 54, x: 44.0, y: 27.8, angle: 85.969 },\n { id: 32, x: -9.0, y: 0.0, angle: 91.615 },\n { id: 8, x: -31.6, y: 30.8, angle: 0.535 },\n { id: 39, x: -12.0, y: 8.2, angle: 90.0 },\n { id: 14, x: -79.6, y: 32.4, angle: 92.342 },\n { id: 42, x: 65.8, y: 20.8, angle: -85.867 },\n { id: 40, x: -65.0, y: 14.0, angle: 87.109 },\n { id: 45, x: 10.6, y: 18.8, angle: 23.697 },\n { id: 71, x: -24.2, y: 18.6, angle: -88.531 },\n { id: 7, x: -72.6, y: 6.4, angle: -89.148 },\n { id: 62, x: -32.0, y: 24.8, angle: -140.8 },\n { id: 49, x: 34.4, y: -0.2, angle: 89.415 },\n { id: 63, x: 74.2, y: 12.6, angle: -138.429 },\n { id: 59, x: 82.8, y: 13.0, angle: -140.177 },\n { id: 34, x: -9.4, y: 23.2, angle: -88.238 },\n { id: 76, x: -57.6, y: 0.0, angle: 1.2 },\n { id: 43, x: 7.0, y: 0.0, angle: 116.565 },\n { id: 20, x: 45.8, y: -0.2, angle: 1.469 },\n { id: 37, x: -16.6, y: 13.2, angle: 84.785 },\n { id: 58, x: -79.0, y: -0.2, angle: 89.481 },\n { id: 50, x: -24.2, y: 12.8, angle: -86.987 },\n { id: 64, x: 59.2, y: 10.2, angle: -92.203 },\n { id: 61, x: -72.0, y: 26.4, angle: -83.66 },\n { id: 47, x: 45.4, y: 5.8, angle: -82.992 },\n { id: 17, x: -52.2, y: 17.8, angle: -52.938 },\n { id: 57, x: -61.8, y: 32.0, angle: 84.627 },\n { id: 29, x: 47.2, y: 28.2, angle: 92.954 },\n { id: 27, x: -4.6, y: 0.2, angle: 87.397 },\n { id: 55, x: -61.4, y: 26.4, angle: 94.086 },\n { id: 73, x: -40.4, y: 13.4, angle: -62.229 },\n { id: 19, x: 53.2, y: 20.6, angle: -87.181 },\n ]\n const result = findSequence(start, prisms)\n const expected = [\n 43, 44, 66, 45, 52, 35, 49, 13, 3, 69, 46, 28, 20, 11, 24, 38, 19, 42, 15,\n 10, 63, 25, 59, 1, 6, 2, 4, 67, 22, 29, 65, 64, 12, 47, 54, 68, 23, 75, 8,\n 26, 18, 9, 60, 17, 31, 7, 70, 40, 5, 51, 61, 55, 57, 14, 58, 76, 56, 16,\n 21, 30, 73, 62, 74, 41, 39, 36, 50, 37, 33, 71, 72, 34, 32, 27, 48, 53,\n ]\n expect(result).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/prism/prism.ts", "content": "export function findSequence(start: unknown, prisms: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/prism/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/prism/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/protein-translation/.docs/instructions.md", "content": "# Instructions\n\nYour job is to translate RNA sequences into proteins.\n\nRNA strands are made up of three-nucleotide sequences called **codons**.\nEach codon translates to an **amino acid**.\nWhen joined together, those amino acids make a protein.\n\nIn the real world, there are 64 codons, which in turn correspond to 20 amino acids.\nHowever, for this exercise, youā€™ll only use a few of the possible 64.\nThey are listed below:\n\n| Codon | Amino Acid |\n| ------------------ | ------------- |\n| AUG | Methionine |\n| UUU, UUC | Phenylalanine |\n| UUA, UUG | Leucine |\n| UCU, UCC, UCA, UCG | Serine |\n| UAU, UAC | Tyrosine |\n| UGU, UGC | Cysteine |\n| UGG | Tryptophan |\n| UAA, UAG, UGA | STOP |\n\nFor example, the RNA string ā€œAUGUUUUCUā€ has three codons: ā€œAUGā€, ā€œUUUā€ and ā€œUCUā€.\nThese map to Methionine, Phenylalanine, and Serine.\n\n## ā€œSTOPā€ Codons\n\nYouā€™ll note from the table above that there are three **ā€œSTOPā€ codons**.\nIf you encounter any of these codons, ignore the rest of the sequence ā€” the protein is complete.\n\nFor example, ā€œAUGUUUUCUUAAAUGā€ contains a STOP codon (ā€œUAAā€).\nOnce we reach that point, we stop processing.\nWe therefore only consider the part before it (i.e. ā€œAUGUUUUCUā€), not any further codons after it (i.e. ā€œAUGā€).\n\nLearn more about [protein translation on Wikipedia][protein-translation].\n\n[protein-translation]: https://en.wikipedia.org/wiki/Translation_(biology)\n" }, { "path": "exercises/practice/protein-translation/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"protein-translation.ts\"\n ],\n \"test\": [\n \"protein-translation.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Translate RNA sequences into proteins.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Tyler Long\"\n}\n" }, { "path": "exercises/practice/protein-translation/.meta/proof.ci.ts", "content": "const ACID_PROTEIN_MAP = {\n AUG: 'Methionine',\n UUU: 'Phenylalanine',\n UUC: 'Phenylalanine',\n UUA: 'Leucine',\n UUG: 'Leucine',\n UCU: 'Serine',\n UCC: 'Serine',\n UCA: 'Serine',\n UCG: 'Serine',\n UAU: 'Tyrosine',\n UAC: 'Tyrosine',\n UGU: 'Cysteine',\n UGC: 'Cysteine',\n UGG: 'Tryptophan',\n UAA: 'STOP',\n UAG: 'STOP',\n UGA: 'STOP',\n} as const\n\ntype Codon = keyof typeof ACID_PROTEIN_MAP\ntype Protein = (typeof ACID_PROTEIN_MAP)[Codon]\n\nconst getProtein = (codon: string): Protein | 'INVALID' =>\n ACID_PROTEIN_MAP[codon as Codon] || 'INVALID'\n\nexport const translate = (rnaStrand: string): Protein[] => {\n const proteins: (typeof ACID_PROTEIN_MAP)[keyof typeof ACID_PROTEIN_MAP][] =\n []\n\n if (rnaStrand) {\n for (let i = 0; i < rnaStrand.length; i += 3) {\n const protein = getProtein(rnaStrand.substring(i, i + 3))\n\n if (protein) {\n if (protein === 'STOP') {\n break\n }\n\n if (protein === 'INVALID') {\n throw new Error('Invalid codon')\n }\n\n proteins.push(protein)\n }\n }\n }\n\n return proteins\n}\n" }, { "path": "exercises/practice/protein-translation/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[2c44f7bf-ba20-43f7-a3bf-f2219c0c3f98]\ndescription = \"Empty RNA sequence results in no proteins\"\n\n[96d3d44f-34a2-4db4-84cd-fff523e069be]\ndescription = \"Methionine RNA sequence\"\n\n[1b4c56d8-d69f-44eb-be0e-7b17546143d9]\ndescription = \"Phenylalanine RNA sequence 1\"\n\n[81b53646-bd57-4732-b2cb-6b1880e36d11]\ndescription = \"Phenylalanine RNA sequence 2\"\n\n[42f69d4f-19d2-4d2c-a8b0-f0ae9ee1b6b4]\ndescription = \"Leucine RNA sequence 1\"\n\n[ac5edadd-08ed-40a3-b2b9-d82bb50424c4]\ndescription = \"Leucine RNA sequence 2\"\n\n[8bc36e22-f984-44c3-9f6b-ee5d4e73f120]\ndescription = \"Serine RNA sequence 1\"\n\n[5c3fa5da-4268-44e5-9f4b-f016ccf90131]\ndescription = \"Serine RNA sequence 2\"\n\n[00579891-b594-42b4-96dc-7ff8bf519606]\ndescription = \"Serine RNA sequence 3\"\n\n[08c61c3b-fa34-4950-8c4a-133945570ef6]\ndescription = \"Serine RNA sequence 4\"\n\n[54e1e7d8-63c0-456d-91d2-062c72f8eef5]\ndescription = \"Tyrosine RNA sequence 1\"\n\n[47bcfba2-9d72-46ad-bbce-22f7666b7eb1]\ndescription = \"Tyrosine RNA sequence 2\"\n\n[3a691829-fe72-43a7-8c8e-1bd083163f72]\ndescription = \"Cysteine RNA sequence 1\"\n\n[1b6f8a26-ca2f-43b8-8262-3ee446021767]\ndescription = \"Cysteine RNA sequence 2\"\n\n[1e91c1eb-02c0-48a0-9e35-168ad0cb5f39]\ndescription = \"Tryptophan RNA sequence\"\n\n[e547af0b-aeab-49c7-9f13-801773a73557]\ndescription = \"STOP codon RNA sequence 1\"\n\n[67640947-ff02-4f23-a2ef-816f8a2ba72e]\ndescription = \"STOP codon RNA sequence 2\"\n\n[9c2ad527-ebc9-4ace-808b-2b6447cb54cb]\ndescription = \"STOP codon RNA sequence 3\"\n\n[f4d9d8ee-00a8-47bf-a1e3-1641d4428e54]\ndescription = \"Sequence of two protein codons translates into proteins\"\n\n[dd22eef3-b4f1-4ad6-bb0b-27093c090a9d]\ndescription = \"Sequence of two different protein codons translates into proteins\"\n\n[d0f295df-fb70-425c-946c-ec2ec185388e]\ndescription = \"Translate RNA strand into correct protein list\"\n\n[e30e8505-97ec-4e5f-a73e-5726a1faa1f4]\ndescription = \"Translation stops if STOP codon at beginning of sequence\"\n\n[5358a20b-6f4c-4893-bce4-f929001710f3]\ndescription = \"Translation stops if STOP codon at end of two-codon sequence\"\n\n[ba16703a-1a55-482f-bb07-b21eef5093a3]\ndescription = \"Translation stops if STOP codon at end of three-codon sequence\"\n\n[4089bb5a-d5b4-4e71-b79e-b8d1f14a2911]\ndescription = \"Translation stops if STOP codon in middle of three-codon sequence\"\n\n[2c2a2a60-401f-4a80-b977-e0715b23b93d]\ndescription = \"Translation stops if STOP codon in middle of six-codon sequence\"\n\n[f6f92714-769f-4187-9524-e353e8a41a80]\ndescription = \"Sequence of two non-STOP codons does not translate to a STOP codon\"\n\n[1e75ea2a-f907-4994-ae5c-118632a1cb0f]\ndescription = \"Non-existing codon can't translate\"\n\n[9eac93f3-627a-4c90-8653-6d0a0595bc6f]\ndescription = \"Unknown amino acids, not part of a codon, can't translate\"\nreimplements = \"1e75ea2a-f907-4994-ae5c-118632a1cb0f\"\n\n[9d73899f-e68e-4291-b1e2-7bf87c00f024]\ndescription = \"Incomplete RNA sequence can't translate\"\n\n[43945cf7-9968-402d-ab9f-b8a28750b050]\ndescription = \"Incomplete RNA sequence can translate if valid until a STOP codon\"\n" }, { "path": "exercises/practice/protein-translation/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/protein-translation/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/protein-translation/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/protein-translation/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/protein-translation/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/protein-translation/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/protein-translation/package.json", "content": "{\n \"name\": \"@exercism/typescript-protein-translation\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/protein-translation/protein-translation.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { translate } from './protein-translation.ts'\n\ndescribe('Translate input RNA sequences into proteins', () => {\n it('Methionine RNA sequence', () => {\n const expected = ['Methionine']\n expect(translate('AUG')).toEqual(expected)\n })\n\n xit('Phenylalanine RNA sequence 1', () => {\n const expected = ['Phenylalanine']\n expect(translate('UUU')).toEqual(expected)\n })\n\n xit('Phenylalanine RNA sequence 2', () => {\n const expected = ['Phenylalanine']\n expect(translate('UUC')).toEqual(expected)\n })\n\n xit('Leucine RNA sequence 1', () => {\n const expected = ['Leucine']\n expect(translate('UUA')).toEqual(expected)\n })\n\n xit('Leucine RNA sequence 2', () => {\n const expected = ['Leucine']\n expect(translate('UUG')).toEqual(expected)\n })\n\n xit('Serine RNA sequence 1', () => {\n const expected = ['Serine']\n expect(translate('UCU')).toEqual(expected)\n })\n\n xit('Serine RNA sequence 2', () => {\n const expected = ['Serine']\n expect(translate('UCC')).toEqual(expected)\n })\n\n xit('Serine RNA sequence 3', () => {\n const expected = ['Serine']\n expect(translate('UCA')).toEqual(expected)\n })\n\n xit('Serine RNA sequence 4', () => {\n const expected = ['Serine']\n expect(translate('UCG')).toEqual(expected)\n })\n\n xit('Tyrosine RNA sequence 1', () => {\n const expected = ['Tyrosine']\n expect(translate('UAU')).toEqual(expected)\n })\n\n xit('Tyrosine RNA sequence 2', () => {\n const expected = ['Tyrosine']\n expect(translate('UAC')).toEqual(expected)\n })\n\n xit('Cysteine RNA sequence 1', () => {\n const expected = ['Cysteine']\n expect(translate('UGU')).toEqual(expected)\n })\n\n xit('Cysteine RNA sequence 2', () => {\n const expected = ['Cysteine']\n expect(translate('UGC')).toEqual(expected)\n })\n\n xit('Tryptophan RNA sequence', () => {\n const expected = ['Tryptophan']\n expect(translate('UGG')).toEqual(expected)\n })\n\n xit('STOP codon RNA sequence 1', () => {\n const expected: string[] = []\n expect(translate('UAA')).toEqual(expected)\n })\n\n xit('STOP codon RNA sequence 2', () => {\n const expected: string[] = []\n expect(translate('UAG')).toEqual(expected)\n })\n\n xit('STOP codon RNA sequence 3', () => {\n const expected: string[] = []\n expect(translate('UGA')).toEqual(expected)\n })\n\n xit('Sequence of two protein codons translates into proteins', () => {\n const expected = ['Phenylalanine', 'Phenylalanine']\n expect(translate('UUUUUU')).toEqual(expected)\n })\n\n xit('Sequence of two different protein codons translates into proteins', () => {\n const expected = ['Leucine', 'Leucine']\n expect(translate('UUAUUG')).toEqual(expected)\n })\n\n xit('Translate RNA strand into correct protein list', () => {\n const expected = ['Methionine', 'Phenylalanine', 'Tryptophan']\n expect(translate('AUGUUUUGG')).toEqual(expected)\n })\n\n xit('Translation stops if STOP codon at beginning of sequence', () => {\n const expected: string[] = []\n expect(translate('UAGUGG')).toEqual(expected)\n })\n\n xit('Translation stops if STOP codon at end of two-codon sequence', () => {\n const expected = ['Tryptophan']\n expect(translate('UGGUAG')).toEqual(expected)\n })\n\n xit('Translation stops if STOP codon at end of three-codon sequence', () => {\n const expected = ['Methionine', 'Phenylalanine']\n expect(translate('AUGUUUUAA')).toEqual(expected)\n })\n\n xit('Translation stops if STOP codon in middle of three-codon sequence', () => {\n const expected = ['Tryptophan']\n expect(translate('UGGUAGUGG')).toEqual(expected)\n })\n\n xit('Translation stops if STOP codon in middle of six-codon sequence', () => {\n const expected = ['Tryptophan', 'Cysteine', 'Tyrosine']\n expect(translate('UGGUGUUAUUAAUGGUUU')).toEqual(expected)\n })\n\n xit('Sequence of two non-STOP codons does not translate to a STOP codon', () => {\n const expected = ['Methionine', 'Methionine']\n expect(translate('AUGAUG')).toEqual(expected)\n })\n\n xit(\"Unknown amino acids, not part of a codon, can't translate\", () => {\n expect(() => {\n translate('XYZ')\n }).toThrow('Invalid codon')\n })\n\n xit(\"Incomplete RNA sequence can't translate\", () => {\n expect(() => {\n translate('AUGU')\n }).toThrow('Invalid codon')\n })\n\n xit('Incomplete RNA sequence can translate if valid until a STOP codon', () => {\n const expected = ['Phenylalanine', 'Phenylalanine']\n expect(translate('UUCUUCUAAUGGU')).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/protein-translation/protein-translation.ts", "content": "export function translate() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/protein-translation/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/protein-translation/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/proverb/.docs/instructions.md", "content": "# Instructions\n\nFor want of a horseshoe nail, a kingdom was lost, or so the saying goes.\n\nGiven a list of inputs, generate the relevant proverb.\nFor example, given the list `[\"nail\", \"shoe\", \"horse\", \"rider\", \"message\", \"battle\", \"kingdom\"]`, you will output the full text of this proverbial rhyme:\n\n```text\nFor want of a nail the shoe was lost.\nFor want of a shoe the horse was lost.\nFor want of a horse the rider was lost.\nFor want of a rider the message was lost.\nFor want of a message the battle was lost.\nFor want of a battle the kingdom was lost.\nAnd all for the want of a nail.\n```\n\nNote that the list of inputs may vary; your solution should be able to handle lists of arbitrary length and content.\nNo line of the output text should be a static, unchanging string; all should vary according to the input given.\n" }, { "path": "exercises/practice/proverb/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"proverb.ts\"\n ],\n \"test\": [\n \"proverb.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"For want of a horseshoe nail, a kingdom was lost, or so the saying goes. Output the full text of this proverbial rhyme.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/For_Want_of_a_Nail\"\n}\n" }, { "path": "exercises/practice/proverb/.meta/proof.ci.ts", "content": "const conclusion = (firstArg: string): string =>\n `And all for the want of a ${firstArg}.`\n\nexport const proverb = (...args: string[]): string => {\n const allExceptLastArg = args.slice(0, -1)\n const chainOfEvents = allExceptLastArg.map(\n (arg, index) => `For want of a ${arg} the ${args[index + 1]} was lost.`\n )\n\n chainOfEvents.push(conclusion(args[0]))\n\n return chainOfEvents.join('\\n')\n}\n" }, { "path": "exercises/practice/proverb/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[e974b73e-7851-484f-8d6d-92e07fe742fc]\ndescription = \"zero pieces\"\n\n[2fcd5f5e-8b82-4e74-b51d-df28a5e0faa4]\ndescription = \"one piece\"\n\n[d9d0a8a1-d933-46e2-aa94-eecf679f4b0e]\ndescription = \"two pieces\"\n\n[c95ef757-5e94-4f0d-a6cb-d2083f5e5a83]\ndescription = \"three pieces\"\n\n[433fb91c-35a2-4d41-aeab-4de1e82b2126]\ndescription = \"full proverb\"\n\n[c1eefa5a-e8d9-41c7-91d4-99fab6d6b9f7]\ndescription = \"four pieces modernized\"\n" }, { "path": "exercises/practice/proverb/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/proverb/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/proverb/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/proverb/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/proverb/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/proverb/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/proverb/package.json", "content": "{\n \"name\": \"@exercism/typescript-proverb\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/proverb/proverb.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { proverb } from './proverb.ts'\n\ndescribe('Proverb', () => {\n it('a single consequence', () => {\n const expected = `For want of a nail the shoe was lost.\\nAnd all for the want of a nail.`\n expect(proverb('nail', 'shoe')).toEqual(expected)\n })\n\n xit('a short chain of consequences', () => {\n const expected = `For want of a nail the shoe was lost.\\nFor want of a shoe the horse was lost.\\nAnd all for the want of a nail.`\n expect(proverb('nail', 'shoe', 'horse')).toEqual(expected)\n })\n\n xit('a longer chain of consequences', () => {\n const expected = `For want of a nail the shoe was lost.\\nFor want of a shoe the horse was lost.\\nFor want of a horse the rider was lost.\\nAnd all for the want of a nail.`\n expect(proverb('nail', 'shoe', 'horse', 'rider')).toEqual(expected)\n })\n\n xit('proverb function does not hard code the rhyme dictionary', () => {\n const expected = `For want of a key the value was lost.\\nAnd all for the want of a key.`\n expect(proverb('key', 'value')).toEqual(expected)\n })\n\n xit('the whole proverb', () => {\n const expected = `For want of a nail the shoe was lost.\\nFor want of a shoe the horse was lost.\\nFor want of a horse the rider was lost.\\nFor want of a rider the message was lost.\\nFor want of a message the battle was lost.\\nFor want of a battle the kingdom was lost.\\nAnd all for the want of a nail.`\n expect(\n proverb('nail', 'shoe', 'horse', 'rider', 'message', 'battle', 'kingdom')\n ).toEqual(expected)\n })\n\n xit('proverb is the same each time', () => {\n expect(proverb('nail', 'shoe')).toEqual(proverb('nail', 'shoe'))\n })\n})\n" }, { "path": "exercises/practice/proverb/proverb.ts", "content": "export function proverb() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/proverb/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/proverb/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/pythagorean-triplet/.docs/instructions.md", "content": "# Description\n\nA Pythagorean triplet is a set of three natural numbers, {a, b, c}, for which,\n\n```text\naĀ² + bĀ² = cĀ²\n```\n\nand such that,\n\n```text\na < b < c\n```\n\nFor example,\n\n```text\n3Ā² + 4Ā² = 5Ā².\n```\n\nGiven an input integer N, find all Pythagorean triplets for which `a + b + c = N`.\n\nFor example, with N = 1000, there is exactly one Pythagorean triplet for which `a + b + c = 1000`: `{200, 375, 425}`.\n" }, { "path": "exercises/practice/pythagorean-triplet/.docs/introduction.md", "content": "# Introduction\n\nYou are an accomplished problem-solver, known for your ability to tackle the most challenging mathematical puzzles.\nOne evening, you receive an urgent letter from an inventor called the Triangle Tinkerer, who is working on a groundbreaking new project.\nThe letter reads:\n\n> Dear Mathematician,\n>\n> I need your help.\n> I am designing a device that relies on the unique properties of Pythagorean triplets ā€” sets of three integers that satisfy the equation aĀ² + bĀ² = cĀ².\n> This device will revolutionize navigation, but for it to work, I must program it with every possible triplet where the sum of a, b, and c equals a specific number, N.\n> Calculating these triplets by hand would take me years, but I hear you are more than up to the task.\n>\n> Time is of the essence.\n> The future of my invention ā€” and perhaps even the future of mathematical innovation ā€” rests on your ability to solve this problem.\n\nMotivated by the importance of the task, you set out to find all Pythagorean triplets that satisfy the condition.\nYour work could have far-reaching implications, unlocking new possibilities in science and engineering.\nCan you rise to the challenge and make history?\n" }, { "path": "exercises/practice/pythagorean-triplet/.meta/config.json", "content": "{\n \"authors\": [\n \"mdowds\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"mdmower\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"pythagorean-triplet.ts\"\n ],\n \"test\": [\n \"pythagorean-triplet.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given an integer N, find all Pythagorean triplets for which a + b + c = N.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": true,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A variation of Problem 9 from Project Euler\",\n \"source_url\": \"https://projecteuler.net/problem=9\"\n}\n" }, { "path": "exercises/practice/pythagorean-triplet/.meta/proof.ci.ts", "content": "type Options = {\n minFactor?: number\n maxFactor?: number\n sum: number\n}\n\ntype TripletArray = [number, number, number]\n\nclass Triplet {\n constructor(\n private readonly a: TripletArray[0],\n private readonly b: TripletArray[1],\n private readonly c: TripletArray[2]\n ) {}\n\n public toArray(): TripletArray {\n return [this.a, this.b, this.c]\n }\n\n public get pythagorean(): boolean {\n return this.a * this.a + this.b * this.b === this.c * this.c\n }\n\n public get sum(): number {\n return this.a + this.b + this.c\n }\n}\n\nexport function triplets({ minFactor, maxFactor, sum }: Options): Triplet[] {\n const min = minFactor || 1\n const max = maxFactor || sum - 1\n\n const isDesired = (triplet: Triplet): boolean => {\n return triplet.pythagorean && (!sum || triplet.sum === sum)\n }\n\n const result: Triplet[] = []\n\n for (let a = min; a < max - 1; a += 1) {\n for (let b = a + 1; b < max; b += 1) {\n for (let c = b + 1; c <= max; c += 1) {\n const triplet = new Triplet(a, b, c)\n\n if (isDesired(triplet)) {\n result.push(triplet)\n }\n }\n }\n }\n\n return result\n}\n" }, { "path": "exercises/practice/pythagorean-triplet/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[a19de65d-35b8-4480-b1af-371d9541e706]\ndescription = \"triplets whose sum is 12\"\n\n[48b21332-0a3d-43b2-9a52-90b2a6e5c9f5]\ndescription = \"triplets whose sum is 108\"\n\n[dffc1266-418e-4daa-81af-54c3e95c3bb5]\ndescription = \"triplets whose sum is 1000\"\n\n[5f86a2d4-6383-4cce-93a5-e4489e79b186]\ndescription = \"no matching triplets for 1001\"\n\n[bf17ba80-1596-409a-bb13-343bdb3b2904]\ndescription = \"returns all matching triplets\"\n\n[9d8fb5d5-6c6f-42df-9f95-d3165963ac57]\ndescription = \"several matching triplets\"\n\n[f5be5734-8aa0-4bd1-99a2-02adcc4402b4]\ndescription = \"triplets for large number\"\n" }, { "path": "exercises/practice/pythagorean-triplet/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/pythagorean-triplet/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/pythagorean-triplet/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/pythagorean-triplet/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/pythagorean-triplet/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/pythagorean-triplet/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/pythagorean-triplet/package.json", "content": "{\n \"name\": \"@exercism/typescript-pythagorean-triplet\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/pythagorean-triplet/pythagorean-triplet.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { triplets } from './pythagorean-triplet.ts'\n\ntype Triplet = [number, number, number]\n\nfunction tripletsWithSum(sum: number, options = {}): Triplet[] {\n return triplets({ ...options, sum }).map((triplet) =>\n triplet.toArray().sort((a, b) => a - b)\n )\n}\n\ndescribe('Triplet', () => {\n it('triplets whose sum is 12', () => {\n expect(tripletsWithSum(12)).toEqual([[3, 4, 5]])\n })\n\n xit('triplets whose sum is 108', () => {\n expect(tripletsWithSum(108)).toEqual([[27, 36, 45]])\n })\n\n xit('triplets whose sum is 1000', () => {\n expect(tripletsWithSum(1000)).toEqual([[200, 375, 425]])\n })\n\n xit('no matching triplets for 1001', () => {\n expect(tripletsWithSum(1001)).toEqual([])\n })\n\n xit('returns all matching triplets', () => {\n expect(tripletsWithSum(90)).toEqual([\n [9, 40, 41],\n [15, 36, 39],\n ])\n })\n\n xit('several matching triplets', () => {\n expect(tripletsWithSum(840)).toEqual([\n [40, 399, 401],\n [56, 390, 394],\n [105, 360, 375],\n [120, 350, 370],\n [140, 336, 364],\n [168, 315, 357],\n [210, 280, 350],\n [240, 252, 348],\n ])\n })\n\n xit('returns triplets with no factor smaller than minimum factor', () => {\n expect(tripletsWithSum(90, { minFactor: 10 })).toEqual([[15, 36, 39]])\n })\n\n xit('returns triplets with no factor larger than maximum factor', () => {\n expect(tripletsWithSum(840, { maxFactor: 349 })).toEqual([[240, 252, 348]])\n })\n\n xit('returns triplets with factors in range', () => {\n expect(tripletsWithSum(840, { maxFactor: 352, minFactor: 150 })).toEqual([\n [210, 280, 350],\n [240, 252, 348],\n ])\n })\n\n it.skip('triplets for large number', () => {\n expect(tripletsWithSum(30000)).toEqual([\n [1200, 14375, 14425],\n [1875, 14000, 14125],\n [5000, 12000, 13000],\n [6000, 11250, 12750],\n [7500, 10000, 12500],\n ])\n })\n})\n" }, { "path": "exercises/practice/pythagorean-triplet/pythagorean-triplet.ts", "content": "type Options = {\n minFactor?: number\n maxFactor?: number\n sum: number\n}\n\nexport function triplets({}: Options): Triplet[] {\n throw new Error('Remove this line and implement the function')\n}\n\nclass Triplet {\n constructor() {\n throw new Error('Remove this line and implement the function')\n }\n\n toArray(): [number, number, number] {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/pythagorean-triplet/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/pythagorean-triplet/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/queen-attack/.docs/instructions.append.md", "content": "# Instructions append\n\nA queen must be placed on a valid position on the board.\nTwo queens cannot share the same position.\n\nIf a position has not been given, the queens are at their [default starting positions](https://en.wikipedia.org/wiki/Rules_of_chess#Initial_setup). That's the bottom row (1) for the white queen and the top row (8) for the black queen. Both queens start in the fourth column (d).\n\n```text\n a b c d e f g h\n8 _ _ _ B _ _ _ _ 8\n7 _ _ _ _ _ _ _ _ 7\n6 _ _ _ _ _ _ _ _ 6\n5 _ _ _ _ _ _ _ _ 5\n4 _ _ _ _ _ _ _ _ 4\n3 _ _ _ _ _ _ _ _ 3\n2 _ _ _ _ _ _ _ _ 2\n1 _ _ _ W _ _ _ _ 1\n a b c d e f g h\n```\n" }, { "path": "exercises/practice/queen-attack/.docs/instructions.md", "content": "# Instructions\n\nGiven the position of two queens on a chess board, indicate whether or not they are positioned so that they can attack each other.\n\nIn the game of chess, a queen can attack pieces which are on the same row, column, or diagonal.\n\nA chessboard can be represented by an 8 by 8 array.\n\nSo if you are told the white queen is at `c5` (zero-indexed at column 2, row 3) and the black queen at `f2` (zero-indexed at column 5, row 6), then you know that the set-up is like so:\n\n![A chess board with two queens. Arrows emanating from the queen at c5 indicate possible directions of capture along file, rank and diagonal.](https://assets.exercism.org/images/exercises/queen-attack/queen-capture.svg)\n\nYou are also able to answer whether the queens can attack each other.\nIn this case, that answer would be yes, they can, because both pieces share a diagonal.\n\n## Credit\n\nThe chessboard image was made by [habere-et-dispertire][habere-et-dispertire] using LaTeX and the [chessboard package][chessboard-package] by Ulrike Fischer.\n\n[habere-et-dispertire]: https://exercism.org/profiles/habere-et-dispertire\n[chessboard-package]: https://github.com/u-fischer/chessboard\n" }, { "path": "exercises/practice/queen-attack/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"queen-attack.ts\"\n ],\n \"test\": [\n \"queen-attack.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given the position of two queens on a chess board, indicate whether or not they are positioned so that they can attack each other.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"J Dalbey's Programming Practice problems\",\n \"source_url\": \"https://users.csc.calpoly.edu/~jdalbey/103/Projects/ProgrammingPractice.html\"\n}\n" }, { "path": "exercises/practice/queen-attack/.meta/proof.ci.ts", "content": "const W = 8\nconst H = 8\nconst STARTING: Positions = { black: [0, 3], white: [7, 3] } as const\n\ntype Position = readonly [number, number]\ntype Board = string[]\n\ntype Positions = {\n white: Position\n black: Position\n}\n\nfunction invalidPosition({ white, black }: Positions): boolean {\n if (white[0] < 0 || white[0] >= H || white[1] < 0 || white[1] >= W) {\n return true\n }\n\n if (black[0] < 0 || black[0] >= H || black[1] < 0 || black[1] >= W) {\n return true\n }\n\n return false\n}\n\nfunction samePosition({ white, black }: Positions): boolean {\n return white[0] === black[0] && white[1] === black[1]\n}\n\nfunction constructBoard(): Board {\n return new Array(W * H).fill('_')\n}\n\nfunction placePieces(self: QueenAttack): void {\n const board = self.board\n const [blackRow, blackColumn] = self.black\n const [whiteRow, whiteColumn] = self.white\n\n board[blackRow * W + blackColumn] = 'B'\n board[whiteRow * W + whiteColumn] = 'W'\n}\n\nexport class QueenAttack {\n public readonly black: Position\n public readonly white: Position\n public readonly board: string[]\n\n constructor(params: Partial = {}) {\n const fullParams = { ...STARTING, ...params }\n if (invalidPosition(fullParams)) {\n throw new Error('Queen must be placed on the board')\n }\n\n if (samePosition(fullParams)) {\n throw new Error('Queens cannot share the same space')\n }\n\n this.black = fullParams.black\n this.white = fullParams.white\n this.board = constructBoard()\n\n placePieces(this)\n\n return this\n }\n\n public get canAttack(): boolean {\n // Same row or column\n if (this.black[0] === this.white[0] || this.black[1] === this.white[1]) {\n return true\n }\n\n // Diagonally\n return (\n Math.abs(this.black[0] - this.white[0]) ===\n Math.abs(this.black[1] - this.white[1])\n )\n }\n\n public toString(): string {\n return Array.from({ length: H }, (_, row) =>\n this.board.slice(row * H, row * H + W).join(' ')\n ).join('\\n')\n }\n}\n" }, { "path": "exercises/practice/queen-attack/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[3ac4f735-d36c-44c4-a3e2-316f79704203]\ndescription = \"Test creation of Queens with valid and invalid positions -> queen with a valid position\"\n\n[4e812d5d-b974-4e38-9a6b-8e0492bfa7be]\ndescription = \"Test creation of Queens with valid and invalid positions -> queen must have positive row\"\n\n[f07b7536-b66b-4f08-beb9-4d70d891d5c8]\ndescription = \"Test creation of Queens with valid and invalid positions -> queen must have row on board\"\n\n[15a10794-36d9-4907-ae6b-e5a0d4c54ebe]\ndescription = \"Test creation of Queens with valid and invalid positions -> queen must have positive column\"\n\n[6907762d-0e8a-4c38-87fb-12f2f65f0ce4]\ndescription = \"Test creation of Queens with valid and invalid positions -> queen must have column on board\"\n\n[33ae4113-d237-42ee-bac1-e1e699c0c007]\ndescription = \"Test the ability of one queen to attack another -> cannot attack\"\n\n[eaa65540-ea7c-4152-8c21-003c7a68c914]\ndescription = \"Test the ability of one queen to attack another -> can attack on same row\"\n\n[bae6f609-2c0e-4154-af71-af82b7c31cea]\ndescription = \"Test the ability of one queen to attack another -> can attack on same column\"\n\n[0e1b4139-b90d-4562-bd58-dfa04f1746c7]\ndescription = \"Test the ability of one queen to attack another -> can attack on first diagonal\"\n\n[ff9b7ed4-e4b6-401b-8d16-bc894d6d3dcd]\ndescription = \"Test the ability of one queen to attack another -> can attack on second diagonal\"\n\n[0a71e605-6e28-4cc2-aa47-d20a2e71037a]\ndescription = \"Test the ability of one queen to attack another -> can attack on third diagonal\"\n\n[0790b588-ae73-4f1f-a968-dd0b34f45f86]\ndescription = \"Test the ability of one queen to attack another -> can attack on fourth diagonal\"\n\n[543f8fd4-2597-4aad-8d77-cbdab63619f8]\ndescription = \"Test the ability of one queen to attack another -> cannot attack if falling diagonals are only the same when reflected across the longest falling diagonal\"\n" }, { "path": "exercises/practice/queen-attack/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/queen-attack/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/queen-attack/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/queen-attack/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/queen-attack/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/queen-attack/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/queen-attack/package.json", "content": "{\n \"name\": \"@exercism/typescript-queen-attack\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/queen-attack/queen-attack.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { QueenAttack } from './queen-attack.ts'\n\ndescribe('Queens', () => {\n describe('Test creation of Queens with valid and invalid positions', () => {\n it('queen with a valid position', () => {\n const queens = new QueenAttack({ white: [2, 2] })\n expect(queens.white).toEqual([2, 2])\n })\n\n xit('queen must have positive row', () => {\n const positioning = { white: [-2, 2] } as const\n const expectedError = 'Queen must be placed on the board'\n expect(() => new QueenAttack(positioning)).toThrow(expectedError)\n })\n\n xit('queen must have row on board', () => {\n const positioning = { white: [8, 4] } as const\n const expectedError = 'Queen must be placed on the board'\n expect(() => new QueenAttack(positioning)).toThrow(expectedError)\n })\n\n xit('queen must have positive column', () => {\n const positioning = { white: [2, -2] } as const\n const expectedError = 'Queen must be placed on the board'\n expect(() => new QueenAttack(positioning)).toThrow(expectedError)\n })\n\n xit('queen must have column on board', () => {\n const positioning = { white: [4, 8] } as const\n const expectedError = 'Queen must be placed on the board'\n expect(() => new QueenAttack(positioning)).toThrow(expectedError)\n })\n\n xit('two queens cannot occupy the same space', () => {\n const positioning = { white: [2, 4], black: [2, 4] } as const\n const expectedError = 'Queens cannot share the same space'\n expect(() => new QueenAttack(positioning)).toThrow(expectedError)\n })\n })\n\n describe('Test the ability of one queen to attack another', () => {\n xit('queens cannot attack', () => {\n const queens = new QueenAttack({ white: [2, 4], black: [6, 6] })\n expect(queens.canAttack).toEqual(false)\n })\n\n xit('queens can attack when they are on the same row', () => {\n const queens = new QueenAttack({ white: [2, 4], black: [2, 6] })\n expect(queens.canAttack).toEqual(true)\n })\n\n xit('queens can attack when they are on the same column', () => {\n const queens = new QueenAttack({ white: [4, 5], black: [2, 5] })\n expect(queens.canAttack).toEqual(true)\n })\n\n xit('queens can attack diagonally', () => {\n const queens = new QueenAttack({ white: [2, 2], black: [0, 4] })\n expect(queens.canAttack).toEqual(true)\n })\n\n xit('queens can attack another diagonally', () => {\n const queens = new QueenAttack({ white: [2, 2], black: [3, 1] })\n expect(queens.canAttack).toEqual(true)\n })\n\n xit('queens can attack yet another diagonally', () => {\n const queens = new QueenAttack({ white: [2, 2], black: [1, 1] })\n expect(queens.canAttack).toEqual(true)\n })\n\n xit('queens can attack diagonally, really', () => {\n const queens = new QueenAttack({ white: [1, 7], black: [0, 6] })\n expect(queens.canAttack).toEqual(true)\n })\n\n xit('queens can attack on a north-east/south-west diagonal', () => {\n const queens = new QueenAttack({ white: [7, 0], black: [0, 7] })\n expect(queens.canAttack).toEqual(true)\n })\n\n xit('queens can attack on another ne/sw diagonal', () => {\n const queens = new QueenAttack({ white: [2, 6], black: [5, 3] })\n expect(queens.canAttack).toEqual(true)\n })\n\n xit('queens cannot attack if falling diagonals are only the same when reflected across the longest falling diagonal', () => {\n const queens = new QueenAttack({ white: [4, 1], black: [2, 5] })\n expect(queens.canAttack).toEqual(false)\n })\n })\n\n describe('Test the board visualisation', () => {\n xit('board', () => {\n const positioning = { white: [3, 2], black: [6, 5] } as const\n const queens = new QueenAttack(positioning)\n const board = [\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ W _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ B _ _',\n '_ _ _ _ _ _ _ _',\n ].join('\\n')\n expect(queens.toString()).toEqual(board)\n })\n\n xit('board with queens at their starting positions', () => {\n const queens = new QueenAttack()\n const board = [\n '_ _ _ B _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ W _ _ _ _',\n ].join('\\n')\n expect(queens.toString()).toEqual(board)\n })\n\n xit('board with the black queen at her starting positions', () => {\n const queens = new QueenAttack({ white: [1, 6] })\n const board = [\n '_ _ _ B _ _ _ _',\n '_ _ _ _ _ _ W _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n ].join('\\n')\n expect(queens.toString()).toEqual(board)\n })\n\n xit('board with queens at the edges', () => {\n const positioning = { white: [0, 0], black: [7, 7] } as const\n const queens = new QueenAttack(positioning)\n const board = [\n 'W _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ _',\n '_ _ _ _ _ _ _ B',\n ].join('\\n')\n expect(queens.toString()).toEqual(board)\n })\n })\n})\n" }, { "path": "exercises/practice/queen-attack/queen-attack.ts", "content": "type Position = readonly [number, number]\n\ntype Positions = {\n white: Position\n black: Position\n}\nexport class QueenAttack {\n public readonly black: Position\n public readonly white: Position\n\n // white: [whiteRow, whiteColumn]\n // black: [blackRow, blackColumn]\n constructor({}: Partial = {}) {\n throw new Error('Remove this line and implement the function')\n }\n\n toString() {\n throw new Error('Remove this line and implement the function')\n }\n\n get canAttack() {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/queen-attack/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/queen-attack/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/raindrops/.docs/instructions.md", "content": "# Instructions\n\nYour task is to convert a number into its corresponding raindrop sounds.\n\nIf a given number:\n\n- is divisible by 3, add \"Pling\" to the result.\n- is divisible by 5, add \"Plang\" to the result.\n- is divisible by 7, add \"Plong\" to the result.\n- **is not** divisible by 3, 5, or 7, the result should be the number as a string.\n\n## Examples\n\n- 28 is divisible by 7, but not 3 or 5, so the result would be `\"Plong\"`.\n- 30 is divisible by 3 and 5, but not 7, so the result would be `\"PlingPlang\"`.\n- 34 is not divisible by 3, 5, or 7, so the result would be `\"34\"`.\n\n~~~~exercism/note\nA common way to test if one number is evenly divisible by another is to compare the [remainder][remainder] or [modulus][modulo] to zero.\nMost languages provide operators or functions for one (or both) of these.\n\n[remainder]: https://exercism.org/docs/programming/operators/remainder\n[modulo]: https://en.wikipedia.org/wiki/Modulo_operation\n~~~~\n" }, { "path": "exercises/practice/raindrops/.docs/introduction.md", "content": "# Introduction\n\nRaindrops is a slightly more complex version of the FizzBuzz challenge, a classic interview question.\n" }, { "path": "exercises/practice/raindrops/.meta/config.json", "content": "{\n \"authors\": [],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"raindrops.ts\"\n ],\n \"test\": [\n \"raindrops.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Convert a number into its corresponding raindrop sounds - Pling, Plang and Plong.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A variation on FizzBuzz, a famous technical interview question that is intended to weed out potential candidates. That question is itself derived from Fizz Buzz, a popular children's game for teaching division.\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Fizz_buzz\"\n}\n" }, { "path": "exercises/practice/raindrops/.meta/proof.ci.ts", "content": "export function convert(drops: number): string {\n let converted = ''\n\n if (drops % 3 === 0) {\n converted += 'Pling'\n }\n if (drops % 5 === 0) {\n converted += 'Plang'\n }\n if (drops % 7 === 0) {\n converted += 'Plong'\n }\n\n return converted ? converted : drops.toString()\n}\n" }, { "path": "exercises/practice/raindrops/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[1575d549-e502-46d4-a8e1-6b7bec6123d8]\ndescription = \"the sound for 1 is 1\"\n\n[1f51a9f9-4895-4539-b182-d7b0a5ab2913]\ndescription = \"the sound for 3 is Pling\"\n\n[2d9bfae5-2b21-4bcd-9629-c8c0e388f3e0]\ndescription = \"the sound for 5 is Plang\"\n\n[d7e60daa-32ef-4c23-b688-2abff46c4806]\ndescription = \"the sound for 7 is Plong\"\n\n[6bb4947b-a724-430c-923f-f0dc3d62e56a]\ndescription = \"the sound for 6 is Pling as it has a factor 3\"\n\n[ce51e0e8-d9d4-446d-9949-96eac4458c2d]\ndescription = \"2 to the power 3 does not make a raindrop sound as 3 is the exponent not the base\"\n\n[0dd66175-e3e2-47fc-8750-d01739856671]\ndescription = \"the sound for 9 is Pling as it has a factor 3\"\n\n[022c44d3-2182-4471-95d7-c575af225c96]\ndescription = \"the sound for 10 is Plang as it has a factor 5\"\n\n[37ab74db-fed3-40ff-b7b9-04acdfea8edf]\ndescription = \"the sound for 14 is Plong as it has a factor of 7\"\n\n[31f92999-6afb-40ee-9aa4-6d15e3334d0f]\ndescription = \"the sound for 15 is PlingPlang as it has factors 3 and 5\"\n\n[ff9bb95d-6361-4602-be2c-653fe5239b54]\ndescription = \"the sound for 21 is PlingPlong as it has factors 3 and 7\"\n\n[d2e75317-b72e-40ab-8a64-6734a21dece1]\ndescription = \"the sound for 25 is Plang as it has a factor 5\"\n\n[a09c4c58-c662-4e32-97fe-f1501ef7125c]\ndescription = \"the sound for 27 is Pling as it has a factor 3\"\n\n[bdf061de-8564-4899-a843-14b48b722789]\ndescription = \"the sound for 35 is PlangPlong as it has factors 5 and 7\"\n\n[c4680bee-69ba-439d-99b5-70c5fd1a7a83]\ndescription = \"the sound for 49 is Plong as it has a factor 7\"\n\n[17f2bc9a-b65a-4d23-8ccd-266e8c271444]\ndescription = \"the sound for 52 is 52\"\n\n[e46677ed-ff1a-419f-a740-5c713d2830e4]\ndescription = \"the sound for 105 is PlingPlangPlong as it has factors 3, 5 and 7\"\n\n[13c6837a-0fcd-4b86-a0eb-20572f7deb0b]\ndescription = \"the sound for 3125 is Plang as it has a factor 5\"\n" }, { "path": "exercises/practice/raindrops/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/raindrops/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/raindrops/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/raindrops/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/raindrops/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/raindrops/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/raindrops/package.json", "content": "{\n \"name\": \"@exercism/typescript-raindrops\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/raindrops/raindrops.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { convert } from './raindrops.ts'\n\ndescribe('Raindrops', () => {\n it('converts 1', () => expect(convert(1)).toEqual('1'))\n\n xit('converts 3', () => expect(convert(3)).toEqual('Pling'))\n\n xit('converts 5', () => expect(convert(5)).toEqual('Plang'))\n\n xit('converts 7', () => expect(convert(7)).toEqual('Plong'))\n\n xit('converts 6', () => expect(convert(6)).toEqual('Pling'))\n\n xit('converts 9', () => expect(convert(9)).toEqual('Pling'))\n\n xit('converts 10', () => expect(convert(10)).toEqual('Plang'))\n\n xit('converts 14', () => expect(convert(14)).toEqual('Plong'))\n\n xit('converts 15', () => expect(convert(15)).toEqual('PlingPlang'))\n\n xit('converts 21', () => expect(convert(21)).toEqual('PlingPlong'))\n\n xit('converts 25', () => expect(convert(25)).toEqual('Plang'))\n\n xit('converts 35', () => expect(convert(35)).toEqual('PlangPlong'))\n\n xit('converts 49', () => expect(convert(49)).toEqual('Plong'))\n\n xit('converts 52', () => expect(convert(52)).toEqual('52'))\n\n xit('converts 105', () => expect(convert(105)).toEqual('PlingPlangPlong'))\n\n xit('converts 12121', () => expect(convert(12121)).toEqual('12121'))\n})\n" }, { "path": "exercises/practice/raindrops/raindrops.ts", "content": "export function convert() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/raindrops/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/raindrops/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/rational-numbers/.docs/instructions.md", "content": "# Instructions\n\nA rational number is defined as the quotient of two integers `a` and `b`, called the numerator and denominator, respectively, where `b != 0`.\n\n~~~~exercism/note\nNote that mathematically, the denominator can't be zero.\nHowever in many implementations of rational numbers, you will find that the denominator is allowed to be zero with behaviour similar to positive or negative infinity in floating point numbers.\nIn those cases, the denominator and numerator generally still can't both be zero at once.\n~~~~\n\nThe absolute value `|r|` of the rational number `r = a/b` is equal to `|a|/|b|`.\n\nThe sum of two rational numbers `rā‚ = aā‚/bā‚` and `rā‚‚ = aā‚‚/bā‚‚` is `rā‚ + rā‚‚ = aā‚/bā‚ + aā‚‚/bā‚‚ = (aā‚ * bā‚‚ + aā‚‚ * bā‚) / (bā‚ * bā‚‚)`.\n\nThe difference of two rational numbers `rā‚ = aā‚/bā‚` and `rā‚‚ = aā‚‚/bā‚‚` is `rā‚ - rā‚‚ = aā‚/bā‚ - aā‚‚/bā‚‚ = (aā‚ * bā‚‚ - aā‚‚ * bā‚) / (bā‚ * bā‚‚)`.\n\nThe product (multiplication) of two rational numbers `rā‚ = aā‚/bā‚` and `rā‚‚ = aā‚‚/bā‚‚` is `rā‚ * rā‚‚ = (aā‚ * aā‚‚) / (bā‚ * bā‚‚)`.\n\nDividing a rational number `rā‚ = aā‚/bā‚` by another `rā‚‚ = aā‚‚/bā‚‚` is `rā‚ / rā‚‚ = (aā‚ * bā‚‚) / (aā‚‚ * bā‚)` if `aā‚‚` is not zero.\n\nExponentiation of a rational number `r = a/b` to a non-negative integer power `n` is `r^n = (a^n)/(b^n)`.\n\nExponentiation of a rational number `r = a/b` to a negative integer power `n` is `r^n = (b^m)/(a^m)`, where `m = |n|`.\n\nExponentiation of a rational number `r = a/b` to a real (floating-point) number `x` is the quotient `(a^x)/(b^x)`, which is a real number.\n\nExponentiation of a real number `x` to a rational number `r = a/b` is `x^(a/b) = root(x^a, b)`, where `root(p, q)` is the `q`th root of `p`.\n\nImplement the following operations:\n\n- addition, subtraction, multiplication and division of two rational numbers,\n- absolute value, exponentiation of a given rational number to an integer power, exponentiation of a given rational number to a real (floating-point) power, exponentiation of a real number to a rational number.\n\nYour implementation of rational numbers should always be reduced to lowest terms.\nFor example, `4/4` should reduce to `1/1`, `30/60` should reduce to `1/2`, `12/8` should reduce to `3/2`, etc.\nTo reduce a rational number `r = a/b`, divide `a` and `b` by the greatest common divisor (gcd) of `a` and `b`.\nSo, for example, `gcd(12, 8) = 4`, so `r = 12/8` can be reduced to `(12/4)/(8/4) = 3/2`.\nThe reduced form of a rational number should be in \"standard form\" (the denominator should always be a positive integer).\nIf a denominator with a negative integer is present, multiply both numerator and denominator by `-1` to ensure standard form is reached.\nFor example, `3/-4` should be reduced to `-3/4`\n\nAssume that the programming language you are using does not have an implementation of rational numbers.\n" }, { "path": "exercises/practice/rational-numbers/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\",\n \"angelikatyborska\"\n ],\n \"files\": {\n \"solution\": [\n \"rational-numbers.ts\"\n ],\n \"test\": [\n \"rational-numbers.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement rational numbers.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Rational_number\"\n}\n" }, { "path": "exercises/practice/rational-numbers/.meta/proof.ci.ts", "content": "export class Rational {\n public numerator: number\n public denominator: number\n\n constructor(numerator: number, denominator: number) {\n if (denominator === 0) {\n throw new Error('Denominator must not be zero.')\n }\n\n this.numerator = numerator\n this.denominator = denominator\n\n this.reduce()\n this.ensureSignInNumerator()\n }\n\n public add(that: Rational): Rational {\n const commonDenominator = this.denominator * that.denominator\n return new Rational(\n this.numerator * that.denominator + that.numerator * this.denominator,\n commonDenominator\n )\n }\n\n public sub(that: Rational): Rational {\n const commonDenominator = this.denominator * that.denominator\n return new Rational(\n this.numerator * that.denominator - that.numerator * this.denominator,\n commonDenominator\n )\n }\n\n public mul(that: Rational): Rational {\n return new Rational(\n this.numerator * that.numerator,\n this.denominator * that.denominator\n )\n }\n\n public div(that: Rational): Rational {\n return new Rational(\n this.numerator * that.denominator,\n this.denominator * that.numerator\n )\n }\n\n public abs(): Rational {\n return new Rational(Math.abs(this.numerator), Math.abs(this.denominator))\n }\n\n public exprational(n: number): Rational {\n if (n > 0) {\n return new Rational(\n Math.pow(this.numerator, n),\n Math.pow(this.denominator, n)\n )\n } else {\n return new Rational(\n Math.pow(this.denominator, Math.abs(n)),\n Math.pow(this.numerator, Math.abs(n))\n )\n }\n }\n\n public expreal(base: number): number {\n return Math.pow(\n 10.0,\n Math.log10(Math.pow(base, this.numerator)) / this.denominator\n )\n }\n\n public reduce(): this {\n const commonDivisor = this.gcd(this.numerator, this.denominator)\n\n this.numerator /= commonDivisor\n this.denominator /= commonDivisor\n this.ensureSignInNumerator()\n\n return this\n }\n\n private gcd(a: number, b: number): number {\n let localA = a\n let localB = b\n while (localB !== 0) {\n const t = localB\n localB = localA % localB\n localA = t\n }\n return localA\n }\n\n private ensureSignInNumerator(): void {\n if (this.denominator < 0) {\n this.denominator = -this.denominator\n this.numerator = -this.numerator\n }\n }\n}\n" }, { "path": "exercises/practice/rational-numbers/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[0ba4d988-044c-4ed5-9215-4d0bb8d0ae9f]\ndescription = \"Arithmetic -> Addition -> Add two positive rational numbers\"\n\n[88ebc342-a2ac-4812-a656-7b664f718b6a]\ndescription = \"Arithmetic -> Addition -> Add a positive rational number and a negative rational number\"\n\n[92ed09c2-991e-4082-a602-13557080205c]\ndescription = \"Arithmetic -> Addition -> Add two negative rational numbers\"\n\n[6e58999e-3350-45fb-a104-aac7f4a9dd11]\ndescription = \"Arithmetic -> Addition -> Add a rational number to its additive inverse\"\n\n[47bba350-9db1-4ab9-b412-4a7e1f72a66e]\ndescription = \"Arithmetic -> Subtraction -> Subtract two positive rational numbers\"\n\n[93926e2a-3e82-4aee-98a7-fc33fb328e87]\ndescription = \"Arithmetic -> Subtraction -> Subtract a positive rational number and a negative rational number\"\n\n[a965ba45-9b26-442b-bdc7-7728e4b8d4cc]\ndescription = \"Arithmetic -> Subtraction -> Subtract two negative rational numbers\"\n\n[0df0e003-f68e-4209-8c6e-6a4e76af5058]\ndescription = \"Arithmetic -> Subtraction -> Subtract a rational number from itself\"\n\n[34fde77a-75f4-4204-8050-8d3a937958d3]\ndescription = \"Arithmetic -> Multiplication -> Multiply two positive rational numbers\"\n\n[6d015cf0-0ea3-41f1-93de-0b8e38e88bae]\ndescription = \"Arithmetic -> Multiplication -> Multiply a negative rational number by a positive rational number\"\n\n[d1bf1b55-954e-41b1-8c92-9fc6beeb76fa]\ndescription = \"Arithmetic -> Multiplication -> Multiply two negative rational numbers\"\n\n[a9b8f529-9ec7-4c79-a517-19365d779040]\ndescription = \"Arithmetic -> Multiplication -> Multiply a rational number by its reciprocal\"\n\n[d89d6429-22fa-4368-ab04-9e01a44d3b48]\ndescription = \"Arithmetic -> Multiplication -> Multiply a rational number by 1\"\n\n[0d95c8b9-1482-4ed7-bac9-b8694fa90145]\ndescription = \"Arithmetic -> Multiplication -> Multiply a rational number by 0\"\n\n[1de088f4-64be-4e6e-93fd-5997ae7c9798]\ndescription = \"Arithmetic -> Division -> Divide two positive rational numbers\"\n\n[7d7983db-652a-4e66-981a-e921fb38d9a9]\ndescription = \"Arithmetic -> Division -> Divide a positive rational number by a negative rational number\"\n\n[1b434d1b-5b38-4cee-aaf5-b9495c399e34]\ndescription = \"Arithmetic -> Division -> Divide two negative rational numbers\"\n\n[d81c2ebf-3612-45a6-b4e0-f0d47812bd59]\ndescription = \"Arithmetic -> Division -> Divide a rational number by 1\"\n\n[5fee0d8e-5955-4324-acbe-54cdca94ddaa]\ndescription = \"Absolute value -> Absolute value of a positive rational number\"\n\n[3cb570b6-c36a-4963-a380-c0834321bcaa]\ndescription = \"Absolute value -> Absolute value of a positive rational number with negative numerator and denominator\"\n\n[6a05f9a0-1f6b-470b-8ff7-41af81773f25]\ndescription = \"Absolute value -> Absolute value of a negative rational number\"\n\n[5d0f2336-3694-464f-8df9-f5852fda99dd]\ndescription = \"Absolute value -> Absolute value of a negative rational number with negative denominator\"\n\n[f8e1ed4b-9dca-47fb-a01e-5311457b3118]\ndescription = \"Absolute value -> Absolute value of zero\"\n\n[4a8c939f-f958-473b-9f88-6ad0f83bb4c4]\ndescription = \"Absolute value -> Absolute value of a rational number is reduced to lowest terms\"\n\n[ea2ad2af-3dab-41e7-bb9f-bd6819668a84]\ndescription = \"Exponentiation of a rational number -> Raise a positive rational number to a positive integer power\"\n\n[8168edd2-0af3-45b1-b03f-72c01332e10a]\ndescription = \"Exponentiation of a rational number -> Raise a negative rational number to a positive integer power\"\n\n[c291cfae-cfd8-44f5-aa6c-b175c148a492]\ndescription = \"Exponentiation of a rational number -> Raise a positive rational number to a negative integer power\"\n\n[45cb3288-4ae4-4465-9ae5-c129de4fac8e]\ndescription = \"Exponentiation of a rational number -> Raise a negative rational number to an even negative integer power\"\n\n[2d47f945-ffe1-4916-a399-c2e8c27d7f72]\ndescription = \"Exponentiation of a rational number -> Raise a negative rational number to an odd negative integer power\"\n\n[e2f25b1d-e4de-4102-abc3-c2bb7c4591e4]\ndescription = \"Exponentiation of a rational number -> Raise zero to an integer power\"\n\n[431cac50-ab8b-4d58-8e73-319d5404b762]\ndescription = \"Exponentiation of a rational number -> Raise one to an integer power\"\n\n[7d164739-d68a-4a9c-b99f-dd77ce5d55e6]\ndescription = \"Exponentiation of a rational number -> Raise a positive rational number to the power of zero\"\n\n[eb6bd5f5-f880-4bcd-8103-e736cb6e41d1]\ndescription = \"Exponentiation of a rational number -> Raise a negative rational number to the power of zero\"\n\n[30b467dd-c158-46f5-9ffb-c106de2fd6fa]\ndescription = \"Exponentiation of a real number to a rational number -> Raise a real number to a positive rational number\"\n\n[6e026bcc-be40-4b7b-ae22-eeaafc5a1789]\ndescription = \"Exponentiation of a real number to a rational number -> Raise a real number to a negative rational number\"\n\n[9f866da7-e893-407f-8cd2-ee85d496eec5]\ndescription = \"Exponentiation of a real number to a rational number -> Raise a real number to a zero rational number\"\n\n[0a63fbde-b59c-4c26-8237-1e0c73354d0a]\ndescription = \"Reduction to lowest terms -> Reduce a positive rational number to lowest terms\"\n\n[5ed6f248-ad8d-4d4e-a545-9146c6727f33]\ndescription = \"Reduction to lowest terms -> Reduce places the minus sign on the numerator\"\n\n[f87c2a4e-d29c-496e-a193-318c503e4402]\ndescription = \"Reduction to lowest terms -> Reduce a negative rational number to lowest terms\"\n\n[3b92ffc0-5b70-4a43-8885-8acee79cdaaf]\ndescription = \"Reduction to lowest terms -> Reduce a rational number with a negative denominator to lowest terms\"\n\n[c9dbd2e6-5ac0-4a41-84c1-48b645b4f663]\ndescription = \"Reduction to lowest terms -> Reduce zero to lowest terms\"\n\n[297b45ad-2054-4874-84d4-0358dc1b8887]\ndescription = \"Reduction to lowest terms -> Reduce an integer to lowest terms\"\n\n[a73a17fe-fe8c-4a1c-a63b-e7579e333d9e]\ndescription = \"Reduction to lowest terms -> Reduce one to lowest terms\"\n" }, { "path": "exercises/practice/rational-numbers/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/rational-numbers/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/rational-numbers/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/rational-numbers/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/rational-numbers/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/rational-numbers/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/rational-numbers/package.json", "content": "{\n \"name\": \"@exercism/typescript-rational-numbers\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/rational-numbers/rational-numbers.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Rational } from './rational-numbers.ts'\n\n/* eslint-disable jest/expect-expect */\n\nfunction assertRational(\n actual: Rational,\n expectedNumerator: number,\n expectedDenominator: number\n): void {\n expect(actual.numerator).toEqual(expectedNumerator)\n expect(actual.denominator).toEqual(expectedDenominator)\n}\n\ndescribe('Addition', () => {\n it('Add two positive rational numbers', () => {\n const actual = new Rational(1, 2).add(new Rational(2, 3))\n assertRational(actual, 7, 6)\n })\n\n xit('Add a positive rational number and a negative rational number', () => {\n const actual = new Rational(1, 2).add(new Rational(-2, 3))\n assertRational(actual, -1, 6)\n })\n\n xit('Add two negative rational numbers', () => {\n const actual = new Rational(-1, 2).add(new Rational(-2, 3))\n assertRational(actual, -7, 6)\n })\n\n xit('Add a rational number to its additive inverse', () => {\n const actual = new Rational(1, 2).add(new Rational(-1, 2))\n assertRational(actual, 0, 1)\n })\n})\n\ndescribe('Subtraction', () => {\n xit('Subtract two positive rational numbers', () => {\n const actual = new Rational(1, 2).sub(new Rational(2, 3))\n assertRational(actual, -1, 6)\n })\n\n xit('Subtract a positive rational number and a negative rational number', () => {\n const actual = new Rational(1, 2).sub(new Rational(-2, 3))\n assertRational(actual, 7, 6)\n })\n\n xit('Subtract two negative rational numbers', () => {\n const actual = new Rational(-1, 2).sub(new Rational(-2, 3))\n assertRational(actual, 1, 6)\n })\n\n xit('Subtract a rational number from itself', () => {\n const actual = new Rational(1, 2).sub(new Rational(1, 2))\n assertRational(actual, 0, 1)\n })\n})\n\ndescribe('Multiplication', () => {\n xit('Multiply two positive rational numbers', () => {\n const actual = new Rational(1, 2).mul(new Rational(2, 3))\n assertRational(actual, 1, 3)\n })\n\n xit('Multiply a negative rational number by a positive rational number', () => {\n const actual = new Rational(-1, 2).mul(new Rational(2, 3))\n assertRational(actual, -1, 3)\n })\n\n xit('Multiply two negative rational numbers', () => {\n const actual = new Rational(-1, 2).mul(new Rational(-2, 3))\n assertRational(actual, 1, 3)\n })\n\n xit('Multiply a rational number by its reciprocal', () => {\n const actual = new Rational(1, 2).mul(new Rational(2, 1))\n assertRational(actual, 1, 1)\n })\n\n xit('Multiply a rational number by 1', () => {\n const actual = new Rational(1, 2).mul(new Rational(1, 1))\n assertRational(actual, 1, 2)\n })\n\n xit('Multiply a rational number by 0', () => {\n const actual = new Rational(1, 2).mul(new Rational(0, 1))\n assertRational(actual, 0, 1)\n })\n})\n\ndescribe('Division', () => {\n xit('Divide two positive rational numbers', () => {\n const actual = new Rational(1, 2).div(new Rational(2, 3))\n assertRational(actual, 3, 4)\n })\n\n xit('Divide a positive rational number by a negative rational number', () => {\n const actual = new Rational(1, 2).div(new Rational(-2, 3))\n assertRational(actual, -3, 4)\n })\n\n xit('Divide two negative rational numbers', () => {\n const actual = new Rational(-1, 2).div(new Rational(-2, 3))\n assertRational(actual, 3, 4)\n })\n\n xit('Divide a rational number by 1', () => {\n const actual = new Rational(1, 2).div(new Rational(1, 1))\n assertRational(actual, 1, 2)\n })\n})\n\ndescribe('Absolute value', () => {\n xit('Absolute value of a positive rational number', () => {\n const actual = new Rational(1, 2).abs()\n assertRational(actual, 1, 2)\n })\n\n xit('Absolute value of a positive rational number with negative numerator and denominator', () => {\n const actual = new Rational(-1, -2).abs()\n assertRational(actual, 1, 2)\n })\n\n xit('Absolute value of a negative rational number', () => {\n const actual = new Rational(-1, 2).abs()\n assertRational(actual, 1, 2)\n })\n\n xit('Absolute value of a negative rational number with negative denominator', () => {\n const actual = new Rational(1, -2).abs()\n assertRational(actual, 1, 2)\n })\n\n xit('Absolute value of zero', () => {\n const actual = new Rational(0, 1).abs()\n assertRational(actual, 0, 1)\n })\n\n xit('Absolute value of a rational number is reduced to lowest terms', () => {\n const actual = new Rational(2, 4).abs()\n assertRational(actual, 1, 2)\n })\n})\n\ndescribe('Exponentiation of a rational number', () => {\n xit('Raise a positive rational number to a positive integer power', () => {\n const actual = new Rational(1, 2).exprational(3)\n assertRational(actual, 1, 8)\n })\n\n xit('Raise a negative rational number to a positive integer power', () => {\n const actual = new Rational(-1, 2).exprational(3)\n assertRational(actual, -1, 8)\n })\n\n xit('Raise a positive rational number to a negative integer power', () => {\n const actual = new Rational(3, 5).exprational(-2)\n assertRational(actual, 25, 9)\n })\n\n xit('Raise a negative rational number to an even negative integer power', () => {\n const actual = new Rational(-3, 5).exprational(-2)\n assertRational(actual, 25, 9)\n })\n\n xit('Raise a negative rational number to an odd negative integer power', () => {\n const actual = new Rational(-3, 5).exprational(-3)\n assertRational(actual, -125, 27)\n })\n\n xit('Raise zero to an integer power', () => {\n const actual = new Rational(0, 1).exprational(5)\n assertRational(actual, 0, 1)\n })\n\n xit('Raise one to an integer power', () => {\n const actual = new Rational(1, 1).exprational(4)\n assertRational(actual, 1, 1)\n })\n\n xit('Raise a positive rational number to the power of zero', () => {\n const actual = new Rational(1, 2).exprational(0)\n assertRational(actual, 1, 1)\n })\n\n xit('Raise a negative rational number to the power of zero', () => {\n const actual = new Rational(-1, 2).exprational(0)\n assertRational(actual, 1, 1)\n })\n})\n\ndescribe('Exponentiation of a real number to a rational number', () => {\n xit('Raise a real number to a positive rational number', () => {\n const actual = new Rational(4, 3).expreal(8)\n expect(actual).toBeCloseTo(16.0, 10)\n })\n\n xit('Raise a real number to a negative rational number', () => {\n const actual = new Rational(-1, 2).expreal(9)\n expect(actual).toBeCloseTo(1.0 / 3.0, 10)\n })\n\n xit('Raise a real number to a zero rational number', () => {\n const actual = new Rational(0, 1).expreal(2)\n expect(actual).toBeCloseTo(1.0, 10)\n })\n})\n\ndescribe('Reduction to lowest terms', () => {\n xit('Reduce a positive rational number to lowest terms', () => {\n const actual = new Rational(2, 4).reduce()\n assertRational(actual, 1, 2)\n })\n\n xit('Reduce places the minus sign on the numerator', () => {\n const actual = new Rational(3, -4).reduce()\n assertRational(actual, -3, 4)\n })\n\n xit('Reduce a negative rational number to lowest terms', () => {\n const actual = new Rational(-4, 6).reduce()\n assertRational(actual, -2, 3)\n })\n\n xit('Reduce a rational number with a negative denominator to lowest terms', () => {\n const actual = new Rational(3, -9).reduce()\n assertRational(actual, -1, 3)\n })\n\n xit('Reduce zero to lowest terms', () => {\n const actual = new Rational(0, 6).reduce()\n assertRational(actual, 0, 1)\n })\n\n xit('Reduce an integer to lowest terms', () => {\n const actual = new Rational(-14, 7).reduce()\n assertRational(actual, -2, 1)\n })\n\n xit('Reduce one to lowest terms', () => {\n const actual = new Rational(13, 13).reduce()\n assertRational(actual, 1, 1)\n })\n})\n" }, { "path": "exercises/practice/rational-numbers/rational-numbers.ts", "content": "export class Rational {\n constructor() {\n throw new Error('Remove this line and implement the function')\n }\n\n add() {\n throw new Error('Remove this line and implement the function')\n }\n\n sub() {\n throw new Error('Remove this line and implement the function')\n }\n\n mul() {\n throw new Error('Remove this line and implement the function')\n }\n\n div() {\n throw new Error('Remove this line and implement the function')\n }\n\n abs() {\n throw new Error('Remove this line and implement the function')\n }\n\n exprational() {\n throw new Error('Remove this line and implement the function')\n }\n\n expreal() {\n throw new Error('Remove this line and implement the function')\n }\n\n reduce() {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/rational-numbers/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/rational-numbers/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/react/.docs/instructions.md", "content": "# Instructions\n\nImplement a basic reactive system.\n\nReactive programming is a programming paradigm that focuses on how values are computed in terms of each other to allow a change to one value to automatically propagate to other values, like in a spreadsheet.\n\nImplement a basic reactive system with cells with settable values (\"input\" cells) and cells with values computed in terms of other cells (\"compute\" cells).\nImplement updates so that when an input value is changed, values propagate to reach a new stable system state.\n\nIn addition, compute cells should allow for registering change notification callbacks.\nCall a cellā€™s callbacks when the cellā€™s value in a new stable state has changed from the previous stable state.\n" }, { "path": "exercises/practice/react/.meta/config.json", "content": "{\n \"authors\": [\n \"peerreynders\"\n ],\n \"files\": {\n \"solution\": [\n \"react.ts\"\n ],\n \"test\": [\n \"react.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement a basic reactive system.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/react/.meta/proof.ci.ts", "content": "//\n// Heavily inspired by signal.ts from [https://github.com/ryansolid/solid]\n// and by extension S.js [https://github.com/adamhaile/S]\n//\n// See:\n// https://indepth.dev/posts/1269/finding-fine-grained-reactive-programming#how-it-works\n// https://levelup.gitconnected.com/finding-fine-grained-reactive-programming-89741994ddee?source=friends_link&sk=31c66a70c1dce7dd5f3f4229423ad127#4543\n//\n\nenum Status {\n OK,\n Pending,\n Stale,\n}\n\n/**\n * Type for the closure's value equality predicate.\n *\n * @typeParam T - Type of the values being compared for\n * equality.\n *\n * @remarks\n * Conceptually this function should be equivalent\n * to: `lhs === rhs`\n *\n * @param lhs - left hand side value\n * @param rhs - right hand side value\n * @returns - `true` if values are considered\n * equal; `false` otherwise.\n */\ntype EqualFn = (lhs: T, rhs: T) => boolean\ntype GetterFn = () => T\ntype SetterFn = (value: T) => T\ntype UnsubscribeFn = () => void\ntype UpdateFn = (value?: T) => T\n\ntype InputPair = [GetterFn, SetterFn]\n\ntype Options = {\n name: string\n}\n\ntype ObserverR = {\n name?: string\n pure: boolean\n status: Status\n subjects: Set\n}\n\ntype ObserverV = {\n value?: T\n updateFn: UpdateFn\n}\n\ntype Observer = ObserverR & ObserverV\n\ntype SubjectR = {\n name?: string\n observers: Set\n}\n\ntype SubjectV = {\n value?: T\n equalFn?: EqualFn\n}\n\ntype Subject = SubjectR & SubjectV\n\ntype ComputedR = ObserverR & SubjectR\n\ntype Computed = ComputedR & ObserverV & SubjectV\n\nfunction isObserverRComputedR(observer: ObserverR): observer is ComputedR {\n const computed = observer as ComputedR\n return computed.observers !== undefined\n}\n\nfunction isSubjectComputed(subject: Subject): subject is Computed {\n const computed = subject as Computed\n return computed.subjects !== undefined\n}\n\nfunction isObserverComputed(observer: Observer): observer is Computed {\n const computed = observer as Computed\n return computed.observers !== undefined\n}\n\nconst defaultEqual = (lhs: T, rhs: T): boolean => lhs === rhs\n\nfunction selectEqualFn(\n equal: boolean | EqualFn | undefined\n): EqualFn | undefined {\n if (typeof equal === 'function') return equal\n\n if (equal === true) return defaultEqual\n\n return undefined\n}\n\n// module context values\nlet activeObserver: ObserverR\nlet updateQueue: ObserverR[] | undefined\nlet callbackQueue: ObserverR[] | undefined\n\nfunction link(subject: SubjectR, observer: ObserverR): void {\n observer.subjects.add(subject)\n subject.observers.add(observer)\n}\n\nfunction unsubscribe(observer: ObserverR): void {\n observer.subjects.forEach((sub) => {\n sub.observers.delete(observer)\n })\n}\n\nfunction makeUnsubscribe(observer: ObserverR | undefined): UnsubscribeFn {\n return (): void => {\n if (!observer) return\n const o = observer\n observer = undefined\n\n unsubscribe(o)\n }\n}\n\nfunction prepareForUpdate(observer: ObserverR): void {\n if (isObserverRComputedR(observer) && observer.status !== Status.Pending) {\n markDeepObservers(observer)\n }\n observer.status = Status.Stale\n\n if (observer.pure) updateQueue!.push(observer)\n else callbackQueue!.push(observer)\n}\n\nfunction markDeep(observer: ObserverR): void {\n if (observer.status === Status.OK) {\n observer.status = Status.Pending\n if (isObserverRComputedR(observer)) markDeepObservers(observer)\n }\n}\n\nfunction markDeepObservers(subject: SubjectR): void {\n subject.observers.forEach(markDeep)\n}\n\nfunction runUpdates(prepareUpdates: () => void): void {\n if (updateQueue) return prepareUpdates()\n\n const updates: ObserverR[] = []\n updateQueue = updates\n\n const [callbacks, delayCallbacks] = callbackQueue\n ? [callbackQueue, true]\n : [[], false]\n callbackQueue = callbacks\n\n prepareUpdates()\n updateQueued(updates)\n updateQueue = undefined\n\n if (delayCallbacks) return\n\n updateQueued(callbacks)\n callbackQueue = undefined\n}\n\nfunction updateQueued(queued: ObserverR[]): void {\n for (let i = 0; i < queued.length; i++) {\n updateViaStatus(queued[i] as Observer, true)\n }\n}\n\nfunction updateViaStatus(\n observer: Observer,\n saveQueue: boolean = false\n): void {\n switch (observer.status) {\n case Status.Pending: {\n if (saveQueue !== true) {\n updateDeepStaleSubjects(observer)\n } else {\n const prevUpdate = updateQueue\n updateQueue = undefined\n updateDeepStaleSubjects(observer)\n updateQueue = prevUpdate\n }\n break\n }\n case Status.Stale:\n updateObserver(observer)\n break\n }\n}\n\nfunction updateDeep(subject: Subject): void {\n if (isSubjectComputed(subject)) updateViaStatus(subject)\n}\n\nfunction updateDeepStaleSubjects(observer: Observer): void {\n observer.subjects.forEach(updateDeep)\n}\n\nfunction updateObserver(observer: Observer): void {\n unsubscribe(observer)\n const prevObserver = activeObserver\n activeObserver = observer\n\n observer.status = Status.OK\n const nextValue = observer.updateFn(observer.value)\n if (isObserverComputed(observer)) writeSubject(observer, nextValue)\n else observer.value = nextValue\n\n activeObserver = prevObserver\n}\n\nfunction readSubject(subject: Subject): T {\n if (isSubjectComputed(subject) && subject.status !== Status.OK) {\n const updates = updateQueue\n updateQueue = undefined\n updateViaStatus(subject)\n updateQueue = updates\n }\n if (activeObserver) link(subject, activeObserver)\n\n return subject.value!\n}\n\nfunction writeSubject(subject: Subject, value: T): T {\n if (subject.equalFn && subject.value && subject.equalFn(subject.value, value))\n return value\n\n subject.value = value\n\n if (subject.observers.size) {\n runUpdates(() => subject.observers.forEach(prepareForUpdate))\n }\n\n return subject.value\n}\n\n/**\n * Creates an input closure. The value is accessed\n * via the accessor and changed via the\n * mutator returned as part an `InputPair`.\n *\n * @typeParam T - Type of the closure's value.\n * By extension the type of the return\n * value of the accessor and the type\n * of the mutator's single argument.\n *\n * @param value - Input closure's initial value.\n * @param equal - By default the current and previous\n * values are not compared so invoking\n * the mutator with identical values\n * will trigger updates on any\n * subscribers. When `true` is\n * specified the\n * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Strict_equality | strict equality operator}\n * is used to compare values and\n * mutations with unchanging values\n * **are** suppressed.\n * When `T` is a structural type\n * it is necessary to provide a\n * `(a: T, b: T) => boolean` comparison\n * predicate instead.\n * @param options - Holder object for relevant options.\n * Assigning a `name` to a subject can\n * be useful during debugging.\n * @returns - An `InputPair`. The 1st\n * element is the accessor (getter\n * function), the 2nd element is\n * the mutator (setter function).\n */\nfunction createInput(\n value: T,\n equal?: boolean | EqualFn,\n options?: Options\n): InputPair {\n const subject: Subject = {\n name: options?.name,\n observers: new Set(),\n value,\n equalFn: selectEqualFn(equal),\n }\n\n return [\n (): T => readSubject(subject),\n (next: T): T => writeSubject(subject, next),\n ]\n}\n\n/**\n * Creates a computed (derived) closure with the\n * supplied function which computes the current value\n * of the closure.\n *\n * @typeParam T - Type of the closure's value.\n * By extension the type of the value\n * returned by the update function and\n * of the value\n * accepted by the function.\n *\n * @param updateFn - Update function. This function\n * references one or more accessors of\n * other subjects. It **should not**\n * perform side effects. It is expected\n * to return a value which will be the\n * value of the closure until the next\n * update. The closure's value is\n * supplied to this update function\n * on the next update.\n * @param value - Initial value that is passed to\n * `updateFn` when it executes for the\n * first time.\n * @param equal - By default the current and previous\n * values are not compared so updates\n * will be triggered even if the value\n * doesn't _change_. When `true` is\n * specified the\n * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Strict_equality | strict equality operator}\n * is used to compare values and updates\n * with identical values **are**\n * suppressed. When `T` is a structural\n * type it is necessary to provide a\n * `(a: T, b: T) => boolean` comparison\n * predicate instead.\n * @param options - Holder object for relevant options.\n * Assigning a `name` to a subject can\n * be useful during debugging.\n * @returns - The accessor to the closure's\n * value (getter function). Retrieves\n * the closure's current value. Used by\n * observers (or more accurately their\n * update function) to obtain the\n * value (and to subscribe for\n * updates).\n */\nfunction createComputed(\n updateFn: UpdateFn,\n value?: T,\n equal?: boolean | EqualFn,\n options?: Options\n): GetterFn {\n const computed: Computed = {\n name: options?.name,\n observers: new Set(),\n value,\n equalFn: selectEqualFn(equal),\n updateFn,\n status: Status.Stale,\n pure: true,\n subjects: new Set(),\n }\n updateObserver(computed)\n return (): T => readSubject(computed)\n}\n\n/**\n * Creates a callback closure with the supplied\n * function which is expected to perform side effects.\n *\n * @typeParam T - Type of the closure's value.\n * By extension the type of the value\n * returned by the callback function\n * and of the value accepted by the\n * function.\n *\n * @param updateFn - Callback function. This function\n * references one or more accessors of\n * subjects. It may perform side effects.\n * It will also be passed the\n * value that it returned the last time it\n * was invoked.\n * @param value - Initial value that is passed to\n * `updateFn` when it executes for\n * the first time.\n * @returns - The `unsubscribe` function. Once\n * invoked the callback closure will\n * stop receiving updates from the\n * subjects it subscribed to.\n */\nfunction createCallback(updateFn: UpdateFn, value?: T): UnsubscribeFn {\n const o: Observer = {\n value,\n updateFn,\n status: Status.Stale,\n pure: false,\n subjects: new Set(),\n }\n\n if (callbackQueue) callbackQueue.push(o)\n else updateObserver(o)\n\n return makeUnsubscribe(o)\n}\n\nexport { createInput, createComputed, createCallback }\n\n// -------------------------------------------------------\n//\n// A `Subject` provides its output value **to**\n// its dependents (`Observer`s).\n//\n// An `Observer` gets its input values **from**\n// its dependencies (`Subject`s).\n//\n// A `Computed` merges the _aspects_ of\n// both `Observer` and `Subject`.\n// Of the three types `Computed` is the most _general_.\n// So while `Computed` is composed of both\n// `Subject` and `Observer`, both\n// `Subject`, `Observer` could be viewed as\n// _constrained_ versions of `Computed` (as\n// opposed to _specialized_ versions).\n//\n// Each type is further split into its _value_ aspect\n// (e.g. `ObserverV`) and _relation_ (or _rest_)\n// aspect (e.g. `ObserverR`). This tactic helps to\n// avoid using generic type references with an\n// explicit _any_ type parameter in the update\n// routing logic which has no actual dependency\n// on the type `T` being managed by the\n// `Subject`/ `Observer`/`Computed`\n// instance.\n//\n// The existence of the value aspect is only\n// acknowledged in `updateQueued()` where the\n// `ObserverR` type is asserted to be an\n// `Observer` which from this point on is\n// then handled by generic functions.\n//\n// So `createInput()` internally creates a\n// `Subject`, `createCallback()` an `Observer`, and\n// `createComputed()` a `Computed`.\n//\n// `createInput()` returns two functions in an\n// `InputCouple` tuple, a `GetterFn` accessor\n// and a `SetterFn` mutator. The mutator triggers\n// the update of all the `Subject`'s dependents\n// while the accessor returns the `Subject`'s\n// current value.\n//\n// The accessor also has the hidden responsibility\n// of subscribing the `Observer` that is accessing\n// the `Subject`. The `Observer` shares its\n// reference via the module's `activeObserver` context\n// value. The `Subject` stores that dependency in\n// its `observers` property.\n//\n// `createComputed()` only returns a `GetterFn`\n// accessor to obtain the internal `Computed`'s\n// current value. The primary argument to\n// `createComputed()` is `fn: UpdateFn` - the\n// function responsible for deriving the\n// `Computed`'s value from its dependencies\n// (and the `Computed`'s own previous value). This\n// function is invoked whenever at least one of the\n// `Computed`'s dependencies has an updated value.\n// The function is run before `createComputed()`\n// exits via `updateObserver()` so that\n// * the `Computed` can calculate its current value\n// * the `Computed` subscribes to all its\n// relevant dependencies.\n//\n// To that end `updateObserver()` sets the\n// module's `activeObserver` context value before\n// invoking `fn: UpdateFn` so that all the\n// `Subject`'s being accessed can register the\n// subscription of the `Observer` (or `Computed`).\n//\n// (Note that `updateObserver()` unsubscribes the\n// `Observer` (or `Computed`) first - this is\n// essential later so that the `Observer` isn't\n// updated for irrelevant dependencies - e.g. an\n// input accessor that is guarded by an `if` condition\n// that currently evaluates to `false`.)\n//\n// `createCallback()` returns an `UnsubscribeFn`\n// function that deactivates the callback when invoked.\n// There is no `GetterFn` because the callbacks\n// act by _side effect_ - i.e. changing values that\n// exist in their enclosing scope (closure:\n// https://github.com/getify/You-Dont-Know-JS/blob/2nd-ed/scope-closures/ch7.md\n// ). Internally a callback is based on a `Observer`.\n// The primary argument to\n// `createCallback()` is `fn: UpdateFn` - the\n// function is responsible for accessing the `Subject`\n// dependencies (and thereby subscribing to them)\n// and implementing the side effect(s). This\n// function is called whenever at least one of the\n// `Observer`'s dependencies has an updated value.\n// `updateObserver()` is only invoked if currently no\n// update is in progress - otherwise the callback is\n// queued for later invocation.\n//\n// All three `create*` functions take a `value: T`\n// argument - required for `createInput()`,\n// optional for the others. For `createInput()`\n// this is the initial value - for the others it is the\n// argument that is passed to the `fn: UpdateFn`\n// the first time it executes.\n//\n// `createInput()` and `createComputed()` have\n// an (optional) ` equal?: boolean | EqualFn`\n// argument. Given the generic implementation of the\n// capabilities, by default `Subject`s don't\n// limit updates to occasions when their `value`\n// _changes_ - as there is no standardized way\n// to check for equality of `T` in TypeScript\n// (compared to for example Rust):\n// https://doc.rust-lang.org/std/cmp/trait.PartialEq.html\n// https://doc.rust-lang.org/std/cmp/trait.Eq.html\n//\n// A value of `true` directs the use of the default\n// equality function `defaultEqual` which will work\n// for primitive types and references. Otherwise a\n// custom equality predicate must be provided\n// if updates for identical values of `T` are to\n// be suppressed.\n//\n// `createCallback` doesn't have this argument.\n// Therefore it is necessary to configure the\n// `Subject`s it depends on to suppress updates\n// on identical values.\n//\n// `createInput()` and `createComputed()` have\n// an optional `Options` value that may carry a\n// `name` property. This can come in handy for\n// debugging.\n//\n// The core capability is driven by the\n// `writeSubject` function which is invoked whenever\n// an input is set with its `SetterFn` or a\n// `Computed` has its `value` set by a dependency.\n// The update of dependents is suppressed for identical\n// values provided the `Subject` is configured\n// accordingly. Otherwise all the observers are\n// prepared for update before the actual updates are\n// made.\n//\n// `prepareForUpdate()` first marks the dependents of a\n// `Computed` as `Status.Pending` _in depth_. The\n// observer itself is marked as `Status.Stale` before\n// being pushed onto `updateQueue` or `callbackQueue`.\n//\n// * `Status.Pending` - an `Observer` has this\n// status when one of its dependencies _descendents_\n// is marked as `Status.Stale`. It acts as a\n// pre-`Status.Stale` status. The `Observer`\n// instance is \"out-of-sync\" but not yet ready\n// for update (so it isn't on `updateQueue`).\n// * `Status.Stale` - an `Observer` enters this\n// state when at least one of its direct\n// dependencies has been updated. The `Observer`\n// instance is on `updateQueue`.\n//\n// `runUpdates` coordinates the current update wave.\n// The passed `prepareUpdate` function is invoked if an\n// update wave is already underway. Otherwise an empty\n// `updateQueue` is set up. If callbacks are already\n// being queued this particular `runUpdates` invocation\n// won't be processing callbacks\n// (`delayCallbacks = true`) - otherwise an empty\n// `callbackQueue` is set up.\n//\n// Finally the passed `prepareUpdates` function is\n// invoked causing \"computeds\" to be queued up on\n// `updateQueue` and \"callbacks\" to be queued up on\n// `callbackQueue`. The `updateQueue` is processed\n// with the `updateQueued()` function.\n//\n// Callbacks are only processed if this is the\n// top-level invocation of `runUpdates()` - this\n// ensures that callbacks are updated as late as\n// possible to avoid unnecessary, multiple\n// updates.\n//\n// Updates routed through `updateViaStatus` by\n// `updateQueued` start a nested (deep) update wave\n// for an `Observer` in the `Status.Pending`\n// status - i.e. there are dependencies in need of\n// update before the `Observer` can perform\n// a meaningful update of itself. `Observer`'s\n// in the `Status.Stale` status can immediately update\n// themselves via their `fn: UpdateFn`.\n//\n// `readSubject()` will issue a nested update wave\n// if it discovers that its `Subject` is currently\n// **not** in `Status.OK` status as it needs those\n// updates to complete before an up-to-date `value`\n// can be returned.\n//\n// References:\n//\n// Enums\n// https://www.typescriptlang.org/docs/handbook/enums.html\n//\n// Type Aliases\n// https://www.typescriptlang.org/docs/handbook/advanced-types.html#type-aliases\n//\n// Function Types\n// https://www.typescriptlang.org/docs/handbook/functions.html#function-types\n//\n// Generics\n// https://www.typescriptlang.org/docs/handbook/generics.html\n//\n// Optional and Default Types\n// https://www.typescriptlang.org/docs/handbook/functions.html#optional-and-default-parameters\n//\n// Tuple\n// https://www.typescriptlang.org/docs/handbook/basic-types.html#tuple\n//\n// Optional Properties\n// https://www.typescriptlang.org/docs/handbook/interfaces.html#optional-properties\n//\n// Set\n// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set\n//\n// Intersection Types\n// https://www.typescriptlang.org/docs/handbook/unions-and-intersections.html#intersection-types\n//\n// User-Defined Type Guards\n// https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards\n//\n// Type Assertions\n// https://www.typescriptlang.org/docs/handbook/basic-types.html#type-assertions\n//\n// Union Types\n// https://www.typescriptlang.org/docs/handbook/unions-and-intersections.html#union-types\n//\n// typeof\n// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/typeof\n//\n// Unknown\n// https://www.typescriptlang.org/docs/handbook/basic-types.html#unknown\n//\n// Non-null assertion operator\n// https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-0.html#non-null-assertion-operator\n//\n// Optional chaining (?.)\n// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Optional_chaining\n//\n// -------------------------------------------------------\n" }, { "path": "exercises/practice/react/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[c51ee736-d001-4f30-88d1-0c8e8b43cd07]\ndescription = \"input cells have a value\"\n\n[dedf0fe0-da0c-4d5d-a582-ffaf5f4d0851]\ndescription = \"an input cell's value can be set\"\n\n[5854b975-f545-4f93-8968-cc324cde746e]\ndescription = \"compute cells calculate initial value\"\n\n[25795a3d-b86c-4e91-abe7-1c340e71560c]\ndescription = \"compute cells take inputs in the right order\"\n\n[c62689bf-7be5-41bb-b9f8-65178ef3e8ba]\ndescription = \"compute cells update value when dependencies are changed\"\n\n[5ff36b09-0a88-48d4-b7f8-69dcf3feea40]\ndescription = \"compute cells can depend on other compute cells\"\n\n[abe33eaf-68ad-42a5-b728-05519ca88d2d]\ndescription = \"compute cells fire callbacks\"\n\n[9e5cb3a4-78e5-4290-80f8-a78612c52db2]\ndescription = \"callback cells only fire on change\"\n\n[ada17cb6-7332-448a-b934-e3d7495c13d3]\ndescription = \"callbacks do not report already reported values\"\n\n[ac271900-ea5c-461c-9add-eeebcb8c03e5]\ndescription = \"callbacks can fire from multiple cells\"\n\n[95a82dcc-8280-4de3-a4cd-4f19a84e3d6f]\ndescription = \"callbacks can be added and removed\"\n\n[f2a7b445-f783-4e0e-8393-469ab4915f2a]\ndescription = \"removing a callback multiple times doesn't interfere with other callbacks\"\n\n[daf6feca-09e0-4ce5-801d-770ddfe1c268]\ndescription = \"callbacks should only be called once even if multiple dependencies change\"\n\n[9a5b159f-b7aa-4729-807e-f1c38a46d377]\ndescription = \"callbacks should not be called if dependencies change but output value doesn't change\"\n" }, { "path": "exercises/practice/react/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/react/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/react/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/react/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/react/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/react/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/react/package.json", "content": "{\n \"name\": \"@exercism/typescript-react\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/react/react.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { createInput, createComputed, createCallback } from './react.ts'\n\ndescribe('React module', () => {\n // c51ee736-d001-4f30-88d1-0c8e8b43cd07\n xit('input cells have a value', () => {\n const initialValue = 10\n const [input, _setInput] = createInput(initialValue)\n expect(input()).toEqual(initialValue)\n })\n\n // dedf0fe0-da0c-4d5d-a582-ffaf5f4d0851\n xit(\"an input cell's value can be set\", () => {\n const newValue = 20\n const [input, setInput] = createInput(4)\n setInput(newValue)\n expect(input()).toEqual(newValue)\n })\n\n // 5854b975-f545-4f93-8968-cc324cde746e\n xit('compute cells calculate initial value', () => {\n const [input] = createInput(1)\n const output = createComputed(() => input() + 1)\n expect(output()).toEqual(2)\n })\n\n // 25795a3d-b86c-4e91-abe7-1c340e71560c\n xit('compute cell takes inputs in correct order', () => {\n const [[one], [two]] = [createInput(1), createInput(2)]\n const output = createComputed(() => one() + two() * 10)\n expect(output()).toEqual(21)\n })\n\n // c62689bf-7be5-41bb-b9f8-65178ef3e8ba\n it('compute cells update value when inputs are changed', () => {\n const [input, setInput] = createInput(1)\n const output = createComputed(() => input() + 1)\n setInput(3)\n expect(output()).toEqual(4)\n })\n\n // 5ff36b09-0a88-48d4-b7f8-69dcf3feea40\n xit('compute cells can depend on other compute cells', () => {\n const [input, setInput] = createInput(1)\n const timesTwo = createComputed(() => input() * 2)\n const timesThirty = createComputed(() => input() * 30)\n const sum = createComputed(() => timesTwo() + timesThirty())\n expect(sum()).toEqual(32)\n setInput(3)\n expect(sum()).toEqual(96)\n })\n\n // abe33eaf-68ad-42a5-b728-05519ca88d2d\n xit('compute cells fire callbacks', () => {\n const [input, setInput] = createInput(1)\n const output = createComputed(() => input() + 1)\n let value = 0\n createCallback(() => (value = output()))\n setInput(3)\n expect(value).toEqual(4)\n })\n\n // 9e5cb3a4-78e5-4290-80f8-a78612c52db2\n xit('callbacks fire only when output values change', () => {\n const [input, setInput] = createInput(1)\n const output = createComputed(\n () => (input() < 3 ? 111 : 222),\n undefined,\n true // i.e. equality check - don't propagate if value doesn't change\n )\n let value: number | undefined\n createCallback(() => (value = output()))\n value = undefined // discard initial value from registration\n setInput(2)\n expect(value).toBeUndefined()\n setInput(4)\n expect(value).toEqual(222)\n })\n\n // ada17cb6-7332-448a-b934-e3d7495c13d\n xit('callbacks do not report already reported values', () => {\n const [input, setInput] = createInput(1)\n const output = createComputed(() => input() + 1)\n\n let value: number | undefined\n createCallback(() => (value = output()))\n\n setInput(2)\n expect(value).toEqual(3)\n\n setInput(3)\n expect(value).toEqual(4)\n })\n\n // ac271900-ea5c-461c-9add-eeebcb8c03e5\n xit('callbacks can fire from multiple cells', () => {\n const [input, setInput] = createInput(1)\n const plus_one = createComputed(() => input() + 1)\n const minus_one = createComputed(() => input() - 1)\n\n let value1 = 0\n createCallback(() => (value1 = plus_one()))\n let value2 = 0\n createCallback(() => (value2 = minus_one()))\n\n setInput(10)\n expect(value1).toEqual(11)\n expect(value2).toEqual(9)\n })\n\n // From JavaScript track\n xit('static callbacks fire even if their own value has not changed', () => {\n const [input, setInput] = createInput(1)\n const output = createComputed(\n () => (input() < 3 ? 111 : 222),\n undefined,\n true // i.e. equality check - don't propagate if value doesn't change\n )\n const values: string[] = []\n createCallback(() => {\n const _dontCare = output()\n values.push('cell changed')\n })\n values.pop() // discard initial value from registration\n setInput(2)\n expect(values).toEqual([])\n setInput(4)\n setInput(2)\n setInput(4)\n expect(values).toEqual(['cell changed', 'cell changed', 'cell changed'])\n })\n\n // 95a82dcc-8280-4de3-a4cd-4f19a84e3d6f\n xit('callbacks can be added and removed', () => {\n const [input, setInput] = createInput(11)\n const output = createComputed(() => input() + 1)\n\n const values1: number[] = []\n const unsubscribe1 = createCallback(() => values1.push(output()))\n values1.pop() // discard initial value from registration\n const values2: number[] = []\n createCallback(() => values2.push(output()))\n values2.pop() // discard initial value ...\n\n setInput(31)\n\n unsubscribe1()\n\n const values3: number[] = []\n createCallback(() => values3.push(output()))\n values3.pop() // discard initial value ...\n\n setInput(41)\n\n expect(values1).toEqual([32])\n expect(values2).toEqual([32, 42])\n expect(values3).toEqual([42])\n })\n\n // f2a7b445-f783-4e0e-8393-469ab4915f2a\n xit(\"removing a callback multiple times doesn't interfere with other callbacks\", () => {\n const [input, setInput] = createInput(1)\n const output = createComputed(() => input() + 1)\n\n const values1: number[] = []\n const unsubscribe1 = createCallback(() => values1.push(output()))\n values1.pop() // discard initial value from registration\n const values2: number[] = []\n createCallback(() => values2.push(output()))\n values2.pop() // discard initial value ...\n\n unsubscribe1()\n unsubscribe1()\n unsubscribe1()\n\n setInput(2)\n\n expect(values1).toEqual([])\n expect(values2).toEqual([3])\n })\n\n // daf6feca-09e0-4ce5-801d-770ddfe1c268\n xit('callbacks should only be called once, even if multiple dependencies change', () => {\n const [input, setInput] = createInput(1)\n const plusOne = createComputed(() => input() + 1)\n const minusOne1 = createComputed(() => input() - 1)\n const minusOne2 = createComputed(() => minusOne1() - 1)\n const output = createComputed(() => plusOne() * minusOne2())\n\n const values: number[] = []\n createCallback(() => values.push(output()))\n values.pop() // discard initial value from registration\n\n setInput(4)\n\n expect(values).toEqual([10])\n })\n\n // 9a5b159f-b7aa-4729-807e-f1c38a46d377\n xit(\"callbacks should not be called if dependencies change but output value doesn't change\", () => {\n const [input, setInput] = createInput(1)\n const plusOne = createComputed(() => input() + 1)\n const minusOne = createComputed(() => input() - 1)\n const alwaysTwo = createComputed(\n () => plusOne() - minusOne(),\n undefined,\n true // i.e. equality check - don't propagate if value doesn't change\n )\n\n const values: number[] = []\n createCallback(() => values.push(alwaysTwo()))\n values.pop() // discard initial value from registration\n\n setInput(2)\n setInput(3)\n setInput(4)\n setInput(5)\n\n expect(values).toEqual([])\n })\n})\n" }, { "path": "exercises/practice/react/react.ts", "content": "//\n// Delete and replace stub with your own implementation\n//\n// Inspired by \"How it Works\":\n// https://indepth.dev/posts/1269/finding-fine-grained-reactive-programming#how-it-works\n// https://levelup.gitconnected.com/finding-fine-grained-reactive-programming-89741994ddee?source=friends_link&sk=31c66a70c1dce7dd5f3f4229423ad127#4543\n//\n// and \"Computations\":\n// https://github.com/ryansolid/solid/blob/master/documentation/reactivity.md#user-content-computations\n//\n\n/**\n * Type for the closure's value equality predicate.\n *\n * @typeParam T - Type of the values being compared for\n * equality.\n *\n * @remarks\n * Conceptually this function should be equivalent\n * to: `lhs === rhs`\n *\n * @param lhs - left hand side value\n * @param rhs - right hand side value\n * @returns - `true` if values are considered\n * equal; `false` otherwise.\n */\ntype EqualFn = (lhs: T, rhs: T) => boolean\ntype GetterFn = () => T\ntype SetterFn = (value: T) => T\ntype UnsubscribeFn = () => void\ntype UpdateFn = (value?: T) => T\n\ntype InputPair = [GetterFn, SetterFn]\n\ntype Options = {\n name: string // for debugging\n}\n\ntype ObserverR = {\n name?: string\n}\n\ntype ObserverV = {\n value?: T\n updateFn: UpdateFn\n}\n\ntype Observer = ObserverR & ObserverV\n\ntype SubjectR = {\n name?: string\n observer: ObserverR | undefined\n}\n\ntype SubjectV = {\n value: T\n equalFn?: EqualFn\n}\n\ntype Subject = SubjectR & SubjectV\n\n// module Context value\nlet activeObserver: ObserverR\n\nfunction updateObserver(observer: Observer): void {\n const prevObserver = activeObserver\n activeObserver = observer\n observer.value = observer.updateFn(observer.value)\n activeObserver = prevObserver\n}\n\n/**\n * Creates an input closure. The value is accessed\n * via the accessor and changed via the\n * mutator returned as part an `InputPair`.\n *\n * @typeParam T - Type of the closure's value.\n * By extension the type of the return\n * value of the accessor and the type\n * of the mutator's single argument.\n *\n * @param value - Input closure's initial value.\n * @param equal - By default the current and previous\n * values are not compared so invoking\n * the mutator with identical values\n * will trigger updates on any\n * subscribers. When `true` is\n * specified the\n * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Strict_equality | strict equality operator}\n * is used to compare values and\n * mutations with unchanging values\n * **are** suppressed.\n * When `T` is a structural type\n * it is necessary to provide a\n * `(a: T, b: T) => boolean` comparison\n * predicate instead.\n * @param options - Holder object for relevant options.\n * Assigning a `name` to a subject can\n * be useful during debugging.\n * @returns - An `InputPair`. The 1st\n * element is the accessor (getter\n * function), the 2nd element is\n * the mutator (setter function).\n */\nfunction createInput(\n value: T,\n _equal?: boolean | EqualFn,\n options?: Options\n): InputPair {\n const s: Subject = {\n name: options?.name,\n observer: undefined,\n value,\n equalFn: undefined,\n }\n\n const read: GetterFn = () => {\n if (activeObserver) s.observer = activeObserver\n return s.value\n }\n\n const write: SetterFn = (nextValue) => {\n s.value = nextValue\n if (s.observer) updateObserver(s.observer as Observer)\n return s.value\n }\n\n return [read, write]\n}\n\n/**\n * Creates a computed (derived) closure with the\n * supplied function which computes the current value\n * of the closure.\n *\n * @privateRemarks\n * `Observer` may be good enough to get through\n * the enabled test case but more is needed to\n * get further ...\n *\n * @typeParam T - Type of the closure's value.\n * By extension the type of the value\n * returned by the update function and\n * of the value\n * accepted by the function.\n *\n * @param updateFn - Update function. This function\n * references one or more accessors of\n * other subjects. It **should not**\n * perform side effects. It is expected\n * to return a value which will be the\n * value of the closure until the next\n * update. The closure's value is\n * supplied to this update function\n * on the next update.\n * @param value - Initial value that is passed to\n * `updateFn` when it executes for the\n * first time.\n * @param equal - By default the current and previous\n * values are not compared so updates\n * will be triggered even if the value\n * doesn't _change_. When `true` is\n * specified the\n * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Strict_equality | strict equality operator}\n * is used to compare values and updates\n * with identical values **are**\n * suppressed. When `T` is a structural\n * type it is necessary to provide a\n * `(a: T, b: T) => boolean` comparison\n * predicate instead.\n * @param options - Holder object for relevant options.\n * Assigning a `name` to a subject can\n * be useful during debugging.\n * @returns - The accessor to the closure's\n * value (getter function). Retrieves\n * the closure's current value. Used by\n * observers (or more accurately their\n * update function) to obtain the\n * value (and to subscribe for\n * updates).\n */\nfunction createComputed(\n updateFn: UpdateFn,\n value?: T,\n _equal?: boolean | EqualFn,\n options?: { name?: string }\n): GetterFn {\n const o: Observer = {\n name: options?.name,\n value,\n updateFn,\n }\n updateObserver(o)\n return (): T => o.value!\n}\n\n/**\n * Creates a callback closure with the supplied\n * function which is expected to perform side effects.\n *\n * @privateRemarks\n * `observer` isn't mean't to be an empty object literal.\n * Replace it with something more appropriate to its\n * purpose.\n *\n * @typeParam T - Type of the closure's value.\n * By extension the type of the value\n * returned by the callback function\n * and of the value accepted by the\n * function.\n *\n * @param updateFn - Callback function. This function\n * references one or more accessors of\n * subjects. It may perform side effects.\n * It will also be passed the\n * value that it returned the last time it\n * was invoked.\n * @param value - Initial value that is passed to\n * `updateFn` when it executes for\n * the first time.\n * @returns - The `unsubscribe` function. Once\n * invoked the callback closure will\n * stop receiving updates from the\n * subjects it subscribed to.\n */\nfunction createCallback(_updateFn: UpdateFn, _value?: T): UnsubscribeFn {\n const observer = {}\n return ((observer: unknown | undefined) => (): void => {\n if (!observer) return\n observer = undefined\n // i.e. dispose of any active subscriptions\n })(observer)\n}\n\nexport { createInput, createComputed, createCallback }\n" }, { "path": "exercises/practice/react/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/react/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/rectangles/.docs/instructions.md", "content": "# Instructions\n\nCount the rectangles in an ASCII diagram like the one below.\n\n```text\n +--+\n ++ |\n+-++--+\n| | |\n+--+--+\n```\n\nThe above diagram contains these 6 rectangles:\n\n```text\n\n\n+-----+\n| |\n+-----+\n```\n\n```text\n +--+\n | |\n | |\n | |\n +--+\n```\n\n```text\n +--+\n | |\n +--+\n\n\n```\n\n```text\n\n\n +--+\n | |\n +--+\n```\n\n```text\n\n\n+--+\n| |\n+--+\n```\n\n```text\n\n ++\n ++\n\n\n```\n\nYou may assume that the input is always a proper rectangle (i.e. the length of every line equals the length of the first line).\n" }, { "path": "exercises/practice/rectangles/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"rectangles.ts\"\n ],\n \"test\": [\n \"rectangles.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Count the rectangles in an ASCII diagram.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/rectangles/.meta/proof.ci.ts", "content": "export function count(diagram: string[]): number {\n const rows = diagram.length\n const cols = rows ? diagram[0].length : 0\n\n let rectangles = 0\n\n // All possible topleft corners\n for (let y = 0; y < rows - 1; y++) {\n for (let x = 0; x < cols - 1; x++) {\n if (diagram[y].charAt(x) === '+') {\n // All possible bottomright corners\n for (let j = y + 1; j < rows; j++) {\n for (let i = x + 1; i < cols; i++) {\n // Check if all corners are valid\n if (\n diagram[j].charAt(i) === '+' &&\n diagram[y].charAt(i) === '+' &&\n diagram[j].charAt(x) === '+'\n ) {\n let validRectangle = true\n\n // Check if all sides are valid\n for (let s = x + 1; s < i; s++) {\n if (!'+-'.includes(diagram[y].charAt(s))) {\n validRectangle = false\n }\n }\n\n for (let s = x + 1; s < i; s++) {\n if (!'+-'.includes(diagram[j].charAt(s))) {\n validRectangle = false\n }\n }\n\n for (let t = y + 1; t < j; t++) {\n if (!'+|'.includes(diagram[t].charAt(x))) {\n validRectangle = false\n }\n }\n\n for (let t = y + 1; t < j; t++) {\n if (!'+|'.includes(diagram[t].charAt(i))) {\n validRectangle = false\n }\n }\n\n if (validRectangle) {\n rectangles++\n }\n }\n }\n }\n }\n }\n }\n\n return rectangles\n}\n" }, { "path": "exercises/practice/rectangles/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[485b7bab-4150-40aa-a8db-73013427d08c]\ndescription = \"no rows\"\n\n[076929ed-27e8-45dc-b14b-08279944dc49]\ndescription = \"no columns\"\n\n[0a8abbd1-a0a4-4180-aa4e-65c1b1a073fa]\ndescription = \"no rectangles\"\n\n[a4ba42e9-4e7f-4973-b7c7-4ce0760ac6cd]\ndescription = \"one rectangle\"\n\n[ced06550-83da-4d23-98b7-d24152e0db93]\ndescription = \"two rectangles without shared parts\"\n\n[5942d69a-a07c-41c8-8b93-2d13877c706a]\ndescription = \"five rectangles with shared parts\"\n\n[82d70be4-ab37-4bf2-a433-e33778d3bbf1]\ndescription = \"rectangle of height 1 is counted\"\n\n[57f1bc0e-2782-401e-ab12-7c01d8bfc2e0]\ndescription = \"rectangle of width 1 is counted\"\n\n[ef0bb65c-bd80-4561-9535-efc4067054f9]\ndescription = \"1x1 square is counted\"\n\n[e1e1d444-e926-4d30-9bf3-7d8ec9a9e330]\ndescription = \"only complete rectangles are counted\"\n\n[ca021a84-1281-4a56-9b9b-af14113933a4]\ndescription = \"rectangles can be of different sizes\"\n\n[51f689a7-ef3f-41ae-aa2f-5ea09ad897ff]\ndescription = \"corner is required for a rectangle to be complete\"\n\n[d78fe379-8c1b-4d3c-bdf7-29bfb6f6dc66]\ndescription = \"large input with many rectangles\"\n\n[6ef24e0f-d191-46da-b929-4faca24b4cd2]\ndescription = \"rectangles must have four sides\"\n" }, { "path": "exercises/practice/rectangles/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/rectangles/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/rectangles/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/rectangles/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/rectangles/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/rectangles/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/rectangles/package.json", "content": "{\n \"name\": \"@exercism/typescript-rectangles\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/rectangles/rectangles.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { count } from './rectangles.ts'\n\ndescribe('Rectangles', () => {\n it('no rows', () => {\n const expected = 0\n const actual = count([])\n expect(actual).toEqual(expected)\n })\n\n xit('no columns', () => {\n const expected = 0\n const actual = count([''])\n expect(actual).toEqual(expected)\n })\n\n xit('no rectangles', () => {\n const expected = 0\n const actual = count([' '])\n expect(actual).toEqual(expected)\n })\n\n xit('one rectangle', () => {\n const expected = 1\n const actual = count(['+-+', '| |', '+-+'])\n expect(actual).toEqual(expected)\n })\n\n xit('two rectangles without shared parts', () => {\n const expected = 2\n const actual = count([' +-+', ' | |', '+-+-+', '| | ', '+-+ '])\n expect(actual).toEqual(expected)\n })\n\n xit('five rectangles with shared parts', () => {\n const expected = 5\n const actual = count([' +-+', ' | |', '+-+-+', '| | |', '+-+-+'])\n expect(actual).toEqual(expected)\n })\n\n xit('rectangle of height 1 is counted', () => {\n const expected = 1\n const actual = count(['+--+', '+--+'])\n expect(actual).toEqual(expected)\n })\n\n xit('rectangle of width 1 is counted', () => {\n const expected = 1\n const actual = count(['++', '||', '++'])\n expect(actual).toEqual(expected)\n })\n\n xit('1x1 square is counted', () => {\n const expected = 1\n const actual = count(['++', '++'])\n expect(actual).toEqual(expected)\n })\n\n xit('only complete rectangles are counted', () => {\n const expected = 1\n const actual = count([' +-+', ' |', '+-+-+', '| | -', '+-+-+'])\n expect(actual).toEqual(expected)\n })\n\n xit('rectangles can be of different sizes', () => {\n const expected = 3\n const actual = count([\n '+------+----+',\n '| | |',\n '+---+--+ |',\n '| | |',\n '+---+-------+',\n ])\n expect(actual).toEqual(expected)\n })\n\n xit('corner is required for a rectangle to be complete', () => {\n const expected = 2\n const actual = count([\n '+------+----+',\n '| | |',\n '+------+ |',\n '| | |',\n '+---+-------+',\n ])\n expect(actual).toEqual(expected)\n })\n\n xit('large input with many rectangles', () => {\n const expected = 60\n const actual = count([\n '+---+--+----+',\n '| +--+----+',\n '+---+--+ |',\n '| +--+----+',\n '+---+--+--+-+',\n '+---+--+--+-+',\n '+------+ | |',\n ' +-+',\n ])\n expect(actual).toEqual(expected)\n })\n\n xit('rectangles must have four sides', () => {\n const expected = 5\n const actual = count([\n '+-+ +-+',\n '| | | |',\n '+-+-+-+',\n ' | | ',\n '+-+-+-+',\n '| | | |',\n '+-+ +-+',\n ])\n expect(actual).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/rectangles/rectangles.ts", "content": "export function count() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/rectangles/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/rectangles/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/relative-distance/.docs/instructions.md", "content": "# Instructions\n\nYour task is to determine the degree of separation between two individuals in a family tree.\nThis is similar to the pop culture idea that every Hollywood actor is [within six degrees of Kevin Bacon][six-bacons].\n\n- You will be given an input, with all parent names and their children.\n- Each name is unique, a child _can_ have one or two parents.\n- The degree of separation is defined as the shortest number of connections from one person to another.\n- If two individuals are not connected, return a value that represents \"no known relationship.\"\n Please see the test cases for the actual implementation.\n\n## Example\n\nGiven the following family tree:\n\n```text\n ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā” ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā” ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”\n ā”‚ Helena ā”‚ ā”‚ Erdős ā”œā”€ā”€ā”€ā”€ā”€ā”¤ Shusaku ā”‚\n ā””ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”¬ā”€ā”€ā”˜ ā””ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”˜ ā””ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”˜\n ā”Œā”€ā”€ā”€ā”˜ ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā” ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜\nā”Œā”€ā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā”€ā” ā”Œā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā” ā”Œā”€ā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā”€ā”\nā”‚ Isla ā”œā”€ā”€ā”€ā”€ā”€ā”¤ Tariq ā”‚ ā”‚ Kevin ā”‚\nā””ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”˜ ā””ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”˜ ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜\n ā”‚ ā”‚\nā”Œā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā”€ā” ā”Œā”€ā”€ā”€ā”€ā”“ā”€ā”€ā”€ā”\nā”‚ Uma ā”‚ ā”‚ Morphy ā”‚\nā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜ ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜\n```\n\nThe degree of separation between Tariq and Uma is 2 (Tariq ā†’ Isla ā†’ Uma).\nThere's no known relationship between Isla and Kevin, as there is no connection in the given data.\nThe degree of separation between Uma and Isla is 1.\n\n~~~~exercism/note\nIsla and Tariq are siblings and have a separation of 1.\nSimilarly, this implementation would report a separation of 2 from you to your father's brother.\n~~~~\n\n[six-bacons]: https://en.wikipedia.org/wiki/Six_Degrees_of_Kevin_Bacon\n" }, { "path": "exercises/practice/relative-distance/.docs/introduction.md", "content": "# Introduction\n\nYou've been hired to develop **Noble Knots**, the hottest new dating app for nobility!\nWith centuries of royal intermarriage, things have gottenā€¦ _complicated_.\nTo avoid any _oops-we're-twins_ situations, your job is to build a system that checks how closely two people are related.\n\nNoble Knots is inspired by Iceland's \"[Islendinga-App][islendiga-app],\" which is backed up by a database that traces all known family connections between Icelanders from the time of the settlement of Iceland.\nYour algorithm will determine the **degree of separation** between two individuals in the royal family tree.\n\nWill your app help crown a perfect match?\n\n[islendiga-app]: https://web.archive.org/web/20250816223614/http://www.islendingaapp.is/information-in-english/\n" }, { "path": "exercises/practice/relative-distance/.meta/config.json", "content": "{\n \"authors\": [\n \"BNAndras\"\n ],\n \"files\": {\n \"solution\": [\n \"relative-distance.ts\"\n ],\n \"test\": [\n \"relative-distance.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a family tree, calculate the degree of separation.\",\n \"source\": \"vaeng\",\n \"source_url\": \"https://github.com/exercism/problem-specifications/pull/2537\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/relative-distance/.meta/proof.ci.ts", "content": "export const degreesOfSeparation = (\n familyTree: Record,\n personA: string,\n personB: string\n) => {\n const neighbors = new Map>()\n\n // Build adjacency list\n for (const [parent, children] of Object.entries(familyTree)) {\n const parentNeighbors = neighbors.get(parent) ?? new Set()\n neighbors.set(parent, parentNeighbors)\n\n for (const child of children) {\n const childNeighbors = neighbors.get(child) ?? new Set()\n neighbors.set(child, childNeighbors)\n\n parentNeighbors.add(child)\n childNeighbors.add(parent)\n\n // Connect siblings\n for (const sibling of children) {\n if (child !== sibling) {\n childNeighbors.add(sibling)\n }\n }\n }\n }\n\n if (!neighbors.has(personA) || !neighbors.has(personB)) return -1\n\n // BFS setup\n const queue: [string, number][] = [[personA, 0]]\n const visited = new Set([personA])\n\n while (queue.length > 0) {\n const [current, degree] = queue.shift()!\n\n if (current === personB) return degree\n\n for (const neighbor of neighbors.get(current)!) {\n if (!visited.has(neighbor)) {\n visited.add(neighbor)\n queue.push([neighbor, degree + 1])\n }\n }\n }\n\n return -1\n}\n" }, { "path": "exercises/practice/relative-distance/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[4a1ded74-5d32-47fb-8ae5-321f51d06b5b]\ndescription = \"Direct parent-child relation\"\n\n[30d17269-83e9-4f82-a0d7-8ef9656d8dce]\ndescription = \"Sibling relationship\"\n\n[8dffa27d-a8ab-496d-80b3-2f21c77648b5]\ndescription = \"Two degrees of separation, grandchild\"\n\n[34e56ec1-d528-4a42-908e-020a4606ee60]\ndescription = \"Unrelated individuals\"\n\n[93ffe989-bad2-48c4-878f-3acb1ce2611b]\ndescription = \"Complex graph, cousins\"\n\n[2cc2e76b-013a-433c-9486-1dbe29bf06e5]\ndescription = \"Complex graph, no shortcut, far removed nephew\"\n\n[46c9fbcb-e464-455f-a718-049ea3c7400a]\ndescription = \"Complex graph, some shortcuts, cross-down and cross-up, cousins several times removed, with unrelated family tree\"\n" }, { "path": "exercises/practice/relative-distance/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/relative-distance/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/relative-distance/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/relative-distance/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/relative-distance/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/relative-distance/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/relative-distance/package.json", "content": "{\n \"name\": \"@exercism/typescript-relative-distance\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/relative-distance/relative-distance.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { degreesOfSeparation } from './relative-distance.ts'\n\ndescribe('RelativeDistance', () => {\n it('Direct parent-child relation', () => {\n const familyTree = {\n Vera: ['Tomoko'],\n Tomoko: ['Aditi'],\n }\n const actual = degreesOfSeparation(familyTree, 'Vera', 'Tomoko')\n expect(actual).toEqual(1)\n })\n\n xit('Sibling relationship', () => {\n const familyTree = {\n Dalia: ['Olga', 'Yassin'],\n }\n const actual = degreesOfSeparation(familyTree, 'Olga', 'Yassin')\n expect(actual).toEqual(1)\n })\n\n xit('Two degrees of separation, grandchild', () => {\n const familyTree = {\n Khadija: ['Mateo'],\n Mateo: ['Rami'],\n }\n const actual = degreesOfSeparation(familyTree, 'Khadija', 'Rami')\n expect(actual).toEqual(2)\n })\n\n xit('Unrelated individuals', () => {\n const familyTree = {\n Priya: ['Rami'],\n Kaito: ['Elif'],\n }\n const actual = degreesOfSeparation(familyTree, 'Priya', 'Kaito')\n expect(actual).toEqual(-1)\n })\n\n xit('Complex graph, cousins', () => {\n const familyTree = {\n Aiko: ['Bao', 'Carlos'],\n Bao: ['Dalia', 'Elias'],\n Carlos: ['Fatima', 'Gustavo'],\n Dalia: ['Hassan', 'Isla'],\n Elias: ['Javier'],\n Fatima: ['Khadija', 'Liam'],\n Gustavo: ['Mina'],\n Hassan: ['Noah', 'Olga'],\n Isla: ['Pedro'],\n Javier: ['Quynh', 'Ravi'],\n Khadija: ['Sofia'],\n Liam: ['Tariq', 'Uma'],\n Mina: ['Viktor', 'Wang'],\n Noah: ['Xiomara'],\n Olga: ['Yuki'],\n Pedro: ['Zane', 'Aditi'],\n Quynh: ['Boris'],\n Ravi: ['Celine'],\n Sofia: ['Diego', 'Elif'],\n Tariq: ['Farah'],\n Uma: ['Giorgio'],\n Viktor: ['Hana', 'Ian'],\n Wang: ['Jing'],\n Xiomara: ['Kaito'],\n Yuki: ['Leila'],\n Zane: ['Mateo'],\n Aditi: ['Nia'],\n Boris: ['Oscar'],\n Celine: ['Priya'],\n Diego: ['Qi'],\n Elif: ['Rami'],\n Farah: ['Sven'],\n Giorgio: ['Tomoko'],\n Hana: ['Umar'],\n Ian: ['Vera'],\n Jing: ['Wyatt'],\n Kaito: ['Xia'],\n Leila: ['Yassin'],\n Mateo: ['Zara'],\n Nia: ['Antonio'],\n Oscar: ['Bianca'],\n Priya: ['Cai'],\n Qi: ['Dimitri'],\n Rami: ['Ewa'],\n Sven: ['Fabio'],\n Tomoko: ['Gabriela'],\n Umar: ['Helena'],\n Vera: ['Igor'],\n Wyatt: ['Jun'],\n Xia: ['Kim'],\n Yassin: ['Lucia'],\n Zara: ['Mohammed'],\n }\n const actual = degreesOfSeparation(familyTree, 'Dimitri', 'Fabio')\n expect(actual).toEqual(9)\n })\n\n xit('Complex graph, no shortcut, far removed nephew', () => {\n const familyTree = {\n Mina: ['Viktor', 'Wang'],\n Olga: ['Yuki'],\n Javier: ['Quynh', 'Ravi'],\n Tariq: ['Farah'],\n Viktor: ['Hana', 'Ian'],\n Diego: ['Qi'],\n Carlos: ['Fatima', 'Gustavo'],\n Hana: ['Umar'],\n Jing: ['Wyatt'],\n Sven: ['Fabio'],\n Zane: ['Mateo'],\n Isla: ['Pedro'],\n Quynh: ['Boris'],\n Kaito: ['Xia'],\n Liam: ['Tariq', 'Uma'],\n Priya: ['Cai'],\n Qi: ['Dimitri'],\n Wang: ['Jing'],\n Yuki: ['Leila'],\n Xia: ['Kim'],\n Pedro: ['Zane', 'Aditi'],\n Uma: ['Giorgio'],\n Giorgio: ['Tomoko'],\n Gustavo: ['Mina'],\n Sofia: ['Diego', 'Elif'],\n Leila: ['Yassin'],\n Umar: ['Helena'],\n Aiko: ['Bao', 'Carlos'],\n Fatima: ['Khadija', 'Liam'],\n Oscar: ['Bianca'],\n Wyatt: ['Jun'],\n Ian: ['Vera'],\n Mateo: ['Zara'],\n Noah: ['Xiomara'],\n Celine: ['Priya'],\n Xiomara: ['Kaito'],\n Bao: ['Dalia', 'Elias'],\n Elif: ['Rami'],\n Farah: ['Sven'],\n Aditi: ['Nia'],\n Vera: ['Igor'],\n Boris: ['Oscar'],\n Khadija: ['Sofia'],\n Zara: ['Mohammed'],\n Dalia: ['Hassan', 'Isla'],\n Ravi: ['Celine'],\n Yassin: ['Lucia'],\n Elias: ['Javier'],\n Nia: ['Antonio'],\n Rami: ['Ewa'],\n Hassan: ['Noah', 'Olga'],\n Tomoko: ['Gabriela'],\n }\n const actual = degreesOfSeparation(familyTree, 'Lucia', 'Jun')\n expect(actual).toEqual(14)\n })\n\n xit('Complex graph, some shortcuts, cross-down and cross-up, cousins several times removed', () => {\n const familyTree = {\n Mina: ['Viktor', 'Wang'],\n Olga: ['Yuki'],\n Javier: ['Quynh', 'Ravi'],\n Tariq: ['Farah'],\n Viktor: ['Hana', 'Ian'],\n Diego: ['Qi'],\n Carlos: ['Fatima', 'Gustavo'],\n Hana: ['Umar'],\n Jing: ['Wyatt'],\n Sven: ['Fabio'],\n Zane: ['Mateo'],\n Isla: ['Pedro'],\n Quynh: ['Boris'],\n Kaito: ['Xia'],\n Liam: ['Tariq', 'Uma'],\n Priya: ['Cai'],\n Qi: ['Dimitri'],\n Wang: ['Jing'],\n Yuki: ['Leila'],\n Xia: ['Kim'],\n Pedro: ['Zane', 'Aditi'],\n Uma: ['Giorgio'],\n Giorgio: ['Tomoko'],\n Gustavo: ['Mina'],\n Sofia: ['Diego', 'Elif'],\n Leila: ['Yassin'],\n Umar: ['Helena'],\n Aiko: ['Bao', 'Carlos'],\n Fatima: ['Khadija', 'Liam'],\n Oscar: ['Bianca'],\n Wyatt: ['Jun'],\n Ian: ['Vera'],\n Mateo: ['Zara'],\n Noah: ['Xiomara'],\n Celine: ['Priya'],\n Xiomara: ['Kaito'],\n Bao: ['Dalia'],\n Elif: ['Rami'],\n Farah: ['Sven'],\n Aditi: ['Nia'],\n Vera: ['Igor'],\n Boris: ['Oscar'],\n Khadija: ['Sofia'],\n Zara: ['Mohammed'],\n Dalia: ['Hassan', 'Isla'],\n Ravi: ['Celine'],\n Yassin: ['Lucia'],\n Nia: ['Antonio'],\n Rami: ['Ewa'],\n Hassan: ['Noah', 'Olga'],\n Tomoko: ['Gabriela'],\n }\n const actual = degreesOfSeparation(familyTree, 'Wyatt', 'Xia')\n expect(actual).toEqual(12)\n })\n})\n" }, { "path": "exercises/practice/relative-distance/relative-distance.ts", "content": "export function degreesOfSeparation(\n familyTree: unknown,\n personA: unknown,\n personB: unknown\n): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/relative-distance/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/relative-distance/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/resistor-color/.docs/instructions.md", "content": "# Instructions\n\nIf you want to build something using a Raspberry Pi, you'll probably use _resistors_.\nFor this exercise, you need to know two things about them:\n\n- Each resistor has a resistance value.\n- Resistors are small - so small in fact that if you printed the resistance value on them, it would be hard to read.\n\nTo get around this problem, manufacturers print color-coded bands onto the resistors to denote their resistance values.\nEach band has a position and a numeric value.\n\nThe first 2 bands of a resistor have a simple encoding scheme: each color maps to a single number.\n\nIn this exercise you are going to create a helpful program so that you don't have to remember the values of the bands.\n\nThese colors are encoded as follows:\n\n- black: 0\n- brown: 1\n- red: 2\n- orange: 3\n- yellow: 4\n- green: 5\n- blue: 6\n- violet: 7\n- grey: 8\n- white: 9\n\nThe goal of this exercise is to create a way:\n\n- to look up the numerical value associated with a particular color band\n- to list the different band colors\n\nMnemonics map the colors to the numbers, that, when stored as an array, happen to map to their index in the array:\nBetter Be Right Or Your Great Big Values Go Wrong.\n\nMore information on the color encoding of resistors can be found in the [Electronic color code Wikipedia article][e-color-code].\n\n[e-color-code]: https://en.wikipedia.org/wiki/Electronic_color_code\n" }, { "path": "exercises/practice/resistor-color/.meta/config.json", "content": "{\n \"authors\": [\n \"Roshanjossey\"\n ],\n \"contributors\": [\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"resistor-color.ts\"\n ],\n \"test\": [\n \"resistor-color.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Convert a resistor band's color to its numeric representation.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Maud de Vries, Erik Schierboom\",\n \"source_url\": \"https://github.com/exercism/problem-specifications/issues/1458\"\n}\n" }, { "path": "exercises/practice/resistor-color/.meta/proof.ci.ts", "content": "export const COLORS = [\n 'black',\n 'brown',\n 'red',\n 'orange',\n 'yellow',\n 'green',\n 'blue',\n 'violet',\n 'grey',\n 'white',\n]\n\nexport const colorCode = (color: string): number => COLORS.indexOf(color)\n" }, { "path": "exercises/practice/resistor-color/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[49eb31c5-10a8-4180-9f7f-fea632ab87ef]\ndescription = \"Color codes -> Black\"\n\n[0a4df94b-92da-4579-a907-65040ce0b3fc]\ndescription = \"Color codes -> White\"\n\n[5f81608d-f36f-4190-8084-f45116b6f380]\ndescription = \"Color codes -> Orange\"\n\n[581d68fa-f968-4be2-9f9d-880f2fb73cf7]\ndescription = \"Colors\"\n" }, { "path": "exercises/practice/resistor-color/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/resistor-color/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/resistor-color/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/resistor-color/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/resistor-color/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/resistor-color/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/resistor-color/package.json", "content": "{\n \"name\": \"@exercism/typescript-resistor-color\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/resistor-color/resistor-color.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { colorCode, COLORS } from './resistor-color.ts'\n\ndescribe('color code', () => {\n it('Black', () => {\n expect(colorCode('black')).toEqual(0)\n })\n\n xit('White', () => {\n expect(colorCode('white')).toEqual(9)\n })\n\n xit('Orange', () => {\n expect(colorCode('orange')).toEqual(3)\n })\n})\n\nxdescribe('Colors', () => {\n xit('returns all colors', () => {\n expect(COLORS).toEqual([\n 'black',\n 'brown',\n 'red',\n 'orange',\n 'yellow',\n 'green',\n 'blue',\n 'violet',\n 'grey',\n 'white',\n ])\n })\n})\n" }, { "path": "exercises/practice/resistor-color/resistor-color.ts", "content": "export const colorCode = () => {\n throw new Error('Remove this line and implement the function')\n}\n\nexport const COLORS = undefined\n" }, { "path": "exercises/practice/resistor-color/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/resistor-color/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/resistor-color-duo/.docs/instructions.md", "content": "# Instructions\n\nIf you want to build something using a Raspberry Pi, you'll probably use _resistors_.\nFor this exercise, you need to know two things about them:\n\n- Each resistor has a resistance value.\n- Resistors are small - so small in fact that if you printed the resistance value on them, it would be hard to read.\n\nTo get around this problem, manufacturers print color-coded bands onto the resistors to denote their resistance values.\nEach band has a position and a numeric value.\n\nThe first 2 bands of a resistor have a simple encoding scheme: each color maps to a single number.\nFor example, if they printed a brown band (value 1) followed by a green band (value 5), it would translate to the number 15.\n\nIn this exercise you are going to create a helpful program so that you don't have to remember the values of the bands.\nThe program will take color names as input and output a two digit number, even if the input is more than two colors!\n\nThe band colors are encoded as follows:\n\n- black: 0\n- brown: 1\n- red: 2\n- orange: 3\n- yellow: 4\n- green: 5\n- blue: 6\n- violet: 7\n- grey: 8\n- white: 9\n\nFrom the example above:\nbrown-green should return 15, and\nbrown-green-violet should return 15 too, ignoring the third color.\n" }, { "path": "exercises/practice/resistor-color-duo/.meta/config.json", "content": "{\n \"authors\": [\n \"msomji\"\n ],\n \"contributors\": [\n \"EduardoBautista\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"resistor-color-duo.ts\"\n ],\n \"test\": [\n \"resistor-color-duo.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Convert color codes, as used on resistors, to a numeric value.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Maud de Vries, Erik Schierboom\",\n \"source_url\": \"https://github.com/exercism/problem-specifications/issues/1464\"\n}\n" }, { "path": "exercises/practice/resistor-color-duo/.meta/proof.ci.ts", "content": "// resistor-color solution START\nconst COLORS = [\n 'black',\n 'brown',\n 'red',\n 'orange',\n 'yellow',\n 'green',\n 'blue',\n 'violet',\n 'grey',\n 'white',\n]\n\nconst colorCode = (color: string): number => COLORS.indexOf(color)\n// resistor-color solution END\n\nexport const decodedValue = ([tens, ones]: string[]): number =>\n colorCode(tens) * 10 + colorCode(ones)\n" }, { "path": "exercises/practice/resistor-color-duo/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[ce11995a-5b93-4950-a5e9-93423693b2fc]\ndescription = \"Brown and black\"\n\n[7bf82f7a-af23-48ba-a97d-38d59406a920]\ndescription = \"Blue and grey\"\n\n[f1886361-fdfd-4693-acf8-46726fe24e0c]\ndescription = \"Yellow and violet\"\n\n[b7a6cbd2-ae3c-470a-93eb-56670b305640]\ndescription = \"White and red\"\n\n[77a8293d-2a83-4016-b1af-991acc12b9fe]\ndescription = \"Orange and orange\"\n\n[0c4fb44f-db7c-4d03-afa8-054350f156a8]\ndescription = \"Ignore additional colors\"\n\n[4a8ceec5-0ab4-4904-88a4-daf953a5e818]\ndescription = \"Black and brown, one-digit\"\n" }, { "path": "exercises/practice/resistor-color-duo/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/resistor-color-duo/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/resistor-color-duo/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/resistor-color-duo/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/resistor-color-duo/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/resistor-color-duo/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/resistor-color-duo/package.json", "content": "{\n \"name\": \"@exercism/typescript-resistor-color-duo\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/resistor-color-duo/resistor-color-duo.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { decodedValue } from './resistor-color-duo.ts'\n\ndescribe('Resistor Colors', () => {\n it('Brown and black', () => {\n expect(decodedValue(['brown', 'black'])).toEqual(10)\n })\n\n xit('Blue and grey', () => {\n expect(decodedValue(['blue', 'grey'])).toEqual(68)\n })\n\n xit('White and red', () => {\n expect(decodedValue(['white', 'red'])).toEqual(92)\n })\n\n xit('Yellow and violet', () => {\n expect(decodedValue(['yellow', 'violet'])).toEqual(47)\n })\n\n xit('Orange and orange', () => {\n expect(decodedValue(['orange', 'orange'])).toEqual(33)\n })\n\n xit('Ignore additional colors', () => {\n expect(decodedValue(['green', 'brown', 'orange'])).toEqual(51)\n })\n\n xit('Black and brown, one-digit', () => {\n expect(decodedValue(['black', 'brown'])).toEqual(1)\n })\n})\n" }, { "path": "exercises/practice/resistor-color-duo/resistor-color-duo.ts", "content": "export function decodedValue() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/resistor-color-duo/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/resistor-color-duo/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/resistor-color-trio/.docs/instructions.md", "content": "# Instructions\n\nIf you want to build something using a Raspberry Pi, you'll probably use _resistors_.\nFor this exercise, you need to know only three things about them:\n\n- Each resistor has a resistance value.\n- Resistors are small - so small in fact that if you printed the resistance value on them, it would be hard to read.\n To get around this problem, manufacturers print color-coded bands onto the resistors to denote their resistance values.\n- Each band acts as a digit of a number.\n For example, if they printed a brown band (value 1) followed by a green band (value 5), it would translate to the number 15.\n In this exercise, you are going to create a helpful program so that you don't have to remember the values of the bands.\n The program will take 3 colors as input, and outputs the correct value, in ohms.\n The color bands are encoded as follows:\n\n- black: 0\n- brown: 1\n- red: 2\n- orange: 3\n- yellow: 4\n- green: 5\n- blue: 6\n- violet: 7\n- grey: 8\n- white: 9\n\nIn Resistor Color Duo you decoded the first two colors.\nFor instance: orange-orange got the main value `33`.\nThe third color stands for how many zeros need to be added to the main value.\nThe main value plus the zeros gives us a value in ohms.\nFor the exercise it doesn't matter what ohms really are.\nFor example:\n\n- orange-orange-black would be 33 and no zeros, which becomes 33 ohms.\n- orange-orange-red would be 33 and 2 zeros, which becomes 3300 ohms.\n- orange-orange-orange would be 33 and 3 zeros, which becomes 33000 ohms.\n\n(If Math is your thing, you may want to think of the zeros as exponents of 10.\nIf Math is not your thing, go with the zeros.\nIt really is the same thing, just in plain English instead of Math lingo.)\n\nThis exercise is about translating the colors into a label:\n\n> \"... ohms\"\n\nSo an input of `\"orange\", \"orange\", \"black\"` should return:\n\n> \"33 ohms\"\n\nWhen we get to larger resistors, a [metric prefix][metric-prefix] is used to indicate a larger magnitude of ohms, such as \"kiloohms\".\nThat is similar to saying \"2 kilometers\" instead of \"2000 meters\", or \"2 kilograms\" for \"2000 grams\".\n\nFor example, an input of `\"orange\", \"orange\", \"orange\"` should return:\n\n> \"33 kiloohms\"\n\n[metric-prefix]: https://en.wikipedia.org/wiki/Metric_prefix\n" }, { "path": "exercises/practice/resistor-color-trio/.meta/config.json", "content": "{\n \"authors\": [\n \"rodmagaldi\"\n ],\n \"contributors\": [\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"resistor-color-trio.ts\"\n ],\n \"test\": [\n \"resistor-color-trio.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Convert color codes, as used on resistors, to a human-readable label.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Maud de Vries, Erik Schierboom\",\n \"source_url\": \"https://github.com/exercism/problem-specifications/issues/1549\"\n}\n" }, { "path": "exercises/practice/resistor-color-trio/.meta/proof.ci.ts", "content": "// resistor-color solution START\nconst COLORS = [\n 'black',\n 'brown',\n 'red',\n 'orange',\n 'yellow',\n 'green',\n 'blue',\n 'violet',\n 'grey',\n 'white',\n]\n\nconst colorCode = (color: string): number => COLORS.indexOf(color)\n// resistor-color solution END\n\ninterface IUnits {\n name: string\n numberOfZeros: number\n representation: string\n}\n\nconst UNITS: IUnits[] = [\n {\n name: 'giga',\n numberOfZeros: 9,\n representation: '000000000',\n },\n {\n name: 'mega',\n numberOfZeros: 6,\n representation: '000000',\n },\n {\n name: 'kilo',\n numberOfZeros: 3,\n representation: '000',\n },\n]\n\nexport const decodedResistorValue = ([\n tens,\n ones,\n exponent,\n]: string[]): string => {\n const numericValue =\n (colorCode(tens) * 10 + colorCode(ones)) * 10 ** colorCode(exponent)\n const stringifiedValue = numericValue.toString()\n\n let readableUnit = ''\n let readableValue: string = stringifiedValue\n\n for (const unit of UNITS) {\n if (stringifiedValue.endsWith(unit.representation)) {\n readableUnit = unit.name\n readableValue = readableValue.slice(0, -unit.numberOfZeros)\n break\n }\n }\n\n return `${readableValue} ${readableUnit}ohms`\n}\n" }, { "path": "exercises/practice/resistor-color-trio/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[d6863355-15b7-40bb-abe0-bfb1a25512ed]\ndescription = \"Orange and orange and black\"\n\n[1224a3a9-8c8e-4032-843a-5224e04647d6]\ndescription = \"Blue and grey and brown\"\n\n[b8bda7dc-6b95-4539-abb2-2ad51d66a207]\ndescription = \"Red and black and red\"\n\n[5b1e74bc-d838-4eda-bbb3-eaba988e733b]\ndescription = \"Green and brown and orange\"\n\n[f5d37ef9-1919-4719-a90d-a33c5a6934c9]\ndescription = \"Yellow and violet and yellow\"\n\n[5f6404a7-5bb3-4283-877d-3d39bcc33854]\ndescription = \"Blue and violet and blue\"\n\n[7d3a6ab8-e40e-46c3-98b1-91639fff2344]\ndescription = \"Minimum possible value\"\n\n[ca0aa0ac-3825-42de-9f07-dac68cc580fd]\ndescription = \"Maximum possible value\"\n\n[0061a76c-903a-4714-8ce2-f26ce23b0e09]\ndescription = \"First two colors make an invalid octal number\"\n\n[30872c92-f567-4b69-a105-8455611c10c4]\ndescription = \"Ignore extra colors\"\n" }, { "path": "exercises/practice/resistor-color-trio/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/resistor-color-trio/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/resistor-color-trio/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/resistor-color-trio/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/resistor-color-trio/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/resistor-color-trio/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/resistor-color-trio/package.json", "content": "{\n \"name\": \"@exercism/typescript-resistor-color-trio\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism practice exercise on resistor-color-trio\",\n \"author\": \"Katrina Owen\",\n \"contributors\": [\n \"Derk-Jan Karrenbeld (https://derk-jan.com)\"\n ],\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/resistor-color-trio/resistor-color-trio.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { decodedResistorValue } from './resistor-color-trio.ts'\n\ndescribe('Resistor Colors', () => {\n it('Orange and orange and black', () => {\n expect(decodedResistorValue(['orange', 'orange', 'black'])).toEqual(\n '33 ohms'\n )\n })\n\n xit('Blue and grey and brown', () => {\n expect(decodedResistorValue(['blue', 'grey', 'brown'])).toEqual('680 ohms')\n })\n\n xit('Red and black and red', () => {\n expect(decodedResistorValue(['red', 'black', 'red'])).toEqual('2 kiloohms')\n })\n\n xit('Green and brown and orange', () => {\n expect(decodedResistorValue(['green', 'brown', 'orange'])).toEqual(\n '51 kiloohms'\n )\n })\n\n xit('Yellow and violet and yellow', () => {\n expect(decodedResistorValue(['yellow', 'violet', 'yellow'])).toEqual(\n '470 kiloohms'\n )\n })\n\n xit('Blue and violet and blue', () => {\n expect(decodedResistorValue(['blue', 'violet', 'blue'])).toEqual(\n '67 megaohms'\n )\n })\n\n xit('Minimum possible value', () => {\n expect(decodedResistorValue(['black', 'black', 'black'])).toEqual('0 ohms')\n })\n\n xit('Maximum possible value', () => {\n expect(decodedResistorValue(['white', 'white', 'white'])).toEqual(\n '99 gigaohms'\n )\n })\n\n xit('First two colors make an invalid octal number', () => {\n expect(decodedResistorValue(['black', 'grey', 'black'])).toEqual('8 ohms')\n })\n\n xit('Ignore extra colors', () => {\n expect(decodedResistorValue(['blue', 'green', 'yellow', 'orange'])).toEqual(\n '650 kiloohms'\n )\n })\n})\n" }, { "path": "exercises/practice/resistor-color-trio/resistor-color-trio.ts", "content": "export function decodedResistorValue() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/resistor-color-trio/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/resistor-color-trio/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/reverse-string/.docs/instructions.md", "content": "# Instructions\n\nYour task is to reverse a given string.\n\nSome examples:\n\n- Turn `\"stressed\"` into `\"desserts\"`.\n- Turn `\"strops\"` into `\"sports\"`.\n- Turn `\"racecar\"` into `\"racecar\"`.\n" }, { "path": "exercises/practice/reverse-string/.docs/introduction.md", "content": "# Introduction\n\nReversing strings (reading them from right to left, rather than from left to right) is a surprisingly common task in programming.\n\nFor example, in bioinformatics, reversing the sequence of DNA or RNA strings is often important for various analyses, such as finding complementary strands or identifying palindromic sequences that have biological significance.\n" }, { "path": "exercises/practice/reverse-string/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"reverse-string.ts\"\n ],\n \"test\": [\n \"reverse-string.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Reverse a given string.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Introductory challenge to reverse an input string\",\n \"source_url\": \"https://www.freecodecamp.org/news/how-to-reverse-a-string-in-javascript-in-3-different-ways-75e4763c68cb\"\n}\n" }, { "path": "exercises/practice/reverse-string/.meta/proof.ci.ts", "content": "export function reverse(value: string): string {\n return value.split('').reverse().join('')\n}\n" }, { "path": "exercises/practice/reverse-string/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[c3b7d806-dced-49ee-8543-933fd1719b1c]\ndescription = \"an empty string\"\n\n[01ebf55b-bebb-414e-9dec-06f7bb0bee3c]\ndescription = \"a word\"\n\n[0f7c07e4-efd1-4aaa-a07a-90b49ce0b746]\ndescription = \"a capitalized word\"\n\n[71854b9c-f200-4469-9f5c-1e8e5eff5614]\ndescription = \"a sentence with punctuation\"\n\n[1f8ed2f3-56f3-459b-8f3e-6d8d654a1f6c]\ndescription = \"a palindrome\"\n\n[b9e7dec1-c6df-40bd-9fa3-cd7ded010c4c]\ndescription = \"an even-sized word\"\n\n[1bed0f8a-13b0-4bd3-9d59-3d0593326fa2]\ndescription = \"wide characters\"\n\n[93d7e1b8-f60f-4f3c-9559-4056e10d2ead]\ndescription = \"grapheme cluster with pre-combined form\"\ninclude = false\ncomment = \"revisit once after upgrade to es2022 or higher\"\n\n[1028b2c1-6763-4459-8540-2da47ca512d9]\ndescription = \"grapheme clusters\"\ninclude = false\ncomment = \"revisit once after upgrade to es2022 or higher\"\n" }, { "path": "exercises/practice/reverse-string/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/reverse-string/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/reverse-string/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/reverse-string/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/reverse-string/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/reverse-string/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/reverse-string/package.json", "content": "{\n \"name\": \"@exercism/typescript-reverse-string\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/reverse-string/reverse-string.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { reverse } from './reverse-string.ts'\n\ndescribe('Reverse String', () => {\n it('an empty string', () => {\n const expected = ''\n expect(reverse('')).toEqual(expected)\n })\n\n xit('a word', () => {\n const expected = 'tobor'\n expect(reverse('robot')).toEqual(expected)\n })\n\n xit('a capitalized word', () => {\n const expected = 'nemaR'\n expect(reverse('Ramen')).toEqual(expected)\n })\n\n xit('a sentence with punctuation', () => {\n const expected = `!yrgnuh m'I`\n expect(reverse(`I'm hungry!`)).toEqual(expected)\n })\n\n xit('a palindrome', () => {\n const expected = 'racecar'\n expect(reverse('racecar')).toEqual(expected)\n })\n\n xit('an even-sized word', () => {\n const expected = 'reward'\n expect(reverse('drawer')).toEqual(expected)\n })\n\n xit('wide characters', () => {\n const expected = 'ēŒ«å­'\n expect(reverse('子ēŒ«')).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/reverse-string/reverse-string.ts", "content": "export function reverse(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/reverse-string/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/reverse-string/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/rna-transcription/.docs/instructions.md", "content": "# Instructions\n\nYour task is to determine the RNA complement of a given DNA sequence.\n\nBoth DNA and RNA strands are a sequence of nucleotides.\n\nThe four nucleotides found in DNA are adenine (**A**), cytosine (**C**), guanine (**G**), and thymine (**T**).\n\nThe four nucleotides found in RNA are adenine (**A**), cytosine (**C**), guanine (**G**), and uracil (**U**).\n\nGiven a DNA strand, its transcribed RNA strand is formed by replacing each nucleotide with its complement:\n\n- `G` -> `C`\n- `C` -> `G`\n- `T` -> `A`\n- `A` -> `U`\n\n~~~~exercism/note\nIf you want to look at how the inputs and outputs are structured, take a look at the examples in the test suite.\n~~~~\n" }, { "path": "exercises/practice/rna-transcription/.docs/introduction.md", "content": "# Introduction\n\nYou work for a bioengineering company that specializes in developing therapeutic solutions.\n\nYour team has just been given a new project to develop a targeted therapy for a rare type of cancer.\n\n~~~~exercism/note\nIt's all very complicated, but the basic idea is that sometimes people's bodies produce too much of a given protein.\nThat can cause all sorts of havoc.\n\nBut if you can create a very specific molecule (called a micro-RNA), it can prevent the protein from being produced.\n\nThis technique is called [RNA Interference][rnai].\n\n[rnai]: https://admin.acceleratingscience.com/ask-a-scientist/what-is-rnai/\n~~~~\n" }, { "path": "exercises/practice/rna-transcription/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"DFXLuna\",\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"rna-transcription.ts\"\n ],\n \"test\": [\n \"rna-transcription.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a DNA strand, return its RNA complement.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Hyperphysics\",\n \"source_url\": \"https://web.archive.org/web/20220408112140/http://hyperphysics.phy-astr.gsu.edu/hbase/Organic/transcription.html\"\n}\n" }, { "path": "exercises/practice/rna-transcription/.meta/proof.ci.ts", "content": "export function toRna(input: string): string {\n const dictionary: { [key: string]: string } = {\n G: 'C',\n C: 'G',\n T: 'A',\n A: 'U',\n }\n let temp = ''\n input.split('').forEach((element) => {\n const current = dictionary[element]\n if (current === undefined) {\n throw new Error('Invalid input DNA.')\n }\n temp += current\n })\n return temp\n}\n" }, { "path": "exercises/practice/rna-transcription/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[b4631f82-c98c-4a2f-90b3-c5c2b6c6f661]\ndescription = \"Empty RNA sequence\"\n\n[a9558a3c-318c-4240-9256-5d5ed47005a6]\ndescription = \"RNA complement of cytosine is guanine\"\n\n[6eedbb5c-12cb-4c8b-9f51-f8320b4dc2e7]\ndescription = \"RNA complement of guanine is cytosine\"\n\n[870bd3ec-8487-471d-8d9a-a25046488d3e]\ndescription = \"RNA complement of thymine is adenine\"\n\n[aade8964-02e1-4073-872f-42d3ffd74c5f]\ndescription = \"RNA complement of adenine is uracil\"\n\n[79ed2757-f018-4f47-a1d7-34a559392dbf]\ndescription = \"RNA complement\"\n" }, { "path": "exercises/practice/rna-transcription/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/rna-transcription/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/rna-transcription/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/rna-transcription/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/rna-transcription/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/rna-transcription/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/rna-transcription/package.json", "content": "{\n \"name\": \"@exercism/typescript-rna-transcription\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/rna-transcription/rna-transcription.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { toRna } from './rna-transcription.ts'\n\ndescribe('Transcriptor', () => {\n it('transcribes cytosine to guanine', () => {\n expect(toRna('C')).toEqual('G')\n })\n\n xit('transcribes guanine to cytosine', () => {\n expect(toRna('G')).toEqual('C')\n })\n\n xit('transcribes adenine to uracil', () => {\n expect(toRna('A')).toEqual('U')\n })\n\n xit('transcribes thymine to adenine', () => {\n expect(toRna('T')).toEqual('A')\n })\n\n xit('transcribes all dna nucleotides to their rna complements', () => {\n expect(toRna('ACGTGGTCTTAA')).toEqual('UGCACCAGAAUU')\n })\n\n xit('correctly handles invalid input', () => {\n expect(() => toRna('U')).toThrow('Invalid input DNA.')\n })\n\n xit('correctly handles completely invalid input', () => {\n expect(() => toRna('XXX')).toThrow('Invalid input DNA.')\n })\n\n xit('correctly handles partially invalid input', () => {\n expect(() => toRna('ACGTXXXCTTAA')).toThrow('Invalid input DNA.')\n })\n})\n" }, { "path": "exercises/practice/rna-transcription/rna-transcription.ts", "content": "export function toRna() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/rna-transcription/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/rna-transcription/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/robot-name/.docs/instructions.md", "content": "# Instructions\n\nManage robot factory settings.\n\nWhen a robot comes off the factory floor, it has no name.\n\nThe first time you turn on a robot, a random name is generated in the format of two uppercase letters followed by three digits, such as RX837 or BC811.\n\nEvery once in a while we need to reset a robot to its factory settings, which means that its name gets wiped.\nThe next time you ask, that robot will respond with a new random name.\n\nThe names must be random: they should not follow a predictable sequence.\nUsing random names means a risk of collisions.\nYour solution must ensure that every existing robot has a unique name.\n" }, { "path": "exercises/practice/robot-name/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"joshgoebel\",\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"robot-name.ts\"\n ],\n \"test\": [\n \"robot-name.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Manage robot factory settings.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": true,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A debugging session with Paul Blackwell at gSchool.\"\n}\n" }, { "path": "exercises/practice/robot-name/.meta/proof.ci.ts", "content": "/**\n * generates a random number from 0 to maximum-1\n *\n * random(5) => generates an integer 0 - 4\n *\n * @param maximum - max limit of generated number\n */\nconst rand = (maximum: number): number => Math.floor(Math.random() * maximum)\n\nclass NameDatabase {\n private static ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'\n private availableNames!: string[]\n\n constructor() {\n this.releaseNames()\n }\n\n public releaseNames(): void {\n this.availableNames = this.allPossibleNames()\n }\n\n public allPossibleNames(): string[] {\n const names = []\n for (const a of NameDatabase.ALPHABET) {\n for (const b of NameDatabase.ALPHABET) {\n for (let i = 0; i < 1000; i++) {\n names.push(`${a}${b}${i.toString().padStart(3, '0')}`)\n }\n }\n }\n return names\n }\n\n public fetchNewName(): string {\n if (this.availableNames.length === 0) {\n throw new Error('no more names')\n }\n\n const randomPosition = rand(this.availableNames.length)\n const name = this.availableNames[randomPosition]\n const lastName = this.availableNames.pop()!\n // swap the last name into the position of the name\n // we just removed (unless we happened to randomly\n // pick the very last name already)\n if (name !== lastName) this.availableNames[randomPosition] = lastName\n\n return name\n }\n}\n\nconst RobotsDB = new NameDatabase()\n\nexport class Robot {\n private _name!: string\n\n public get name(): string {\n return this._name\n }\n\n constructor() {\n this.resetName()\n }\n\n public resetName(): void {\n this._name = RobotsDB.fetchNewName()\n }\n\n public static releaseNames(): void {\n RobotsDB.releaseNames()\n }\n}\n" }, { "path": "exercises/practice/robot-name/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/robot-name/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/robot-name/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/robot-name/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/robot-name/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/robot-name/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/robot-name/package.json", "content": "{\n \"name\": \"@exercism/typescript-robot-name\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/robot-name/robot-name.test.ts", "content": "import { beforeEach, afterEach, describe, it, expect, xit } from '@jest/globals'\nimport { Robot } from './robot-name.ts'\n\nconst areSequential = (name1: string, name2: string): boolean => {\n const alpha1 = name1.substring(0, 2)\n const alpha2 = name2.substring(0, 2)\n const num1 = Number(name1.substring(2, 5))\n const num2 = Number(name2.substring(2, 5))\n\n const numDiff = num2 - num1\n const alphaDiff =\n (alpha2.charCodeAt(0) - alpha1.charCodeAt(0)) * 26 +\n (alpha2.charCodeAt(1) - alpha1.charCodeAt(1))\n\n const totalDiff = alphaDiff * 1000 + numDiff\n\n return Math.abs(totalDiff) <= 1\n}\n\nconst NAME_RE = /^[A-Z]{2}\\d{3}$/\nconst TOTAL_NUMBER_OF_NAMES =\n 26 * // A-Z\n 26 * // A-Z\n 10 * // 0-9\n 10 * // 0-9\n 10 // 0-9\n\ndescribe('Robot', () => {\n let robot: Robot\n\n beforeEach(() => {\n robot = new Robot()\n })\n\n afterEach(() => {\n Robot.releaseNames()\n })\n\n it('has a name', () => {\n expect(robot.name).toMatch(NAME_RE)\n })\n\n xit('name is the same each time', () => {\n expect(robot.name).toEqual(robot.name)\n })\n\n xit('different robots have different names', () => {\n const differentRobot = new Robot()\n expect(differentRobot.name).not.toEqual(robot.name)\n })\n\n xit('is able to reset the name', () => {\n const originalName = robot.name\n\n robot.resetName()\n const newName = robot.name\n\n expect(newName).toMatch(NAME_RE)\n expect(originalName).not.toEqual(newName)\n })\n\n xit('should set a unique name after reset', () => {\n const NUMBER_OF_ROBOTS = 10000\n const usedNames = new Set()\n\n usedNames.add(robot.name)\n for (let i = 0; i < NUMBER_OF_ROBOTS; i++) {\n robot.resetName()\n usedNames.add(robot.name)\n }\n\n expect(usedNames.size).toEqual(NUMBER_OF_ROBOTS + 1)\n })\n\n xit('new names should not be sequential', () => {\n const name1 = robot.name\n const name2 = new Robot().name\n const name3 = new Robot().name\n expect(areSequential(name1, name1)).toBe(true)\n expect(areSequential(name1, name2)).toBe(false)\n expect(areSequential(name2, name3)).toBe(false)\n })\n\n xit('names from reset should not be sequential', () => {\n const name1 = robot.name\n robot.resetName()\n const name2 = robot.name\n robot.resetName()\n const name3 = robot.name\n expect(areSequential(name1, name2)).toBe(false)\n expect(areSequential(name2, name3)).toBe(false)\n expect(areSequential(name3, name3)).toBe(true)\n })\n\n xit('uses all letters', () => {\n let letters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'\n\n for (let i = 0; i < 1000 - 1; i += 1) {\n const newRobot = new Robot()\n const lettersInName = newRobot.name.slice(0, 2)\n letters = letters.replace(lettersInName[0], '')\n letters = letters.replace(lettersInName[1], '')\n\n if (letters.length === 0) {\n break\n }\n }\n expect(letters).toEqual('')\n })\n\n xit('uses all numbers', () => {\n let numbers = '0123456789'\n\n for (let i = 0; i < 1000 - 1; i += 1) {\n const newRobot = new Robot()\n const digitsInName = newRobot.name.slice(2, 5)\n numbers = numbers.replace(digitsInName[0], '')\n numbers = numbers.replace(digitsInName[1], '')\n numbers = numbers.replace(digitsInName[2], '')\n\n if (numbers.length === 0) {\n break\n }\n }\n expect(numbers).toEqual('')\n })\n\n // This test is optional.\n //\n // This test doesn't run on our online test runner because it will time-out\n // with most implementations. It's up to you to test your solution locally.\n it.skip('all the names can be generated', () => {\n const usedNames = new Set()\n usedNames.add(robot.name)\n\n for (let i = 0; i < TOTAL_NUMBER_OF_NAMES - 1; i += 1) {\n const newRobot = new Robot()\n usedNames.add(newRobot.name)\n }\n\n expect(usedNames.size).toEqual(TOTAL_NUMBER_OF_NAMES)\n })\n})\n" }, { "path": "exercises/practice/robot-name/robot-name.ts", "content": "export class Robot {\n constructor() {}\n\n public get name(): string {\n throw new Error('Remove this line and implement the function')\n }\n\n public resetName(): void {\n throw new Error('Remove this line and implement the function')\n }\n\n public static releaseNames(): void {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/robot-name/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/robot-name/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/robot-simulator/.docs/instructions.md", "content": "# Instructions\n\nWrite a robot simulator.\n\nA robot factory's test facility needs a program to verify robot movements.\n\nThe robots have three possible movements:\n\n- turn right\n- turn left\n- advance\n\nRobots are placed on a hypothetical infinite grid, facing a particular direction (north, east, south, or west) at a set of {x,y} coordinates,\ne.g., {3,8}, with coordinates increasing to the north and east.\n\nThe robot then receives a number of instructions, at which point the testing facility verifies the robot's new position, and in which direction it is pointing.\n\n- The letter-string \"RAALAL\" means:\n - Turn right\n - Advance twice\n - Turn left\n - Advance once\n - Turn left yet again\n- Say a robot starts at {7, 3} facing north.\n Then running this stream of instructions should leave it at {9, 4} facing west.\n" }, { "path": "exercises/practice/robot-simulator/.meta/config.json", "content": "{\n \"authors\": [\n \"deyshin\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"robot-simulator.ts\"\n ],\n \"test\": [\n \"robot-simulator.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Write a robot simulator.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Inspired by an interview question at a famous company.\"\n}\n" }, { "path": "exercises/practice/robot-simulator/.meta/proof.ci.ts", "content": "export class InvalidInputError extends Error {\n constructor(message: string) {\n super()\n this.message = message || 'Invalid Input'\n }\n}\n\ntype Bearing = 'north' | 'south' | 'east' | 'west'\ntype Instruction = 'turnLeft' | 'turnRight' | 'advance'\n\nconst validDirections: Bearing[] = ['north', 'south', 'east', 'west']\n\nfunction isValidBearing(next: string): next is Bearing {\n return validDirections.includes(next as Bearing)\n}\nexport class Robot {\n public coordinates: [number, number]\n public bearing: Bearing\n\n private static instructions(s: string): Instruction[] {\n return [...s].map((character) => {\n switch (character) {\n case 'L':\n return 'turnLeft'\n case 'R':\n return 'turnRight'\n case 'A':\n return 'advance'\n default:\n throw new InvalidInputError(\n `${character} is not a valid instruction character.`\n )\n }\n })\n }\n\n constructor() {\n this.coordinates = [0, 0]\n this.bearing = 'north'\n }\n\n private set direction(next: string) {\n if (!isValidBearing(next)) {\n throw new InvalidInputError('Invalid Robot Bearing')\n }\n\n this.bearing = next\n }\n\n private advance(): void {\n if (this.bearing === 'north') {\n this.coordinates[1] += 1\n } else if (this.bearing === 'south') {\n this.coordinates[1] -= 1\n } else if (this.bearing === 'east') {\n this.coordinates[0] += 1\n } else if (this.bearing === 'west') {\n this.coordinates[0] -= 1\n }\n }\n\n private turnLeft(): void {\n if (this.bearing === 'north') {\n this.direction = 'west'\n } else if (this.bearing === 'south') {\n this.direction = 'east'\n } else if (this.bearing === 'east') {\n this.direction = 'north'\n } else if (this.bearing === 'west') {\n this.direction = 'south'\n }\n }\n\n private turnRight(): void {\n if (this.bearing === 'north') {\n this.direction = 'east'\n } else if (this.bearing === 'south') {\n this.direction = 'west'\n } else if (this.bearing === 'east') {\n this.direction = 'south'\n } else if (this.bearing === 'west') {\n this.direction = 'north'\n }\n }\n\n public place(args: { x: number; y: number; direction: string }): void {\n this.coordinates = [args.x, args.y]\n this.direction = args.direction\n }\n\n public evaluate(s: string): void {\n Robot.instructions(s).forEach((instruction) => {\n this[instruction]()\n })\n }\n}\n" }, { "path": "exercises/practice/robot-simulator/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[c557c16d-26c1-4e06-827c-f6602cd0785c]\ndescription = \"at origin facing north\"\n\n[bf0dffce-f11c-4cdb-8a5e-2c89d8a5a67d]\ndescription = \"at negative position facing south\"\n\n[8cbd0086-6392-4680-b9b9-73cf491e67e5]\ndescription = \"changes north to east\"\n\n[8abc87fc-eab2-4276-93b7-9c009e866ba1]\ndescription = \"changes east to south\"\n\n[3cfe1b85-bbf2-4bae-b54d-d73e7e93617a]\ndescription = \"changes south to west\"\n\n[5ea9fb99-3f2c-47bd-86f7-46b7d8c3c716]\ndescription = \"changes west to north\"\n\n[fa0c40f5-6ba3-443d-a4b3-58cbd6cb8d63]\ndescription = \"changes north to west\"\n\n[da33d734-831f-445c-9907-d66d7d2a92e2]\ndescription = \"changes west to south\"\n\n[bd1ca4b9-4548-45f4-b32e-900fc7c19389]\ndescription = \"changes south to east\"\n\n[2de27b67-a25c-4b59-9883-bc03b1b55bba]\ndescription = \"changes east to north\"\n\n[f0dc2388-cddc-4f83-9bed-bcf46b8fc7b8]\ndescription = \"facing north increments Y\"\n\n[2786cf80-5bbf-44b0-9503-a89a9c5789da]\ndescription = \"facing south decrements Y\"\n\n[84bf3c8c-241f-434d-883d-69817dbd6a48]\ndescription = \"facing east increments X\"\n\n[bb69c4a7-3bbf-4f64-b415-666fa72d7b04]\ndescription = \"facing west decrements X\"\n\n[e34ac672-4ed4-4be3-a0b8-d9af259cbaa1]\ndescription = \"moving east and north from README\"\n\n[f30e4955-4b47-4aa3-8b39-ae98cfbd515b]\ndescription = \"moving west and north\"\n\n[3e466bf6-20ab-4d79-8b51-264165182fca]\ndescription = \"moving west and south\"\n\n[41f0bb96-c617-4e6b-acff-a4b279d44514]\ndescription = \"moving east and north\"\n" }, { "path": "exercises/practice/robot-simulator/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/robot-simulator/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/robot-simulator/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/robot-simulator/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/robot-simulator/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/robot-simulator/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/robot-simulator/package.json", "content": "{\n \"name\": \"@exercism/typescript-robot-simulator\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/robot-simulator/robot-simulator.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { Robot, InvalidInputError } from './robot-simulator.ts'\n\nfunction turnRight(robot: Robot): void {\n robot.evaluate('R')\n}\n\nfunction turnLeft(robot: Robot): void {\n robot.evaluate('L')\n}\n\nfunction advance(robot: Robot): void {\n robot.evaluate('A')\n}\n\ndescribe('Robot', () => {\n describe('Create robot', () => {\n it('facing north by default', () => {\n const robot = new Robot()\n expect(robot.bearing).toEqual('north')\n })\n\n it('facing east', () => {\n const robot = new Robot()\n robot.place({ direction: 'east', x: 0, y: 0 })\n\n expect(robot.bearing).toEqual('east')\n })\n\n it('facing west, at origin', () => {\n const robot = new Robot()\n robot.place({ direction: 'west', x: 0, y: 0 })\n\n expect(robot.bearing).toEqual('west')\n expect(robot.coordinates).toEqual([0, 0])\n })\n\n it('at negative position facing south', () => {\n const robot = new Robot()\n robot.place({ direction: 'south', x: -1, y: -1 })\n\n expect(robot.bearing).toEqual('south')\n expect(robot.coordinates).toEqual([-1, -1])\n })\n\n xit('invalid robot bearing', () => {\n const robot = new Robot()\n\n expect(InvalidInputError.prototype).toBeInstanceOf(Error)\n expect(() => robot.place({ direction: 'crood', x: 0, y: 0 })).toThrow(\n InvalidInputError\n )\n })\n })\n\n xdescribe('Rotating clockwise', () => {\n const robot = new Robot()\n\n xit('changes north to east', () => {\n robot.place({ direction: 'north', x: 0, y: 0 })\n\n turnRight(robot)\n\n expect(robot.bearing).toEqual('east')\n expect(robot.coordinates).toEqual([0, 0])\n })\n\n xit('changes east to south', () => {\n robot.place({ direction: 'east', x: 0, y: 0 })\n\n turnRight(robot)\n\n expect(robot.bearing).toEqual('south')\n expect(robot.coordinates).toEqual([0, 0])\n })\n\n xit('changes south to west', () => {\n robot.place({ direction: 'south', x: 0, y: 0 })\n\n turnRight(robot)\n\n expect(robot.bearing).toEqual('west')\n expect(robot.coordinates).toEqual([0, 0])\n })\n\n xit('changes west to north', () => {\n robot.place({ direction: 'west', x: 0, y: 0 })\n\n turnRight(robot)\n\n expect(robot.bearing).toEqual('north')\n expect(robot.coordinates).toEqual([0, 0])\n })\n })\n\n xdescribe('Rotating counter-clockwise', () => {\n const robot = new Robot()\n\n xit('changes north to west', () => {\n robot.place({ direction: 'north', x: 0, y: 0 })\n\n turnLeft(robot)\n\n expect(robot.bearing).toEqual('west')\n expect(robot.coordinates).toEqual([0, 0])\n })\n\n xit('changes west to south', () => {\n robot.place({ direction: 'west', x: 0, y: 0 })\n\n turnLeft(robot)\n\n expect(robot.bearing).toEqual('south')\n expect(robot.coordinates).toEqual([0, 0])\n })\n\n xit('changes south to east', () => {\n robot.place({ direction: 'south', x: 0, y: 0 })\n\n turnLeft(robot)\n\n expect(robot.bearing).toEqual('east')\n expect(robot.coordinates).toEqual([0, 0])\n })\n\n xit('changes east to north', () => {\n robot.place({ direction: 'east', x: 0, y: 0 })\n\n turnLeft(robot)\n\n expect(robot.bearing).toEqual('north')\n expect(robot.coordinates).toEqual([0, 0])\n })\n })\n\n xdescribe('Moving forward one', () => {\n const robot = new Robot()\n\n xit('advance when facing north', () => {\n robot.place({ direction: 'north', x: 0, y: 0 })\n\n advance(robot)\n\n expect(robot.coordinates).toEqual([0, 1])\n expect(robot.bearing).toEqual('north')\n })\n\n xit('advance when facing south', () => {\n robot.place({ direction: 'south', x: 0, y: 0 })\n\n advance(robot)\n\n expect(robot.coordinates).toEqual([0, -1])\n expect(robot.bearing).toEqual('south')\n })\n\n xit('advance when facing east', () => {\n robot.place({ direction: 'east', x: 0, y: 0 })\n\n advance(robot)\n\n expect(robot.coordinates).toEqual([1, 0])\n expect(robot.bearing).toEqual('east')\n })\n\n xit('advance when facing west', () => {\n robot.place({ direction: 'west', x: 0, y: 0 })\n\n advance(robot)\n\n expect(robot.coordinates).toEqual([-1, 0])\n expect(robot.bearing).toEqual('west')\n })\n })\n\n xdescribe('Follow series of instructions', () => {\n const robot = new Robot()\n\n xit('moving east and north from README', () => {\n robot.place({ x: 7, y: 3, direction: 'north' })\n\n robot.evaluate('RAALAL')\n\n expect(robot.coordinates).toEqual([9, 4])\n expect(robot.bearing).toEqual('west')\n })\n\n xit('moving west and north', () => {\n robot.place({ x: 0, y: 0, direction: 'north' })\n\n robot.evaluate('LAAARALA')\n\n expect(robot.coordinates).toEqual([-4, 1])\n expect(robot.bearing).toEqual('west')\n })\n\n xit('moving west and south', () => {\n robot.place({ x: 2, y: -7, direction: 'east' })\n\n robot.evaluate('RRAAAAALA')\n\n expect(robot.coordinates).toEqual([-3, -8])\n expect(robot.bearing).toEqual('south')\n })\n\n xit('moving east and north', () => {\n robot.place({ x: 8, y: 4, direction: 'south' })\n\n robot.evaluate('LAAARRRALLLL')\n\n expect(robot.coordinates).toEqual([11, 5])\n expect(robot.bearing).toEqual('north')\n })\n\n xit('instruct many robots', () => {\n const robot1 = new Robot()\n const robot2 = new Robot()\n const robot3 = new Robot()\n robot1.place({ x: 0, y: 0, direction: 'north' })\n robot2.place({ x: 2, y: -7, direction: 'east' })\n robot3.place({ x: 8, y: 4, direction: 'south' })\n\n robot1.evaluate('LAAARALA')\n robot2.evaluate('RRAAAAALA')\n robot3.evaluate('LAAARRRALLLL')\n\n expect(robot1.coordinates).toEqual([-4, 1])\n expect(robot1.bearing).toEqual('west')\n\n expect(robot2.coordinates).toEqual([-3, -8])\n expect(robot2.bearing).toEqual('south')\n\n expect(robot3.coordinates).toEqual([11, 5])\n expect(robot3.bearing).toEqual('north')\n })\n })\n})\n" }, { "path": "exercises/practice/robot-simulator/robot-simulator.ts", "content": "export class InvalidInputError extends Error {\n constructor(message: string) {\n super()\n this.message = message || 'Invalid Input'\n }\n}\n\ntype Direction = 'north' | 'east' | 'south' | 'west'\ntype Coordinates = [number, number]\n\nexport class Robot {\n get bearing(): Direction {\n throw new Error('Remove this line and implement the function')\n }\n\n get coordinates(): Coordinates {\n throw new Error('Remove this line and implement the function')\n }\n\n place({}: { x: number; y: number; direction: string }) {\n throw new Error('Remove this line and implement the function')\n }\n\n evaluate(instructions: string) {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/robot-simulator/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/robot-simulator/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/roman-numerals/.docs/instructions.md", "content": "# Introduction\n\nYour task is to convert a number from Arabic numerals to Roman numerals.\n\nFor this exercise, we are only concerned about traditional Roman numerals, in which the largest number is MMMCMXCIX (or 3,999).\n\n~~~~exercism/note\nThere are lots of different ways to convert between Arabic and Roman numerals.\nWe recommend taking a naive approach first to familiarise yourself with the concept of Roman numerals and then search for more efficient methods.\n\nMake sure to check out our Deep Dive video at the end to explore the different approaches you can take!\n~~~~\n" }, { "path": "exercises/practice/roman-numerals/.docs/introduction.md", "content": "# Description\n\nToday, most people in the world use Arabic numerals (0ā€“9).\nBut if you travelled back two thousand years, you'd find that most Europeans were using Roman numerals instead.\n\nTo write a Roman numeral we use the following Latin letters, each of which has a value:\n\n| M | D | C | L | X | V | I |\n| ---- | --- | --- | --- | --- | --- | --- |\n| 1000 | 500 | 100 | 50 | 10 | 5 | 1 |\n\nA Roman numeral is a sequence of these letters, and its value is the sum of the letters' values.\nFor example, `XVIII` has the value 18 (`10 + 5 + 1 + 1 + 1 = 18`).\n\nThere's one rule that makes things trickier though, and that's that **the same letter cannot be used more than three times in succession**.\nThat means that we can't express numbers such as 4 with the seemingly natural `IIII`.\nInstead, for those numbers, we use a subtraction method between two letters.\nSo we think of `4` not as `1 + 1 + 1 + 1` but instead as `5 - 1`.\nAnd slightly confusingly to our modern thinking, we write the smaller number first.\nThis applies only in the following cases: 4 (`IV`), 9 (`IX`), 40 (`XL`), 90 (`XC`), 400 (`CD`) and 900 (`CM`).\n\nOrder matters in Roman numerals!\nLetters (and the special compounds above) must be ordered by decreasing value from left to right.\n\nHere are some examples:\n\n```text\n 105 => CV\n---- => --\n 100 => C\n+ 5 => V\n```\n\n```text\n 106 => CVI\n---- => --\n 100 => C\n+ 5 => V\n+ 1 => I\n```\n\n```text\n 104 => CIV\n---- => ---\n 100 => C\n+ 4 => IV\n```\n\nAnd a final more complex example:\n\n```text\n 1996 => MCMXCVI\n----- => -------\n 1000 => M\n+ 900 => CM\n+ 90 => XC\n+ 5 => V\n+ 1 => I\n```\n" }, { "path": "exercises/practice/roman-numerals/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"roman-numerals.ts\"\n ],\n \"test\": [\n \"roman-numerals.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Convert modern Arabic numbers into Roman numerals.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"The Roman Numeral Kata\",\n \"source_url\": \"https://codingdojo.org/kata/RomanNumerals/\"\n}\n" }, { "path": "exercises/practice/roman-numerals/.meta/proof.ci.ts", "content": "export function toRoman(number: number): string {\n let result = ''\n let remainingNumber = number\n\n const mappings = [\n { arabic: 1000, roman: 'M' },\n { arabic: 900, roman: 'CM' },\n { arabic: 500, roman: 'D' },\n { arabic: 400, roman: 'CD' },\n { arabic: 100, roman: 'C' },\n { arabic: 90, roman: 'XC' },\n { arabic: 50, roman: 'L' },\n { arabic: 40, roman: 'XL' },\n { arabic: 10, roman: 'X' },\n { arabic: 9, roman: 'IX' },\n { arabic: 5, roman: 'V' },\n { arabic: 4, roman: 'IV' },\n { arabic: 1, roman: 'I' },\n ]\n\n mappings.forEach((mapping) => {\n while (remainingNumber >= mapping.arabic) {\n result += mapping.roman\n remainingNumber -= mapping.arabic\n }\n })\n\n return result\n}\n" }, { "path": "exercises/practice/roman-numerals/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[19828a3a-fbf7-4661-8ddd-cbaeee0e2178]\ndescription = \"1 is I\"\n\n[f088f064-2d35-4476-9a41-f576da3f7b03]\ndescription = \"2 is II\"\n\n[b374a79c-3bea-43e6-8db8-1286f79c7106]\ndescription = \"3 is III\"\n\n[05a0a1d4-a140-4db1-82e8-fcc21fdb49bb]\ndescription = \"4 is IV\"\n\n[57c0f9ad-5024-46ab-975d-de18c430b290]\ndescription = \"5 is V\"\n\n[20a2b47f-e57f-4797-a541-0b3825d7f249]\ndescription = \"6 is VI\"\n\n[ff3fb08c-4917-4aab-9f4e-d663491d083d]\ndescription = \"9 is IX\"\n\n[6d1d82d5-bf3e-48af-9139-87d7165ed509]\ndescription = \"16 is XVI\"\n\n[2bda64ca-7d28-4c56-b08d-16ce65716cf6]\ndescription = \"27 is XXVII\"\n\n[a1f812ef-84da-4e02-b4f0-89c907d0962c]\ndescription = \"48 is XLVIII\"\n\n[607ead62-23d6-4c11-a396-ef821e2e5f75]\ndescription = \"49 is XLIX\"\n\n[d5b283d4-455d-4e68-aacf-add6c4b51915]\ndescription = \"59 is LIX\"\n\n[4465ffd5-34dc-44f3-ada5-56f5007b6dad]\ndescription = \"66 is LXVI\"\n\n[46b46e5b-24da-4180-bfe2-2ef30b39d0d0]\ndescription = \"93 is XCIII\"\n\n[30494be1-9afb-4f84-9d71-db9df18b55e3]\ndescription = \"141 is CXLI\"\n\n[267f0207-3c55-459a-b81d-67cec7a46ed9]\ndescription = \"163 is CLXIII\"\n\n[902ad132-0b4d-40e3-8597-ba5ed611dd8d]\ndescription = \"166 is CLXVI\"\n\n[cdb06885-4485-4d71-8bfb-c9d0f496b404]\ndescription = \"402 is CDII\"\n\n[6b71841d-13b2-46b4-ba97-dec28133ea80]\ndescription = \"575 is DLXXV\"\n\n[dacb84b9-ea1c-4a61-acbb-ce6b36674906]\ndescription = \"666 is DCLXVI\"\n\n[432de891-7fd6-4748-a7f6-156082eeca2f]\ndescription = \"911 is CMXI\"\n\n[e6de6d24-f668-41c0-88d7-889c0254d173]\ndescription = \"1024 is MXXIV\"\n\n[efbe1d6a-9f98-4eb5-82bc-72753e3ac328]\ndescription = \"1666 is MDCLXVI\"\n\n[bb550038-d4eb-4be2-a9ce-f21961ac3bc6]\ndescription = \"3000 is MMM\"\n\n[3bc4b41c-c2e6-49d9-9142-420691504336]\ndescription = \"3001 is MMMI\"\n\n[2f89cad7-73f6-4d1b-857b-0ef531f68b7e]\ndescription = \"3888 is MMMDCCCLXXXVIII\"\n\n[4e18e96b-5fbb-43df-a91b-9cb511fe0856]\ndescription = \"3999 is MMMCMXCIX\"\n" }, { "path": "exercises/practice/roman-numerals/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/roman-numerals/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/roman-numerals/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/roman-numerals/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/roman-numerals/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/roman-numerals/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/roman-numerals/package.json", "content": "{\n \"name\": \"@exercism/typescript-roman-numerals\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/roman-numerals/roman-numerals.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { toRoman } from './roman-numerals.ts'\n\ndescribe('toRoman()', () => {\n it('converts 1', () => expect(toRoman(1)).toEqual('I'))\n xit('converts 2', () => expect(toRoman(2)).toEqual('II'))\n xit('converts 3', () => expect(toRoman(3)).toEqual('III'))\n xit('converts 4', () => expect(toRoman(4)).toEqual('IV'))\n xit('converts 5', () => expect(toRoman(5)).toEqual('V'))\n xit('converts 6', () => expect(toRoman(6)).toEqual('VI'))\n xit('converts 9', () => expect(toRoman(9)).toEqual('IX'))\n xit('converts 16', () => expect(toRoman(16)).toEqual('XVI'))\n xit('converts 27', () => expect(toRoman(27)).toEqual('XXVII'))\n xit('converts 48', () => expect(toRoman(48)).toEqual('XLVIII'))\n xit('converts 49', () => expect(toRoman(49)).toEqual('XLIX'))\n xit('converts 59', () => expect(toRoman(59)).toEqual('LIX'))\n xit('converts 66', () => expect(toRoman(66)).toEqual('LXVI'))\n xit('converts 93', () => expect(toRoman(93)).toEqual('XCIII'))\n xit('converts 141', () => expect(toRoman(141)).toEqual('CXLI'))\n xit('converts 163', () => expect(toRoman(163)).toEqual('CLXIII'))\n xit('converts 166', () => expect(toRoman(166)).toEqual('CLXVI'))\n xit('converts 402', () => expect(toRoman(402)).toEqual('CDII'))\n xit('converts 575', () => expect(toRoman(575)).toEqual('DLXXV'))\n xit('converts 666', () => expect(toRoman(666)).toEqual('DCLXVI'))\n xit('converts 911', () => expect(toRoman(911)).toEqual('CMXI'))\n xit('converts 1024', () => expect(toRoman(1024)).toEqual('MXXIV'))\n xit('converts 1666', () => expect(toRoman(1666)).toEqual('MDCLXVI'))\n xit('converts 3000', () => expect(toRoman(3000)).toEqual('MMM'))\n xit('converts 3001', () => expect(toRoman(3001)).toEqual('MMMI'))\n xit('converts 3888', () => expect(toRoman(3888)).toEqual('MMMDCCCLXXXVIII'))\n xit('converts 3999', () => expect(toRoman(3999)).toEqual('MMMCMXCIX'))\n})\n" }, { "path": "exercises/practice/roman-numerals/roman-numerals.ts", "content": "export const toRoman = () => {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/roman-numerals/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/roman-numerals/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/rotational-cipher/.docs/instructions.md", "content": "# Instructions\n\nCreate an implementation of the rotational cipher, also sometimes called the Caesar cipher.\n\nThe Caesar cipher is a simple shift cipher that relies on transposing all the letters in the alphabet using an integer key between `0` and `26`.\nUsing a key of `0` or `26` will always yield the same output due to modular arithmetic.\nThe letter is shifted for as many values as the value of the key.\n\nThe general notation for rotational ciphers is `ROT + `.\nThe most commonly used rotational cipher is `ROT13`.\n\nA `ROT13` on the Latin alphabet would be as follows:\n\n```text\nPlain: abcdefghijklmnopqrstuvwxyz\nCipher: nopqrstuvwxyzabcdefghijklm\n```\n\nIt is stronger than the Atbash cipher because it has 27 possible keys, and 25 usable keys.\n\nCiphertext is written out in the same formatting as the input including spaces and punctuation.\n\n## Examples\n\n- ROT5 `omg` gives `trl`\n- ROT0 `c` gives `c`\n- ROT26 `Cool` gives `Cool`\n- ROT13 `The quick brown fox jumps over the lazy dog.` gives `Gur dhvpx oebja sbk whzcf bire gur ynml qbt.`\n- ROT13 `Gur dhvpx oebja sbk whzcf bire gur ynml qbt.` gives `The quick brown fox jumps over the lazy dog.`\n" }, { "path": "exercises/practice/rotational-cipher/.meta/config.json", "content": "{\n \"authors\": [\n \"anuragsoni\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"rotational-cipher.ts\"\n ],\n \"test\": [\n \"rotational-cipher.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Create an implementation of the rotational cipher, also sometimes called the Caesar cipher.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Caesar_cipher\"\n}\n" }, { "path": "exercises/practice/rotational-cipher/.meta/proof.ci.ts", "content": "export function rotate(text: string, shiftBy: number): string {\n return [...text]\n .map((c) => {\n const isUpper = c.toUpperCase() === c\n const isAlpha = c.match(/[a-z]/i)\n const caseCharCode = (isUpper ? 'A' : 'a').charCodeAt(0)\n if (isAlpha) {\n const charCode = c.charCodeAt(0)\n return String.fromCharCode(\n ((charCode - caseCharCode + shiftBy) % 26) + caseCharCode\n )\n } else {\n return c\n }\n })\n .join('')\n}\n" }, { "path": "exercises/practice/rotational-cipher/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[74e58a38-e484-43f1-9466-877a7515e10f]\ndescription = \"rotate a by 0, same output as input\"\n\n[7ee352c6-e6b0-4930-b903-d09943ecb8f5]\ndescription = \"rotate a by 1\"\n\n[edf0a733-4231-4594-a5ee-46a4009ad764]\ndescription = \"rotate a by 26, same output as input\"\n\n[e3e82cb9-2a5b-403f-9931-e43213879300]\ndescription = \"rotate m by 13\"\n\n[19f9eb78-e2ad-4da4-8fe3-9291d47c1709]\ndescription = \"rotate n by 13 with wrap around alphabet\"\n\n[a116aef4-225b-4da9-884f-e8023ca6408a]\ndescription = \"rotate capital letters\"\n\n[71b541bb-819c-4dc6-a9c3-132ef9bb737b]\ndescription = \"rotate spaces\"\n\n[ef32601d-e9ef-4b29-b2b5-8971392282e6]\ndescription = \"rotate numbers\"\n\n[32dd74f6-db2b-41a6-b02c-82eb4f93e549]\ndescription = \"rotate punctuation\"\n\n[9fb93fe6-42b0-46e6-9ec1-0bf0a062d8c9]\ndescription = \"rotate all letters\"\n" }, { "path": "exercises/practice/rotational-cipher/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/rotational-cipher/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/rotational-cipher/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/rotational-cipher/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/rotational-cipher/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/rotational-cipher/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/rotational-cipher/package.json", "content": "{\n \"name\": \"@exercism/typescript-rotational-cipher\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/rotational-cipher/rotational-cipher.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { rotate } from './rotational-cipher.ts'\n\ndescribe('RotationalCipher', () => {\n it('rotate a by 1', () => {\n const result = rotate('a', 1)\n expect(result).toEqual('b')\n })\n\n xit('rotate a by 26, same output as input', () => {\n const result = rotate('a', 26)\n expect(result).toEqual('a')\n })\n\n xit('rotate a by 0, same output as input', () => {\n const result = rotate('a', 0)\n expect(result).toEqual('a')\n })\n\n xit('rotate m by 13', () => {\n const result = rotate('m', 13)\n expect(result).toEqual('z')\n })\n\n xit('rotate n by 13 with wrap around alphabet', () => {\n const result = rotate('n', 13)\n expect(result).toEqual('a')\n })\n\n xit('rotate capital letters', () => {\n const result = rotate('OMG', 5)\n expect(result).toEqual('TRL')\n })\n\n xit('rotate spaces', () => {\n const result = rotate('O M G', 5)\n expect(result).toEqual('T R L')\n })\n\n xit('rotate numbers', () => {\n const result = rotate('Testing 1 2 3 testing', 4)\n expect(result).toEqual('Xiwxmrk 1 2 3 xiwxmrk')\n })\n\n xit('rotate punctuation', () => {\n const result = rotate(\"Let's eat, Grandma!\", 21)\n expect(result).toEqual(\"Gzo'n zvo, Bmviyhv!\")\n })\n\n xit('rotate all letters', () => {\n const result = rotate('The quick brown fox jumps over the lazy dog.', 13)\n expect(result).toEqual('Gur dhvpx oebja sbk whzcf bire gur ynml qbt.')\n })\n})\n" }, { "path": "exercises/practice/rotational-cipher/rotational-cipher.ts", "content": "export function rotate() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/rotational-cipher/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/rotational-cipher/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/run-length-encoding/.docs/instructions.md", "content": "# Instructions\n\nImplement run-length encoding and decoding.\n\nRun-length encoding (RLE) is a simple form of data compression, where runs (consecutive data elements) are replaced by just one data value and count.\n\nFor example we can represent the original 53 characters with only 13.\n\n```text\n\"WWWWWWWWWWWWBWWWWWWWWWWWWBBBWWWWWWWWWWWWWWWWWWWWWWWWB\" -> \"12WB12W3B24WB\"\n```\n\nRLE allows the original data to be perfectly reconstructed from the compressed data, which makes it a lossless data compression.\n\n```text\n\"AABCCCDEEEE\" -> \"2AB3CD4E\" -> \"AABCCCDEEEE\"\n```\n\nFor simplicity, you can assume that the unencoded string will only contain the letters A through Z (either lower or upper case) and whitespace.\nThis way data to be encoded will never contain any numbers and numbers inside data to be decoded always represent the count for the following character.\n" }, { "path": "exercises/practice/run-length-encoding/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"run-length-encoding.ts\"\n ],\n \"test\": [\n \"run-length-encoding.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement run-length encoding and decoding.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Run-length_encoding\"\n}\n" }, { "path": "exercises/practice/run-length-encoding/.meta/proof.ci.ts", "content": "export function encode(plaintext: string): string {\n return plaintext.replace(/([\\w\\s])\\1*/g, (match) => {\n return match.length > 1 ? match.length + match[0] : match[0]\n })\n}\n\nexport function decode(cypher: string): string {\n return cypher.replace(/(\\d+)(\\w|\\s)/g, (_match, repeats, char) => {\n return new Array(Number(repeats) + 1).join(char as string)\n })\n}\n" }, { "path": "exercises/practice/run-length-encoding/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[ad53b61b-6ffc-422f-81a6-61f7df92a231]\ndescription = \"empty string\"\n\n[52012823-b7e6-4277-893c-5b96d42f82de]\ndescription = \"single characters only are encoded without count\"\n\n[b7868492-7e3a-415f-8da3-d88f51f80409]\ndescription = \"string with no single characters\"\n\n[859b822b-6e9f-44d6-9c46-6091ee6ae358]\ndescription = \"single characters mixed with repeated characters\"\n\n[1b34de62-e152-47be-bc88-469746df63b3]\ndescription = \"multiple whitespace mixed in string\"\n\n[abf176e2-3fbd-40ad-bb2f-2dd6d4df721a]\ndescription = \"lowercase characters\"\n\n[7ec5c390-f03c-4acf-ac29-5f65861cdeb5]\ndescription = \"empty string\"\n\n[ad23f455-1ac2-4b0e-87d0-b85b10696098]\ndescription = \"single characters only\"\n\n[21e37583-5a20-4a0e-826c-3dee2c375f54]\ndescription = \"string with no single characters\"\n\n[1389ad09-c3a8-4813-9324-99363fba429c]\ndescription = \"single characters with repeated characters\"\n\n[3f8e3c51-6aca-4670-b86c-a213bf4706b0]\ndescription = \"multiple whitespace mixed in string\"\n\n[29f721de-9aad-435f-ba37-7662df4fb551]\ndescription = \"lower case string\"\n\n[2a762efd-8695-4e04-b0d6-9736899fbc16]\ndescription = \"encode followed by decode gives original string\"\n" }, { "path": "exercises/practice/run-length-encoding/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/run-length-encoding/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/run-length-encoding/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/run-length-encoding/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/run-length-encoding/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/run-length-encoding/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/run-length-encoding/package.json", "content": "{\n \"name\": \"@exercism/typescript-run-length-encoding\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/run-length-encoding/run-length-encoding.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { encode, decode } from './run-length-encoding.ts'\n\ndescribe('run-length encode a string', () => {\n it('empty string', () => {\n const expected = ''\n expect(encode('')).toEqual(expected)\n })\n\n xit('single characters only are encoded without count', () => {\n const expected = 'XYZ'\n expect(encode('XYZ')).toEqual(expected)\n })\n\n xit('string with no single characters', () => {\n const expected = '2A3B4C'\n expect(encode('AABBBCCCC')).toEqual(expected)\n })\n\n xit('single characters mixed with repeated characters', () => {\n const expected = '12WB12W3B24WB'\n expect(\n encode('WWWWWWWWWWWWBWWWWWWWWWWWWBBBWWWWWWWWWWWWWWWWWWWWWWWWB')\n ).toEqual(expected)\n })\n\n xit('multiple whitespace mixed in string', () => {\n const expected = '2 hs2q q2w2 '\n expect(encode(' hsqq qww ')).toEqual(expected)\n })\n\n xit('lowercase characters', () => {\n const expected = '2a3b4c'\n expect(encode('aabbbcccc')).toEqual(expected)\n })\n})\n\nxdescribe('run-length decode a string', () => {\n xit('empty string', () => {\n const expected = ''\n expect(decode('')).toEqual(expected)\n })\n\n xit('single characters only', () => {\n const expected = 'XYZ'\n expect(decode('XYZ')).toEqual(expected)\n })\n\n xit('string with no single characters', () => {\n const expected = 'AABBBCCCC'\n expect(decode('2A3B4C')).toEqual(expected)\n })\n\n xit('single characters with repeated characters', () => {\n const expected = 'WWWWWWWWWWWWBWWWWWWWWWWWWBBBWWWWWWWWWWWWWWWWWWWWWWWWB'\n expect(decode('12WB12W3B24WB')).toEqual(expected)\n })\n\n xit('multiple whitespace mixed in string', () => {\n const expected = ' hsqq qww '\n expect(decode('2 hs2q q2w2 ')).toEqual(expected)\n })\n\n xit('lower case string', () => {\n const expected = 'aabbbcccc'\n expect(decode('2a3b4c')).toEqual(expected)\n })\n})\n\nxdescribe('encode and then decode', () => {\n xit('encode followed by decode gives original string', () => {\n expect(decode(encode('zzz ZZ zZ'))).toEqual('zzz ZZ zZ')\n })\n})\n" }, { "path": "exercises/practice/run-length-encoding/run-length-encoding.ts", "content": "export function encode() {\n throw new Error('Remove this line and implement the function')\n}\n\nexport function decode() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/run-length-encoding/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/run-length-encoding/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/saddle-points/.docs/instructions.md", "content": "# Instructions\n\nYour task is to find the potential trees where you could build your tree house.\n\nThe data company provides the data as grids that show the heights of the trees.\nThe rows of the grid represent the east-west direction, and the columns represent the north-south direction.\n\nAn acceptable tree will be the largest in its row, while being the smallest in its column.\n\nA grid might not have any good trees at all.\nOr it might have one, or even several.\n\nHere is a grid that has exactly one candidate tree.\n\n```text\n ā†“\n 1 2 3 4\n |-----------\n 1 | 9 8 7 8\nā†’ 2 |[5] 3 2 4\n 3 | 6 6 7 1\n```\n\n- Row 2 has values 5, 3, 2, and 4. The largest value is 5.\n- Column 1 has values 9, 5, and 6. The smallest value is 5.\n\nSo the point at `[2, 1]` (row: 2, column: 1) is a great spot for a tree house.\n" }, { "path": "exercises/practice/saddle-points/.docs/introduction.md", "content": "# Introduction\n\nYou plan to build a tree house in the woods near your house so that you can watch the sun rise and set.\n\nYou've obtained data from a local survey company that show the height of every tree in each rectangular section of the map.\nYou need to analyze each grid on the map to find good trees for your tree house.\n\nA good tree is both:\n\n- taller than every tree to the east and west, so that you have the best possible view of the sunrises and sunsets.\n- shorter than every tree to the north and south, to minimize the amount of tree climbing.\n" }, { "path": "exercises/practice/saddle-points/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"saddle-points.ts\"\n ],\n \"test\": [\n \"saddle-points.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Detect saddle points in a matrix.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"J Dalbey's Programming Practice problems\",\n \"source_url\": \"https://users.csc.calpoly.edu/~jdalbey/103/Projects/ProgrammingPractice.html\"\n}\n" }, { "path": "exercises/practice/saddle-points/.meta/proof.ci.ts", "content": "export function saddlePoints(\n matrix: number[][]\n): Array<{ row: number; column: number }> {\n const maximumRowValues: number[] = []\n const minimumColumnValues: number[] = []\n\n for (let i = 0; i <= matrix.length - 1; i++) {\n let maximumRowValue = Number.MIN_VALUE\n for (let j = 0; j < matrix[0].length; j++) {\n maximumRowValue = Math.max(maximumRowValue, matrix[i][j])\n }\n maximumRowValues.push(maximumRowValue)\n }\n\n for (let i = 0; i <= matrix[0].length - 1; i++) {\n let minimumColumnValue = Number.MAX_VALUE\n for (let j = 0; j <= matrix.length - 1; j++) {\n minimumColumnValue = Math.min(minimumColumnValue, matrix[j][i])\n }\n minimumColumnValues.push(minimumColumnValue)\n }\n\n const resultPoints: Array<{ row: number; column: number }> = []\n for (let i = 0; i < maximumRowValues.length; i++) {\n for (let j = 0; j < minimumColumnValues.length; j++) {\n if (maximumRowValues[i] === minimumColumnValues[j]) {\n resultPoints.push({ row: i + 1, column: j + 1 })\n }\n }\n }\n\n return resultPoints\n}\n" }, { "path": "exercises/practice/saddle-points/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[3e374e63-a2e0-4530-a39a-d53c560382bd]\ndescription = \"Can identify single saddle point\"\n\n[6b501e2b-6c1f-491f-b1bb-7f278f760534]\ndescription = \"Can identify that empty matrix has no saddle points\"\n\n[8c27cc64-e573-4fcb-a099-f0ae863fb02f]\ndescription = \"Can identify lack of saddle points when there are none\"\n\n[6d1399bd-e105-40fd-a2c9-c6609507d7a3]\ndescription = \"Can identify multiple saddle points in a column\"\n\n[3e81dce9-53b3-44e6-bf26-e328885fd5d1]\ndescription = \"Can identify multiple saddle points in a row\"\n\n[88868621-b6f4-4837-bb8b-3fad8b25d46b]\ndescription = \"Can identify saddle point in bottom right corner\"\n\n[5b9499ca-fcea-4195-830a-9c4584a0ee79]\ndescription = \"Can identify saddle points in a non square matrix\"\n\n[ee99ccd2-a1f1-4283-ad39-f8c70f0cf594]\ndescription = \"Can identify that saddle points in a single column matrix are those with the minimum value\"\n\n[63abf709-a84b-407f-a1b3-456638689713]\ndescription = \"Can identify that saddle points in a single row matrix are those with the maximum value\"\n" }, { "path": "exercises/practice/saddle-points/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/saddle-points/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/saddle-points/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/saddle-points/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/saddle-points/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/saddle-points/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/saddle-points/package.json", "content": "{\n \"name\": \"@exercism/typescript-saddle-points\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/saddle-points/saddle-points.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { saddlePoints } from './saddle-points.ts'\n\ndescribe('Saddle Points', () => {\n it('Can identify single saddle point', () => {\n const expected = [{ row: 2, column: 1 }]\n expect(\n saddlePoints([\n [9, 8, 7],\n [5, 3, 2],\n [6, 6, 7],\n ])\n ).toEqual(expected)\n })\n\n xit('Can identify that empty matrix has no saddle points', () => {\n const expected: number[] = []\n expect(saddlePoints([[]])).toEqual(expected)\n })\n\n xit('Can identify lack of saddle points when there are none', () => {\n const expected: number[] = []\n expect(\n saddlePoints([\n [1, 2, 3],\n [3, 1, 2],\n [2, 3, 1],\n ])\n ).toEqual(expected)\n })\n\n xit('Can identify multiple saddle points in a column', () => {\n const expected = [\n { row: 1, column: 2 },\n { row: 2, column: 2 },\n { row: 3, column: 2 },\n ]\n expect(\n saddlePoints([\n [4, 5, 4],\n [3, 5, 5],\n [1, 5, 4],\n ])\n ).toEqual(expected)\n })\n\n xit('Can identify multiple saddle points in a row', () => {\n const expected = [\n { row: 2, column: 1 },\n { row: 2, column: 2 },\n { row: 2, column: 3 },\n ]\n expect(\n saddlePoints([\n [6, 7, 8],\n [5, 5, 5],\n [7, 5, 6],\n ])\n ).toEqual(expected)\n })\n\n xit('Can identify saddle point in bottom right corner', () => {\n const expected = [{ row: 3, column: 3 }]\n expect(\n saddlePoints([\n [8, 7, 9],\n [6, 7, 6],\n [3, 2, 5],\n ])\n ).toEqual(expected)\n })\n\n xit('Can identify saddle points in a non square matrix', () => {\n const expected = [\n { row: 1, column: 1 },\n { row: 1, column: 3 },\n ]\n expect(\n saddlePoints([\n [3, 1, 3],\n [3, 2, 4],\n ])\n ).toEqual(expected)\n })\n\n xit('Can identify that saddle points in a single column matrix are those with the minimum value', () => {\n const expected = [\n { row: 2, column: 1 },\n { row: 4, column: 1 },\n ]\n expect(saddlePoints([[2], [1], [4], [1]])).toEqual(expected)\n })\n\n xit('Can identify that saddle points in a single row matrix are those with the maximum value', () => {\n const expected = [\n { row: 1, column: 2 },\n { row: 1, column: 4 },\n ]\n expect(saddlePoints([[2, 5, 3, 5]])).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/saddle-points/saddle-points.ts", "content": "export function saddlePoints(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/saddle-points/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/saddle-points/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/say/.docs/instructions.md", "content": "# Instructions\n\nGiven a number, your task is to express it in English words exactly as your friend should say it out loud.\nYaŹ»qÅ«b expects to use numbers from 0 up to 999,999,999,999.\n\nExamples:\n\n- 0 ā†’ zero\n- 1 ā†’ one\n- 12 ā†’ twelve\n- 123 ā†’ one hundred twenty-three\n- 1,234 ā†’ one thousand two hundred thirty-four\n" }, { "path": "exercises/practice/say/.docs/introduction.md", "content": "# Introduction\n\nYour friend YaŹ»qÅ«b works the counter at the busiest deli in town, slicing, weighing, and wrapping orders for a never-ending line of hungry customers.\nTo keep things moving, each customer takes a numbered ticket when they arrive.\n\nWhen itā€™s time to call the next person, YaŹ»qÅ«b reads their number out loud, always in full English words to make sure everyone hears it clearly.\n" }, { "path": "exercises/practice/say/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"say.ts\"\n ],\n \"test\": [\n \"say.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a number from 0 to 999,999,999,999, spell out that number in English.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A variation on the JavaRanch CattleDrive, Assignment 4\",\n \"source_url\": \"https://web.archive.org/web/20240907035912/https://coderanch.com/wiki/718804\"\n}\n" }, { "path": "exercises/practice/say/.meta/proof.ci.ts", "content": "const numbersMap = new Map([\n [0, 'zero'],\n [1, 'one'],\n [2, 'two'],\n [3, 'three'],\n [4, 'four'],\n [5, 'five'],\n [6, 'six'],\n [7, 'seven'],\n [8, 'eight'],\n [9, 'nine'],\n [10, 'ten'],\n [11, 'eleven'],\n [12, 'twelve'],\n [13, 'thirteen'],\n [14, 'fourteen'],\n [15, 'fifteen'],\n [16, 'sixteen'],\n [17, 'seventeen'],\n [18, 'eighteen'],\n [19, 'nineteen'],\n [20, 'twenty'],\n [30, 'thirty'],\n [40, 'forty'],\n [50, 'fifty'],\n [60, 'sixty'],\n [70, 'seventy'],\n [80, 'eighty'],\n [90, 'ninety'],\n [100, 'hundred'],\n [1000, 'thousand'],\n [1000000, 'million'],\n [1000000000, 'billion'],\n])\n\nfunction divideNoDecimal(input: number, by: number): number {\n return (input / by) | 0 // this is like a hack to get int width\n}\n\nfunction classifier(input: number): number {\n if (input >= 100 && input < 1000) {\n return 100\n }\n if (input < 1000000 && input >= 1000) {\n return 1000\n }\n if (input < 1000000000 && input >= 1000000) {\n return 1000000\n }\n if (input < 1000000000000 && input >= 1000000000) {\n return 1000000000\n }\n throw new Error(\n `${classifier.name} only accepts values between 100 to 1000000000000 - 1`\n )\n}\n\nfunction numberGenerator(input: number): string {\n if (input < 100) {\n return zeroTo99(input)\n }\n const level = classifier(input)\n const thirdPlace = divideNoDecimal(input, level)\n const remainder = input % level\n\n let builder = ''\n builder +=\n thirdPlace === 0\n ? ''\n : `${numberGenerator(thirdPlace)} ${numbersMap.get(level)!}`\n builder += remainder === 0 ? '' : ' ' + `${numberGenerator(remainder)}`\n return builder\n}\n\nfunction zeroTo99(input: number): string {\n if (input > 100) {\n throw new Error(`${zeroTo99.name} only accepts values 0 to 99`)\n }\n if (input <= 20) {\n return numbersMap.get(input)!\n }\n if (input > 20 && input < 100) {\n const teen = divideNoDecimal(input, 10) * 10\n const tens = numbersMap.get(teen)!\n const remainder = numbersMap.get(input % teen)!\n if (remainder === 'zero') {\n return tens\n } else {\n return `${tens}-${remainder}`\n }\n }\n return ''\n}\n\nexport function sayInEnglish(input: number): string {\n if (input < 0 || input > 999999999999) {\n throw new Error('Number must be between 0 and 999,999,999,999.')\n }\n\n return numberGenerator(input)\n}\n" }, { "path": "exercises/practice/say/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[5d22a120-ba0c-428c-bd25-8682235d83e8]\ndescription = \"zero\"\n\n[9b5eed77-dbf6-439d-b920-3f7eb58928f6]\ndescription = \"one\"\n\n[7c499be1-612e-4096-a5e1-43b2f719406d]\ndescription = \"fourteen\"\n\n[f541dd8e-f070-4329-92b4-b7ce2fcf06b4]\ndescription = \"twenty\"\n\n[d78601eb-4a84-4bfa-bf0e-665aeb8abe94]\ndescription = \"twenty-two\"\n\n[f010d4ca-12c9-44e9-803a-27789841adb1]\ndescription = \"thirty\"\n\n[738ce12d-ee5c-4dfb-ad26-534753a98327]\ndescription = \"ninety-nine\"\n\n[e417d452-129e-4056-bd5b-6eb1df334dce]\ndescription = \"one hundred\"\n\n[d6924f30-80ba-4597-acf6-ea3f16269da8]\ndescription = \"one hundred twenty-three\"\n\n[2f061132-54bc-4fd4-b5df-0a3b778959b9]\ndescription = \"two hundred\"\n\n[feed6627-5387-4d38-9692-87c0dbc55c33]\ndescription = \"nine hundred ninety-nine\"\n\n[3d83da89-a372-46d3-b10d-de0c792432b3]\ndescription = \"one thousand\"\n\n[865af898-1d5b-495f-8ff0-2f06d3c73709]\ndescription = \"one thousand two hundred thirty-four\"\n\n[b6a3f442-266e-47a3-835d-7f8a35f6cf7f]\ndescription = \"one million\"\n\n[2cea9303-e77e-4212-b8ff-c39f1978fc70]\ndescription = \"one million two thousand three hundred forty-five\"\n\n[3e240eeb-f564-4b80-9421-db123f66a38f]\ndescription = \"one billion\"\n\n[9a43fed1-c875-4710-8286-5065d73b8a9e]\ndescription = \"a big number\"\n\n[49a6a17b-084e-423e-994d-a87c0ecc05ef]\ndescription = \"numbers below zero are out of range\"\n\n[4d6492eb-5853-4d16-9d34-b0f61b261fd9]\ndescription = \"numbers above 999,999,999,999 are out of range\"\n" }, { "path": "exercises/practice/say/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/say/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/say/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/say/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/say/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/say/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/say/package.json", "content": "{\n \"name\": \"@exercism/typescript-say\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/say/say.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { sayInEnglish } from './say.ts'\n\ndescribe('say', () => {\n it('zero', () => {\n expect(sayInEnglish(0)).toBe('zero')\n })\n\n xit('one', () => {\n expect(sayInEnglish(1)).toBe('one')\n })\n\n xit('fourteen', () => {\n expect(sayInEnglish(14)).toBe('fourteen')\n })\n\n xit('twenty', () => {\n expect(sayInEnglish(20)).toBe('twenty')\n })\n\n xit('twenty-two', () => {\n expect(sayInEnglish(22)).toBe('twenty-two')\n })\n\n xit('thirty', () => {\n expect(sayInEnglish(30)).toBe('thirty')\n })\n\n xit('ninety-nine', () => {\n expect(sayInEnglish(99)).toBe('ninety-nine')\n })\n\n xit('one hundred', () => {\n expect(sayInEnglish(100)).toBe('one hundred')\n })\n\n xit('one hundred twenty-three', () => {\n expect(sayInEnglish(123)).toBe('one hundred twenty-three')\n })\n\n xit('two hundred', () => {\n expect(sayInEnglish(200)).toBe('two hundred')\n })\n\n xit('nine hundred ninety-nine', () => {\n expect(sayInEnglish(999)).toBe('nine hundred ninety-nine')\n })\n\n xit('one thousand', () => {\n expect(sayInEnglish(1000)).toBe('one thousand')\n })\n\n xit('one thousand two hundred thirty-four', () => {\n expect(sayInEnglish(1234)).toBe('one thousand two hundred thirty-four')\n })\n\n xit('one million', () => {\n expect(sayInEnglish(1000000)).toBe('one million')\n })\n\n xit('one million two', () => {\n expect(sayInEnglish(1000002)).toBe('one million two')\n })\n\n xit('one million two thousand three hundred forty-five', () => {\n expect(sayInEnglish(1002345)).toBe(\n 'one million two thousand three hundred forty-five'\n )\n })\n\n xit('one billion', () => {\n expect(sayInEnglish(1000000000)).toBe('one billion')\n })\n\n xit('a really big number', () => {\n let expected = 'nine hundred eighty-seven billion '\n expected += 'six hundred fifty-four million '\n expected += 'three hundred twenty-one thousand '\n expected += 'one hundred twenty-three'\n expect(sayInEnglish(987654321123)).toBe(expected)\n })\n\n xit('raises an error below zero', () => {\n expect(() => {\n sayInEnglish(-1)\n }).toThrow('Number must be between 0 and 999,999,999,999.')\n })\n\n xit('raises an error above 999,999,999,999', () => {\n expect(() => {\n sayInEnglish(1000000000000)\n }).toThrow('Number must be between 0 and 999,999,999,999.')\n })\n})\n" }, { "path": "exercises/practice/say/say.ts", "content": "export function sayInEnglish() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/say/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/say/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/scrabble-score/.docs/instructions.md", "content": "# Instructions\n\nYour task is to compute a word's Scrabble score by summing the values of its letters.\n\nThe letters are valued as follows:\n\n| Letter | Value |\n| ---------------------------- | ----- |\n| A, E, I, O, U, L, N, R, S, T | 1 |\n| D, G | 2 |\n| B, C, M, P | 3 |\n| F, H, V, W, Y | 4 |\n| K | 5 |\n| J, X | 8 |\n| Q, Z | 10 |\n\nFor example, the word \"cabbage\" is worth 14 points:\n\n- 3 points for C\n- 1 point for A\n- 3 points for B\n- 3 points for B\n- 1 point for A\n- 2 points for G\n- 1 point for E\n" }, { "path": "exercises/practice/scrabble-score/.docs/introduction.md", "content": "# Introduction\n\n[Scrabble][wikipedia] is a word game where players place letter tiles on a board to form words.\nEach letter has a value.\nA word's score is the sum of its letters' values.\n\n[wikipedia]: https://en.wikipedia.org/wiki/Scrabble\n" }, { "path": "exercises/practice/scrabble-score/.meta/config.json", "content": "{\n \"authors\": [\n \"zgavin1\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"scrabble-score.ts\"\n ],\n \"test\": [\n \"scrabble-score.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a word, compute the Scrabble score for that word.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Inspired by the Extreme Startup game\",\n \"source_url\": \"https://github.com/rchatley/extreme_startup\"\n}\n" }, { "path": "exercises/practice/scrabble-score/.meta/proof.ci.ts", "content": "interface LetterScore {\n [key: string]: number\n}\n\nconst letterScores: LetterScore = {\n a: 1,\n e: 1,\n i: 1,\n o: 1,\n u: 1,\n l: 1,\n n: 1,\n r: 1,\n s: 1,\n t: 1,\n d: 2,\n g: 2,\n b: 3,\n c: 3,\n m: 3,\n p: 3,\n f: 4,\n h: 4,\n v: 4,\n w: 4,\n y: 4,\n k: 5,\n j: 8,\n x: 8,\n q: 10,\n z: 10,\n}\n\nexport const score = (word: string | undefined): number => {\n word = word ? word.toLowerCase() : ''\n\n let output = 0\n word.split('').forEach((letter: string): void => {\n output += letterScores[letter]\n })\n\n return output\n}\n" }, { "path": "exercises/practice/scrabble-score/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[f46cda29-1ca5-4ef2-bd45-388a767e3db2]\ndescription = \"lowercase letter\"\n\n[f7794b49-f13e-45d1-a933-4e48459b2201]\ndescription = \"uppercase letter\"\n\n[eaba9c76-f9fa-49c9-a1b0-d1ba3a5b31fa]\ndescription = \"valuable letter\"\n\n[f3c8c94e-bb48-4da2-b09f-e832e103151e]\ndescription = \"short word\"\n\n[71e3d8fa-900d-4548-930e-68e7067c4615]\ndescription = \"short, valuable word\"\n\n[d3088ad9-570c-4b51-8764-c75d5a430e99]\ndescription = \"medium word\"\n\n[fa20c572-ad86-400a-8511-64512daac352]\ndescription = \"medium, valuable word\"\n\n[9336f0ba-9c2b-4fa0-bd1c-2e2d328cf967]\ndescription = \"long, mixed-case word\"\n\n[1e34e2c3-e444-4ea7-b598-3c2b46fd2c10]\ndescription = \"english-like word\"\n\n[4efe3169-b3b6-4334-8bae-ff4ef24a7e4f]\ndescription = \"empty input\"\n\n[3b305c1c-f260-4e15-a5b5-cb7d3ea7c3d7]\ndescription = \"entire alphabet available\"\n" }, { "path": "exercises/practice/scrabble-score/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/scrabble-score/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/scrabble-score/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/scrabble-score/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/scrabble-score/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/scrabble-score/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/scrabble-score/package.json", "content": "{\n \"name\": \"@exercism/typescript-scrabble-score\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/scrabble-score/scrabble-score.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { score } from './scrabble-score.ts'\n\ndescribe('Scrabble', () => {\n it('scores an empty word as zero', () => expect(score('')).toEqual(0))\n\n xit('scores a null as zero', () => expect(score(undefined)).toEqual(0))\n\n xit('scores a very short word', () => expect(score('a')).toEqual(1))\n\n xit('scores the word by the number of letters', () =>\n expect(score('street')).toEqual(6))\n\n xit('scores more complicated words with more', () =>\n expect(score('quirky')).toEqual(22))\n\n xit('scores case insensitive words', () =>\n expect(score('OXYPHENBUTAZONE')).toEqual(41))\n})\n" }, { "path": "exercises/practice/scrabble-score/scrabble-score.ts", "content": "export function score() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/scrabble-score/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/scrabble-score/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/secret-handshake/.docs/instructions.md", "content": "# Instructions\n\nYour task is to convert a number between 1 and 31 to a sequence of actions in the secret handshake.\n\nThe sequence of actions is chosen by looking at the rightmost five digits of the number once it's been converted to binary.\nStart at the right-most digit and move left.\n\nThe actions for each number place are:\n\n```plaintext\n00001 = wink\n00010 = double blink\n00100 = close your eyes\n01000 = jump\n10000 = Reverse the order of the operations in the secret handshake.\n```\n\nLet's use the number `9` as an example:\n\n- 9 in binary is `1001`.\n- The digit that is farthest to the right is 1, so the first action is `wink`.\n- Going left, the next digit is 0, so there is no double-blink.\n- Going left again, the next digit is 0, so you leave your eyes open.\n- Going left again, the next digit is 1, so you jump.\n\nThat was the last digit, so the final code is:\n\n```plaintext\nwink, jump\n```\n\nGiven the number 26, which is `11010` in binary, we get the following actions:\n\n- double blink\n- jump\n- reverse actions\n\nThe secret handshake for 26 is therefore:\n\n```plaintext\njump, double blink\n```\n\n~~~~exercism/note\nIf you aren't sure what binary is or how it works, check out [this binary tutorial][intro-to-binary].\n\n[intro-to-binary]: https://medium.com/basecs/bits-bytes-building-with-binary-13cb4289aafa\n~~~~\n" }, { "path": "exercises/practice/secret-handshake/.docs/introduction.md", "content": "# Introduction\n\nYou are starting a secret coding club with some friends and friends-of-friends.\nNot everyone knows each other, so you and your friends have decided to create a secret handshake that you can use to recognize that someone is a member.\nYou don't want anyone who isn't in the know to be able to crack the code.\n\nYou've designed the code so that one person says a number between 1 and 31, and the other person turns it into a series of actions.\n" }, { "path": "exercises/practice/secret-handshake/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"secret-handshake.ts\"\n ],\n \"test\": [\n \"secret-handshake.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a decimal number, convert it to the appropriate sequence of events for a secret handshake.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Bert, in Mary Poppins\",\n \"source_url\": \"https://www.imdb.com/title/tt0058331/quotes/?item=qt0437047\"\n}\n" }, { "path": "exercises/practice/secret-handshake/.meta/proof.ci.ts", "content": "const COMMANDS = ['wink', 'double blink', 'close your eyes', 'jump'] as const\ntype Command = (typeof COMMANDS)[number]\ntype Commands = Command[]\n\nexport const commands = (handshake: number): Commands => {\n const shakeWith = COMMANDS.filter((_, i) => handshake & Math.pow(2, i))\n\n if (handshake & Math.pow(2, 4)) {\n shakeWith.reverse()\n }\n\n return shakeWith\n}\n" }, { "path": "exercises/practice/secret-handshake/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[b8496fbd-6778-468c-8054-648d03c4bb23]\ndescription = \"wink for 1\"\n\n[83ec6c58-81a9-4fd1-bfaf-0160514fc0e3]\ndescription = \"double blink for 10\"\n\n[0e20e466-3519-4134-8082-5639d85fef71]\ndescription = \"close your eyes for 100\"\n\n[b339ddbb-88b7-4b7d-9b19-4134030d9ac0]\ndescription = \"jump for 1000\"\n\n[40499fb4-e60c-43d7-8b98-0de3ca44e0eb]\ndescription = \"combine two actions\"\n\n[9730cdd5-ef27-494b-afd3-5c91ad6c3d9d]\ndescription = \"reverse two actions\"\n\n[0b828205-51ca-45cd-90d5-f2506013f25f]\ndescription = \"reversing one action gives the same action\"\n\n[9949e2ac-6c9c-4330-b685-2089ab28b05f]\ndescription = \"reversing no actions still gives no actions\"\n\n[23fdca98-676b-4848-970d-cfed7be39f81]\ndescription = \"all possible actions\"\n\n[ae8fe006-d910-4d6f-be00-54b7c3799e79]\ndescription = \"reverse all possible actions\"\n\n[3d36da37-b31f-4cdb-a396-d93a2ee1c4a5]\ndescription = \"do nothing for zero\"\n" }, { "path": "exercises/practice/secret-handshake/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/secret-handshake/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/secret-handshake/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/secret-handshake/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/secret-handshake/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/secret-handshake/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/secret-handshake/package.json", "content": "{\n \"name\": \"@exercism/typescript-secret-handshake\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/secret-handshake/secret-handshake.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { commands } from './secret-handshake.ts'\n\ndescribe('Secret Handshake', () => {\n describe('Create A Handshake For A Number', () => {\n it('wink for 1', () => {\n expect(commands(1)).toEqual(['wink'])\n })\n\n xit('double blink for 10', () => {\n expect(commands(2)).toEqual(['double blink'])\n })\n\n xit('close your eyes for 100', () => {\n expect(commands(4)).toEqual(['close your eyes'])\n })\n\n xit('jump for 1000', () => {\n expect(commands(8)).toEqual(['jump'])\n })\n\n xit('combine two actions', () => {\n expect(commands(3)).toEqual(['wink', 'double blink'])\n })\n\n xit('reverse two actions', () => {\n expect(commands(19)).toEqual(['double blink', 'wink'])\n })\n\n xit('reversing one action gives the same action', () => {\n expect(commands(24)).toEqual(['jump'])\n })\n\n xit('reversing no actions still gives no actions', () => {\n expect(commands(16)).toEqual([])\n })\n\n xit('all possible actions', () => {\n expect(commands(15)).toEqual([\n 'wink',\n 'double blink',\n 'close your eyes',\n 'jump',\n ])\n })\n\n xit('reverse all possible actions', () => {\n expect(commands(31)).toEqual([\n 'jump',\n 'close your eyes',\n 'double blink',\n 'wink',\n ])\n })\n\n xit('do nothing for zero', () => {\n expect(commands(0)).toEqual([])\n })\n })\n})\n" }, { "path": "exercises/practice/secret-handshake/secret-handshake.ts", "content": "export function commands() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/secret-handshake/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/secret-handshake/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/series/.docs/instructions.md", "content": "# Instructions\n\nGiven a string of digits, output all the contiguous substrings of length `n` in that string in the order that they appear.\n\nFor example, the string \"49142\" has the following 3-digit series:\n\n- \"491\"\n- \"914\"\n- \"142\"\n\nAnd the following 4-digit series:\n\n- \"4914\"\n- \"9142\"\n\nAnd if you ask for a 6-digit series from a 5-digit string, you deserve whatever you get.\n\nNote that these series are only required to occupy _adjacent positions_ in the input;\nthe digits need not be _numerically consecutive_.\n" }, { "path": "exercises/practice/series/.meta/config.json", "content": "{\n \"authors\": [\n \"foxfriends\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"series.ts\"\n ],\n \"test\": [\n \"series.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a string of digits, output all the contiguous substrings of length `n` in that string.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A subset of the Problem 8 at Project Euler\",\n \"source_url\": \"https://projecteuler.net/problem=8\"\n}\n" }, { "path": "exercises/practice/series/.meta/proof.ci.ts", "content": "export class Series {\n private readonly numberString: string\n private readonly digits: number[]\n\n constructor(numberString: string) {\n if (!numberString) {\n throw new Error('series cannot be empty')\n }\n\n this.numberString = numberString\n this.digits = this.getDigits()\n }\n\n private getDigits(): number[] {\n return [...this.numberString].map((digit) => parseInt(digit, 10))\n }\n\n public slices(sliceSize: number): number[][] {\n const result: number[][] = []\n let slice: number[] = []\n\n if (sliceSize < 0) {\n throw new Error('slice length cannot be negative')\n }\n\n if (sliceSize === 0) {\n throw new Error('slice length cannot be zero')\n }\n\n if (sliceSize > this.digits.length) {\n throw new Error('slice length cannot be greater than series length')\n }\n\n for (let i = 0; i < this.digits.length - sliceSize + 1; i += 1) {\n for (let j = 0; j < sliceSize; j += 1) {\n slice.push(this.digits[i + j])\n }\n result.push(slice)\n slice = []\n }\n\n return result\n }\n}\n" }, { "path": "exercises/practice/series/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[7ae7a46a-d992-4c2a-9c15-a112d125ebad]\ndescription = \"slices of one from one\"\n\n[3143b71d-f6a5-4221-aeae-619f906244d2]\ndescription = \"slices of one from two\"\n\n[dbb68ff5-76c5-4ccd-895a-93dbec6d5805]\ndescription = \"slices of two\"\n\n[19bbea47-c987-4e11-a7d1-e103442adf86]\ndescription = \"slices of two overlap\"\n\n[8e17148d-ba0a-4007-a07f-d7f87015d84c]\ndescription = \"slices can include duplicates\"\n\n[bd5b085e-f612-4f81-97a8-6314258278b0]\ndescription = \"slices of a long series\"\n\n[6d235d85-46cf-4fae-9955-14b6efef27cd]\ndescription = \"slice length is too large\"\n\n[d7957455-346d-4e47-8e4b-87ed1564c6d7]\ndescription = \"slice length is way too large\"\n\n[d34004ad-8765-4c09-8ba1-ada8ce776806]\ndescription = \"slice length cannot be zero\"\n\n[10ab822d-8410-470a-a85d-23fbeb549e54]\ndescription = \"slice length cannot be negative\"\n\n[c7ed0812-0e4b-4bf3-99c4-28cbbfc246a2]\ndescription = \"empty series is invalid\"\n" }, { "path": "exercises/practice/series/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/series/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/series/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/series/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/series/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/series/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/series/package.json", "content": "{\n \"name\": \"@exercism/typescript-series\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/series/series.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Series } from './series.ts'\n\ndescribe('Series', () => {\n it('slices of one from one', () => {\n expect(new Series('1').slices(1)).toEqual([[1]])\n })\n\n xit('slices of one from two', () => {\n expect(new Series('12').slices(1)).toEqual([[1], [2]])\n })\n\n xit('slices of two', () => {\n expect(new Series('35').slices(2)).toEqual([[3, 5]])\n })\n\n xit('slices of two overlap', () => {\n expect(new Series('9142').slices(2)).toEqual([\n [9, 1],\n [1, 4],\n [4, 2],\n ])\n })\n\n xit('slices can include duplicates', () => {\n expect(new Series('777777').slices(3)).toEqual([\n [7, 7, 7],\n [7, 7, 7],\n [7, 7, 7],\n [7, 7, 7],\n ])\n })\n\n xit('slices of long series', () => {\n expect(new Series('918493904243').slices(5)).toEqual([\n [9, 1, 8, 4, 9],\n [1, 8, 4, 9, 3],\n [8, 4, 9, 3, 9],\n [4, 9, 3, 9, 0],\n [9, 3, 9, 0, 4],\n [3, 9, 0, 4, 2],\n [9, 0, 4, 2, 4],\n [0, 4, 2, 4, 3],\n ])\n })\n\n xit('slice length is too large', () => {\n expect(() => {\n new Series('12345').slices(6)\n }).toThrow(new Error('slice length cannot be greater than series length'))\n })\n\n xit('slice length is way too large', () => {\n expect(() => {\n new Series('12345').slices(42)\n }).toThrow(new Error('slice length cannot be greater than series length'))\n })\n\n xit('slice length cannot be zero', () => {\n expect(() => {\n new Series('12345').slices(0)\n }).toThrow(new Error('slice length cannot be zero'))\n })\n\n xit('slice length cannot be negative', () => {\n expect(() => {\n new Series('123').slices(-1)\n }).toThrow(new Error('slice length cannot be negative'))\n })\n\n xit('empty series is invalid', () => {\n expect(() => {\n new Series('').slices(1)\n }).toThrow(new Error('series cannot be empty'))\n })\n})\n" }, { "path": "exercises/practice/series/series.ts", "content": "export class Series {\n constructor(series: unknown) {\n throw new Error('Remove this line and implement the function')\n }\n\n slices(sliceLength: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/series/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/series/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/sieve/.docs/instructions.md", "content": "# Instructions\n\nYour task is to create a program that implements the Sieve of Eratosthenes algorithm to find all prime numbers less than or equal to a given number.\n\nA prime number is a number larger than 1 that is only divisible by 1 and itself.\nFor example, 2, 3, 5, 7, 11, and 13 are prime numbers.\nBy contrast, 6 is _not_ a prime number as it not only divisible by 1 and itself, but also by 2 and 3.\n\nTo use the Sieve of Eratosthenes, first, write out all the numbers from 2 up to and including your given number.\nThen, follow these steps:\n\n1. Find the next unmarked number (skipping over marked numbers).\n This is a prime number.\n2. Mark all the multiples of that prime number as **not** prime.\n\nRepeat the steps until you've gone through every number.\nAt the end, all the unmarked numbers are prime.\n\n~~~~exercism/note\nThe Sieve of Eratosthenes marks off multiples of each prime using addition (repeatedly adding the prime) or multiplication (directly computing its multiples), rather than checking each number for divisibility.\n\nThe tests don't check that you've implemented the algorithm, only that you've come up with the correct primes.\n~~~~\n\n## Example\n\nLet's say you're finding the primes less than or equal to 10.\n\n- Write out 2, 3, 4, 5, 6, 7, 8, 9, 10, leaving them all unmarked.\n\n ```text\n 2 3 4 5 6 7 8 9 10\n ```\n\n- 2 is unmarked and is therefore a prime.\n Mark 4, 6, 8 and 10 as \"not prime\".\n\n ```text\n 2 3 [4] 5 [6] 7 [8] 9 [10]\n ā†‘\n ```\n\n- 3 is unmarked and is therefore a prime.\n Mark 6 and 9 as not prime _(marking 6 is optional - as it's already been marked)_.\n\n ```text\n 2 3 [4] 5 [6] 7 [8] [9] [10]\n ā†‘\n ```\n\n- 4 is marked as \"not prime\", so we skip over it.\n\n ```text\n 2 3 [4] 5 [6] 7 [8] [9] [10]\n ā†‘\n ```\n\n- 5 is unmarked and is therefore a prime.\n Mark 10 as not prime _(optional - as it's already been marked)_.\n\n ```text\n 2 3 [4] 5 [6] 7 [8] [9] [10]\n ā†‘\n ```\n\n- 6 is marked as \"not prime\", so we skip over it.\n\n ```text\n 2 3 [4] 5 [6] 7 [8] [9] [10]\n ā†‘\n ```\n\n- 7 is unmarked and is therefore a prime.\n\n ```text\n 2 3 [4] 5 [6] 7 [8] [9] [10]\n ā†‘\n ```\n\n- 8 is marked as \"not prime\", so we skip over it.\n\n ```text\n 2 3 [4] 5 [6] 7 [8] [9] [10]\n ā†‘\n ```\n\n- 9 is marked as \"not prime\", so we skip over it.\n\n ```text\n 2 3 [4] 5 [6] 7 [8] [9] [10]\n ā†‘\n ```\n\n- 10 is marked as \"not prime\", so we stop as there are no more numbers to check.\n\n ```text\n 2 3 [4] 5 [6] 7 [8] [9] [10]\n ā†‘\n ```\n\nYou've examined all the numbers and found that 2, 3, 5, and 7 are still unmarked, meaning they're the primes less than or equal to 10.\n" }, { "path": "exercises/practice/sieve/.docs/introduction.md", "content": "# Introduction\n\nYou bought a big box of random computer parts at a garage sale.\nYou've started putting the parts together to build custom computers.\n\nYou want to test the performance of different combinations of parts, and decide to create your own benchmarking program to see how your computers compare.\nYou choose the famous \"Sieve of Eratosthenes\" algorithm, an ancient algorithm, but one that should push your computers to the limits.\n" }, { "path": "exercises/practice/sieve/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"sieve.ts\"\n ],\n \"test\": [\n \"sieve.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Use the Sieve of Eratosthenes to find all the primes from 2 up to a given number.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": true,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Sieve of Eratosthenes at Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Sieve_of_Eratosthenes\"\n}\n" }, { "path": "exercises/practice/sieve/.meta/proof.ci.ts", "content": "export function primes(limit: number): number[] {\n if (limit === 2) {\n return [limit]\n }\n\n const sieve: boolean[] = []\n for (let i = 0; i < limit; i++) {\n sieve[i] = true\n }\n\n const found: number[] = []\n const maxCandidate = Math.floor(Math.sqrt(limit))\n for (let candidate = 2; candidate <= maxCandidate + 1; candidate++) {\n if (!sieve[candidate - 1]) {\n continue\n }\n\n found.push(candidate)\n let multiple = candidate * candidate\n while (multiple <= limit) {\n sieve[multiple - 1] = false\n multiple += candidate\n }\n }\n\n for (let i = maxCandidate + 1; i <= limit; i++) {\n if (sieve[i - 1]) {\n found.push(i)\n }\n }\n\n return found\n}\n" }, { "path": "exercises/practice/sieve/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[88529125-c4ce-43cc-bb36-1eb4ddd7b44f]\ndescription = \"no primes under two\"\n\n[4afe9474-c705-4477-9923-840e1024cc2b]\ndescription = \"find first prime\"\n\n[974945d8-8cd9-4f00-9463-7d813c7f17b7]\ndescription = \"find primes up to 10\"\n\n[2e2417b7-3f3a-452a-8594-b9af08af6d82]\ndescription = \"limit is prime\"\n\n[92102a05-4c7c-47de-9ed0-b7d5fcd00f21]\ndescription = \"find primes up to 1000\"\n" }, { "path": "exercises/practice/sieve/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/sieve/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/sieve/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/sieve/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/sieve/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/sieve/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/sieve/package.json", "content": "{\n \"name\": \"@exercism/typescript-sieve\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/sieve/sieve.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { primes } from './sieve.ts'\n\ndescribe('Sieve', () => {\n it('no primes under two', () => {\n const expected: number[] = []\n expect(primes(1)).toEqual(expected)\n })\n\n xit('find first prime', () => {\n const expected = [2]\n expect(primes(2)).toEqual(expected)\n })\n\n xit('find primes up to 10', () => {\n const expected = [2, 3, 5, 7]\n expect(primes(10)).toEqual(expected)\n })\n\n xit('limit is prime', () => {\n const expected = [2, 3, 5, 7, 11, 13]\n expect(primes(13)).toEqual(expected)\n })\n\n xit('find primes up to 1000', () => {\n const expected: number[] = [\n 2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67,\n 71, 73, 79, 83, 89, 97, 101, 103, 107, 109, 113, 127, 131, 137, 139, 149,\n 151, 157, 163, 167, 173, 179, 181, 191, 193, 197, 199, 211, 223, 227, 229,\n 233, 239, 241, 251, 257, 263, 269, 271, 277, 281, 283, 293, 307, 311, 313,\n 317, 331, 337, 347, 349, 353, 359, 367, 373, 379, 383, 389, 397, 401, 409,\n 419, 421, 431, 433, 439, 443, 449, 457, 461, 463, 467, 479, 487, 491, 499,\n 503, 509, 521, 523, 541, 547, 557, 563, 569, 571, 577, 587, 593, 599, 601,\n 607, 613, 617, 619, 631, 641, 643, 647, 653, 659, 661, 673, 677, 683, 691,\n 701, 709, 719, 727, 733, 739, 743, 751, 757, 761, 769, 773, 787, 797, 809,\n 811, 821, 823, 827, 829, 839, 853, 857, 859, 863, 877, 881, 883, 887, 907,\n 911, 919, 929, 937, 941, 947, 953, 967, 971, 977, 983, 991, 997,\n ]\n expect(primes(1000)).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/sieve/sieve.ts", "content": "export function primes() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/sieve/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/sieve/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/simple-cipher/.docs/instructions.md", "content": "# Instructions\n\nCreate an implementation of the [VigenĆØre cipher][wiki].\nThe VigenĆØre cipher is a simple substitution cipher.\n\n## Cipher terminology\n\nA cipher is an algorithm used to encrypt, or encode, a string.\nThe unencrypted string is called the _plaintext_ and the encrypted string is called the _ciphertext_.\nConverting plaintext to ciphertext is called _encoding_ while the reverse is called _decoding_.\n\nIn a _substitution cipher_, each plaintext letter is replaced with a ciphertext letter which is computed with the help of a _key_.\n(Note, it is possible for replacement letter to be the same as the original letter.)\n\n## Encoding details\n\nIn this cipher, the key is a series of lowercase letters, such as `\"abcd\"`.\nEach letter of the plaintext is _shifted_ or _rotated_ by a distance based on a corresponding letter in the key.\nAn `\"a\"` in the key means a shift of 0 (that is, no shift).\nA `\"b\"` in the key means a shift of 1.\nA `\"c\"` in the key means a shift of 2, and so on.\n\nThe first letter of the plaintext uses the first letter of the key, the second letter of the plaintext uses the second letter of the key and so on.\nIf you run out of letters in the key before you run out of letters in the plaintext, start over from the start of the key again.\n\nIf the key only contains one letter, such as `\"dddddd\"`, then all letters of the plaintext are shifted by the same amount (three in this example), which would make this the same as a rotational cipher or shift cipher (sometimes called a Caesar cipher).\nFor example, the plaintext `\"iamapandabear\"` would become `\"ldpdsdqgdehdu\"`.\n\nIf the key only contains the letter `\"a\"` (one or more times), the shift distance is zero and the ciphertext is the same as the plaintext.\n\nUsually the key is more complicated than that, though!\nIf the key is `\"abcd\"` then letters of the plaintext would be shifted by a distance of 0, 1, 2, and 3.\nIf the plaintext is `\"hello\"`, we need 5 shifts so the key would wrap around, giving shift distances of 0, 1, 2, 3, and 0.\nApplying those shifts to the letters of `\"hello\"` we get `\"hfnoo\"`.\n\n## Random keys\n\nIf no key is provided, generate a key which consists of at least 100 random lowercase letters from the Latin alphabet.\n\n[wiki]: https://en.wikipedia.org/wiki/Vigen%C3%A8re_cipher\n" }, { "path": "exercises/practice/simple-cipher/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"daveyarwood\",\n \"janczer\",\n \"masters3d\",\n \"SleeplessByte\",\n \"tekerson\"\n ],\n \"files\": {\n \"solution\": [\n \"simple-cipher.ts\"\n ],\n \"test\": [\n \"simple-cipher.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement the VigenĆØre cipher, a simple substitution cipher.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Substitution Cipher at Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Substitution_cipher\"\n}\n" }, { "path": "exercises/practice/simple-cipher/.meta/proof.ci.ts", "content": "export class SimpleCipher {\n public key: string\n\n constructor(key?: string) {\n if (key === undefined) {\n this.key = ''\n\n for (let i = 0; i < 100; i++) {\n this.key += String.fromCharCode(Math.random() * 26 + 97)\n }\n } else if (!/^[a-z]+$/.test(key)) {\n throw new Error('Bad key')\n } else {\n this.key = key\n }\n }\n\n public encode(decodedMessage: string): string {\n let encodedMessage = ''\n for (let i = 0; i < decodedMessage.length; i++) {\n let encodedChar = String.fromCharCode(\n decodedMessage.charCodeAt(i) +\n (this.key.charCodeAt(i % this.key.length) - 97)\n )\n if (encodedChar.charCodeAt(0) > 122) {\n encodedChar = String.fromCharCode(encodedChar.charCodeAt(0) - 26)\n }\n encodedMessage += encodedChar\n }\n return encodedMessage\n }\n\n public decode(encodedMessage: string): string {\n let decodedMessage = ''\n for (let i = 0; i < encodedMessage.length; i++) {\n let decodedChar = String.fromCharCode(\n encodedMessage.charCodeAt(i) -\n (this.key.charCodeAt(i % this.key.length) - 97)\n )\n if (decodedChar.charCodeAt(0) < 97) {\n decodedChar = String.fromCharCode(decodedChar.charCodeAt(0) + 26)\n }\n decodedMessage += decodedChar\n }\n return decodedMessage\n }\n}\n" }, { "path": "exercises/practice/simple-cipher/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[b8bdfbe1-bea3-41bb-a999-b41403f2b15d]\ndescription = \"Can encode\"\n\n[3dff7f36-75db-46b4-ab70-644b3f38b81c]\ndescription = \"Can decode\"\n\n[8143c684-6df6-46ba-bd1f-dea8fcb5d265]\ndescription = \"Is reversible. I.e., if you apply decode in a encoded result, you must see the same plaintext encode parameter as a result of the decode method\"\n\n[defc0050-e87d-4840-85e4-51a1ab9dd6aa]\ndescription = \"Key is made only of lowercase letters\"\n\n[565e5158-5b3b-41dd-b99d-33b9f413c39f]\ndescription = \"Can encode\"\n\n[d44e4f6a-b8af-4e90-9d08-fd407e31e67b]\ndescription = \"Can decode\"\n\n[70a16473-7339-43df-902d-93408c69e9d1]\ndescription = \"Is reversible. I.e., if you apply decode in a encoded result, you must see the same plaintext encode parameter as a result of the decode method\"\n\n[69a1458b-92a6-433a-a02d-7beac3ea91f9]\ndescription = \"Can double shift encode\"\n\n[21d207c1-98de-40aa-994f-86197ae230fb]\ndescription = \"Can wrap on encode\"\n\n[a3d7a4d7-24a9-4de6-bdc4-a6614ced0cb3]\ndescription = \"Can wrap on decode\"\n\n[e31c9b8c-8eb6-45c9-a4b5-8344a36b9641]\ndescription = \"Can encode messages longer than the key\"\n\n[93cfaae0-17da-4627-9a04-d6d1e1be52e3]\ndescription = \"Can decode messages longer than the key\"\n" }, { "path": "exercises/practice/simple-cipher/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/simple-cipher/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/simple-cipher/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/simple-cipher/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/simple-cipher/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/simple-cipher/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/simple-cipher/package.json", "content": "{\n \"name\": \"@exercism/typescript-simple-cipher\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/simple-cipher/simple-cipher.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { SimpleCipher } from './simple-cipher.ts'\n\ndescribe('Random key generation', () => {\n xit('generates keys at random', () => {\n // Strictly speaking, this is difficult to test with 100% certainty.\n // But, if you have a generator that generates 100-character-long\n // strings of lowercase letters at random, the odds of two consecutively\n // generated keys being identical are astronomically low.\n expect(new SimpleCipher().key).not.toEqual(new SimpleCipher().key)\n })\n})\n\nxdescribe('Random key cipher', () => {\n const simpleCipher = new SimpleCipher()\n\n it('has a key made of letters', () => {\n expect(simpleCipher.key).toMatch(/^[a-z]+$/)\n })\n\n xit('has a key that is at least 100 characters long', () => {\n expect(simpleCipher.key.length).toBeGreaterThanOrEqual(100)\n })\n\n // Here we take advantage of the fact that plaintext of \"aaa...\"\n // outputs the key. This is a critical problem with shift ciphers, some\n // characters will always output the key verbatim.\n xit('can encode', () => {\n expect(simpleCipher.encode('aaaaaaaaaa')).toEqual(\n simpleCipher.key.substring(0, 10)\n )\n })\n\n xit('can decode', () => {\n expect(simpleCipher.decode(simpleCipher.key.substring(0, 10))).toEqual(\n 'aaaaaaaaaa'\n )\n })\n\n xit('is reversible', () => {\n const plaintext = 'abcdefghij'\n expect(simpleCipher.decode(simpleCipher.encode(plaintext))).toEqual(\n plaintext\n )\n })\n})\n\nxdescribe('Substitution cipher', () => {\n const key = 'abcdefghij'\n const simpleCipher = new SimpleCipher(key)\n\n xit('keeps the submitted key', () => {\n expect(simpleCipher.key).toEqual(key)\n })\n\n xit('can encode', () => {\n expect(simpleCipher.encode('aaaaaaaaaa')).toEqual('abcdefghij')\n })\n\n xit('can decode', () => {\n expect(simpleCipher.decode('abcdefghij')).toEqual('aaaaaaaaaa')\n })\n\n xit('is reversible', () => {\n expect(simpleCipher.decode(simpleCipher.encode('abcdefghij'))).toEqual(\n 'abcdefghij'\n )\n })\n\n xit(': double shift encode', () => {\n expect(new SimpleCipher('iamapandabear').encode('iamapandabear')).toEqual(\n 'qayaeaagaciai'\n )\n })\n\n xit('can wrap on encode', () => {\n expect(simpleCipher.encode('zzzzzzzzzz')).toEqual('zabcdefghi')\n })\n\n xit('can wrap on decode', () => {\n expect(simpleCipher.decode('zabcdefghi')).toEqual('zzzzzzzzzz')\n })\n\n xit('can encode messages longer than the key\"', () => {\n expect(new SimpleCipher('abc').encode('iamapandabear')).toEqual(\n 'iboaqcnecbfcr'\n )\n })\n\n xit('can decode messages longer than the key', () => {\n expect(new SimpleCipher('abc').decode('iboaqcnecbfcr')).toEqual(\n 'iamapandabear'\n )\n })\n})\n" }, { "path": "exercises/practice/simple-cipher/simple-cipher.ts", "content": "export class SimpleCipher {\n encode(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n }\n\n decode(/* Parameters go here */) {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/simple-cipher/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/simple-cipher/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/space-age/.docs/instructions.md", "content": "# Instructions\n\nGiven an age in seconds, calculate how old someone would be on a planet in our Solar System.\n\nOne Earth year equals 365.25 Earth days, or 31,557,600 seconds.\nIf you were told someone was 1,000,000,000 seconds old, their age would be 31.69 Earth-years.\n\nFor the other planets, you have to account for their orbital period in Earth Years:\n\n| Planet | Orbital period in Earth Years |\n| ------- | ----------------------------- |\n| Mercury | 0.2408467 |\n| Venus | 0.61519726 |\n| Earth | 1.0 |\n| Mars | 1.8808158 |\n| Jupiter | 11.862615 |\n| Saturn | 29.447498 |\n| Uranus | 84.016846 |\n| Neptune | 164.79132 |\n\n~~~~exercism/note\nThe actual length of one complete orbit of the Earth around the sun is closer to 365.256 days (1 sidereal year).\nThe Gregorian calendar has, on average, 365.2425 days.\nWhile not entirely accurate, 365.25 is the value used in this exercise.\nSee [Year on Wikipedia][year] for more ways to measure a year.\n\n[year]: https://en.wikipedia.org/wiki/Year#Summary\n~~~~\n" }, { "path": "exercises/practice/space-age/.docs/introduction.md", "content": "# Introduction\n\nThe year is 2525 and you've just embarked on a journey to visit all planets in the Solar System (Mercury, Venus, Earth, Mars, Jupiter, Saturn, Uranus and Neptune).\nThe first stop is Mercury, where customs require you to fill out a form (bureaucracy is apparently _not_ Earth-specific).\nAs you hand over the form to the customs officer, they scrutinize it and frown.\n\"Do you _really_ expect me to believe you're just 50 years old?\nYou must be closer to 200 years old!\"\n\nAmused, you wait for the customs officer to start laughing, but they appear to be dead serious.\nYou realize that you've entered your age in _Earth years_, but the officer expected it in _Mercury years_!\nAs Mercury's orbital period around the sun is significantly shorter than Earth, you're actually a lot older in Mercury years.\nAfter some quick calculations, you're able to provide your age in Mercury Years.\nThe customs officer smiles, satisfied, and waves you through.\nYou make a mental note to pre-calculate your planet-specific age _before_ future customs checks, to avoid such mix-ups.\n\n~~~~exercism/note\nIf you're wondering why Pluto didn't make the cut, go watch [this YouTube video][pluto-video].\n\n[pluto-video]: https://www.youtube.com/watch?v=Z_2gbGXzFbs\n~~~~\n" }, { "path": "exercises/practice/space-age/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"space-age.ts\"\n ],\n \"test\": [\n \"space-age.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given an age in seconds, calculate how old someone is in terms of a given planet's solar years.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Partially inspired by Chapter 1 in Chris Pine's online Learn to Program tutorial.\",\n \"source_url\": \"https://pine.fm/LearnToProgram/chap_01.html\"\n}\n" }, { "path": "exercises/practice/space-age/.meta/proof.ci.ts", "content": "const EARTH_TO_OTHER_PLANETS = {\n mercury: 0.2408467,\n venus: 0.61519726,\n earth: 1,\n mars: 1.8808158,\n jupiter: 11.862615,\n saturn: 29.447498,\n uranus: 84.016846,\n neptune: 164.79132,\n}\n\nexport const age = (\n planet: keyof typeof EARTH_TO_OTHER_PLANETS,\n seconds: number\n): number => {\n const earthYears = seconds / 31557600\n const years = earthYears / EARTH_TO_OTHER_PLANETS[planet]\n\n return Number(years.toFixed(2))\n}\n" }, { "path": "exercises/practice/space-age/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[84f609af-5a91-4d68-90a3-9e32d8a5cd34]\ndescription = \"age on Earth\"\n\n[ca20c4e9-6054-458c-9312-79679ffab40b]\ndescription = \"age on Mercury\"\n\n[502c6529-fd1b-41d3-8fab-65e03082b024]\ndescription = \"age on Venus\"\n\n[9ceadf5e-a0d5-4388-9d40-2c459227ceb8]\ndescription = \"age on Mars\"\n\n[42927dc3-fe5e-4f76-a5b5-f737fc19bcde]\ndescription = \"age on Jupiter\"\n\n[8469b332-7837-4ada-b27c-00ee043ebcad]\ndescription = \"age on Saturn\"\n\n[999354c1-76f8-4bb5-a672-f317b6436743]\ndescription = \"age on Uranus\"\n\n[80096d30-a0d4-4449-903e-a381178355d8]\ndescription = \"age on Neptune\"\n\n[57b96e2a-1178-40b7-b34d-f3c9c34e4bf4]\ndescription = \"invalid planet causes error\"\ninclude = false\n" }, { "path": "exercises/practice/space-age/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/space-age/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/space-age/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/space-age/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/space-age/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/space-age/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/space-age/package.json", "content": "{\n \"name\": \"@exercism/typescript-space-age\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/space-age/space-age.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { age } from './space-age.ts'\n\ndescribe('Space Age', () => {\n it('age on Earth', () => {\n expect(age('earth', 1000000000)).toEqual(31.69)\n })\n\n xit('age on Mercury', () => {\n expect(age('mercury', 2134835688)).toEqual(280.88)\n })\n\n xit('age on Venus', () => {\n expect(age('venus', 189839836)).toEqual(9.78)\n })\n\n xit('age on Mars', () => {\n expect(age('mars', 2129871239)).toEqual(35.88)\n })\n\n xit('age on Jupiter', () => {\n expect(age('jupiter', 901876382)).toEqual(2.41)\n })\n\n xit('age on Saturn', () => {\n expect(age('saturn', 2000000000)).toEqual(2.15)\n })\n\n xit('age on Uranus', () => {\n expect(age('uranus', 1210123456)).toEqual(0.46)\n })\n\n xit('age on Neptune', () => {\n expect(age('neptune', 1821023456)).toEqual(0.35)\n })\n})\n" }, { "path": "exercises/practice/space-age/space-age.ts", "content": "export function age(planet: unknown, seconds: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/space-age/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/space-age/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/spiral-matrix/.docs/instructions.md", "content": "# Instructions\n\nYour task is to return a square matrix of a given size.\n\nThe matrix should be filled with natural numbers, starting from 1 in the top-left corner, increasing in an inward, clockwise spiral order, like these examples:\n\n## Examples\n\n### Spiral matrix of size 3\n\n```text\n1 2 3\n8 9 4\n7 6 5\n```\n\n### Spiral matrix of size 4\n\n```text\n 1 2 3 4\n12 13 14 5\n11 16 15 6\n10 9 8 7\n```\n" }, { "path": "exercises/practice/spiral-matrix/.docs/introduction.md", "content": "# Introduction\n\nIn a small village near an ancient forest, there was a legend of a hidden treasure buried deep within the woods.\nDespite numerous attempts, no one had ever succeeded in finding it.\nThis was about to change, however, thanks to a young explorer named Elara.\nShe had discovered an old document containing instructions on how to locate the treasure.\nUsing these instructions, Elara was able to draw a map that revealed the path to the treasure.\n\nTo her surprise, the path followed a peculiar clockwise spiral.\nIt was no wonder no one had been able to find the treasure before!\nWith the map in hand, Elara embarks on her journey to uncover the hidden treasure.\n" }, { "path": "exercises/practice/spiral-matrix/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"spiral-matrix.ts\"\n ],\n \"test\": [\n \"spiral-matrix.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given the size, return a square matrix of numbers in spiral order.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Reddit r/dailyprogrammer challenge #320 [Easy] Spiral Ascension.\",\n \"source_url\": \"https://web.archive.org/web/20230607064729/https://old.reddit.com/r/dailyprogrammer/comments/6i60lr/20170619_challenge_320_easy_spiral_ascension/\"\n}\n" }, { "path": "exercises/practice/spiral-matrix/.meta/proof.ci.ts", "content": "export function ofSize(size: number): number[][] {\n const spiral = Array(size)\n .fill(Array())\n .map(() => Array(size).fill(0))\n\n const totalNumbers = size ** 2\n let currentNumber = 1\n let topLeft = 0\n let bottomRight = size - 1\n\n while (currentNumber <= totalNumbers) {\n for (let x = topLeft; x <= bottomRight; x++) {\n spiral[topLeft][x] = currentNumber++\n }\n for (let y = topLeft + 1; y <= bottomRight; y++) {\n spiral[y][bottomRight] = currentNumber++\n }\n for (let x = bottomRight - 1; x >= topLeft; x--) {\n spiral[bottomRight][x] = currentNumber++\n }\n for (let y = bottomRight - 1; y >= topLeft + 1; y--) {\n spiral[y][topLeft] = currentNumber++\n }\n topLeft++\n bottomRight--\n }\n\n return spiral\n}\n" }, { "path": "exercises/practice/spiral-matrix/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[8f584201-b446-4bc9-b132-811c8edd9040]\ndescription = \"empty spiral\"\n\n[e40ae5f3-e2c9-4639-8116-8a119d632ab2]\ndescription = \"trivial spiral\"\n\n[cf05e42d-eb78-4098-a36e-cdaf0991bc48]\ndescription = \"spiral of size 2\"\n\n[1c475667-c896-4c23-82e2-e033929de939]\ndescription = \"spiral of size 3\"\n\n[05ccbc48-d891-44f5-9137-f4ce462a759d]\ndescription = \"spiral of size 4\"\n\n[f4d2165b-1738-4e0c-bed0-c459045ae50d]\ndescription = \"spiral of size 5\"\n" }, { "path": "exercises/practice/spiral-matrix/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/spiral-matrix/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/spiral-matrix/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/spiral-matrix/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/spiral-matrix/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/spiral-matrix/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/spiral-matrix/package.json", "content": "{\n \"name\": \"@exercism/typescript-spiral-matrix\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/spiral-matrix/spiral-matrix.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { ofSize } from './spiral-matrix.ts'\n\ndescribe('Spiral Matrix', () => {\n it('empty spiral', () => {\n const expected: number[][] = []\n const actual = ofSize(0)\n expect(actual).toEqual(expected)\n })\n\n xit('trivial spiral', () => {\n const expected = [[1]]\n const actual = ofSize(1)\n expect(actual).toEqual(expected)\n })\n\n xit('spiral of size 2', () => {\n const expected = [\n [1, 2],\n [4, 3],\n ]\n const actual = ofSize(2)\n expect(actual).toEqual(expected)\n })\n\n xit('spiral of size 3', () => {\n const expected = [\n [1, 2, 3],\n [8, 9, 4],\n [7, 6, 5],\n ]\n const actual = ofSize(3)\n expect(actual).toEqual(expected)\n })\n\n xit('spiral of size 4', () => {\n const expected = [\n [1, 2, 3, 4],\n [12, 13, 14, 5],\n [11, 16, 15, 6],\n [10, 9, 8, 7],\n ]\n const actual = ofSize(4)\n expect(actual).toEqual(expected)\n })\n\n xit('spiral of size 5', () => {\n const expected = [\n [1, 2, 3, 4, 5],\n [16, 17, 18, 19, 6],\n [15, 24, 25, 20, 7],\n [14, 23, 22, 21, 8],\n [13, 12, 11, 10, 9],\n ]\n const actual = ofSize(5)\n expect(expected).toEqual(actual)\n })\n})\n" }, { "path": "exercises/practice/spiral-matrix/spiral-matrix.ts", "content": "export function ofSize() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/spiral-matrix/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/spiral-matrix/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/split-second-stopwatch/.docs/instructions.md", "content": "# Instructions\n\nYour task is to build a stopwatch to keep precise track of lap times.\n\nThe stopwatch uses four commands (start, stop, lap, and reset) to keep track of:\n\n1. The current lap's tracked time\n2. Previously recorded lap times\n\nWhat commands can be used depends on which state the stopwatch is in:\n\n1. Ready: initial state\n2. Running: tracking time\n3. Stopped: not tracking time\n\n| Command | Begin state | End state | Effect |\n| ------- | ----------- | --------- | -------------------------------------------------------- |\n| Start | Ready | Running | Start tracking time |\n| Start | Stopped | Running | Resume tracking time |\n| Stop | Running | Stopped | Stop tracking time |\n| Lap | Running | Running | Add current lap to previous laps, then reset current lap |\n| Reset | Stopped | Ready | Reset current lap and clear previous laps |\n" }, { "path": "exercises/practice/split-second-stopwatch/.docs/introduction.md", "content": "# Introduction\n\nYou've always run for the thrill of it ā€” no schedules, no timers, just the sound of your feet on the pavement.\nBut now that you've joined a competitive running crew, things are getting serious.\nTraining sessions are timed to the second, and every split second counts.\nTo keep pace, you've picked up the _Split-Second Stopwatch_ ā€” a sleek, high-tech gadget that's about to become your new best friend.\n" }, { "path": "exercises/practice/split-second-stopwatch/.meta/config.json", "content": "{\n \"authors\": [\n \"BNAndras\"\n ],\n \"files\": {\n \"solution\": [\n \"split-second-stopwatch.ts\"\n ],\n \"test\": [\n \"split-second-stopwatch.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Keep track of time through a digital stopwatch.\",\n \"source\": \"Erik Schierboom\",\n \"source_url\": \"https://github.com/exercism/problem-specifications/pull/2547\"\n}\n" }, { "path": "exercises/practice/split-second-stopwatch/.meta/proof.ci.ts", "content": "export type State = 'ready' | 'running' | 'stopped'\n\nexport class SplitSecondStopwatch {\n private _state: State = 'ready'\n private totalSeconds = 0\n private currentLapSeconds = 0\n private previousLapSeconds: number[] = []\n\n public get state(): State {\n return this._state\n }\n\n public get currentLap(): string {\n return this.formatTime(this.currentLapSeconds)\n }\n\n public get total(): string {\n return this.formatTime(this.totalSeconds)\n }\n\n public get previousLaps(): string[] {\n return this.previousLapSeconds.map((s) => this.formatTime(s))\n }\n\n public start(): void {\n if (this._state === 'running') {\n throw new Error('cannot start an already running stopwatch')\n }\n this._state = 'running'\n }\n\n public stop(): void {\n if (this._state !== 'running') {\n throw new Error('cannot stop a stopwatch that is not running')\n }\n this._state = 'stopped'\n }\n\n public lap(): void {\n if (this._state !== 'running') {\n throw new Error('cannot lap a stopwatch that is not running')\n }\n this.previousLapSeconds.push(this.currentLapSeconds)\n this.currentLapSeconds = 0\n }\n\n public reset(): void {\n if (this._state !== 'stopped') {\n throw new Error('cannot reset a stopwatch that is not stopped')\n }\n this._state = 'ready'\n this.totalSeconds = 0\n this.currentLapSeconds = 0\n this.previousLapSeconds = []\n }\n\n public advanceTime(duration: string): void {\n if (this._state === 'running') {\n const seconds = this.toSeconds(duration)\n this.currentLapSeconds += seconds\n this.totalSeconds += seconds\n }\n }\n\n private toSeconds(duration: string): number {\n const [h, m, s] = duration.split(':').map(Number)\n return h * 3600 + m * 60 + s\n }\n\n private formatTime(seconds: number): string {\n const h = Math.floor(seconds / 3600)\n const m = Math.floor((seconds % 3600) / 60)\n const s = seconds % 60\n\n return `${String(h).padStart(2, '0')}:${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')}`\n }\n}\n" }, { "path": "exercises/practice/split-second-stopwatch/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[ddb238ea-99d4-4eaa-a81d-3c917a525a23]\ndescription = \"new stopwatch starts in ready state\"\n\n[b19635d4-08ad-4ac3-b87f-aca10e844071]\ndescription = \"new stopwatch's current lap has no elapsed time\"\n\n[492eb532-268d-43ea-8a19-2a032067d335]\ndescription = \"new stopwatch's total has no elapsed time\"\n\n[8a892c1e-9ef7-4690-894e-e155a1fe4484]\ndescription = \"new stopwatch does not have previous laps\"\n\n[5b2705b6-a584-4042-ba3a-4ab8d0ab0281]\ndescription = \"start from ready state changes state to running\"\n\n[748235ce-1109-440b-9898-0a431ea179b6]\ndescription = \"start does not change previous laps\"\n\n[491487b1-593d-423e-a075-aa78d449ff1f]\ndescription = \"start initiates time tracking for current lap\"\n\n[a0a7ba2c-8db6-412c-b1b6-cb890e9b72ed]\ndescription = \"start initiates time tracking for total\"\n\n[7f558a17-ef6d-4a5b-803a-f313af7c41d3]\ndescription = \"start cannot be called from running state\"\n\n[32466eef-b2be-4d60-a927-e24fce52dab9]\ndescription = \"stop from running state changes state to stopped\"\n\n[621eac4c-8f43-4d99-919c-4cad776d93df]\ndescription = \"stop pauses time tracking for current lap\"\n\n[465bcc82-7643-41f2-97ff-5e817cef8db4]\ndescription = \"stop pauses time tracking for total\"\n\n[b1ba7454-d627-41ee-a078-891b2ed266fc]\ndescription = \"stop cannot be called from ready state\"\n\n[5c041078-0898-44dc-9d5b-8ebb5352626c]\ndescription = \"stop cannot be called from stopped state\"\n\n[3f32171d-8fbf-46b6-bc2b-0810e1ec53b7]\ndescription = \"start from stopped state changes state to running\"\n\n[626997cb-78d5-4fe8-b501-29fdef804799]\ndescription = \"start from stopped state resumes time tracking for current lap\"\n\n[58487c53-ab26-471c-a171-807ef6363319]\ndescription = \"start from stopped state resumes time tracking for total\"\n\n[091966e3-ed25-4397-908b-8bb0330118f8]\ndescription = \"lap adds current lap to previous laps\"\n\n[1aa4c5ee-a7d5-4d59-9679-419deef3c88f]\ndescription = \"lap resets current lap and resumes time tracking\"\n\n[4b46b92e-1b3f-46f6-97d2-0082caf56e80]\ndescription = \"lap continues time tracking for total\"\n\n[ea75d36e-63eb-4f34-97ce-8c70e620bdba]\ndescription = \"lap cannot be called from ready state\"\n\n[63731154-a23a-412d-a13f-c562f208eb1e]\ndescription = \"lap cannot be called from stopped state\"\n\n[e585ee15-3b3f-4785-976b-dd96e7cc978b]\ndescription = \"stop does not change previous laps\"\n\n[fc3645e2-86cf-4d11-97c6-489f031103f6]\ndescription = \"reset from stopped state changes state to ready\"\n\n[20fbfbf7-68ad-4310-975a-f5f132886c4e]\ndescription = \"reset resets current lap\"\n\n[00a8f7bb-dd5c-43e5-8705-3ef124007662]\ndescription = \"reset clears previous laps\"\n\n[76cea936-6214-4e95-b6d1-4d4edcf90499]\ndescription = \"reset cannot be called from ready state\"\n\n[ba4d8e69-f200-4721-b59e-90d8cf615153]\ndescription = \"reset cannot be called from running state\"\n\n[0b01751a-cb57-493f-bb86-409de6e84306]\ndescription = \"supports very long laps\"\n" }, { "path": "exercises/practice/split-second-stopwatch/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/split-second-stopwatch/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/split-second-stopwatch/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/split-second-stopwatch/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/split-second-stopwatch/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/split-second-stopwatch/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/split-second-stopwatch/package.json", "content": "{\n \"name\": \"@exercism/typescript-split-second-stopwatch\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/split-second-stopwatch/split-second-stopwatch.test.ts", "content": "import { describe, expect, it, xit } from '@jest/globals'\nimport { SplitSecondStopwatch } from './split-second-stopwatch.ts'\n\ndescribe('SplitSecondStopwatch', () => {\n it('new stopwatch starts in ready state', () => {\n const stopwatch = new SplitSecondStopwatch()\n expect(stopwatch.state).toBe('ready')\n })\n\n xit(\"new stopwatch's current lap has no elapsed time\", () => {\n const stopwatch = new SplitSecondStopwatch()\n expect(stopwatch.currentLap).toBe('00:00:00')\n })\n\n xit(\"new stopwatch's total has no elapsed time\", () => {\n const stopwatch = new SplitSecondStopwatch()\n expect(stopwatch.total).toBe('00:00:00')\n })\n\n xit('new stopwatch does not have previous laps', () => {\n const stopwatch = new SplitSecondStopwatch()\n expect(stopwatch.previousLaps).toEqual([])\n })\n\n xit('start from ready state changes state to running', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n expect(stopwatch.state).toBe('running')\n })\n\n xit('start does not change previous laps', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n expect(stopwatch.previousLaps).toEqual([])\n })\n\n xit('start initiates time tracking for current lap', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:00:05')\n expect(stopwatch.currentLap).toBe('00:00:05')\n })\n\n xit('start initiates time tracking for total', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:00:23')\n expect(stopwatch.total).toBe('00:00:23')\n })\n\n xit('start cannot be called from running state', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n expect(() => stopwatch.start()).toThrow(\n 'cannot start an already running stopwatch'\n )\n })\n\n xit('stop from running state changes state to stopped', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.stop()\n expect(stopwatch.state).toBe('stopped')\n })\n\n xit('stop pauses time tracking for current lap', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:00:05')\n stopwatch.stop()\n stopwatch.advanceTime('00:00:08')\n expect(stopwatch.currentLap).toBe('00:00:05')\n })\n\n xit('stop pauses time tracking for total', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:00:13')\n stopwatch.stop()\n stopwatch.advanceTime('00:00:44')\n expect(stopwatch.total).toBe('00:00:13')\n })\n\n xit('stop cannot be called from ready state', () => {\n const stopwatch = new SplitSecondStopwatch()\n expect(() => stopwatch.stop()).toThrow(\n 'cannot stop a stopwatch that is not running'\n )\n })\n\n xit('stop cannot be called from stopped state', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.stop()\n expect(() => stopwatch.stop()).toThrow(\n 'cannot stop a stopwatch that is not running'\n )\n })\n\n xit('start from stopped state changes state to running', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.stop()\n stopwatch.start()\n expect(stopwatch.state).toBe('running')\n })\n\n xit('start from stopped state resumes time tracking for current lap', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:01:20')\n stopwatch.stop()\n stopwatch.advanceTime('00:00:20')\n stopwatch.start()\n stopwatch.advanceTime('00:00:08')\n expect(stopwatch.currentLap).toBe('00:01:28')\n })\n\n xit('start from stopped state resumes time tracking for total', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:00:23')\n stopwatch.stop()\n stopwatch.advanceTime('00:00:44')\n stopwatch.start()\n stopwatch.advanceTime('00:00:09')\n expect(stopwatch.total).toBe('00:00:32')\n })\n\n xit('lap adds current lap to previous laps', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:01:38')\n stopwatch.lap()\n expect(stopwatch.previousLaps).toEqual(['00:01:38'])\n stopwatch.advanceTime('00:00:44')\n stopwatch.lap()\n expect(stopwatch.previousLaps).toEqual(['00:01:38', '00:00:44'])\n })\n\n xit('lap resets current lap and resumes time tracking', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:08:22')\n stopwatch.lap()\n expect(stopwatch.currentLap).toBe('00:00:00')\n stopwatch.advanceTime('00:00:15')\n expect(stopwatch.currentLap).toBe('00:00:15')\n })\n\n xit('lap continues time tracking for total', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:00:22')\n stopwatch.lap()\n stopwatch.advanceTime('00:00:33')\n expect(stopwatch.total).toBe('00:00:55')\n })\n\n xit('lap cannot be called from ready state', () => {\n const stopwatch = new SplitSecondStopwatch()\n expect(() => stopwatch.lap()).toThrow(\n 'cannot lap a stopwatch that is not running'\n )\n })\n\n xit('lap cannot be called from stopped state', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.stop()\n expect(() => stopwatch.lap()).toThrow(\n 'cannot lap a stopwatch that is not running'\n )\n })\n\n xit('stop does not change previous laps', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:11:22')\n stopwatch.lap()\n expect(stopwatch.previousLaps).toEqual(['00:11:22'])\n stopwatch.stop()\n expect(stopwatch.previousLaps).toEqual(['00:11:22'])\n })\n\n xit('reset from stopped state changes state to ready', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.stop()\n stopwatch.reset()\n expect(stopwatch.state).toBe('ready')\n })\n\n xit('reset resets current lap', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:00:10')\n stopwatch.stop()\n stopwatch.reset()\n expect(stopwatch.currentLap).toBe('00:00:00')\n })\n\n xit('reset clears previous laps', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('00:00:10')\n stopwatch.lap()\n stopwatch.advanceTime('00:00:20')\n stopwatch.lap()\n expect(stopwatch.previousLaps).toEqual(['00:00:10', '00:00:20'])\n stopwatch.stop()\n stopwatch.reset()\n expect(stopwatch.previousLaps).toEqual([])\n })\n\n xit('reset cannot be called from ready state', () => {\n const stopwatch = new SplitSecondStopwatch()\n expect(() => stopwatch.reset()).toThrow(\n 'cannot reset a stopwatch that is not stopped'\n )\n })\n\n xit('reset cannot be called from running state', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n expect(() => stopwatch.reset()).toThrow(\n 'cannot reset a stopwatch that is not stopped'\n )\n })\n\n xit('supports very long laps', () => {\n const stopwatch = new SplitSecondStopwatch()\n stopwatch.start()\n stopwatch.advanceTime('01:23:45')\n expect(stopwatch.currentLap).toBe('01:23:45')\n stopwatch.lap()\n expect(stopwatch.previousLaps).toEqual(['01:23:45'])\n stopwatch.advanceTime('04:01:40')\n expect(stopwatch.currentLap).toBe('04:01:40')\n expect(stopwatch.total).toBe('05:25:25')\n stopwatch.lap()\n expect(stopwatch.previousLaps).toEqual(['01:23:45', '04:01:40'])\n stopwatch.advanceTime('08:43:05')\n expect(stopwatch.currentLap).toBe('08:43:05')\n expect(stopwatch.total).toBe('14:08:30')\n stopwatch.lap()\n expect(stopwatch.previousLaps).toEqual(['01:23:45', '04:01:40', '08:43:05'])\n })\n})\n" }, { "path": "exercises/practice/split-second-stopwatch/split-second-stopwatch.ts", "content": "export class SplitSecondStopwatch {\n constructor() {\n throw new Error('Remove this line and implement the function')\n }\n\n public get state(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public get currentLap(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public get total(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public get previousLaps(): unknown[] {\n throw new Error('Remove this line and implement the function')\n }\n\n public start(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public stop(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public lap(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public reset(): unknown {\n throw new Error('Remove this line and implement the function')\n }\n\n public advanceTime(duration: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/split-second-stopwatch/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/split-second-stopwatch/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/square-root/.docs/instructions.md", "content": "# Instructions\n\nYour task is to calculate the square root of a given number.\n\n- Try to avoid using the pre-existing math libraries of your language.\n- As input you'll be given a positive whole number, i.e. 1, 2, 3, 4ā€¦\n- You are only required to handle cases where the result is a positive whole number.\n\nSome potential approaches:\n\n- Linear or binary search for a number that gives the input number when squared.\n- Successive approximation using Newton's or Heron's method.\n- Calculating one digit at a time or one bit at a time.\n\nYou can check out the Wikipedia pages on [integer square root][integer-square-root] and [methods of computing square roots][computing-square-roots] to help with choosing a method of calculation.\n\n[integer-square-root]: https://en.wikipedia.org/wiki/Integer_square_root\n[computing-square-roots]: https://en.wikipedia.org/wiki/Methods_of_computing_square_roots\n" }, { "path": "exercises/practice/square-root/.docs/introduction.md", "content": "# Introduction\n\nWe are launching a deep space exploration rocket and we need a way to make sure the navigation system stays on target.\n\nAs the first step in our calculation, we take a target number and find its square root (that is, the number that when multiplied by itself equals the target number).\n\nThe journey will be very long.\nTo make the batteries last as long as possible, we had to make our rocket's onboard computer very power efficient.\nUnfortunately that means that we can't rely on fancy math libraries and functions, as they use more power.\nInstead we want to implement our own square root calculation.\n" }, { "path": "exercises/practice/square-root/.meta/config.json", "content": "{\n \"authors\": [\n \"BNAndras\"\n ],\n \"files\": {\n \"solution\": [\n \"square-root.ts\"\n ],\n \"test\": [\n \"square-root.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a natural radicand, return its square root.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"wolf99\",\n \"source_url\": \"https://github.com/exercism/problem-specifications/pull/1582\"\n}\n" }, { "path": "exercises/practice/square-root/.meta/proof.ci.ts", "content": "export function squareRoot(radicand: number): number {\n if (radicand === 1) {\n return 1\n }\n\n let guess = Math.floor(radicand / 2)\n for (let i = 0; i < 10; i++) {\n guess = Math.floor((guess + radicand / guess) / 2)\n }\n\n return guess\n}\n" }, { "path": "exercises/practice/square-root/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[9b748478-7b0a-490c-b87a-609dacf631fd]\ndescription = \"root of 1\"\n\n[7d3aa9ba-9ac6-4e93-a18b-2e8b477139bb]\ndescription = \"root of 4\"\n\n[6624aabf-3659-4ae0-a1c8-25ae7f33c6ef]\ndescription = \"root of 25\"\n\n[93beac69-265e-4429-abb1-94506b431f81]\ndescription = \"root of 81\"\n\n[fbddfeda-8c4f-4bc4-87ca-6991af35360e]\ndescription = \"root of 196\"\n\n[c03d0532-8368-4734-a8e0-f96a9eb7fc1d]\ndescription = \"root of 65025\"\n" }, { "path": "exercises/practice/square-root/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/square-root/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/square-root/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/square-root/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/square-root/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/square-root/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/square-root/package.json", "content": "{\n \"name\": \"@exercism/typescript-square-root\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/square-root/square-root.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { squareRoot } from './square-root.ts'\n\ndescribe('Square Root', () => {\n // Root of 1\n it('root of 1', () => {\n expect(squareRoot(1)).toEqual(1)\n })\n\n // Root of 4\n xit('root of 4', () => {\n expect(squareRoot(4)).toEqual(2)\n })\n\n // Root of 25\n xit('root of 25', () => {\n expect(squareRoot(25)).toEqual(5)\n })\n\n // Root of 81\n xit('root of 81', () => {\n expect(squareRoot(81)).toEqual(9)\n })\n\n // Root of 196\n xit('root of 196', () => {\n expect(squareRoot(196)).toEqual(14)\n })\n\n // Root of 65025\n xit('root of 65025', () => {\n expect(squareRoot(65025)).toEqual(255)\n })\n})\n" }, { "path": "exercises/practice/square-root/square-root.ts", "content": "export function squareRoot(radicand: unknown): unknown {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/square-root/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/square-root/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/.docs/instructions.md", "content": "# Instructions\n\nIn this exercise, you're going to implement a program that determines the state of a [tic-tac-toe][] game.\n(_You may also know the game as \"noughts and crosses\" or \"Xs and Os\"._)\n\nThe game is played on a 3Ɨ3 grid.\nPlayers take turns to place `X`s and `O`s on the grid.\nThe game ends when one player has won by placing three of marks in a row, column, or along a diagonal of the grid, or when the entire grid is filled up.\n\nIn this exercise, we will assume that `X` starts.\n\nIt's your job to determine which state a given game is in.\n\nThere are 3 potential game states:\n\n- The game is **ongoing**.\n- The game ended in a **draw**.\n- The game ended in a **win**.\n\nIf the given board is invalid, throw an appropriate error.\n\nIf a board meets the following conditions, it is invalid:\n\n- The given board cannot be reached when turns are taken in the correct order (remember that `X` starts).\n- The game was played after it already ended.\n\n## Examples\n\n### Ongoing game\n\n```text\n | |\n X | |\n___|___|___\n | |\n | X | O\n___|___|___\n | |\n O | X |\n | |\n```\n\n### Draw\n\n```text\n | |\n X | O | X\n___|___|___\n | |\n X | X | O\n___|___|___\n | |\n O | X | O\n | |\n```\n\n### Win\n\n```text\n | |\n X | X | X\n___|___|___\n | |\n | O | O\n___|___|___\n | |\n | |\n | |\n```\n\n### Invalid\n\n#### Wrong turn order\n\n```text\n | |\n O | O | X\n___|___|___\n | |\n | |\n___|___|___\n | |\n | |\n | |\n```\n\n#### Continued playing after win\n\n```text\n | |\n X | X | X\n___|___|___\n | |\n O | O | O\n___|___|___\n | |\n | |\n | |\n```\n\n[tic-tac-toe]: https://en.wikipedia.org/wiki/Tic-tac-toe\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/.meta/config.json", "content": "{\n \"authors\": [\n \"Cool-Katt\"\n ],\n \"contributors\": [\n \"BNAndras\"\n ],\n \"files\": {\n \"solution\": [\n \"state-of-tic-tac-toe.ts\"\n ],\n \"test\": [\n \"state-of-tic-tac-toe.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Determine the game state of a match of Tic-Tac-Toe.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Created by Sascha Mann for the Julia track of the Exercism Research Experiment.\",\n \"source_url\": \"https://github.com/exercism/research_experiment_1/tree/julia-dev/exercises/julia-1-a\"\n}\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/.meta/proof.ci.ts", "content": "export const gamestate = (board: string[]): string => {\n const gridSize = board.length\n const numberOfX = (board.join('').match(/X/g) || []).length\n const numberOfO = (board.join('').match(/O/g) || []).length\n const scoringArray = Array(gridSize * 2 + 2).fill(0)\n\n const boardAsNumbers = board.flatMap((row) =>\n row.split('').map((element) => {\n if (element === 'X') return 1\n if (element === 'O') return -1\n return 0\n })\n )\n\n boardAsNumbers.forEach((element, index) => {\n const row = Math.floor(index / gridSize)\n const col = index % gridSize\n\n scoringArray[row] += element\n scoringArray[gridSize + col] += element\n if (row === col) {\n scoringArray[2 * gridSize] += element\n }\n if (gridSize - 1 - col === row) {\n scoringArray[2 * gridSize + 1] += element\n }\n })\n\n if (numberOfX - numberOfO > 1) {\n throw new Error('Wrong turn order: X went twice')\n }\n if (numberOfX - numberOfO < 0) {\n throw new Error('Wrong turn order: O started')\n }\n\n const xWins = scoringArray.some((score) => score === gridSize)\n const oWins = scoringArray.some((score) => score === -gridSize)\n\n if (xWins && oWins) {\n throw new Error(\n 'Impossible board: game should have ended after the game was won'\n )\n }\n if (xWins || oWins) {\n return 'win'\n }\n if (boardAsNumbers.includes(0)) {\n return 'ongoing'\n }\n return 'draw'\n}\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[fe8e9fa9-37af-4d7e-aa24-2f4b8517161a]\ndescription = \"Won games -> Finished game where X won via left column victory\"\n\n[96c30df5-ae23-4cf6-bf09-5ef056dddea1]\ndescription = \"Won games -> Finished game where X won via middle column victory\"\n\n[0d7a4b0a-2afd-4a75-8389-5fb88ab05eda]\ndescription = \"Won games -> Finished game where X won via right column victory\"\n\n[bd1007c0-ec5d-4c60-bb9f-1a4f22177d51]\ndescription = \"Won games -> Finished game where O won via left column victory\"\n\n[c032f800-5735-4354-b1b9-46f14d4ee955]\ndescription = \"Won games -> Finished game where O won via middle column victory\"\n\n[662c8902-c94a-4c4c-9d9c-e8ca513db2b4]\ndescription = \"Won games -> Finished game where O won via right column victory\"\n\n[2d62121f-7e3a-44a0-9032-0d73e3494941]\ndescription = \"Won games -> Finished game where X won via top row victory\"\n\n[108a5e82-cc61-409f-aece-d7a18c1beceb]\ndescription = \"Won games -> Finished game where X won via middle row victory\"\ninclude = false\n\n[346527db-4db9-4a96-b262-d7023dc022b0]\ndescription = \"Won games -> Finished game where X won via middle row victory\"\nreimplements = \"108a5e82-cc61-409f-aece-d7a18c1beceb\"\n\n[a013c583-75f8-4ab2-8d68-57688ff04574]\ndescription = \"Won games -> Finished game where X won via bottom row victory\"\n\n[2c08e7d7-7d00-487f-9442-e7398c8f1727]\ndescription = \"Won games -> Finished game where O won via top row victory\"\n\n[bb1d6c62-3e3f-4d1a-9766-f8803c8ed70f]\ndescription = \"Won games -> Finished game where O won via middle row victory\"\n\n[6ef641e9-12ec-44f5-a21c-660ea93907af]\ndescription = \"Won games -> Finished game where O won via bottom row victory\"\n\n[ab145b7b-26a7-426c-ab71-bf418cd07f81]\ndescription = \"Won games -> Finished game where X won via falling diagonal victory\"\n\n[7450caab-08f5-4f03-a74b-99b98c4b7a4b]\ndescription = \"Won games -> Finished game where X won via rising diagonal victory\"\n\n[c2a652ee-2f93-48aa-a710-a70cd2edce61]\ndescription = \"Won games -> Finished game where O won via falling diagonal victory\"\n\n[5b20ceea-494d-4f0c-a986-b99efc163bcf]\ndescription = \"Won games -> Finished game where O won via rising diagonal victory\"\n\n[035a49b9-dc35-47d3-9d7c-de197161b9d4]\ndescription = \"Won games -> Finished game where X won via a row and a column victory\"\n\n[e5dfdeb0-d2bf-4b5a-b307-e673f69d4a53]\ndescription = \"Won games -> Finished game where X won via two diagonal victories\"\n\n[b42ed767-194c-4364-b36e-efbfb3de8788]\ndescription = \"Drawn games -> Draw\"\n\n[227a76b2-0fef-4e16-a4bd-8f9d7e4c3b13]\ndescription = \"Drawn games -> Another draw\"\n\n[4d93f15c-0c40-43d6-b966-418b040012a9]\ndescription = \"Ongoing games -> Ongoing game: one move in\"\n\n[c407ae32-4c44-4989-b124-2890cf531f19]\ndescription = \"Ongoing games -> Ongoing game: two moves in\"\n\n[199b7a8d-e2b6-4526-a85e-78b416e7a8a9]\ndescription = \"Ongoing games -> Ongoing game: five moves in\"\n\n[1670145b-1e3d-4269-a7eb-53cd327b302e]\ndescription = \"Invalid boards -> Invalid board: X went twice\"\n\n[47c048e8-b404-4bcf-9e51-8acbb3253f3b]\ndescription = \"Invalid boards -> Invalid board: O started\"\n\n[b1dc8b13-46c4-47db-a96d-aa90eedc4e8d]\ndescription = \"Invalid boards -> Invalid board\"\ninclude = false\n\n[6c1920f2-ab5c-4648-a0c9-997414dda5eb]\ndescription = \"Invalid boards -> Invalid board: X won and O kept playing\"\nreimplements = \"b1dc8b13-46c4-47db-a96d-aa90eedc4e8d\"\n\n[4801cda2-f5b7-4c36-8317-3cdd167ac22c]\ndescription = \"Invalid boards -> Invalid board: players kept playing after a win\"\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/package.json", "content": "{\n \"name\": \"@exercism/typescript-state-of-tic-tac-toe\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/state-of-tic-tac-toe.test.ts", "content": "import { describe, expect, it, xit } from '@jest/globals'\nimport { gamestate } from './state-of-tic-tac-toe.ts'\n\ndescribe('state-of-tic-tac-toe', () => {\n describe('Won games', () => {\n it('Finished game where X won via left column victory', () => {\n const board = ['XOO', 'X ', 'X ']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where X won via middle column victory', () => {\n const board = ['OXO', ' X ', ' X ']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where X won via right column victory', () => {\n const board = ['OOX', ' X', ' X']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where O won via left column victory', () => {\n const board = ['OXX', 'OX ', 'O ']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where O won via middle column victory', () => {\n const board = ['XOX', ' OX', ' O ']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where O won via right column victory', () => {\n const board = ['XXO', ' XO', ' O']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where X won via top row victory', () => {\n const board = ['XXX', 'XOO', 'O ']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where X won via middle row victory', () => {\n const board = ['O ', 'XXX', ' O ']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where X won via bottom row victory', () => {\n const board = [' OO', 'O X', 'XXX']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where O won via top row victory', () => {\n const board = ['OOO', 'XXO', 'XX ']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where O won via middle row victory', () => {\n const board = ['XX ', 'OOO', 'X ']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where O won via bottom row victory', () => {\n const board = ['XOX', ' XX', 'OOO']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where X won via falling diagonal victory', () => {\n const board = ['XOO', ' X ', ' X']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where X won via rising diagonal victory', () => {\n const board = ['O X', 'OX ', 'X ']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where O won via falling diagonal victory', () => {\n const board = ['OXX', 'OOX', 'X O']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where O won via rising diagonal victory', () => {\n const board = [' O', ' OX', 'OXX']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where X won via a row and a column victory', () => {\n const board = ['XXX', 'XOO', 'XOO']\n expect(gamestate(board)).toEqual('win')\n })\n\n xit('Finished game where X won via two diagonal victories', () => {\n const board = ['XOX', 'OXO', 'XOX']\n expect(gamestate(board)).toEqual('win')\n })\n })\n\n describe('Draw games', () => {\n xit('Draw', () => {\n const board = ['XOX', 'XXO', 'OXO']\n expect(gamestate(board)).toEqual('draw')\n })\n\n xit('Another draw', () => {\n const board = ['XXO', 'OXX', 'XOO']\n expect(gamestate(board)).toEqual('draw')\n })\n })\n\n describe('Ongoing games', () => {\n xit('Ongoing game: one move in', () => {\n const board = [' ', 'X ', ' ']\n expect(gamestate(board)).toEqual('ongoing')\n })\n\n xit('Ongoing game: two moves in', () => {\n const board = ['O ', ' X ', ' ']\n expect(gamestate(board)).toEqual('ongoing')\n })\n\n xit('Ongoing game: five moves in', () => {\n const board = ['X ', ' XO', 'OX ']\n expect(gamestate(board)).toEqual('ongoing')\n })\n })\n\n describe('Invalid boards', () => {\n xit('Invalid board: X went twice', () => {\n const board = ['XX ', ' ', ' ']\n expect(() => {\n gamestate(board)\n }).toThrow('Wrong turn order: X went twice')\n })\n\n xit('Invalid board: O started', () => {\n const board = ['OOX', ' ', ' ']\n expect(() => {\n gamestate(board)\n }).toThrow('Wrong turn order: O started')\n })\n\n xit('Invalid board: X won and O kept playing', () => {\n const board = ['XXX', 'OOO', ' ']\n expect(() => {\n gamestate(board)\n }).toThrow(\n 'Impossible board: game should have ended after the game was won'\n )\n })\n\n xit('Invalid board: players kept playing after a win', () => {\n const board = ['XXX', 'OOO', 'XOX']\n expect(() => {\n gamestate(board)\n }).toThrow(\n 'Impossible board: game should have ended after the game was won'\n )\n })\n })\n})\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/state-of-tic-tac-toe.ts", "content": "export const gamestate = (board: unknown): unknown => {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/state-of-tic-tac-toe/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/strain/.docs/instructions.md", "content": "# Instructions\n\nImplement the `keep` and `discard` operation on collections.\nGiven a collection and a predicate on the collection's elements, `keep` returns a new collection containing those elements where the predicate is true, while `discard` returns a new collection containing those elements where the predicate is false.\n\nFor example, given the collection of numbers:\n\n- 1, 2, 3, 4, 5\n\nAnd the predicate:\n\n- is the number even?\n\nThen your keep operation should produce:\n\n- 2, 4\n\nWhile your discard operation should produce:\n\n- 1, 3, 5\n\nNote that the union of keep and discard is all the elements.\n\nThe functions may be called `keep` and `discard`, or they may need different names in order to not clash with existing functions or concepts in your language.\n\n## Restrictions\n\nKeep your hands off that filter/reject/whatchamacallit functionality provided by your standard library!\nSolve this one yourself using other basic tools instead.\n" }, { "path": "exercises/practice/strain/.meta/config.json", "content": "{\n \"authors\": [\n \"jspengeman\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"strain.ts\"\n ],\n \"test\": [\n \"strain.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement the `keep` and `discard` operation on collections.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Conversation with James Edward Gray II\",\n \"source_url\": \"http://graysoftinc.com/\"\n}\n" }, { "path": "exercises/practice/strain/.meta/proof.ci.ts", "content": "interface Predicate {\n (element: T): boolean\n}\n\nexport function keep(array: T[], predicate: Predicate): T[] {\n const output: T[] = []\n array.forEach((el: T) => {\n if (predicate(el)) {\n output.push(el)\n }\n })\n return output\n}\n\nexport function discard(array: T[], predicate: Predicate): T[] {\n const output: T[] = []\n array.forEach((el: T) => {\n if (!predicate(el)) {\n output.push(el)\n }\n })\n return output\n}\n" }, { "path": "exercises/practice/strain/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[26af8c32-ba6a-4eb3-aa0a-ebd8f136e003]\ndescription = \"keep on empty list returns empty list\"\n\n[f535cb4d-e99b-472a-bd52-9fa0ffccf454]\ndescription = \"keeps everything\"\n\n[950b8e8e-f628-42a8-85e2-9b30f09cde38]\ndescription = \"keeps nothing\"\n\n[92694259-6e76-470c-af87-156bdf75018a]\ndescription = \"keeps first and last\"\n\n[938f7867-bfc7-449e-a21b-7b00cbb56994]\ndescription = \"keeps neither first nor last\"\n\n[8908e351-4437-4d2b-a0f7-770811e48816]\ndescription = \"keeps strings\"\n\n[2728036b-102a-4f1e-a3ef-eac6160d876a]\ndescription = \"keeps lists\"\n\n[ef16beb9-8d84-451a-996a-14e80607fce6]\ndescription = \"discard on empty list returns empty list\"\n\n[2f42f9bc-8e06-4afe-a222-051b5d8cd12a]\ndescription = \"discards everything\"\n\n[ca990fdd-08c2-4f95-aa50-e0f5e1d6802b]\ndescription = \"discards nothing\"\n\n[71595dae-d283-48ca-a52b-45fa96819d2f]\ndescription = \"discards first and last\"\n\n[ae141f79-f86d-4567-b407-919eaca0f3dd]\ndescription = \"discards neither first nor last\"\n\n[daf25b36-a59f-4f29-bcfe-302eb4e43609]\ndescription = \"discards strings\"\n\n[a38d03f9-95ad-4459-80d1-48e937e4acaf]\ndescription = \"discards lists\"\n" }, { "path": "exercises/practice/strain/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/strain/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/strain/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/strain/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/strain/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/strain/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/strain/package.json", "content": "{\n \"name\": \"@exercism/typescript-strain\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/strain/strain.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { keep, discard } from './strain.ts'\n\ndescribe('strain', () => {\n it('keeps on empty array returns empty array', () => {\n const predicate = (_: number): boolean => true\n expect(keep([], predicate)).toEqual([])\n })\n\n xit('keeps everything', () => {\n const predicate = (_: number): boolean => true\n expect(keep([1, 3, 5], predicate)).toEqual([1, 3, 5])\n })\n\n xit('keeps nothing', () => {\n const predicate = (_: number): boolean => false\n expect(keep([1, 3, 5], predicate)).toEqual([])\n })\n\n xit('keeps first and last', () => {\n const predicate = (e: number): boolean => e % 2 === 1\n expect(keep([1, 2, 3], predicate)).toEqual([1, 3])\n })\n\n xit('keeps neither first nor last', () => {\n const predicate = (e: number): boolean => e % 2 === 0\n expect(keep([1, 2, 3], predicate)).toEqual([2])\n })\n\n xit('keeps strings', () => {\n const words = ['apple', 'zebra', 'banana', 'zombies', 'cherimoya', 'zealot']\n const predicate = (word: string): boolean => word.indexOf('z') === 0\n const result = keep(words, predicate)\n expect(result).toEqual(['zebra', 'zombies', 'zealot'])\n })\n\n xit('keeps arrays', () => {\n const rows = [\n [1, 2, 3],\n [5, 5, 5],\n [5, 1, 2],\n [2, 1, 2],\n [1, 5, 2],\n [2, 2, 1],\n [1, 2, 5],\n ]\n const predicate = (row: number[]): boolean => row.indexOf(5) > -1\n const result = keep(rows, predicate)\n expect(result).toEqual([\n [5, 5, 5],\n [5, 1, 2],\n [1, 5, 2],\n [1, 2, 5],\n ])\n })\n\n xit('empty discard', () => {\n const predicate = (_: number): boolean => true\n expect(discard([], predicate)).toEqual([])\n })\n\n xit('discards everything', () => {\n const predicate = (_: number): boolean => true\n expect(discard([1, 3, 5], predicate)).toEqual([])\n })\n\n it('discards nothing', () => {\n const predicate = (_: number): boolean => false\n expect(discard([1, 3, 5], predicate)).toEqual([1, 3, 5])\n })\n\n xit('discards first and last', () => {\n const predicate = (e: number): boolean => e % 2 === 1\n expect(discard([1, 2, 3], predicate)).toEqual([2])\n })\n\n xit('discards neither first nor last', () => {\n const predicate = (e: number): boolean => e % 2 === 0\n const result = discard([1, 2, 3], predicate)\n expect(result).toEqual([1, 3])\n })\n\n xit('discards strings', () => {\n const words = ['apple', 'zebra', 'banana', 'zombies', 'cherimoya', 'zealot']\n const predicate = (word: string): boolean => word.indexOf('z') === 0\n const result = discard(words, predicate)\n expect(result).toEqual(['apple', 'banana', 'cherimoya'])\n })\n\n xit('discards arrays', () => {\n const rows = [\n [1, 2, 3],\n [5, 5, 5],\n [5, 1, 2],\n [2, 1, 2],\n [1, 5, 2],\n [2, 2, 1],\n [1, 2, 5],\n ]\n\n const predicate = (row: number[]): boolean => row.indexOf(5) > -1\n const result = discard(rows, predicate)\n expect(result).toEqual([\n [1, 2, 3],\n [2, 1, 2],\n [2, 2, 1],\n ])\n })\n})\n" }, { "path": "exercises/practice/strain/strain.ts", "content": "export function keep() {\n throw new Error('Remove this line and implement the function')\n}\n\nexport function discard() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/strain/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/strain/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/sublist/.docs/instructions.md", "content": "# Instructions\n\nGiven any two lists `A` and `B`, determine if:\n\n- List `A` is equal to list `B`; or\n- List `A` contains list `B` (`A` is a superlist of `B`); or\n- List `A` is contained by list `B` (`A` is a sublist of `B`); or\n- None of the above is true, thus lists `A` and `B` are unequal\n\nSpecifically, list `A` is equal to list `B` if both lists have the same values in the same order.\nList `A` is a superlist of `B` if `A` contains a contiguous sub-sequence of values equal to `B`.\nList `A` is a sublist of `B` if `B` contains a contiguous sub-sequence of values equal to `A`.\n\nExamples:\n\n- If `A = []` and `B = []` (both lists are empty), then `A` and `B` are equal\n- If `A = [1, 2, 3]` and `B = []`, then `A` is a superlist of `B`\n- If `A = []` and `B = [1, 2, 3]`, then `A` is a sublist of `B`\n- If `A = [1, 2, 3]` and `B = [1, 2, 3, 4, 5]`, then `A` is a sublist of `B`\n- If `A = [3, 4, 5]` and `B = [1, 2, 3, 4, 5]`, then `A` is a sublist of `B`\n- If `A = [3, 4]` and `B = [1, 2, 3, 4, 5]`, then `A` is a sublist of `B`\n- If `A = [1, 2, 3]` and `B = [1, 2, 3]`, then `A` and `B` are equal\n- If `A = [1, 2, 3, 4, 5]` and `B = [2, 3, 4]`, then `A` is a superlist of `B`\n- If `A = [1, 2, 4]` and `B = [1, 2, 3, 4, 5]`, then `A` and `B` are unequal\n- If `A = [1, 2, 3]` and `B = [1, 3, 2]`, then `A` and `B` are unequal\n" }, { "path": "exercises/practice/sublist/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"sublist.ts\"\n ],\n \"test\": [\n \"sublist.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Write a function to determine if a list is a sublist of another list.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/sublist/.meta/proof.ci.ts", "content": "export class List {\n private readonly list: number[]\n\n constructor(...list: number[]) {\n this.list = list\n }\n\n public compare(other: List): 'sublist' | 'superlist' | 'unequal' | 'equal' {\n switch (this.lengthDiff(this, other)) {\n case '-1':\n return this.isSublist(other.list, this.list) ? 'sublist' : 'unequal'\n case '0':\n return this.isSublist(other.list, this.list) ? 'equal' : 'unequal'\n case '1':\n return this.isSublist(this.list, other.list) ? 'superlist' : 'unequal'\n }\n\n return 'unequal'\n }\n\n private lengthDiff(listOne: List, listTwo: List): string {\n return String(Math.sign(listOne.list.length - listTwo.list.length))\n }\n\n private isSublist(listOne: number[], listTwo: number[]): boolean {\n const join = (list: number[]): string => {\n const joiner = ','\n return list.join(joiner) + joiner\n }\n\n return Boolean(join(listOne).match(join(listTwo)))\n }\n}\n" }, { "path": "exercises/practice/sublist/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[97319c93-ebc5-47ab-a022-02a1980e1d29]\ndescription = \"empty lists\"\n\n[de27dbd4-df52-46fe-a336-30be58457382]\ndescription = \"empty list within non empty list\"\n\n[5487cfd1-bc7d-429f-ac6f-1177b857d4fb]\ndescription = \"non empty list contains empty list\"\n\n[1f390b47-f6b2-4a93-bc23-858ba5dda9a6]\ndescription = \"list equals itself\"\n\n[7ed2bfb2-922b-4363-ae75-f3a05e8274f5]\ndescription = \"different lists\"\n\n[3b8a2568-6144-4f06-b0a1-9d266b365341]\ndescription = \"false start\"\n\n[dc39ed58-6311-4814-be30-05a64bc8d9b1]\ndescription = \"consecutive\"\n\n[d1270dab-a1ce-41aa-b29d-b3257241ac26]\ndescription = \"sublist at start\"\n\n[81f3d3f7-4f25-4ada-bcdc-897c403de1b6]\ndescription = \"sublist in middle\"\n\n[43bcae1e-a9cf-470e-923e-0946e04d8fdd]\ndescription = \"sublist at end\"\n\n[76cf99ed-0ff0-4b00-94af-4dfb43fe5caa]\ndescription = \"at start of superlist\"\n\n[b83989ec-8bdf-4655-95aa-9f38f3e357fd]\ndescription = \"in middle of superlist\"\n\n[26f9f7c3-6cf6-4610-984a-662f71f8689b]\ndescription = \"at end of superlist\"\n\n[0a6db763-3588-416a-8f47-76b1cedde31e]\ndescription = \"first list missing element from second list\"\n\n[83ffe6d8-a445-4a3c-8795-1e51a95e65c3]\ndescription = \"second list missing element from first list\"\n\n[7bc76cb8-5003-49ca-bc47-cdfbe6c2bb89]\ndescription = \"first list missing additional digits from second list\"\n\n[0d7ee7c1-0347-45c8-9ef5-b88db152b30b]\ndescription = \"order matters to a list\"\n\n[5f47ce86-944e-40f9-9f31-6368aad70aa6]\ndescription = \"same digits but different numbers\"\n" }, { "path": "exercises/practice/sublist/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/sublist/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/sublist/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/sublist/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/sublist/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/sublist/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/sublist/package.json", "content": "{\n \"name\": \"@exercism/typescript-sublist\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/sublist/sublist.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { List } from './sublist.ts'\n\ndescribe('Sublist', () => {\n it('empty lists', () => {\n const listOne = new List()\n const listTwo = new List()\n const expected = 'equal'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('empty list within non empty list', () => {\n const listOne = new List()\n const listTwo = new List(1, 2, 3)\n const expected = 'sublist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('non empty list contains empty list', () => {\n const listOne = new List(1, 2, 3)\n const listTwo = new List()\n const expected = 'superlist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('list equals itself', () => {\n const listOne = new List(1, 2, 3)\n const listTwo = new List(1, 2, 3)\n const expected = 'equal'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('different lists', () => {\n const listOne = new List(1, 2, 3)\n const listTwo = new List(2, 3, 4)\n const expected = 'unequal'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('false start', () => {\n const listOne = new List(1, 2, 5)\n const listTwo = new List(0, 1, 2, 3, 1, 2, 5, 6)\n const expected = 'sublist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('consecutive', () => {\n const listOne = new List(1, 1, 2)\n const listTwo = new List(0, 1, 1, 1, 2, 1, 2)\n const expected = 'sublist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('sublist at start', () => {\n const listOne = new List(0, 1, 2)\n const listTwo = new List(0, 1, 2, 3, 4, 5)\n const expected = 'sublist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('sublist in middle', () => {\n const listOne = new List(2, 3, 4)\n const listTwo = new List(0, 1, 2, 3, 4, 5)\n const expected = 'sublist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('sublist at end', () => {\n const listOne = new List(3, 4, 5)\n const listTwo = new List(0, 1, 2, 3, 4, 5)\n const expected = 'sublist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('at start of superlist', () => {\n const listOne = new List(0, 1, 2, 3, 4, 5)\n const listTwo = new List(0, 1, 2)\n const expected = 'superlist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('in middle of superlist', () => {\n const listOne = new List(0, 1, 2, 3, 4, 5)\n const listTwo = new List(2, 3)\n const expected = 'superlist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('at end of superlist', () => {\n const listOne = new List(0, 1, 2, 3, 4, 5)\n const listTwo = new List(3, 4, 5)\n const expected = 'superlist'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('first list missing element from second list', () => {\n const listOne = new List(1, 3)\n const listTwo = new List(1, 2, 3)\n const expected = 'unequal'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('second list missing element from first list', () => {\n const listOne = new List(1, 2, 3)\n const listTwo = new List(1, 3)\n const expected = 'unequal'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('first list missing additional digits from second list', () => {\n const listOne = new List(1, 2)\n const listTwo = new List(1, 22)\n const expected = 'unequal'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('order matters to a list', () => {\n const listOne = new List(1, 2, 3)\n const listTwo = new List(3, 2, 1)\n const expected = 'unequal'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n\n xit('same digits but different numbers', () => {\n const listOne = new List(1, 0, 1)\n const listTwo = new List(10, 1)\n const expected = 'unequal'\n\n expect(listOne.compare(listTwo)).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/sublist/sublist.ts", "content": "export class List {\n constructor() {\n throw new Error('Remove this line and implement the function')\n }\n\n compare() {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/sublist/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/sublist/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/sum-of-multiples/.docs/instructions.md", "content": "# Instructions\n\nYour task is to write the code that calculates the energy points that get awarded to players when they complete a level.\n\nThe points awarded depend on two things:\n\n- The level (a number) that the player completed.\n- The base value of each magical item collected by the player during that level.\n\nThe energy points are awarded according to the following rules:\n\n1. For each magical item, take the base value and find all the multiples of that value that are less than the level number.\n2. Combine the sets of numbers.\n3. Remove any duplicates.\n4. Calculate the sum of all the numbers that are left.\n\nLet's look at an example:\n\n**The player completed level 20 and found two magical items with base values of 3 and 5.**\n\nTo calculate the energy points earned by the player, we need to find all the unique multiples of these base values that are less than level 20.\n\n- Multiples of 3 less than 20: `{3, 6, 9, 12, 15, 18}`\n- Multiples of 5 less than 20: `{5, 10, 15}`\n- Combine the sets and remove duplicates: `{3, 5, 6, 9, 10, 12, 15, 18}`\n- Sum the unique multiples: `3 + 5 + 6 + 9 + 10 + 12 + 15 + 18 = 78`\n- Therefore, the player earns **78** energy points for completing level 20 and finding the two magical items with base values of 3 and 5.\n" }, { "path": "exercises/practice/sum-of-multiples/.docs/introduction.md", "content": "# Introduction\n\nYou work for a company that makes an online, fantasy-survival game.\n\nWhen a player finishes a level, they are awarded energy points.\nThe amount of energy awarded depends on which magical items the player found while exploring that level.\n" }, { "path": "exercises/practice/sum-of-multiples/.meta/config.json", "content": "{\n \"authors\": [],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"sum-of-multiples.ts\"\n ],\n \"test\": [\n \"sum-of-multiples.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a number, find the sum of all the multiples of particular numbers up to but not including that number.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A variation on Problem 1 at Project Euler\",\n \"source_url\": \"https://projecteuler.net/problem=1\"\n}\n" }, { "path": "exercises/practice/sum-of-multiples/.meta/proof.ci.ts", "content": "export const sum = (multiples: number[], limit: number): number => {\n let result = 0\n for (let i = 1; i < limit; i++) {\n if (multiples.some((multiple) => i % multiple === 0)) {\n result += i\n }\n }\n return result\n}\n" }, { "path": "exercises/practice/sum-of-multiples/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[54aaab5a-ce86-4edc-8b40-d3ab2400a279]\ndescription = \"no multiples within limit\"\n\n[361e4e50-c89b-4f60-95ef-5bc5c595490a]\ndescription = \"one factor has multiples within limit\"\n\n[e644e070-040e-4ae0-9910-93c69fc3f7ce]\ndescription = \"more than one multiple within limit\"\n\n[607d6eb9-535c-41ce-91b5-3a61da3fa57f]\ndescription = \"more than one factor with multiples within limit\"\n\n[f47e8209-c0c5-4786-b07b-dc273bf86b9b]\ndescription = \"each multiple is only counted once\"\n\n[28c4b267-c980-4054-93e9-07723db615ac]\ndescription = \"a much larger limit\"\n\n[09c4494d-ff2d-4e0f-8421-f5532821ee12]\ndescription = \"three factors\"\n\n[2d0d5faa-f177-4ad6-bde9-ebb865083751]\ndescription = \"factors not relatively prime\"\n\n[ece8f2e8-96aa-4166-bbb7-6ce71261e354]\ndescription = \"some pairs of factors relatively prime and some not\"\n\n[624fdade-6ffb-400e-8472-456a38c171c0]\ndescription = \"one factor is a multiple of another\"\n\n[949ee7eb-db51-479c-b5cb-4a22b40ac057]\ndescription = \"much larger factors\"\n\n[41093673-acbd-482c-ab80-d00a0cbedecd]\ndescription = \"all numbers are multiples of 1\"\n\n[1730453b-baaa-438e-a9c2-d754497b2a76]\ndescription = \"no factors means an empty sum\"\n\n[214a01e9-f4bf-45bb-80f1-1dce9fbb0310]\ndescription = \"the only multiple of 0 is 0\"\n\n[c423ae21-a0cb-4ec7-aeb1-32971af5b510]\ndescription = \"the factor 0 does not affect the sum of multiples of other factors\"\n\n[17053ba9-112f-4ac0-aadb-0519dd836342]\ndescription = \"solutions using include-exclude must extend to cardinality greater than 3\"\n" }, { "path": "exercises/practice/sum-of-multiples/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/sum-of-multiples/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/sum-of-multiples/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/sum-of-multiples/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/sum-of-multiples/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/sum-of-multiples/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/sum-of-multiples/package.json", "content": "{\n \"name\": \"@exercism/typescript-sum-of-multiples\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/sum-of-multiples/sum-of-multiples.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { sum } from './sum-of-multiples.ts'\n\ndescribe('Sum Of Multiples', () => {\n it('no multiples within limit', () => {\n expect(sum([3, 5], 1)).toEqual(0)\n })\n\n xit('one factor has multiples within limit', () => {\n expect(sum([3, 5], 4)).toEqual(3)\n })\n\n xit('more than one multiple within limit', () => {\n expect(sum([3], 7)).toEqual(9)\n })\n\n xit('more than one factor with multiples within limit', () => {\n expect(sum([3, 5], 10)).toEqual(23)\n })\n\n xit('each multiple is only counted once', () => {\n expect(sum([3, 5], 100)).toEqual(2318)\n })\n\n xit('a much larger limit', () => {\n expect(sum([3, 5], 1000)).toEqual(233168)\n })\n\n xit('three factors', () => {\n expect(sum([7, 13, 17], 20)).toEqual(51)\n })\n\n xit('factors not relatively prime', () => {\n expect(sum([4, 6], 15)).toEqual(30)\n })\n\n xit('some pairs of factors relatively prime and some not', () => {\n expect(sum([5, 6, 8], 150)).toEqual(4419)\n })\n\n xit('one factor is a multiple of another', () => {\n expect(sum([5, 25], 51)).toEqual(275)\n })\n\n xit('much larger factors', () => {\n expect(sum([43, 47], 10000)).toEqual(2203160)\n })\n\n xit('all numbers are multiples of 1', () => {\n expect(sum([1], 100)).toEqual(4950)\n })\n\n xit('no factors means an empty sum', () => {\n expect(sum([], 10000)).toEqual(0)\n })\n\n xit('the only multiple of 0 is 0', () => {\n expect(sum([0], 1)).toEqual(0)\n })\n\n xit('the factor 0 does not affect the sum of multiples of other factors', () => {\n expect(sum([3, 0], 4)).toEqual(3)\n })\n\n xit('solutions using include-exclude must extend to cardinality greater than 3', () => {\n expect(sum([2, 3, 5, 7, 11], 10000)).toEqual(39614537)\n })\n})\n" }, { "path": "exercises/practice/sum-of-multiples/sum-of-multiples.ts", "content": "export function sum() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/sum-of-multiples/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/sum-of-multiples/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/tournament/.docs/instructions.md", "content": "# Instructions\n\nTally the results of a small football competition.\n\nBased on an input file containing which team played against which and what the outcome was, create a file with a table like this:\n\n```text\nTeam | MP | W | D | L | P\nDevastating Donkeys | 3 | 2 | 1 | 0 | 7\nAllegoric Alaskans | 3 | 2 | 0 | 1 | 6\nBlithering Badgers | 3 | 1 | 0 | 2 | 3\nCourageous Californians | 3 | 0 | 1 | 2 | 1\n```\n\nWhat do those abbreviations mean?\n\n- MP: Matches Played\n- W: Matches Won\n- D: Matches Drawn (Tied)\n- L: Matches Lost\n- P: Points\n\nA win earns a team 3 points.\nA draw earns 1.\nA loss earns 0.\n\nThe outcome is ordered by points, descending.\nIn case of a tie, teams are ordered alphabetically.\n\n## Input\n\nYour tallying program will receive input that looks like:\n\n```text\nAllegoric Alaskans;Blithering Badgers;win\nDevastating Donkeys;Courageous Californians;draw\nDevastating Donkeys;Allegoric Alaskans;win\nCourageous Californians;Blithering Badgers;loss\nBlithering Badgers;Devastating Donkeys;loss\nAllegoric Alaskans;Courageous Californians;win\n```\n\nThe result of the match refers to the first team listed.\nSo this line:\n\n```text\nAllegoric Alaskans;Blithering Badgers;win\n```\n\nmeans that the Allegoric Alaskans beat the Blithering Badgers.\n\nThis line:\n\n```text\nCourageous Californians;Blithering Badgers;loss\n```\n\nmeans that the Blithering Badgers beat the Courageous Californians.\n\nAnd this line:\n\n```text\nDevastating Donkeys;Courageous Californians;draw\n```\n\nmeans that the Devastating Donkeys and Courageous Californians tied.\n" }, { "path": "exercises/practice/tournament/.meta/config.json", "content": "{\n \"authors\": [\n \"BrianDGLS\"\n ],\n \"files\": {\n \"solution\": [\n \"tournament.ts\"\n ],\n \"test\": [\n \"tournament.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Tally the results of a small football competition.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/tournament/.meta/proof.ci.ts", "content": "class TeamStats {\n public won = 0\n public lost = 0\n public drawn = 0\n public played = 0\n\n public get points(): number {\n return this.won * 3 + this.drawn\n }\n\n constructor(public name: string) {}\n\n public getStatTableRow(): string {\n const { name, won, lost, played, drawn } = this\n const namePad = name.padEnd(31, ' ')\n const wonPad = won.toString().padStart(3 - won.toString().length, ' ')\n const lostPad = lost.toString().padStart(3 - lost.toString().length, ' ')\n const drawnPad = drawn.toString().padStart(3 - drawn.toString().length, ' ')\n const playedPad = played\n .toString()\n .padStart(3 - played.toString().length, ' ')\n const poinntsPad = this.points\n .toString()\n .padStart(3 - this.points.toString().length, ' ')\n return `${namePad}| ${playedPad} | ${wonPad} | ${drawnPad} | ${lostPad} | ${poinntsPad}`\n }\n}\n\nexport class Tournament {\n private tableHeader =\n 'Team | MP | W | D | L | P'\n\n private teams: { [key: string]: TeamStats } = {}\n\n public tally(input: string): string {\n if (!input) return this.tableHeader\n\n for (const line of input.split('\\n')) {\n const [teamAName, teamBName, result] = line.split(';')\n\n if (!this.teams[teamAName]) {\n this.teams[teamAName] = new TeamStats(teamAName)\n }\n\n if (!this.teams[teamBName]) {\n this.teams[teamBName] = new TeamStats(teamBName)\n }\n\n this.applyResult(this.teams[teamAName], this.teams[teamBName], result)\n }\n\n return Object.keys(this.teams)\n .sort(this.sortByPointsAlphabetically)\n .reduce(\n (acc, team) => acc + this.teams[team].getStatTableRow() + '\\n',\n this.tableHeader + '\\n'\n )\n .trimEnd()\n }\n\n private sortByPointsAlphabetically = (a: string, b: string): number => {\n const teamA = this.teams[a]\n const teamB = this.teams[b]\n if (teamA.points === teamB.points) {\n return teamA.name.localeCompare(teamB.name)\n }\n return teamB.points - teamA.points\n }\n\n private applyResult(\n teamA: TeamStats,\n teamB: TeamStats,\n result: string\n ): void {\n if (result === 'draw') {\n teamA.drawn++\n teamB.drawn++\n }\n\n if (result === 'win') {\n teamA.won++\n teamB.lost++\n }\n\n if (result === 'loss') {\n teamA.lost++\n teamB.won++\n }\n\n teamA.played++\n teamB.played++\n }\n}\n" }, { "path": "exercises/practice/tournament/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[67e9fab1-07c1-49cf-9159-bc8671cc7c9c]\ndescription = \"just the header if no input\"\n\n[1b4a8aef-0734-4007-80a2-0626178c88f4]\ndescription = \"a win is three points, a loss is zero points\"\n\n[5f45ac09-4efe-46e7-8ddb-75ad85f86e05]\ndescription = \"a win can also be expressed as a loss\"\n\n[fd297368-efa0-442d-9f37-dd3f9a437239]\ndescription = \"a different team can win\"\n\n[26c016f9-e753-4a93-94e9-842f7b4d70fc]\ndescription = \"a draw is one point each\"\n\n[731204f6-4f34-4928-97eb-1c307ba83e62]\ndescription = \"There can be more than one match\"\n\n[49dc2463-42af-4ea6-95dc-f06cc5776adf]\ndescription = \"There can be more than one winner\"\n\n[6d930f33-435c-4e6f-9e2d-63fa85ce7dc7]\ndescription = \"There can be more than two teams\"\n\n[97022974-0c8a-4a50-8fe7-e36bdd8a5945]\ndescription = \"typical input\"\n\n[fe562f0d-ac0a-4c62-b9c9-44ee3236392b]\ndescription = \"incomplete competition (not all pairs have played)\"\n\n[3aa0386f-150b-4f99-90bb-5195e7b7d3b8]\ndescription = \"ties broken alphabetically\"\n\n[f9e20931-8a65-442a-81f6-503c0205b17a]\ndescription = \"ensure points sorted numerically\"\n" }, { "path": "exercises/practice/tournament/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/tournament/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/tournament/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/tournament/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/tournament/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/tournament/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/tournament/package.json", "content": "{\n \"name\": \"@exercism/typescript-tournament\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/tournament/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/tournament/tournament.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { Tournament } from './tournament.ts'\n\ndescribe('Tournament', () => {\n it('just the header if no input', () => {\n expect(new Tournament().tally('')).toBe(\n 'Team | MP | W | D | L | P'\n )\n })\n\n xit('a win is three points, a loss is zero points', () => {\n expect(\n new Tournament().tally('Allegoric Alaskans;Blithering Badgers;win')\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Allegoric Alaskans | 1 | 1 | 0 | 0 | 3',\n 'Blithering Badgers | 1 | 0 | 0 | 1 | 0',\n ].join('\\n')\n )\n })\n\n xit('a win can also be expressed as a loss', () => {\n expect(\n new Tournament().tally('Blithering Badgers;Allegoric Alaskans;loss')\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Allegoric Alaskans | 1 | 1 | 0 | 0 | 3',\n 'Blithering Badgers | 1 | 0 | 0 | 1 | 0',\n ].join('\\n')\n )\n })\n\n xit('a different team can win', () => {\n expect(\n new Tournament().tally('Blithering Badgers;Allegoric Alaskans;win')\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Blithering Badgers | 1 | 1 | 0 | 0 | 3',\n 'Allegoric Alaskans | 1 | 0 | 0 | 1 | 0',\n ].join('\\n')\n )\n })\n\n xit('a draw is one point each', () => {\n expect(\n new Tournament().tally('Allegoric Alaskans;Blithering Badgers;draw')\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Allegoric Alaskans | 1 | 0 | 1 | 0 | 1',\n 'Blithering Badgers | 1 | 0 | 1 | 0 | 1',\n ].join('\\n')\n )\n })\n\n xit('There can be more than one match', () => {\n expect(\n new Tournament().tally(\n [\n 'Allegoric Alaskans;Blithering Badgers;win',\n 'Allegoric Alaskans;Blithering Badgers;win',\n ].join('\\n')\n )\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Allegoric Alaskans | 2 | 2 | 0 | 0 | 6',\n 'Blithering Badgers | 2 | 0 | 0 | 2 | 0',\n ].join('\\n')\n )\n })\n\n xit('There can be more than one winner', () => {\n expect(\n new Tournament().tally(\n [\n 'Allegoric Alaskans;Blithering Badgers;loss',\n 'Allegoric Alaskans;Blithering Badgers;win',\n ].join('\\n')\n )\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Allegoric Alaskans | 2 | 1 | 0 | 1 | 3',\n 'Blithering Badgers | 2 | 1 | 0 | 1 | 3',\n ].join('\\n')\n )\n })\n\n xit('There can be more than two teams', () => {\n expect(\n new Tournament().tally(\n [\n 'Allegoric Alaskans;Blithering Badgers;win',\n 'Blithering Badgers;Courageous Californians;win',\n 'Courageous Californians;Allegoric Alaskans;loss',\n ].join('\\n')\n )\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Allegoric Alaskans | 2 | 2 | 0 | 0 | 6',\n 'Blithering Badgers | 2 | 1 | 0 | 1 | 3',\n 'Courageous Californians | 2 | 0 | 0 | 2 | 0',\n ].join('\\n')\n )\n })\n\n xit('typical input', () => {\n expect(\n new Tournament().tally(\n [\n 'Allegoric Alaskans;Blithering Badgers;win',\n 'Devastating Donkeys;Courageous Californians;draw',\n 'Devastating Donkeys;Allegoric Alaskans;win',\n 'Courageous Californians;Blithering Badgers;loss',\n 'Blithering Badgers;Devastating Donkeys;loss',\n 'Allegoric Alaskans;Courageous Californians;win',\n ].join('\\n')\n )\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Devastating Donkeys | 3 | 2 | 1 | 0 | 7',\n 'Allegoric Alaskans | 3 | 2 | 0 | 1 | 6',\n 'Blithering Badgers | 3 | 1 | 0 | 2 | 3',\n 'Courageous Californians | 3 | 0 | 1 | 2 | 1',\n ].join('\\n')\n )\n })\n\n xit('incomplete competition (not all pairs have played)', () => {\n expect(\n new Tournament().tally(\n [\n 'Allegoric Alaskans;Blithering Badgers;loss',\n 'Devastating Donkeys;Allegoric Alaskans;loss',\n 'Courageous Californians;Blithering Badgers;draw',\n 'Allegoric Alaskans;Courageous Californians;win',\n ].join('\\n')\n )\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Allegoric Alaskans | 3 | 2 | 0 | 1 | 6',\n 'Blithering Badgers | 2 | 1 | 1 | 0 | 4',\n 'Courageous Californians | 2 | 0 | 1 | 1 | 1',\n 'Devastating Donkeys | 1 | 0 | 0 | 1 | 0',\n ].join('\\n')\n )\n })\n\n xit('ties broken alphabetically', () => {\n expect(\n new Tournament().tally(\n [\n 'Courageous Californians;Devastating Donkeys;win',\n 'Allegoric Alaskans;Blithering Badgers;win',\n 'Devastating Donkeys;Allegoric Alaskans;loss',\n 'Courageous Californians;Blithering Badgers;win',\n 'Blithering Badgers;Devastating Donkeys;draw',\n 'Allegoric Alaskans;Courageous Californians;draw',\n ].join('\\n')\n )\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Allegoric Alaskans | 3 | 2 | 1 | 0 | 7',\n 'Courageous Californians | 3 | 2 | 1 | 0 | 7',\n 'Blithering Badgers | 3 | 0 | 1 | 2 | 1',\n 'Devastating Donkeys | 3 | 0 | 1 | 2 | 1',\n ].join('\\n')\n )\n })\n\n xit('ensure points sorted numerically', () => {\n expect(\n new Tournament().tally(\n [\n 'Devastating Donkeys;Blithering Badgers;win',\n 'Devastating Donkeys;Blithering Badgers;win',\n 'Devastating Donkeys;Blithering Badgers;win',\n 'Devastating Donkeys;Blithering Badgers;win',\n 'Blithering Badgers;Devastating Donkeys;win',\n ].join('\\n')\n )\n ).toBe(\n [\n 'Team | MP | W | D | L | P',\n 'Devastating Donkeys | 5 | 4 | 0 | 1 | 12',\n 'Blithering Badgers | 5 | 1 | 0 | 4 | 3',\n ].join('\\n')\n )\n })\n})\n" }, { "path": "exercises/practice/tournament/tournament.ts", "content": "export class Tournament {\n // eslint-disable-next-line no-unused-vars\n public tally(input: string): string {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/tournament/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/transpose/.docs/instructions.md", "content": "# Instructions\n\nGiven an input text output it transposed.\n\nRoughly explained, the transpose of a matrix:\n\n```text\nABC\nDEF\n```\n\nis given by:\n\n```text\nAD\nBE\nCF\n```\n\nRows become columns and columns become rows.\nSee [transpose][].\n\nIf the input has rows of different lengths, this is to be solved as follows:\n\n- Pad to the left with spaces.\n- Don't pad to the right.\n\nTherefore, transposing this matrix:\n\n```text\nABC\nDE\n```\n\nresults in:\n\n```text\nAD\nBE\nC\n```\n\nAnd transposing:\n\n```text\nAB\nDEF\n```\n\nresults in:\n\n```text\nAD\nBE\n F\n```\n\nIn general, all characters from the input should also be present in the transposed output.\nThat means that if a column in the input text contains only spaces on its bottom-most row(s), the corresponding output row should contain the spaces in its right-most column(s).\n\n[transpose]: https://en.wikipedia.org/wiki/Transpose\n" }, { "path": "exercises/practice/transpose/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"peerreynders\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"transpose.ts\"\n ],\n \"test\": [\n \"transpose.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Take input text and output it transposed.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Reddit r/dailyprogrammer challenge #270 [Easy].\",\n \"source_url\": \"https://web.archive.org/web/20230630051421/https://old.reddit.com/r/dailyprogrammer/comments/4msu2x/challenge_270_easy_transpose_the_input_text/\"\n}\n" }, { "path": "exercises/practice/transpose/.meta/proof.ci.ts", "content": "const fillColumn: (t: string[], l: string, r: number) => void = (\n transposed,\n fromSource,\n toColumn\n) => {\n for (let row = 0; row < fromSource.length; row++) {\n transposed[row] =\n (row in transposed ? transposed[row] : '').padEnd(toColumn) +\n fromSource.charAt(row)\n }\n}\n\nexport function transpose(lines: string[]): string[] {\n const transposed: string[] = []\n for (let toColumn = 0; toColumn < lines.length; toColumn++)\n fillColumn(transposed, lines[toColumn], toColumn)\n\n return transposed\n}\n" }, { "path": "exercises/practice/transpose/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[404b7262-c050-4df0-a2a2-0cb06cd6a821]\ndescription = \"empty string\"\n\n[a89ce8a3-c940-4703-a688-3ea39412fbcb]\ndescription = \"two characters in a row\"\n\n[855bb6ae-4180-457c-abd0-ce489803ce98]\ndescription = \"two characters in a column\"\n\n[5ceda1c0-f940-441c-a244-0ced197769c8]\ndescription = \"simple\"\n\n[a54675dd-ae7d-4a58-a9c4-0c20e99a7c1f]\ndescription = \"single line\"\n\n[0dc2ec0b-549d-4047-aeeb-8029fec8d5c5]\ndescription = \"first line longer than second line\"\n\n[984e2ec3-b3d3-4b53-8bd6-96f5ef404102]\ndescription = \"second line longer than first line\"\n\n[eccd3784-45f0-4a3f-865a-360cb323d314]\ndescription = \"mixed line length\"\n\n[85b96b3f-d00c-4f80-8ca2-c8a5c9216c2d]\ndescription = \"square\"\n\n[b9257625-7a53-4748-8863-e08e9d27071d]\ndescription = \"rectangle\"\n\n[b80badc9-057e-4543-bd07-ce1296a1ea2c]\ndescription = \"triangle\"\n\n[76acfd50-5596-4d05-89f1-5116328a7dd9]\ndescription = \"jagged triangle\"\n" }, { "path": "exercises/practice/transpose/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/transpose/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/transpose/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/transpose/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/transpose/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/transpose/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/transpose/package.json", "content": "{\n \"name\": \"@exercism/typescript-transpose\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/transpose/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/transpose/transpose.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { transpose } from './transpose.ts'\n\ndescribe('Transpose', () => {\n it('empty string', () => {\n const expected: string[] = []\n expect(transpose([])).toEqual(expected)\n })\n\n xit('two characters in a row', () => {\n const expected = ['A', '1']\n expect(transpose(['A1'])).toEqual(expected)\n })\n\n xit('two characters in a column', () => {\n const expected = ['A1']\n expect(transpose(['A', '1'])).toEqual(expected)\n })\n\n xit('simple', () => {\n const expected = ['A1', 'B2', 'C3']\n expect(transpose(['ABC', '123'])).toEqual(expected)\n })\n\n xit('single line', () => {\n const expected = [\n 'S',\n 'i',\n 'n',\n 'g',\n 'l',\n 'e',\n ' ',\n 'l',\n 'i',\n 'n',\n 'e',\n '.',\n ]\n expect(transpose(['Single line.'])).toEqual(expected)\n })\n\n xit('first line longer than second line', () => {\n const expected = [\n 'TT',\n 'hh',\n 'ee',\n ' ',\n 'ff',\n 'oi',\n 'uf',\n 'rt',\n 'th',\n 'h ',\n ' l',\n 'li',\n 'in',\n 'ne',\n 'e.',\n '.',\n ]\n expect(transpose(['The fourth line.', 'The fifth line.'])).toEqual(expected)\n })\n\n xit('second line longer than first line', () => {\n const expected = [\n 'TT',\n 'hh',\n 'ee',\n ' ',\n 'fs',\n 'ie',\n 'rc',\n 'so',\n 'tn',\n ' d',\n 'l ',\n 'il',\n 'ni',\n 'en',\n '.e',\n ' .',\n ]\n expect(transpose(['The first line.', 'The second line.'])).toEqual(expected)\n })\n\n xit('square', () => {\n const expected = ['HEART', 'EMBER', 'ABUSE', 'RESIN', 'TREND']\n expect(transpose(['HEART', 'EMBER', 'ABUSE', 'RESIN', 'TREND'])).toEqual(\n expected\n )\n })\n\n xit('rectangle', () => {\n const expected = [\n 'FOBS',\n 'RULE',\n 'ATOP',\n 'CLOT',\n 'TIME',\n 'UNIT',\n 'RENT',\n 'EDGE',\n ]\n expect(transpose(['FRACTURE', 'OUTLINED', 'BLOOMING', 'SEPTETTE'])).toEqual(\n expected\n )\n })\n\n xit('triangle', () => {\n const expected = [\n 'TEASER',\n ' EASER',\n ' ASER',\n ' SER',\n ' ER',\n ' R',\n ]\n expect(transpose(['T', 'EE', 'AAA', 'SSSS', 'EEEEE', 'RRRRRR'])).toEqual(\n expected\n )\n })\n\n xit('jagged triangle', () => {\n const expected = ['123456', '1 3456', ' 3456', ' 3 56', ' 56', ' 5']\n\n expect(transpose(['11', '2', '3333', '444', '555555', '66666'])).toEqual(\n expected\n )\n })\n\n xit('test many lines', () => {\n const expected = [\n 'CIFWFAWDTAWITW',\n 'hnrhr hohnhshh',\n 'o oeopotedi ea',\n 'rfmrmash cn t',\n '.a e ie fthow ',\n ' ia fr weh,whh',\n 'Trnco miae ie',\n 'w ciroitr btcr',\n 'oVivtfshfcuhhe',\n ' eeih a uote ',\n 'hrnl sdtln is',\n 'oot ttvh tttfh',\n 'un bhaeepihw a',\n 'saglernianeoyl',\n 'e,ro -trsui ol',\n 'h uofcu sarhu ',\n 'owddarrdan o m',\n \"lhg to'egccuwi\",\n 'deemasdaeehris',\n 'sr als t ists',\n \",ebk 'phool'h,\",\n ' reldi ffd ',\n 'bweso tb rtpo',\n 'oea ileutterau',\n 't kcnoorhhnatr',\n \"hl isvuyee'fi \",\n ' atv es iisfet',\n 'ayoior trr ino',\n 'l lfsoh ecti',\n 'ion vedpn l',\n 'kuehtteieadoe ',\n 'erwaharrar,fas',\n ' nekt te rh',\n 'ismdsehphnnosa',\n 'ncuse ra-tau l',\n ' et tormsural',\n \"dniuthwea'g t \",\n 'iennwesnr hsts',\n 'g,ycoi tkrttet',\n \"n ,l r s'a anr\",\n \"i ef 'dgcgdi\",\n 't aol eoe,v',\n 'y nei sl,u; e',\n ', .sf to l ',\n ' e rv d t',\n ' ; ie o',\n ' f, r ',\n ' e e m',\n ' . m e',\n ' o n',\n ' v d',\n ' e .',\n ' ,',\n ]\n expect(\n transpose([\n 'Chor. Two households, both alike in dignity,',\n 'In fair Verona, where we lay our scene,',\n 'From ancient grudge break to new mutiny,',\n 'Where civil blood makes civil hands unclean.',\n 'From forth the fatal loins of these two foes',\n \"A pair of star-cross'd lovers take their life;\",\n \"Whose misadventur'd piteous overthrows\",\n \"Doth with their death bury their parents' strife.\",\n \"The fearful passage of their death-mark'd love,\",\n \"And the continuance of their parents' rage,\",\n \"Which, but their children's end, naught could remove,\",\n \"Is now the two hours' traffic of our stage;\",\n 'The which if you with patient ears attend,',\n 'What here shall miss, our toil shall strive to mend.',\n ])\n ).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/transpose/transpose.ts", "content": "export function transpose() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/transpose/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/triangle/.docs/instructions.md", "content": "# Instructions\n\nDetermine if a triangle is equilateral, isosceles, or scalene.\n\nAn _equilateral_ triangle has all three sides the same length.\n\nAn _isosceles_ triangle has at least two sides the same length.\n(It is sometimes specified as having exactly two sides the same length, but for the purposes of this exercise we'll say at least two.)\n\nA _scalene_ triangle has all sides of different lengths.\n\n## Note\n\nFor a shape to be a triangle at all, all sides have to be of length > 0, and the sum of the lengths of any two sides must be greater than or equal to the length of the third side.\n\n~~~~exercism/note\n_Degenerate triangles_ are triangles where the sum of the length of two sides is **equal** to the length of the third side, e.g. `1, 1, 2`.\nWe opted to not include tests for degenerate triangles in this exercise.\nYou may handle those situations if you wish to do so, or safely ignore them.\n~~~~\n\nIn equations:\n\nLet `a`, `b`, and `c` be sides of the triangle.\nThen all three of the following expressions must be true:\n\n```text\na + b ā‰„ c\nb + c ā‰„ a\na + c ā‰„ b\n```\n\nSee [Triangle Inequality][triangle-inequality]\n\n[triangle-inequality]: https://en.wikipedia.org/wiki/Triangle_inequality\n" }, { "path": "exercises/practice/triangle/.meta/config.json", "content": "{\n \"authors\": [\n \"anuragsoni\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"triangle.ts\"\n ],\n \"test\": [\n \"triangle.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Determine if a triangle is equilateral, isosceles, or scalene.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"The Ruby Koans triangle project, parts 1 & 2\",\n \"source_url\": \"https://www.rubykoans.com/\"\n}\n" }, { "path": "exercises/practice/triangle/.meta/proof.ci.ts", "content": "export class Triangle {\n private readonly sides: number[]\n\n constructor(...sides: number[]) {\n this.sides = sides\n }\n\n public get isValid(): boolean {\n const [s1, s2, s3] = this.sides\n const sidesArePositive = s1 > 0 && s2 > 0 && s3 > 0\n const validatesTriangleInequality =\n s1 + s2 >= s3 && s1 + s3 >= s2 && s2 + s3 >= s1\n return sidesArePositive && validatesTriangleInequality\n }\n\n public get isEquilateral(): boolean {\n if (!this.isValid) {\n return false\n }\n const [s1, s2, s3] = this.sides\n return s1 === s2 && s2 === s3 && s1 === s3\n }\n\n public get isIsosceles(): boolean {\n if (!this.isValid) {\n return false\n }\n const [s1, s2, s3] = this.sides\n return s1 === s2 || s1 === s3 || s2 === s3\n }\n\n public get isScalene(): boolean {\n if (!this.isValid) {\n return false\n }\n return !this.isIsosceles\n }\n}\n" }, { "path": "exercises/practice/triangle/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[8b2c43ac-7257-43f9-b552-7631a91988af]\ndescription = \"equilateral triangle -> all sides are equal\"\n\n[33eb6f87-0498-4ccf-9573-7f8c3ce92b7b]\ndescription = \"equilateral triangle -> any side is unequal\"\n\n[c6585b7d-a8c0-4ad8-8a34-e21d36f7ad87]\ndescription = \"equilateral triangle -> no sides are equal\"\n\n[16e8ceb0-eadb-46d1-b892-c50327479251]\ndescription = \"equilateral triangle -> all zero sides is not a triangle\"\n\n[3022f537-b8e5-4cc1-8f12-fd775827a00c]\ndescription = \"equilateral triangle -> sides may be floats\"\n\n[cbc612dc-d75a-4c1c-87fc-e2d5edd70b71]\ndescription = \"isosceles triangle -> last two sides are equal\"\n\n[e388ce93-f25e-4daf-b977-4b7ede992217]\ndescription = \"isosceles triangle -> first two sides are equal\"\n\n[d2080b79-4523-4c3f-9d42-2da6e81ab30f]\ndescription = \"isosceles triangle -> first and last sides are equal\"\n\n[8d71e185-2bd7-4841-b7e1-71689a5491d8]\ndescription = \"isosceles triangle -> equilateral triangles are also isosceles\"\n\n[840ed5f8-366f-43c5-ac69-8f05e6f10bbb]\ndescription = \"isosceles triangle -> no sides are equal\"\n\n[2eba0cfb-6c65-4c40-8146-30b608905eae]\ndescription = \"isosceles triangle -> first triangle inequality violation\"\n\n[278469cb-ac6b-41f0-81d4-66d9b828f8ac]\ndescription = \"isosceles triangle -> second triangle inequality violation\"\n\n[90efb0c7-72bb-4514-b320-3a3892e278ff]\ndescription = \"isosceles triangle -> third triangle inequality violation\"\n\n[adb4ee20-532f-43dc-8d31-e9271b7ef2bc]\ndescription = \"isosceles triangle -> sides may be floats\"\n\n[e8b5f09c-ec2e-47c1-abec-f35095733afb]\ndescription = \"scalene triangle -> no sides are equal\"\n\n[2510001f-b44d-4d18-9872-2303e7977dc1]\ndescription = \"scalene triangle -> all sides are equal\"\n\n[c6e15a92-90d9-4fb3-90a2-eef64f8d3e1e]\ndescription = \"scalene triangle -> first and second sides are equal\"\n\n[3da23a91-a166-419a-9abf-baf4868fd985]\ndescription = \"scalene triangle -> first and third sides are equal\"\n\n[b6a75d98-1fef-4c42-8e9a-9db854ba0a4d]\ndescription = \"scalene triangle -> second and third sides are equal\"\n\n[70ad5154-0033-48b7-af2c-b8d739cd9fdc]\ndescription = \"scalene triangle -> may not violate triangle inequality\"\n\n[26d9d59d-f8f1-40d3-ad58-ae4d54123d7d]\ndescription = \"scalene triangle -> sides may be floats\"\n" }, { "path": "exercises/practice/triangle/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/triangle/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/triangle/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/triangle/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/triangle/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/triangle/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/triangle/package.json", "content": "{\n \"name\": \"@exercism/typescript-triangle\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/triangle/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/triangle/triangle.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { Triangle } from './triangle.ts'\n\ndescribe('Triangle', () => {\n describe('equilateral triangle', () => {\n it('all sides are equal', () => {\n const triangle = new Triangle(2, 2, 2)\n expect(triangle.isEquilateral).toBe(true)\n })\n\n xit('any side is unequal', () => {\n const triangle = new Triangle(2, 3, 2)\n expect(triangle.isEquilateral).toBe(false)\n })\n\n xit('no sides are equal', () => {\n const triangle = new Triangle(5, 4, 6)\n expect(triangle.isEquilateral).toBe(false)\n })\n\n xit('all zero sides is not a triangle', () => {\n const triangle = new Triangle(0, 0, 0)\n expect(triangle.isEquilateral).toBe(false)\n })\n\n xit('sides may be floats', () => {\n const triangle = new Triangle(0.5, 0.5, 0.5)\n expect(triangle.isEquilateral).toBe(true)\n })\n })\n\n xdescribe('isosceles triangle', () => {\n xit('last two sides are equal', () => {\n const triangle = new Triangle(3, 4, 4)\n expect(triangle.isIsosceles).toBe(true)\n })\n\n xit('first two sides are equal', () => {\n const triangle = new Triangle(4, 4, 3)\n expect(triangle.isIsosceles).toBe(true)\n })\n\n xit('first and last sides are equal', () => {\n const triangle = new Triangle(4, 3, 4)\n expect(triangle.isIsosceles).toBe(true)\n })\n\n xit('equilateral triangles are also isosceles', () => {\n const triangle = new Triangle(4, 4, 4)\n expect(triangle.isIsosceles).toBe(true)\n })\n\n xit('no sides are equal', () => {\n const triangle = new Triangle(2, 3, 4)\n expect(triangle.isIsosceles).toBe(false)\n })\n\n xit('first triangle inequality violation', () => {\n const triangle = new Triangle(1, 1, 3)\n expect(triangle.isIsosceles).toBe(false)\n })\n\n xit('second triangle inequality violation', () => {\n const triangle = new Triangle(1, 3, 1)\n expect(triangle.isIsosceles).toBe(false)\n })\n\n xit('third triangle inequality violation', () => {\n const triangle = new Triangle(3, 1, 1)\n expect(triangle.isIsosceles).toBe(false)\n })\n\n xit('sides may be floats', () => {\n const triangle = new Triangle(0.5, 0.4, 0.5)\n expect(triangle.isIsosceles).toBe(true)\n })\n })\n\n xdescribe('scalene triangle', () => {\n xit('no sides are equal', () => {\n const triangle = new Triangle(5, 4, 6)\n expect(triangle.isScalene).toBe(true)\n })\n\n xit('all sides are equal', () => {\n const triangle = new Triangle(4, 4, 4)\n expect(triangle.isScalene).toBe(false)\n })\n\n xit('first and second sides are equal', () => {\n const triangle = new Triangle(4, 4, 3)\n expect(triangle.isScalene).toBe(false)\n })\n\n xit('first and third sides are equal', () => {\n const triangle = new Triangle(3, 4, 3)\n expect(triangle.isScalene).toBe(false)\n })\n\n xit('second and third sides are equal', () => {\n const triangle = new Triangle(4, 3, 3)\n expect(triangle.isScalene).toBe(false)\n })\n\n xit('may not violate triangle inequality', () => {\n const triangle = new Triangle(7, 3, 2)\n expect(triangle.isScalene).toBe(false)\n })\n\n xit('sides may be floats', () => {\n const triangle = new Triangle(0.5, 0.4, 0.6)\n expect(triangle.isScalene).toBe(true)\n })\n })\n})\n" }, { "path": "exercises/practice/triangle/triangle.ts", "content": "export class Triangle {\n constructor(...sides) {\n throw new Error('Remove this line and implement the function')\n }\n\n get isEquilateral() {\n throw new Error('Remove this line and implement the function')\n }\n\n get isIsosceles() {\n throw new Error('Remove this line and implement the function')\n }\n\n get isScalene() {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/triangle/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/twelve-days/.docs/instructions.md", "content": "# Instructions\n\nYour task in this exercise is to write code that returns the lyrics of the song: \"The Twelve Days of Christmas.\"\n\n\"The Twelve Days of Christmas\" is a common English Christmas carol.\nEach subsequent verse of the song builds on the previous verse.\n\nThe lyrics your code returns should _exactly_ match the full song text shown below.\n\n## Lyrics\n\n```text\nOn the first day of Christmas my true love gave to me: a Partridge in a Pear Tree.\n\nOn the second day of Christmas my true love gave to me: two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the third day of Christmas my true love gave to me: three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the fourth day of Christmas my true love gave to me: four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the fifth day of Christmas my true love gave to me: five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the sixth day of Christmas my true love gave to me: six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the seventh day of Christmas my true love gave to me: seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the eighth day of Christmas my true love gave to me: eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the ninth day of Christmas my true love gave to me: nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the tenth day of Christmas my true love gave to me: ten Lords-a-Leaping, nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the eleventh day of Christmas my true love gave to me: eleven Pipers Piping, ten Lords-a-Leaping, nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n\nOn the twelfth day of Christmas my true love gave to me: twelve Drummers Drumming, eleven Pipers Piping, ten Lords-a-Leaping, nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\n```\n" }, { "path": "exercises/practice/twelve-days/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"PatrickMcSweeny\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"twelve-days.ts\"\n ],\n \"test\": [\n \"twelve-days.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Output the lyrics to 'The Twelve Days of Christmas'.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/The_Twelve_Days_of_Christmas_(song)\"\n}\n" }, { "path": "exercises/practice/twelve-days/.meta/proof.ci.ts", "content": "const days = [\n 'first',\n 'second',\n 'third',\n 'fourth',\n 'fifth',\n 'sixth',\n 'seventh',\n 'eighth',\n 'ninth',\n 'tenth',\n 'eleventh',\n 'twelfth',\n] as const\n\nconst gifts = [\n 'a Partridge in a Pear Tree.',\n 'two Turtle Doves, ',\n 'three French Hens, ',\n 'four Calling Birds, ',\n 'five Gold Rings, ',\n 'six Geese-a-Laying, ',\n 'seven Swans-a-Swimming, ',\n 'eight Maids-a-Milking, ',\n 'nine Ladies Dancing, ',\n 'ten Lords-a-Leaping, ',\n 'eleven Pipers Piping, ',\n 'twelve Drummers Drumming, ',\n] as const\n\nexport function recite(startVerse: number, endVerse: number): string {\n let lyrics = reciteVerse(startVerse)\n for (let i = startVerse + 1; i <= endVerse; i++) {\n lyrics += reciteVerse(i)\n }\n return lyrics\n}\n\nfunction reciteVerse(verse: number): string {\n let result =\n 'On the ' + days[verse - 1] + ' day of Christmas my true love gave to me: '\n for (let i = verse; i > 0; i--) {\n if (verse !== 1 && i === 1) {\n result += 'and '\n }\n result += gifts[i - 1]\n }\n result += '\\n'\n return result\n}\n" }, { "path": "exercises/practice/twelve-days/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[c0b5a5e6-c89d-49b1-a6b2-9f523bff33f7]\ndescription = \"first day a partridge in a pear tree\"\n\n[1c64508a-df3d-420a-b8e1-fe408847854a]\ndescription = \"second day two turtle doves\"\n\n[a919e09c-75b2-4e64-bb23-de4a692060a8]\ndescription = \"third day three french hens\"\n\n[9bed8631-ec60-4894-a3bb-4f0ec9fbe68d]\ndescription = \"fourth day four calling birds\"\n\n[cf1024f0-73b6-4545-be57-e9cea565289a]\ndescription = \"fifth day five gold rings\"\n\n[50bd3393-868a-4f24-a618-68df3d02ff04]\ndescription = \"sixth day six geese-a-laying\"\n\n[8f29638c-9bf1-4680-94be-e8b84e4ade83]\ndescription = \"seventh day seven swans-a-swimming\"\n\n[7038d6e1-e377-47ad-8c37-10670a05bc05]\ndescription = \"eighth day eight maids-a-milking\"\n\n[37a800a6-7a56-4352-8d72-0f51eb37cfe8]\ndescription = \"ninth day nine ladies dancing\"\n\n[10b158aa-49ff-4b2d-afc3-13af9133510d]\ndescription = \"tenth day ten lords-a-leaping\"\n\n[08d7d453-f2ba-478d-8df0-d39ea6a4f457]\ndescription = \"eleventh day eleven pipers piping\"\n\n[0620fea7-1704-4e48-b557-c05bf43967f0]\ndescription = \"twelfth day twelve drummers drumming\"\n\n[da8b9013-b1e8-49df-b6ef-ddec0219e398]\ndescription = \"recites first three verses of the song\"\n\n[c095af0d-3137-4653-ad32-bfb899eda24c]\ndescription = \"recites three verses from the middle of the song\"\n\n[20921bc9-cc52-4627-80b3-198cbbfcf9b7]\ndescription = \"recites the whole song\"\n" }, { "path": "exercises/practice/twelve-days/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/twelve-days/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/twelve-days/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/twelve-days/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/twelve-days/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/twelve-days/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/twelve-days/package.json", "content": "{\n \"name\": \"@exercism/typescript-twelve-days\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/twelve-days/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/twelve-days/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/twelve-days/twelve-days.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { recite } from './twelve-days.ts'\n\ndescribe('verse', () => {\n it('first day a partridge in a pear tree', () => {\n const expected =\n 'On the first day of Christmas my true love gave to me: a Partridge in a Pear Tree.\\n'\n expect(recite(1, 1)).toEqual(expected)\n })\n\n xit('second day two turtle doves', () => {\n const expected =\n 'On the second day of Christmas my true love gave to me: two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(2, 2)).toEqual(expected)\n })\n\n xit('third day three french hens', () => {\n const expected =\n 'On the third day of Christmas my true love gave to me: three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(3, 3)).toEqual(expected)\n })\n\n xit('fourth day four calling birds', () => {\n const expected =\n 'On the fourth day of Christmas my true love gave to me: four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(4, 4)).toEqual(expected)\n })\n\n xit('fifth day five gold rings', () => {\n const expected =\n 'On the fifth day of Christmas my true love gave to me: five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(5, 5)).toEqual(expected)\n })\n\n xit('sixth day six geese-a-laying', () => {\n const expected =\n 'On the sixth day of Christmas my true love gave to me: six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(6, 6)).toEqual(expected)\n })\n\n xit('seventh day seven swans-a-swimming', () => {\n const expected =\n 'On the seventh day of Christmas my true love gave to me: seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(7, 7)).toEqual(expected)\n })\n\n xit('eighth day eight maids-a-milking', () => {\n const expected =\n 'On the eighth day of Christmas my true love gave to me: eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(8, 8)).toEqual(expected)\n })\n\n xit('ninth day nine ladies dancing', () => {\n const expected =\n 'On the ninth day of Christmas my true love gave to me: nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(9, 9)).toEqual(expected)\n })\n\n xit('tenth day ten lords-a-leaping', () => {\n const expected =\n 'On the tenth day of Christmas my true love gave to me: ten Lords-a-Leaping, nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(10, 10)).toEqual(expected)\n })\n\n xit('eleventh day eleven pipers piping', () => {\n const expected =\n 'On the eleventh day of Christmas my true love gave to me: eleven Pipers Piping, ten Lords-a-Leaping, nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(11, 11)).toEqual(expected)\n })\n\n xit('twelfth day twelve drummers drumming', () => {\n const expected =\n 'On the twelfth day of Christmas my true love gave to me: twelve Drummers Drumming, eleven Pipers Piping, ten Lords-a-Leaping, nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(12, 12)).toEqual(expected)\n })\n})\n\ndescribe('lyrics', () => {\n xit('recites first three verses of the song', () => {\n const expected =\n 'On the first day of Christmas my true love gave to me: a Partridge in a Pear Tree.\\nOn the second day of Christmas my true love gave to me: two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the third day of Christmas my true love gave to me: three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(1, 3)).toEqual(expected)\n })\n\n xit('recites three verses from the middle of the song', () => {\n const expected =\n 'On the fourth day of Christmas my true love gave to me: four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the fifth day of Christmas my true love gave to me: five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the sixth day of Christmas my true love gave to me: six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(4, 6)).toEqual(expected)\n })\n\n xit('recites the whole song', () => {\n const expected =\n 'On the first day of Christmas my true love gave to me: a Partridge in a Pear Tree.\\nOn the second day of Christmas my true love gave to me: two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the third day of Christmas my true love gave to me: three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the fourth day of Christmas my true love gave to me: four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the fifth day of Christmas my true love gave to me: five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the sixth day of Christmas my true love gave to me: six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the seventh day of Christmas my true love gave to me: seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the eighth day of Christmas my true love gave to me: eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the ninth day of Christmas my true love gave to me: nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the tenth day of Christmas my true love gave to me: ten Lords-a-Leaping, nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the eleventh day of Christmas my true love gave to me: eleven Pipers Piping, ten Lords-a-Leaping, nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\nOn the twelfth day of Christmas my true love gave to me: twelve Drummers Drumming, eleven Pipers Piping, ten Lords-a-Leaping, nine Ladies Dancing, eight Maids-a-Milking, seven Swans-a-Swimming, six Geese-a-Laying, five Gold Rings, four Calling Birds, three French Hens, two Turtle Doves, and a Partridge in a Pear Tree.\\n'\n expect(recite(1, 12)).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/twelve-days/twelve-days.ts", "content": "export function recite() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/two-bucket/.docs/instructions.md", "content": "# Instructions\n\nGiven two buckets of different size and which bucket to fill first, determine how many actions are required to measure an exact number of liters by strategically transferring fluid between the buckets.\n\nThere are some rules that your solution must follow:\n\n- You can only do one action at a time.\n- There are only 3 possible actions:\n 1. Pouring one bucket into the other bucket until either:\n a) the first bucket is empty\n b) the second bucket is full\n 2. Emptying a bucket and doing nothing to the other.\n 3. Filling a bucket and doing nothing to the other.\n- After an action, you may not arrive at a state where the initial starting bucket is empty and the other bucket is full.\n\nYour program will take as input:\n\n- the size of bucket one\n- the size of bucket two\n- the desired number of liters to reach\n- which bucket to fill first, either bucket one or bucket two\n\nYour program should determine:\n\n- the total number of actions it should take to reach the desired number of liters, including the first fill of the starting bucket\n- which bucket should end up with the desired number of liters - either bucket one or bucket two\n- how many liters are left in the other bucket\n\nNote: any time a change is made to either or both buckets counts as one (1) action.\n\nExample:\nBucket one can hold up to 7 liters, and bucket two can hold up to 11 liters.\nLet's say at a given step, bucket one is holding 7 liters and bucket two is holding 8 liters (7,8).\nIf you empty bucket one and make no change to bucket two, leaving you with 0 liters and 8 liters respectively (0,8), that counts as one action.\nInstead, if you had poured from bucket one into bucket two until bucket two was full, resulting in 4 liters in bucket one and 11 liters in bucket two (4,11), that would also only count as one action.\n\nAnother Example:\nBucket one can hold 3 liters, and bucket two can hold up to 5 liters.\nYou are told you must start with bucket one.\nSo your first action is to fill bucket one.\nYou choose to empty bucket one for your second action.\nFor your third action, you may not fill bucket two, because this violates the third rule -- you may not end up in a state after any action where the starting bucket is empty and the other bucket is full.\n\nWritten with <3 at [Fullstack Academy][fullstack] by Lindsay Levine.\n\n[fullstack]: https://www.fullstackacademy.com/\n" }, { "path": "exercises/practice/two-bucket/.meta/config.json", "content": "{\n \"authors\": [],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"two-bucket.ts\"\n ],\n \"test\": [\n \"two-bucket.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given two buckets of different size, demonstrate how to measure an exact number of liters.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Water Pouring Problem\",\n \"source_url\": \"https://demonstrations.wolfram.com/WaterPouringProblem/\"\n}\n" }, { "path": "exercises/practice/two-bucket/.meta/proof.ci.ts", "content": "class Bucket {\n public name: string\n public readonly size: number\n public amount: number\n\n constructor(name: string, size: number) {\n this.name = name\n this.size = size\n this.amount = 0\n }\n\n // accessors\n public get available(): number {\n return this.size - this.amount\n }\n public get isFull(): boolean {\n return this.amount === this.size\n }\n public get isEmpty(): boolean {\n return this.amount === 0\n }\n\n public fill(): void {\n this.amount = this.size\n }\n public empty(): void {\n this.amount = 0\n }\n\n public pourInto(other: Bucket): void {\n const quantity = Math.min(this.amount, other.available)\n this.amount -= quantity\n other.amount += quantity\n }\n}\n\nconst gcd: (a: number, b: number) => number = (a, b) =>\n b === 0 ? a : gcd(b, a % b)\n\nexport class TwoBucket {\n private readonly buckets: Bucket[]\n private readonly goal: number\n public goalBucket: string | undefined\n public otherBucket: number | undefined\n\n constructor(size1: number, size2: number, goal: number, start: string) {\n this.goal = goal\n this.buckets = [new Bucket('one', size1), new Bucket('two', size2)]\n\n if (start === 'two') {\n this.buckets.reverse()\n }\n }\n\n private get first(): Bucket {\n return this.buckets[0]\n }\n private get second(): Bucket {\n return this.buckets[1]\n }\n\n private validate(): void {\n if (this.goal > Math.max(this.first.size, this.second.size)) {\n throw new Error('Goal is bigger than the largest bucket.')\n }\n\n if (this.goal % gcd(this.first.size, this.second.size) !== 0) {\n throw new Error(\n 'Goal must be a multiple of the GCD of the sizes of the two buckets.'\n )\n }\n }\n\n private moves(): number {\n this.validate()\n\n this.first.empty()\n this.second.empty()\n let moves = 0\n\n // fill the start bucket with the first move\n this.first.fill()\n moves += 1\n\n // optimization: if the other bucket is the right size,\n // fill it immediately with the second move\n if (this.second.size === this.goal) {\n this.second.fill()\n moves += 1\n }\n\n while (true) {\n if (this.first.amount === this.goal) {\n this.goalBucket = this.first.name\n this.otherBucket = this.second.amount\n return moves\n }\n\n if (this.second.amount === this.goal) {\n this.goalBucket = this.second.name\n this.otherBucket = this.first.amount\n return moves\n }\n\n if (this.first.isEmpty) {\n this.first.fill()\n } else if (this.second.isFull) {\n this.second.empty()\n } else {\n this.first.pourInto(this.second)\n }\n\n moves += 1\n }\n }\n}\n" }, { "path": "exercises/practice/two-bucket/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[a6f2b4ba-065f-4dca-b6f0-e3eee51cb661]\ndescription = \"Measure using bucket one of size 3 and bucket two of size 5 - start with bucket one\"\n\n[6c4ea451-9678-4926-b9b3-68364e066d40]\ndescription = \"Measure using bucket one of size 3 and bucket two of size 5 - start with bucket two\"\n\n[3389f45e-6a56-46d5-9607-75aa930502ff]\ndescription = \"Measure using bucket one of size 7 and bucket two of size 11 - start with bucket one\"\n\n[fe0ff9a0-3ea5-4bf7-b17d-6d4243961aa1]\ndescription = \"Measure using bucket one of size 7 and bucket two of size 11 - start with bucket two\"\n\n[0ee1f57e-da84-44f7-ac91-38b878691602]\ndescription = \"Measure one step using bucket one of size 1 and bucket two of size 3 - start with bucket two\"\n\n[eb329c63-5540-4735-b30b-97f7f4df0f84]\ndescription = \"Measure using bucket one of size 2 and bucket two of size 3 - start with bucket one and end with bucket two\"\n\n[58d70152-bf2b-46bb-ad54-be58ebe94c03]\ndescription = \"Measure using bucket one much bigger than bucket two\"\n\n[9dbe6499-caa5-4a58-b5ce-c988d71b8981]\ndescription = \"Measure using bucket one much smaller than bucket two\"\n\n[449be72d-b10a-4f4b-a959-ca741e333b72]\ndescription = \"Not possible to reach the goal\"\n\n[aac38b7a-77f4-4d62-9b91-8846d533b054]\ndescription = \"With the same buckets but a different goal, then it is possible\"\n\n[74633132-0ccf-49de-8450-af4ab2e3b299]\ndescription = \"Goal larger than both buckets is impossible\"\n" }, { "path": "exercises/practice/two-bucket/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/two-bucket/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/two-bucket/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/two-bucket/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/two-bucket/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/two-bucket/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/two-bucket/package.json", "content": "{\n \"name\": \"@exercism/typescript-two-bucket\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/two-bucket/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/two-bucket/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/two-bucket/two-bucket.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { TwoBucket } from './two-bucket.ts'\n\ndescribe('TwoBucket', () => {\n describe('Measure using bucket one of size 3 and bucket two of size 5', () => {\n const buckOne = 3\n const buckTwo = 5\n const goal = 1\n\n it('start with bucket one', () => {\n // indicates which bucket to fill first\n const starterBuck = 'one'\n const twoBucket = new TwoBucket(buckOne, buckTwo, goal, starterBuck)\n // includes the first fill\n expect(twoBucket.moves()).toEqual(4)\n // which bucket should end up with the desired # of liters\n expect(twoBucket.goalBucket).toEqual('one')\n // leftover value in the \"other\" bucket once the goal has been reached\n expect(twoBucket.otherBucket).toEqual(5)\n })\n\n xit('start with bucket two', () => {\n const starterBuck = 'two'\n const twoBucket = new TwoBucket(buckOne, buckTwo, goal, starterBuck)\n expect(twoBucket.moves()).toEqual(8)\n expect(twoBucket.goalBucket).toEqual('two')\n expect(twoBucket.otherBucket).toEqual(3)\n })\n })\n\n xdescribe('Measure using bucket one of size 7 and bucket two of size 11', () => {\n const buckOne = 7\n const buckTwo = 11\n const goal = 2\n\n xit('start with bucket one', () => {\n const starterBuck = 'one'\n const twoBucket = new TwoBucket(buckOne, buckTwo, goal, starterBuck)\n expect(twoBucket.moves()).toEqual(14)\n expect(twoBucket.goalBucket).toEqual('one')\n expect(twoBucket.otherBucket).toEqual(11)\n })\n\n xit('start with bucket two', () => {\n const starterBuck = 'two'\n const twoBucket = new TwoBucket(buckOne, buckTwo, goal, starterBuck)\n expect(twoBucket.moves()).toEqual(18)\n expect(twoBucket.goalBucket).toEqual('two')\n expect(twoBucket.otherBucket).toEqual(7)\n })\n })\n\n xdescribe('Measure one step using bucket one of size 1 and bucket two of size 3', () => {\n xit('start with bucket two', () => {\n const twoBucket = new TwoBucket(1, 3, 3, 'two')\n expect(twoBucket.moves()).toEqual(1)\n expect(twoBucket.goalBucket).toEqual('two')\n expect(twoBucket.otherBucket).toEqual(0)\n })\n })\n\n xdescribe('Measure using bucket one of size 2 and bucket two of size 3', () => {\n xit('start with bucket one and end with bucket two', () => {\n const twoBucket = new TwoBucket(2, 3, 3, 'one')\n expect(twoBucket.moves()).toEqual(2)\n expect(twoBucket.goalBucket).toEqual('two')\n expect(twoBucket.otherBucket).toEqual(2)\n })\n })\n\n xdescribe('Very different sizes', () => {\n xit('measure using bucket one much bigger than bucket two', () => {\n const twoBucket = new TwoBucket(5, 1, 2, 'one')\n expect(twoBucket.moves()).toEqual(6)\n expect(twoBucket.goalBucket).toEqual('one')\n expect(twoBucket.otherBucket).toEqual(1)\n })\n\n xit('measure using bucket one much smaller than bucket two', () => {\n const twoBucket = new TwoBucket(3, 15, 9, 'one')\n expect(twoBucket.moves()).toEqual(6)\n expect(twoBucket.goalBucket).toEqual('two')\n expect(twoBucket.otherBucket).toEqual(0)\n })\n })\n\n xdescribe('Reachability', () => {\n const buckOne = 6\n const buckTwo = 15\n const starterBuck = 'one'\n\n xit('Not possible to reach the goal', () => {\n const goal = 5\n const twoBucket = new TwoBucket(buckOne, buckTwo, goal, starterBuck)\n expect(() => twoBucket.moves()).toThrow()\n })\n\n xit('With the same buckets but a different goal, then it is possible', () => {\n const goal = 9\n const twoBucket = new TwoBucket(buckOne, buckTwo, goal, starterBuck)\n expect(twoBucket.moves()).toEqual(10)\n expect(twoBucket.goalBucket).toEqual('two')\n expect(twoBucket.otherBucket).toEqual(0)\n })\n })\n\n xdescribe('Goal larger than both buckets', () => {\n xit('Is impossible', () => {\n const twoBucket = new TwoBucket(5, 7, 8, 'one')\n expect(() => twoBucket.moves()).toThrow()\n })\n })\n})\n" }, { "path": "exercises/practice/two-bucket/two-bucket.ts", "content": "export class TwoBucket {\n constructor() {\n throw new Error('Remove this line and implement the function')\n }\n\n moves() {\n throw new Error('Remove this line and implement the function')\n }\n\n get goalBucket() {\n throw new Error('Remove this line and implement the function')\n }\n\n get otherBucket() {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/two-fer/.docs/instructions.md", "content": "# Instructions\n\nYour task is to determine what you will say as you give away the extra cookie.\n\nIf you know the person's name (e.g. if they're named Do-yun), then you will say:\n\n```text\nOne for Do-yun, one for me.\n```\n\nIf you don't know the person's name, you will say _you_ instead.\n\n```text\nOne for you, one for me.\n```\n\nHere are some examples:\n\n| Name | Dialogue |\n| :----- | :-------------------------- |\n| Alice | One for Alice, one for me. |\n| Bohdan | One for Bohdan, one for me. |\n| | One for you, one for me. |\n| Zaphod | One for Zaphod, one for me. |\n" }, { "path": "exercises/practice/two-fer/.docs/introduction.md", "content": "# Introduction\n\nIn some English accents, when you say \"two for\" quickly, it sounds like \"two fer\".\nTwo-for-one is a way of saying that if you buy one, you also get one for free.\nSo the phrase \"two-fer\" often implies a two-for-one offer.\n\nImagine a bakery that has a holiday offer where you can buy two cookies for the price of one (\"two-fer one!\").\nYou take the offer and (very generously) decide to give the extra cookie to someone else in the queue.\n" }, { "path": "exercises/practice/two-fer/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"two-fer.ts\"\n ],\n \"test\": [\n \"two-fer.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Create a sentence of the form \\\"One for X, one for me.\\\".\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source_url\": \"https://github.com/exercism/problem-specifications/issues/757\"\n}\n" }, { "path": "exercises/practice/two-fer/.meta/proof.ci.ts", "content": "export function twoFer(name = 'you'): string {\n return `One for ${name}, one for me.`\n}\n" }, { "path": "exercises/practice/two-fer/.meta/tests.toml", "content": "# This is an auto-generated file. Regular comments will be removed when this\n# file is regenerated. Regenerating will not touch any manually added keys,\n# so comments can be added in a \"comment\" key.\n\n[1cf3e15a-a3d7-4a87-aeb3-ba1b43bc8dce]\ndescription = \"no name given\"\n\n[b4c6dbb8-b4fb-42c2-bafd-10785abe7709]\ndescription = \"a name given\"\n\n[3549048d-1a6e-4653-9a79-b0bda163e8d5]\ndescription = \"another name given\"\n" }, { "path": "exercises/practice/two-fer/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/two-fer/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/two-fer/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/two-fer/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/two-fer/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/two-fer/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/two-fer/package.json", "content": "{\n \"name\": \"@exercism/typescript-two-fer\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/two-fer/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/two-fer/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/two-fer/two-fer.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { twoFer } from './two-fer.ts'\n\ndescribe('TwoFer', () => {\n it('no name given', () => {\n const expected = 'One for you, one for me.'\n expect(twoFer()).toEqual(expected)\n })\n\n xit('a name given', () => {\n const expected = 'One for Alice, one for me.'\n expect(twoFer('Alice')).toEqual(expected)\n })\n\n xit('another name given', () => {\n const expected = 'One for Bob, one for me.'\n expect(twoFer('Bob')).toEqual(expected)\n })\n})\n" }, { "path": "exercises/practice/two-fer/two-fer.ts", "content": "/**\n * This stub is provided to make it straightforward to get started.\n */\n\nexport function twoFer(): string {\n // ^ ^ ^ this is called a return type; it's the type of the\n // ^ ^ value that is returned from this function\n // ^ ^\n // ^ parameters go here\n // ^\n // allows the tests to import this function and call it\n // <-- Your code goes here. You may remove all the commentary in this file.\n}\n" }, { "path": "exercises/practice/variable-length-quantity/.docs/instructions.md", "content": "# Instructions\n\nImplement variable length quantity encoding and decoding.\n\nThe goal of this exercise is to implement [VLQ][vlq] encoding/decoding.\n\nIn short, the goal of this encoding is to encode integer values in a way that would save bytes.\nOnly the first 7 bits of each byte are significant (right-justified; sort of like an ASCII byte).\nSo, if you have a 32-bit value, you have to unpack it into a series of 7-bit bytes.\nOf course, you will have a variable number of bytes depending upon your integer.\nTo indicate which is the last byte of the series, you leave bit #7 clear.\nIn all of the preceding bytes, you set bit #7.\n\nSo, if an integer is between `0-127`, it can be represented as one byte.\nAlthough VLQ can deal with numbers of arbitrary sizes, for this exercise we will restrict ourselves to only numbers that fit in a 32-bit unsigned integer.\nHere are examples of integers as 32-bit values, and the variable length quantities that they translate to:\n\n```text\n NUMBER VARIABLE QUANTITY\n00000000 00\n00000040 40\n0000007F 7F\n00000080 81 00\n00002000 C0 00\n00003FFF FF 7F\n00004000 81 80 00\n00100000 C0 80 00\n001FFFFF FF FF 7F\n00200000 81 80 80 00\n08000000 C0 80 80 00\n0FFFFFFF FF FF FF 7F\n```\n\n[vlq]: https://en.wikipedia.org/wiki/Variable-length_quantity\n" }, { "path": "exercises/practice/variable-length-quantity/.meta/config.json", "content": "{\n \"authors\": [\n \"CRivasGomez\"\n ],\n \"contributors\": [\n \"masters3d\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"variable-length-quantity.ts\"\n ],\n \"test\": [\n \"variable-length-quantity.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Implement variable length quantity encoding and decoding.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"A poor Splice developer having to implement MIDI encoding/decoding.\",\n \"source_url\": \"https://splice.com\"\n}\n" }, { "path": "exercises/practice/variable-length-quantity/.meta/proof.ci.ts", "content": "const LENGTH = 7\nconst CONT_BITS = 1 << LENGTH\nconst DATA_BITS = CONT_BITS - 1\n\nfunction encodeOne(val: number): number[] {\n const buf: number[] = []\n let left = val\n\n while (left) {\n const bits = (left & DATA_BITS) | CONT_BITS // set continuation everywhere\n left = left >>> LENGTH\n buf.push(bits)\n }\n buf[0] = buf[0] & DATA_BITS // cancel the last continuation\n return buf.reverse()\n}\n\nfunction decodeOne(buf: number[]): number {\n let val = 0\n\n for (let i = 0; i <= buf.length - 1; i++) {\n val = (val << LENGTH) | (buf[i] & DATA_BITS)\n }\n return val >>> 0 // convert to unsigned 32-bit\n}\n\nexport function encode(data: number[]): number[] {\n let buf: number[] = []\n\n for (let i = 0; i <= data.length - 1; i++) {\n buf = buf.concat(encodeOne(data[i]))\n }\n return buf\n}\n\nexport function decode(data: number[]): number[] {\n let start = 0\n const vals = []\n\n for (let i = 0; i < data.length; i++) {\n if (~data[i] & CONT_BITS) {\n vals.push(decodeOne(data.slice(start, i + 1)))\n start = i + 1\n }\n }\n if (start < data.length) {\n throw new Error('Incomplete sequence')\n }\n return vals\n}\n" }, { "path": "exercises/practice/variable-length-quantity/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[35c9db2e-f781-4c52-b73b-8e76427defd0]\ndescription = \"Encode a series of integers, producing a series of bytes. -> zero\"\n\n[be44d299-a151-4604-a10e-d4b867f41540]\ndescription = \"Encode a series of integers, producing a series of bytes. -> arbitrary single byte\"\n\n[890bc344-cb80-45af-b316-6806a6971e81]\ndescription = \"Encode a series of integers, producing a series of bytes. -> asymmetric single byte\"\n\n[ea399615-d274-4af6-bbef-a1c23c9e1346]\ndescription = \"Encode a series of integers, producing a series of bytes. -> largest single byte\"\n\n[77b07086-bd3f-4882-8476-8dcafee79b1c]\ndescription = \"Encode a series of integers, producing a series of bytes. -> smallest double byte\"\n\n[63955a49-2690-4e22-a556-0040648d6b2d]\ndescription = \"Encode a series of integers, producing a series of bytes. -> arbitrary double byte\"\n\n[4977d113-251b-4d10-a3ad-2f5a7756bb58]\ndescription = \"Encode a series of integers, producing a series of bytes. -> asymmetric double byte\"\n\n[29da7031-0067-43d3-83a7-4f14b29ed97a]\ndescription = \"Encode a series of integers, producing a series of bytes. -> largest double byte\"\n\n[3345d2e3-79a9-4999-869e-d4856e3a8e01]\ndescription = \"Encode a series of integers, producing a series of bytes. -> smallest triple byte\"\n\n[5df0bc2d-2a57-4300-a653-a75ee4bd0bee]\ndescription = \"Encode a series of integers, producing a series of bytes. -> arbitrary triple byte\"\n\n[6731045f-1e00-4192-b5ae-98b22e17e9f7]\ndescription = \"Encode a series of integers, producing a series of bytes. -> asymmetric triple byte\"\n\n[f51d8539-312d-4db1-945c-250222c6aa22]\ndescription = \"Encode a series of integers, producing a series of bytes. -> largest triple byte\"\n\n[da78228b-544f-47b7-8bfe-d16b35bbe570]\ndescription = \"Encode a series of integers, producing a series of bytes. -> smallest quadruple byte\"\n\n[11ed3469-a933-46f1-996f-2231e05d7bb6]\ndescription = \"Encode a series of integers, producing a series of bytes. -> arbitrary quadruple byte\"\n\n[b45ef770-cbba-48c2-bd3c-c6362679516e]\ndescription = \"Encode a series of integers, producing a series of bytes. -> asymmetric quadruple byte\"\n\n[d5f3f3c3-e0f1-4e7f-aad0-18a44f223d1c]\ndescription = \"Encode a series of integers, producing a series of bytes. -> largest quadruple byte\"\n\n[91a18b33-24e7-4bfb-bbca-eca78ff4fc47]\ndescription = \"Encode a series of integers, producing a series of bytes. -> smallest quintuple byte\"\n\n[5f34ff12-2952-4669-95fe-2d11b693d331]\ndescription = \"Encode a series of integers, producing a series of bytes. -> arbitrary quintuple byte\"\n\n[9be46731-7cd5-415c-b960-48061cbc1154]\ndescription = \"Encode a series of integers, producing a series of bytes. -> asymmetric quintuple byte\"\n\n[7489694b-88c3-4078-9864-6fe802411009]\ndescription = \"Encode a series of integers, producing a series of bytes. -> maximum 32-bit integer input\"\n\n[f9b91821-cada-4a73-9421-3c81d6ff3661]\ndescription = \"Encode a series of integers, producing a series of bytes. -> two single-byte values\"\n\n[68694449-25d2-4974-ba75-fa7bb36db212]\ndescription = \"Encode a series of integers, producing a series of bytes. -> two multi-byte values\"\n\n[51a06b5c-de1b-4487-9a50-9db1b8930d85]\ndescription = \"Encode a series of integers, producing a series of bytes. -> many multi-byte values\"\n\n[baa73993-4514-4915-bac0-f7f585e0e59a]\ndescription = \"Decode a series of bytes, producing a series of integers. -> one byte\"\n\n[72e94369-29f9-46f2-8c95-6c5b7a595aee]\ndescription = \"Decode a series of bytes, producing a series of integers. -> two bytes\"\n\n[df5a44c4-56f7-464e-a997-1db5f63ce691]\ndescription = \"Decode a series of bytes, producing a series of integers. -> three bytes\"\n\n[1bb58684-f2dc-450a-8406-1f3452aa1947]\ndescription = \"Decode a series of bytes, producing a series of integers. -> four bytes\"\n\n[cecd5233-49f1-4dd1-a41a-9840a40f09cd]\ndescription = \"Decode a series of bytes, producing a series of integers. -> maximum 32-bit integer\"\n\n[e7d74ba3-8b8e-4bcb-858d-d08302e15695]\ndescription = \"Decode a series of bytes, producing a series of integers. -> incomplete sequence causes error\"\n\n[aa378291-9043-4724-bc53-aca1b4a3fcb6]\ndescription = \"Decode a series of bytes, producing a series of integers. -> incomplete sequence causes error, even if value is zero\"\n\n[a91e6f5a-c64a-48e3-8a75-ce1a81e0ebee]\ndescription = \"Decode a series of bytes, producing a series of integers. -> multiple values\"\n" }, { "path": "exercises/practice/variable-length-quantity/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/variable-length-quantity/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/variable-length-quantity/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/variable-length-quantity/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/variable-length-quantity/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/variable-length-quantity/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/variable-length-quantity/package.json", "content": "{\n \"name\": \"@exercism/typescript-variable-length-quantity\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/variable-length-quantity/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/variable-length-quantity/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/variable-length-quantity/variable-length-quantity.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { encode, decode } from './variable-length-quantity.ts'\n\ndescribe('VariableLengthQuantity', () => {\n describe('Encode a series of integers, producing a series of bytes.', () => {\n it('zero', () => {\n expect(encode([0])).toEqual([0])\n })\n\n xit('arbitrary single byte', () => {\n expect(encode([0x40])).toEqual([0x40])\n })\n\n xit('asymmetric single byte', () => {\n expect(encode([0x53])).toEqual([0x53])\n })\n\n xit('largest single byte', () => {\n expect(encode([0x7f])).toEqual([0x7f])\n })\n\n xit('smallest double byte', () => {\n expect(encode([0x80])).toEqual([0x81, 0])\n })\n\n xit('arbitrary double byte', () => {\n expect(encode([0x2000])).toEqual([0xc0, 0])\n })\n\n xit('asymmetric double byte', () => {\n expect(encode([0xad])).toEqual([0x81, 0x2d])\n })\n\n xit('largest double byte', () => {\n expect(encode([0x3fff])).toEqual([0xff, 0x7f])\n })\n\n xit('smallest triple byte', () => {\n expect(encode([0x4000])).toEqual([0x81, 0x80, 0])\n })\n\n xit('arbitrary triple byte', () => {\n expect(encode([0x100000])).toEqual([0xc0, 0x80, 0])\n })\n\n xit('asymmetric triple byte', () => {\n expect(encode([0x1d59c])).toEqual([0x87, 0xab, 0x1c])\n })\n\n xit('largest triple byte', () => {\n expect(encode([0x1fffff])).toEqual([0xff, 0xff, 0x7f])\n })\n\n xit('smallest quadruple byte', () => {\n expect(encode([0x200000])).toEqual([0x81, 0x80, 0x80, 0])\n })\n\n xit('arbitrary quadruple byte', () => {\n expect(encode([0x8000000])).toEqual([0xc0, 0x80, 0x80, 0])\n })\n\n xit('asymmetric quadruple byte', () => {\n expect(encode([0x357704])).toEqual([0x81, 0xd5, 0xee, 0x04])\n })\n\n xit('largest quadruple byte', () => {\n expect(encode([0xfffffff])).toEqual([0xff, 0xff, 0xff, 0x7f])\n })\n\n xit('smallest quintuple byte', () => {\n expect(encode([0x10000000])).toEqual([0x81, 0x80, 0x80, 0x80, 0])\n })\n\n xit('arbitrary quintuple byte', () => {\n expect(encode([0xff000000])).toEqual([0x8f, 0xf8, 0x80, 0x80, 0])\n })\n\n xit('asymmetric quintuple byte', () => {\n expect(encode([0x86656105])).toEqual([0x88, 0xb3, 0x95, 0xc2, 0x05])\n })\n\n xit('maximum 32-bit integer input', () => {\n expect(encode([0xffffffff])).toEqual([0x8f, 0xff, 0xff, 0xff, 0x7f])\n })\n\n xit('two single-byte values', () => {\n expect(encode([0x40, 0x7f])).toEqual([0x40, 0x7f])\n })\n\n xit('two multi-byte values', () => {\n expect(encode([0x4000, 0x123456])).toEqual([\n 0x81, 0x80, 0, 0xc8, 0xe8, 0x56,\n ])\n })\n\n xit('many multi-byte values', () => {\n const input = [0x2000, 0x123456, 0xfffffff, 0, 0x3fff, 0x4000]\n const expected = [\n 0xc0, 0, 0xc8, 0xe8, 0x56, 0xff, 0xff, 0xff, 0x7f, 0, 0xff, 0x7f, 0x81,\n 0x80, 0,\n ]\n expect(encode(input)).toEqual(expected)\n })\n })\n\n describe('Decode a series of bytes, producing a series of integers.', () => {\n xit('one byte', () => {\n expect(decode([0x7f])).toEqual([0x7f])\n })\n\n xit('two bytes', () => {\n expect(decode([0xc0, 0])).toEqual([0x2000])\n })\n\n xit('three bytes', () => {\n expect(decode([0xff, 0xff, 0x7f])).toEqual([0x1fffff])\n })\n\n xit('four bytes', () => {\n expect(decode([0x81, 0x80, 0x80, 0])).toEqual([0x200000])\n })\n\n xit('maximum 32-bit integer', () => {\n expect(decode([0x8f, 0xff, 0xff, 0xff, 0x7f])).toEqual([0xffffffff])\n })\n\n xit('incomplete sequence causes error', () => {\n expect(() => {\n decode([0xff])\n }).toThrow('Incomplete sequence')\n })\n\n xit('incomplete sequence causes error, even if value is zero', () => {\n expect(() => {\n decode([0x80])\n }).toThrow('Incomplete sequence')\n })\n\n xit('multiple values', () => {\n const input = [\n 0xc0, 0, 0xc8, 0xe8, 0x56, 0xff, 0xff, 0xff, 0x7f, 0, 0xff, 0x7f, 0x81,\n 0x80, 0,\n ]\n const expected = [0x2000, 0x123456, 0xfffffff, 0, 0x3fff, 0x4000]\n expect(decode(input)).toEqual(expected)\n })\n })\n})\n" }, { "path": "exercises/practice/variable-length-quantity/variable-length-quantity.ts", "content": "export function encode() {\n throw new Error('Remove this line and implement the function')\n}\n\nexport function decode() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/word-count/.docs/instructions.md", "content": "# Instructions\n\nYour task is to count how many times each word occurs in a subtitle of a drama.\n\nThe subtitles from these dramas use only ASCII characters.\n\nThe characters often speak in casual English, using contractions like _they're_ or _it's_.\nThough these contractions come from two words (e.g. _we are_), the contraction (_we're_) is considered a single word.\n\nWords can be separated by any form of punctuation (e.g. \":\", \"!\", or \"?\") or whitespace (e.g. \"\\t\", \"\\n\", or \" \").\nThe only punctuation that does not separate words is the apostrophe in contractions.\n\nNumbers are considered words.\nIf the subtitles say _It costs 100 dollars._ then _100_ will be its own word.\n\nWords are case insensitive.\nFor example, the word _you_ occurs three times in the following sentence:\n\n> You come back, you hear me? DO YOU HEAR ME?\n\nThe ordering of the word counts in the results doesn't matter.\n\nHere's an example that incorporates several of the elements discussed above:\n\n- simple words\n- contractions\n- numbers\n- case insensitive words\n- punctuation (including apostrophes) to separate words\n- different forms of whitespace to separate words\n\n`\"That's the password: 'PASSWORD 123'!\", cried the Special Agent.\\nSo I fled.`\n\nThe mapping for this subtitle would be:\n\n```text\n123: 1\nagent: 1\ncried: 1\nfled: 1\ni: 1\npassword: 2\nso: 1\nspecial: 1\nthat's: 1\nthe: 2\n```\n" }, { "path": "exercises/practice/word-count/.docs/introduction.md", "content": "# Introduction\n\nYou teach English as a foreign language to high school students.\n\nYou've decided to base your entire curriculum on TV shows.\nYou need to analyze which words are used, and how often they're repeated.\n\nThis will let you choose the simplest shows to start with, and to gradually increase the difficulty as time passes.\n" }, { "path": "exercises/practice/word-count/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"SleeplessByte\",\n \"angelikatyborska\"\n ],\n \"files\": {\n \"solution\": [\n \"word-count.ts\"\n ],\n \"test\": [\n \"word-count.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Given a phrase, count the occurrences of each word in that phrase.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"This is a classic toy problem, but we were reminded of it by seeing it in the Go Tour.\"\n}\n" }, { "path": "exercises/practice/word-count/.meta/proof.ci.ts", "content": "export function count(input: string): Map {\n const inputArray = input\n .trim()\n .toLowerCase()\n .split(/[ ,\\n]+/g)\n const inputMap = new Map()\n\n for (const each of inputArray) {\n const word = each.replace(/[.,!:\"&@$%^?]|^'|'$/g, '')\n\n if (word === '') {\n continue\n }\n const value = inputMap.get(word) || 0\n\n inputMap.set(word, value + 1)\n }\n return inputMap\n}\n" }, { "path": "exercises/practice/word-count/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[61559d5f-2cad-48fb-af53-d3973a9ee9ef]\ndescription = \"count one word\"\n\n[5abd53a3-1aed-43a4-a15a-29f88c09cbbd]\ndescription = \"count one of each word\"\n\n[2a3091e5-952e-4099-9fac-8f85d9655c0e]\ndescription = \"multiple occurrences of a word\"\n\n[e81877ae-d4da-4af4-931c-d923cd621ca6]\ndescription = \"handles cramped lists\"\n\n[7349f682-9707-47c0-a9af-be56e1e7ff30]\ndescription = \"handles expanded lists\"\n\n[a514a0f2-8589-4279-8892-887f76a14c82]\ndescription = \"ignore punctuation\"\n\n[d2e5cee6-d2ec-497b-bdc9-3ebe092ce55e]\ndescription = \"include numbers\"\n\n[dac6bc6a-21ae-4954-945d-d7f716392dbf]\ndescription = \"normalize case\"\n\n[4185a902-bdb0-4074-864c-f416e42a0f19]\ndescription = \"with apostrophes\"\ninclude = false\n\n[4ff6c7d7-fcfc-43ef-b8e7-34ff1837a2d3]\ndescription = \"with apostrophes\"\nreimplements = \"4185a902-bdb0-4074-864c-f416e42a0f19\"\n\n[be72af2b-8afe-4337-b151-b297202e4a7b]\ndescription = \"with quotations\"\n\n[8d6815fe-8a51-4a65-96f9-2fb3f6dc6ed6]\ndescription = \"substrings from the beginning\"\n\n[c5f4ef26-f3f7-4725-b314-855c04fb4c13]\ndescription = \"multiple spaces not detected as a word\"\n\n[50176e8a-fe8e-4f4c-b6b6-aa9cf8f20360]\ndescription = \"alternating word separators not detected as a word\"\n\n[6d00f1db-901c-4bec-9829-d20eb3044557]\ndescription = \"quotation for word with apostrophe\"\n" }, { "path": "exercises/practice/word-count/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/word-count/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/word-count/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/word-count/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/word-count/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/word-count/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/word-count/package.json", "content": "{\n \"name\": \"@exercism/typescript-word-count\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/word-count/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/word-count/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/word-count/word-count.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { count } from './word-count.ts'\n\ndescribe('count()', () => {\n it('counts one word', () => {\n const expectedCounts = new Map(Object.entries({ word: 1 }))\n expect(count('word')).toEqual(expectedCounts)\n })\n\n xit('counts one of each', () => {\n const expectedCounts = new Map(Object.entries({ one: 1, of: 1, each: 1 }))\n expect(count('one of each')).toEqual(expectedCounts)\n })\n\n xit('counts multiple occurrences', () => {\n const expectedCounts = new Map(\n Object.entries({ one: 1, fish: 4, two: 1, red: 1, blue: 1 })\n )\n expect(count('one fish two fish red fish blue fish')).toEqual(\n expectedCounts\n )\n })\n\n xit('handles cramped lists', () => {\n const expectedCounts = new Map(Object.entries({ one: 1, two: 1, three: 1 }))\n expect(count('one,two,three')).toEqual(expectedCounts)\n })\n\n xit('handles expanded lists', () => {\n const expectedCounts = new Map(Object.entries({ one: 1, two: 1, three: 1 }))\n expect(count('one,\\ntwo,\\nthree')).toEqual(expectedCounts)\n })\n\n xit('ignores punctuation', () => {\n const expectedCounts = new Map(\n Object.entries({\n car: 1,\n carpet: 1,\n as: 1,\n java: 1,\n javascript: 1,\n })\n )\n expect(count('car: carpet as java: javascript!!&@$%^&\"')).toEqual(\n expectedCounts\n )\n })\n\n xit('includes numbers', () => {\n const expectedCounts = new Map(Object.entries({ testing: 2, 1: 1, 2: 1 }))\n expect(count('testing, 1, 2 testing')).toEqual(expectedCounts)\n })\n\n xit('normalizes case', () => {\n const expectedCounts = new Map(Object.entries({ go: 3, stop: 2 }))\n expect(count('go Go GO Stop stop')).toEqual(expectedCounts)\n })\n\n xit('with apostrophes', () => {\n const expectedCounts = new Map(\n Object.entries({\n first: 1,\n \"don't\": 2,\n laugh: 1,\n then: 1,\n cry: 1,\n \"you're\": 1,\n getting: 1,\n it: 1,\n })\n )\n expect(\n count(\"'First: don't laugh. Then: don't cry. You're getting it.'\")\n ).toEqual(expectedCounts)\n })\n\n xit('substrings from the beginning', () => {\n const expectedCounts = new Map(\n Object.entries({\n joe: 1,\n \"can't\": 1,\n tell: 1,\n between: 1,\n app: 1,\n apple: 1,\n and: 1,\n a: 1,\n })\n )\n expect(count(\"Joe can't tell between app, apple and a.\")).toEqual(\n expectedCounts\n )\n })\n\n xit('multiple spaces not detected as a word', () => {\n const expectedCounts = new Map(\n Object.entries({ multiple: 1, whitespaces: 1 })\n )\n expect(count(' multiple whitespaces')).toEqual(expectedCounts)\n })\n\n xit('alternating word separators not detected as a word', () => {\n const expectedCounts = new Map(Object.entries({ one: 1, two: 1, three: 1 }))\n expect(count(\",\\n,one,\\n ,two \\n 'three'\")).toEqual(expectedCounts)\n })\n\n xit('quotation for word with apostrophe', () => {\n const expectedCounts = new Map(Object.entries({ can: 1, \"can't\": 2 }))\n expect(count(\"can, can't, 'can't'\")).toEqual(expectedCounts)\n })\n\n xit('handles properties that exist on Objectā€™s prototype', () => {\n const expectedCounts = new Map(\n Object.entries({\n reserved: 1,\n words: 1,\n like: 1,\n constructor: 1,\n and: 1,\n tostring: 1,\n ok: 1,\n })\n )\n expect(count('reserved words like constructor and toString ok?')).toEqual(\n expectedCounts\n )\n })\n})\n" }, { "path": "exercises/practice/word-count/word-count.ts", "content": "export function count() {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/word-search/.docs/instructions.md", "content": "# Instructions\n\nIn word search puzzles you get a square of letters and have to find specific words in them.\n\nFor example:\n\n```text\njefblpepre\ncamdcimgtc\noivokprjsm\npbwasqroua\nrixilelhrs\nwolcqlirpc\nscreeaumgr\nalxhpburyi\njalaycalmp\nclojurermt\n```\n\nThere are several programming languages hidden in the above square.\n\nWords can be hidden in all kinds of directions: left-to-right, right-to-left, vertical and diagonal.\n\nGiven a puzzle and a list of words return the location of the first and last letter of each word.\n" }, { "path": "exercises/practice/word-search/.meta/config.json", "content": "{\n \"authors\": [\n \"msomji\"\n ],\n \"contributors\": [\n \"ErikSchierboom\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"word-search.ts\"\n ],\n \"test\": [\n \"word-search.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Create a program to solve a word search puzzle.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n }\n}\n" }, { "path": "exercises/practice/word-search/.meta/proof.ci.ts", "content": "interface Result {\n start: number[]\n end: number[]\n}\n\nexport class WordSearch {\n private grid: string[]\n constructor(grid: string[]) {\n this.grid = grid\n }\n private findCoordsWhereLetterMatch(\n currentLetter: string,\n board: string[]\n ): number[][] {\n return board.reduce(\n (accumulatedCoordinates: number[][], row: string, rowNumber: number) => [\n ...accumulatedCoordinates,\n ...row\n .split('')\n .reduce(\n (\n matchingLetterIndecies: number[],\n letter: string,\n index: number\n ) =>\n letter === currentLetter\n ? [...matchingLetterIndecies, index]\n : matchingLetterIndecies,\n []\n )\n .reduce(\n (coordinates: number[][], col) => [\n ...coordinates,\n [rowNumber, col],\n ],\n []\n ),\n ],\n []\n )\n }\n\n private getCoordsOfSurroundingLetters(\n initialCoord: number[],\n totalRows: number,\n totalColumns: number\n ): number[][] {\n const top: number[] = [initialCoord[0] - 1, initialCoord[1]]\n const bottom: number[] = [initialCoord[0] + 1, initialCoord[1]]\n\n const right: number[] = [initialCoord[0], initialCoord[1] + 1]\n const left: number[] = [initialCoord[0], initialCoord[1] - 1]\n\n const topRight: number[] = [initialCoord[0] + 1, initialCoord[1] + 1]\n const topLeft: number[] = [initialCoord[0] + 1, initialCoord[1] - 1]\n\n const bottomRight: number[] = [initialCoord[0] - 1, initialCoord[1] + 1]\n const bottomLeft: number[] = [initialCoord[0] - 1, initialCoord[1] - 1]\n\n return [\n top,\n bottom,\n right,\n left,\n topRight,\n topLeft,\n bottomRight,\n bottomLeft,\n ].filter(\n (coordinates: number[]) =>\n coordinates[0] <= totalRows - 1 &&\n coordinates[1] <= totalColumns - 1 &&\n coordinates[0] >= 0 &&\n coordinates[1] >= 0\n )\n }\n\n private getValueFromCoordinate(\n board: string[],\n coordinates: number[]\n ): string {\n return (\n board[coordinates[0]] && board[coordinates[0]].split('')[coordinates[1]]\n )\n }\n\n private matchingValues(\n board: string[],\n coordinates: number[],\n letter: string\n ): boolean {\n return this.getValueFromCoordinate(board, coordinates) === letter\n }\n\n private getDirectionFunction(\n originCoords: number[],\n destinationCoords: number[]\n ): (currentCoords: number[]) => number[] {\n return (nextCoord: number[]): number[] => [\n nextCoord[0] + (destinationCoords[0] - originCoords[0]),\n nextCoord[1] + (destinationCoords[1] - originCoords[1]),\n ]\n }\n\n private getValidNeighbouringCoordinates(\n initial: number[],\n board: string[],\n letter: string\n ): number[][] {\n return this.getCoordsOfSurroundingLetters(\n initial,\n board.length,\n board[0].length\n ).filter((neighbouringCoordinate) =>\n this.matchingValues(board, neighbouringCoordinate, letter)\n )\n }\n\n private findOne(word: string, board: string[]): Result {\n const allPossibleStartCoords: number[][] = this.findCoordsWhereLetterMatch(\n word[0],\n board\n )\n const allPossibleCoordsForFirstTwoLetters: number[][][] =\n allPossibleStartCoords.reduce((accum: number[][][], initial) => {\n return [\n ...accum,\n ...this.getValidNeighbouringCoordinates(initial, board, word[1]).map(\n (secondCoordinate) => [initial, secondCoordinate]\n ),\n ]\n }, [])\n\n const allPossiblePaths: number[][][] =\n allPossibleCoordsForFirstTwoLetters.map((coordsSoFar: number[][]) => {\n const incrementFunction = this.getDirectionFunction(\n coordsSoFar[0],\n coordsSoFar[1]\n )\n return word\n .substr(2, word.length)\n .split('')\n .reduce(\n (accum: number[][], _) => [\n ...accum,\n incrementFunction(accum[accum.length - 1]),\n ],\n coordsSoFar\n )\n })\n\n const validPaths: number[][][] = allPossiblePaths.reduce(\n (result: number[][][], path: number[][]) =>\n word\n .split('')\n .map((letter, index) =>\n this.matchingValues(board, path[index], letter)\n )\n .includes(false)\n ? result\n : [...result, path],\n [] as number[][][]\n )\n\n return validPaths.reduce(\n (_: Result, path: number[][]) => ({\n start: path[0].map((c) => c + 1),\n end: path[path.length - 1].map((c) => c + 1),\n }),\n {} as Result\n )\n }\n\n public find(\n words: string[]\n ): { [word: string]: Result } | { [word: string]: undefined } {\n return words.reduce(\n (\n accum: { [word: string]: Result } | { [word: string]: undefined },\n word\n ) => {\n const result = this.findOne(word, this.grid)\n accum[word] = Object.keys(result).length === 0 ? undefined : result\n\n return accum\n },\n {} as { [word: string]: Result } | { [word: string]: undefined }\n )\n }\n}\n" }, { "path": "exercises/practice/word-search/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[b4057815-0d01-41f0-9119-6a91f54b2a0a]\ndescription = \"Should accept an initial game grid and a target search word\"\n\n[6b22bcc5-6cbf-4674-931b-d2edbff73132]\ndescription = \"Should locate one word written left to right\"\n\n[ff462410-434b-442d-9bc3-3360c75f34a8]\ndescription = \"Should locate the same word written left to right in a different position\"\n\n[a02febae-6347-443e-b99c-ab0afb0b8fca]\ndescription = \"Should locate a different left to right word\"\n\n[e42e9987-6304-4e13-8232-fa07d5280130]\ndescription = \"Should locate that different left to right word in a different position\"\n\n[9bff3cee-49b9-4775-bdfb-d55b43a70b2f]\ndescription = \"Should locate a left to right word in two line grid\"\n\n[851a35fb-f499-4ec1-9581-395a87903a22]\ndescription = \"Should locate a left to right word in three line grid\"\n\n[2f3dcf84-ba7d-4b75-8b8d-a3672b32c035]\ndescription = \"Should locate a left to right word in ten line grid\"\n\n[006d4856-f365-4e84-a18c-7d129ce9eefb]\ndescription = \"Should locate that left to right word in a different position in a ten line grid\"\n\n[eff7ac9f-ff11-443e-9747-40850c12ab60]\ndescription = \"Should locate a different left to right word in a ten line grid\"\n\n[dea39f86-8c67-4164-8884-13bfc48bd13b]\ndescription = \"Should locate multiple words\"\n\n[29e6a6a5-f80c-48a6-8e68-05bbbe187a09]\ndescription = \"Should locate a single word written right to left\"\n\n[3cf34428-b43f-48b6-b332-ea0b8836011d]\ndescription = \"Should locate multiple words written in different horizontal directions\"\n\n[2c8cd344-a02f-464b-93b6-8bf1bd890003]\ndescription = \"Should locate words written top to bottom\"\n\n[9ee1e43d-e59d-4c32-9a5f-6a22d4a1550f]\ndescription = \"Should locate words written bottom to top\"\n\n[6a21a676-f59e-4238-8e88-9f81015afae9]\ndescription = \"Should locate words written top left to bottom right\"\n\n[c9125189-1861-4b0d-a14e-ba5dab29ca7c]\ndescription = \"Should locate words written bottom right to top left\"\n\n[b19e2149-7fc5-41ec-a8a9-9bc6c6c38c40]\ndescription = \"Should locate words written bottom left to top right\"\n\n[69e1d994-a6d7-4e24-9b5a-db76751c2ef8]\ndescription = \"Should locate words written top right to bottom left\"\n\n[695531db-69eb-463f-8bad-8de3bf5ef198]\ndescription = \"Should fail to locate a word that is not in the puzzle\"\n\n[fda5b937-6774-4a52-8f89-f64ed833b175]\ndescription = \"Should fail to locate words that are not on horizontal, vertical, or diagonal lines\"\n\n[5b6198eb-2847-4e2f-8efe-65045df16bd3]\ndescription = \"Should not concatenate different lines to find a horizontal word\"\n\n[eba44139-a34f-4a92-98e1-bd5f259e5769]\ndescription = \"Should not wrap around horizontally to find a word\"\n\n[cd1f0fa8-76af-4167-b105-935f78364dac]\ndescription = \"Should not wrap around vertically to find a word\"\n" }, { "path": "exercises/practice/word-search/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/word-search/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/word-search/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/word-search/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/word-search/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/word-search/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/word-search/package.json", "content": "{\n \"name\": \"@exercism/typescript-word-search\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/word-search/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/word-search/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/word-search/word-search.test.ts", "content": "import { describe, xdescribe, it, expect, xit } from '@jest/globals'\nimport { WordSearch } from './word-search.ts'\n\ndescribe('single line grids', () => {\n it('should accept an initial game grid', () => {\n const grid = ['jefblpepre']\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch instanceof WordSearch).toEqual(true)\n })\n\n xit('should accept a target search word', () => {\n const grid = ['jefblpepre']\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['glasnost'])).toEqual({ glasnost: undefined })\n })\n\n xit('should locate a word written left to right', () => {\n const grid = ['clojurermt']\n const expectedResults = {\n clojure: {\n start: [1, 1],\n end: [1, 7],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['clojure'])).toEqual(expectedResults)\n })\n\n xit('should locate the same word written left to right in a different position', () => {\n const grid = ['mtclojurer']\n const expectedResults = {\n clojure: {\n start: [1, 3],\n end: [1, 9],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['clojure'])).toEqual(expectedResults)\n })\n\n xit('should locate a different left to right word', () => {\n const grid = ['coffeelplx']\n const expectedResults = {\n coffee: {\n start: [1, 1],\n end: [1, 6],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['coffee'])).toEqual(expectedResults)\n })\n\n xit('should locate that different left to right word in a different position', () => {\n const grid = ['xcoffeezlp']\n const expectedResults = {\n coffee: {\n start: [1, 2],\n end: [1, 7],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['coffee'])).toEqual(expectedResults)\n })\n})\n\nxdescribe('multi line grids', () => {\n xit('should locate a left to right word in a two line grid', () => {\n const grid = ['jefblpepre', 'clojurermt']\n\n const expectedResults = {\n clojure: {\n start: [2, 1],\n end: [2, 7],\n },\n }\n\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['clojure'])).toEqual(expectedResults)\n })\n\n xit('should locate a left to right word in a different position in a two line grid', () => {\n const grid = ['jefblpepre', 'tclojurerm']\n const expectedResults = {\n clojure: {\n start: [2, 2],\n end: [2, 8],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['clojure'])).toEqual(expectedResults)\n })\n\n xit('should locate a left to right word in a three line grid', () => {\n const grid = ['camdcimgtc', 'jefblpepre', 'clojurermt']\n const expectedResults = {\n clojure: {\n start: [3, 1],\n end: [3, 7],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['clojure'])).toEqual(expectedResults)\n })\n\n xit('should locate a left to right word in a ten line grid', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n ]\n\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['clojure'])).toEqual(expectedResults)\n })\n\n xit('should locate a left to right word in a different position in a ten line grid', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'clojurermt',\n 'jalaycalmp',\n ]\n\n const expectedResults = {\n clojure: {\n start: [9, 1],\n end: [9, 7],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['clojure'])).toEqual(expectedResults)\n })\n\n xit('should locate a different left to right word in a ten line grid', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'clojurermt',\n 'jalaycalmp',\n ]\n const expectedResults = {\n scree: {\n start: [7, 1],\n end: [7, 5],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['scree'])).toEqual(expectedResults)\n })\n})\n\nxdescribe('multiple words', () => {\n xit('should locate two words written left to right', () => {\n const grid = [\n 'aefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n 'xjavamtzlp',\n ]\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n java: {\n start: [11, 2],\n end: [11, 5],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['java', 'clojure'])).toEqual(expectedResults)\n })\n})\n\nxdescribe('different directions', () => {\n xit('should locate a single word written right to left', () => {\n const grid = ['rixilelhrs']\n const expectedResults = {\n elixir: {\n start: [1, 6],\n end: [1, 1],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['elixir'])).toEqual(expectedResults)\n })\n\n xit('should locate multiple words written in different horizontal directions', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n ]\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n elixir: {\n start: [5, 6],\n end: [5, 1],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['elixir', 'clojure'])).toEqual(expectedResults)\n })\n})\n\nxdescribe('vertical directions', () => {\n xit('should locate words written top to bottom', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n ]\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n elixir: {\n start: [5, 6],\n end: [5, 1],\n },\n ecmascript: {\n start: [1, 10],\n end: [10, 10],\n },\n }\n const wordSearch = new WordSearch(grid)\n expect(wordSearch.find(['elixir', 'clojure', 'ecmascript'])).toEqual(\n expectedResults\n )\n })\n\n xit('should locate words written bottom to top', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n ]\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n elixir: {\n start: [5, 6],\n end: [5, 1],\n },\n ecmascript: {\n start: [1, 10],\n end: [10, 10],\n },\n rust: {\n start: [5, 9],\n end: [2, 9],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(\n wordSearch.find(['elixir', 'clojure', 'ecmascript', 'rust'])\n ).toEqual(expectedResults)\n })\n\n xit('should locate words written top left to bottom right', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n ]\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n elixir: {\n start: [5, 6],\n end: [5, 1],\n },\n ecmascript: {\n start: [1, 10],\n end: [10, 10],\n },\n rust: {\n start: [5, 9],\n end: [2, 9],\n },\n java: {\n start: [1, 1],\n end: [4, 4],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(\n wordSearch.find(['clojure', 'elixir', 'ecmascript', 'rust', 'java'])\n ).toEqual(expectedResults)\n })\n\n xit('should locate words written bottom right to top left', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n ]\n\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n elixir: {\n start: [5, 6],\n end: [5, 1],\n },\n ecmascript: {\n start: [1, 10],\n end: [10, 10],\n },\n rust: {\n start: [5, 9],\n end: [2, 9],\n },\n java: {\n start: [1, 1],\n end: [4, 4],\n },\n lua: {\n start: [9, 8],\n end: [7, 6],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(\n wordSearch.find([\n 'clojure',\n 'elixir',\n 'ecmascript',\n 'rust',\n 'java',\n 'lua',\n ])\n ).toEqual(expectedResults)\n })\n\n xit('should locate words written bottom left to top right', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n ]\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n elixir: {\n start: [5, 6],\n end: [5, 1],\n },\n ecmascript: {\n start: [1, 10],\n end: [10, 10],\n },\n rust: {\n start: [5, 9],\n end: [2, 9],\n },\n java: {\n start: [1, 1],\n end: [4, 4],\n },\n lua: {\n start: [9, 8],\n end: [7, 6],\n },\n lisp: {\n start: [6, 3],\n end: [3, 6],\n },\n }\n\n const wordSearch = new WordSearch(grid)\n\n expect(\n wordSearch.find([\n 'clojure',\n 'elixir',\n 'ecmascript',\n 'rust',\n 'java',\n 'lua',\n 'lisp',\n ])\n ).toEqual(expectedResults)\n })\n\n xit('should locate words written top right to bottom left', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n ]\n\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n elixir: {\n start: [5, 6],\n end: [5, 1],\n },\n ecmascript: {\n start: [1, 10],\n end: [10, 10],\n },\n rust: {\n start: [5, 9],\n end: [2, 9],\n },\n java: {\n start: [1, 1],\n end: [4, 4],\n },\n lua: {\n start: [9, 8],\n end: [7, 6],\n },\n lisp: {\n start: [6, 3],\n end: [3, 6],\n },\n ruby: {\n start: [6, 8],\n end: [9, 5],\n },\n }\n const wordSearch = new WordSearch(grid)\n\n expect(\n wordSearch.find([\n 'clojure',\n 'elixir',\n 'ecmascript',\n 'rust',\n 'java',\n 'lua',\n 'lisp',\n 'ruby',\n ])\n ).toEqual(expectedResults)\n })\n})\n\nxdescribe('avoiding false-positives', () => {\n xit('should fail to locate a word that is not in the puzzle', () => {\n const grid = [\n 'jefblpepre',\n 'camdcimgtc',\n 'oivokprjsm',\n 'pbwasqroua',\n 'rixilelhrs',\n 'wolcqlirpc',\n 'screeaumgr',\n 'alxhpburyi',\n 'jalaycalmp',\n 'clojurermt',\n ]\n\n const expectedResults = {\n clojure: {\n start: [10, 1],\n end: [10, 7],\n },\n elixir: {\n start: [5, 6],\n end: [5, 1],\n },\n ecmascript: {\n start: [1, 10],\n end: [10, 10],\n },\n rust: {\n start: [5, 9],\n end: [2, 9],\n },\n java: {\n start: [1, 1],\n end: [4, 4],\n },\n lua: {\n start: [9, 8],\n end: [7, 6],\n },\n lisp: {\n start: [6, 3],\n end: [3, 6],\n },\n ruby: {\n start: [6, 8],\n end: [9, 5],\n },\n haskell: undefined,\n }\n const wordSearch = new WordSearch(grid)\n\n expect(\n wordSearch.find([\n 'clojure',\n 'elixir',\n 'ecmascript',\n 'rust',\n 'java',\n 'lua',\n 'lisp',\n 'ruby',\n 'haskell',\n ])\n ).toEqual(expectedResults)\n })\n\n xit('should fail to locate words that are not on horizontal, vertical, or diagonal lines', () => {\n const grid = ['abc', 'def']\n\n const expectedResults = {\n aef: undefined,\n ced: undefined,\n abf: undefined,\n cbd: undefined,\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['aef', 'ced', 'abf', 'cbd'])).toEqual(\n expectedResults\n )\n })\n\n xit('should not concatenate different lines to find a horizontal word', () => {\n const grid = ['abceli', 'xirdfg']\n\n const expectedResults = {\n elixir: undefined,\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['elixir'])).toEqual(expectedResults)\n })\n\n xit('should not wrap around horizontally to find a word', () => {\n const grid = ['silabcdefp']\n\n const expectedResults = {\n lisp: undefined,\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['lisp'])).toEqual(expectedResults)\n })\n\n xit('should not wrap around vertically to find a word', () => {\n const grid = ['s', 'u', 'r', 'a', 'b', 'c', 't']\n\n const expectedResults = {\n rust: undefined,\n }\n const wordSearch = new WordSearch(grid)\n\n expect(wordSearch.find(['rust'])).toEqual(expectedResults)\n })\n})\n" }, { "path": "exercises/practice/word-search/word-search.ts", "content": "export class WordSearch {\n constructor() {\n throw new Error('Remove this line and implement the function')\n }\n\n public find(words: string[]) {\n throw new Error('Remove this line and implement the function')\n }\n}\n" }, { "path": "exercises/practice/wordy/.docs/instructions.md", "content": "# Instructions\n\nParse and evaluate simple math word problems returning the answer as an integer.\n\n## Iteration 0 ā€” Numbers\n\nProblems with no operations simply evaluate to the number given.\n\n> What is 5?\n\nEvaluates to 5.\n\n## Iteration 1 ā€” Addition\n\nAdd two numbers together.\n\n> What is 5 plus 13?\n\nEvaluates to 18.\n\nHandle large numbers and negative numbers.\n\n## Iteration 2 ā€” Subtraction, Multiplication and Division\n\nNow, perform the other three operations.\n\n> What is 7 minus 5?\n\n2\n\n> What is 6 multiplied by 4?\n\n24\n\n> What is 25 divided by 5?\n\n5\n\n## Iteration 3 ā€” Multiple Operations\n\nHandle a set of operations, in sequence.\n\nSince these are verbal word problems, evaluate the expression from left-to-right, _ignoring the typical order of operations._\n\n> What is 5 plus 13 plus 6?\n\n24\n\n> What is 3 plus 2 multiplied by 3?\n\n15 (i.e. not 9)\n\n## Iteration 4 ā€” Errors\n\nThe parser should reject:\n\n- Unsupported operations (\"What is 52 cubed?\")\n- Non-math questions (\"Who is the President of the United States\")\n- Word problems with invalid syntax (\"What is 1 plus plus 2?\")\n" }, { "path": "exercises/practice/wordy/.meta/config.json", "content": "{\n \"authors\": [\n \"masters3d\"\n ],\n \"contributors\": [\n \"lukaszklis\",\n \"SleeplessByte\"\n ],\n \"files\": {\n \"solution\": [\n \"wordy.ts\"\n ],\n \"test\": [\n \"wordy.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Parse and evaluate simple math word problems returning the answer as an integer.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"Inspired by one of the generated questions in the Extreme Startup game.\",\n \"source_url\": \"https://github.com/rchatley/extreme_startup\"\n}\n" }, { "path": "exercises/practice/wordy/.meta/proof.ci.ts", "content": "const compute = (\n operand1: number,\n operand2: number,\n operation: string\n): number => {\n switch (operation) {\n case 'plus':\n return operand1 + operand2\n case 'minus':\n return operand1 - operand2\n case 'divided by':\n return operand1 / operand2\n case 'multiplied by':\n return operand1 * operand2\n }\n}\n\nexport const answer = (question: string): number => {\n const operationsPattern = new RegExp(/plus|minus|divided by|multiplied by/g)\n if (\n !operationsPattern.test(question) &&\n !/^What is ?-?\\d*\\?$/.test(question)\n ) {\n throw new Error('Unknown operation')\n }\n\n const generalPattern =\n /^What is -?\\d+( (plus|minus|multiplied by|divided by) -?\\d+)*\\?$/g\n if (!generalPattern.test(question)) {\n throw new Error('Syntax error')\n }\n\n const operations = question.match(operationsPattern)\n const operands = question.match(/-?\\d+/g)\n\n let result = parseInt(operands[0])\n\n if (!operations) {\n return result\n }\n\n for (let i = 0; i < operations.length; i++) {\n result = compute(result, parseInt(operands[i + 1]), operations[i])\n }\n return result\n}\n" }, { "path": "exercises/practice/wordy/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[88bf4b28-0de3-4883-93c7-db1b14aa806e]\ndescription = \"just a number\"\n\n[18983214-1dfc-4ebd-ac77-c110dde699ce]\ndescription = \"just a zero\"\n\n[607c08ee-2241-4288-916d-dae5455c87e6]\ndescription = \"just a negative number\"\n\n[bb8c655c-cf42-4dfc-90e0-152fcfd8d4e0]\ndescription = \"addition\"\n\n[bb9f2082-171c-46ad-ad4e-c3f72087c1b5]\ndescription = \"addition with a left hand zero\"\n\n[6fa05f17-405a-4742-80ae-5d1a8edb0d5d]\ndescription = \"addition with a right hand zero\"\n\n[79e49e06-c5ae-40aa-a352-7a3a01f70015]\ndescription = \"more addition\"\n\n[b345dbe0-f733-44e1-863c-5ae3568f3803]\ndescription = \"addition with negative numbers\"\n\n[cd070f39-c4cc-45c4-97fb-1be5e5846f87]\ndescription = \"large addition\"\n\n[0d86474a-cd93-4649-a4fa-f6109a011191]\ndescription = \"subtraction\"\n\n[30bc8395-5500-4712-a0cf-1d788a529be5]\ndescription = \"multiplication\"\n\n[34c36b08-8605-4217-bb57-9a01472c427f]\ndescription = \"division\"\n\n[da6d2ce4-fb94-4d26-8f5f-b078adad0596]\ndescription = \"multiple additions\"\n\n[7fd74c50-9911-4597-be09-8de7f2fea2bb]\ndescription = \"addition and subtraction\"\n\n[b120ffd5-bad6-4e22-81c8-5512e8faf905]\ndescription = \"multiple subtraction\"\n\n[4f4a5749-ef0c-4f60-841f-abcfaf05d2ae]\ndescription = \"subtraction then addition\"\n\n[312d908c-f68f-42c9-aa75-961623cc033f]\ndescription = \"multiple multiplication\"\n\n[38e33587-8940-4cc1-bc28-bfd7e3966276]\ndescription = \"addition and multiplication\"\n\n[3c854f97-9311-46e8-b574-92b60d17d394]\ndescription = \"multiple division\"\n\n[3ad3e433-8af7-41ec-aa9b-97b42ab49357]\ndescription = \"unknown operation\"\n\n[8a7e85a8-9e7b-4d46-868f-6d759f4648f8]\ndescription = \"Non math question\"\n\n[42d78b5f-dbd7-4cdb-8b30-00f794bb24cf]\ndescription = \"reject problem missing an operand\"\n\n[c2c3cbfc-1a72-42f2-b597-246e617e66f5]\ndescription = \"reject problem with no operands or operators\"\n\n[4b3df66d-6ed5-4c95-a0a1-d38891fbdab6]\ndescription = \"reject two operations in a row\"\n\n[6abd7a50-75b4-4665-aa33-2030fd08bab1]\ndescription = \"reject two numbers in a row\"\n\n[10a56c22-e0aa-405f-b1d2-c642d9c4c9de]\ndescription = \"reject postfix notation\"\n\n[0035bc63-ac43-4bb5-ad6d-e8651b7d954e]\ndescription = \"reject prefix notation\"\n" }, { "path": "exercises/practice/wordy/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/wordy/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/wordy/.yarnrc.yml", "content": "compressionLevel: mixed\n\nenableGlobalCache: true\n" }, { "path": "exercises/practice/wordy/babel.config.cjs", "content": "module.exports = {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n presets: [[require('@exercism/babel-preset-typescript'), { corejs: '3.38' }]],\n plugins: [],\n}\n" }, { "path": "exercises/practice/wordy/eslint.config.mjs", "content": "// @ts-check\n\nimport tsEslint from 'typescript-eslint'\nimport config from '@exercism/eslint-config-typescript'\nimport maintainersConfig from '@exercism/eslint-config-typescript/maintainers.mjs'\n\nexport default [\n ...tsEslint.config(...config, {\n files: ['.meta/proof.ci.ts', '.meta/exemplar.ts', '*.test.ts'],\n extends: maintainersConfig,\n }),\n {\n ignores: [\n // # Protected or generated\n '.git/**/*',\n '.vscode/**/*',\n\n //# When using npm\n 'node_modules/**/*',\n\n // # Configuration files\n 'babel.config.cjs',\n 'jest.config.cjs',\n ],\n },\n]\n" }, { "path": "exercises/practice/wordy/jest.config.cjs", "content": "module.exports = {\n verbose: true,\n projects: [''],\n testMatch: [\n '**/__tests__/**/*.[jt]s?(x)',\n '**/test/**/*.[jt]s?(x)',\n '**/?(*.)+(spec|test).[jt]s?(x)',\n ],\n testPathIgnorePatterns: [\n '/(?:production_)?node_modules/',\n '.d.ts$',\n '/test/fixtures',\n '/test/helpers',\n '__mocks__',\n ],\n transform: {\n '^.+\\\\.[jt]sx?$': 'babel-jest',\n },\n moduleNameMapper: {\n '^(\\\\.\\\\/.+)\\\\.js$': '$1',\n },\n}\n" }, { "path": "exercises/practice/wordy/package.json", "content": "{\n \"name\": \"@exercism/typescript-wordy\",\n \"version\": \"1.0.0\",\n \"description\": \"Exercism exercises in Typescript.\",\n \"private\": true,\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/exercism/typescript\"\n },\n \"type\": \"module\",\n \"engines\": {\n \"node\": \"^18.16.0 || >=20.0.0\"\n },\n \"devDependencies\": {\n \"@exercism/babel-preset-typescript\": \"^0.6.0\",\n \"@exercism/eslint-config-typescript\": \"^0.8.0\",\n \"@jest/globals\": \"^29.7.0\",\n \"@types/node\": \"~22.7.6\",\n \"babel-jest\": \"^29.7.0\",\n \"core-js\": \"~3.38.1\",\n \"eslint\": \"^9.12.0\",\n \"expect\": \"^29.7.0\",\n \"jest\": \"^29.7.0\",\n \"prettier\": \"^3.3.3\",\n \"tstyche\": \"^2.1.1\",\n \"typescript\": \"~5.6.3\",\n \"typescript-eslint\": \"^8.10.0\"\n },\n \"scripts\": {\n \"test\": \"corepack yarn node test-runner.mjs\",\n \"test:types\": \"corepack yarn tstyche\",\n \"test:implementation\": \"corepack yarn jest --no-cache --passWithNoTests\",\n \"lint\": \"corepack yarn lint:types && corepack yarn lint:ci\",\n \"lint:types\": \"corepack yarn tsc --noEmit -p .\",\n \"lint:ci\": \"corepack yarn eslint . --ext .tsx,.ts\"\n },\n \"packageManager\": \"yarn@4.5.1\"\n}\n" }, { "path": "exercises/practice/wordy/test-runner.mjs", "content": "#!/usr/bin/env node\n\n/**\n * šŸ‘‹šŸ½ Hello there reader,\n *\n * It looks like you are working on this solution using the Exercism CLI and\n * not the online editor. That's great! The file you are looking at executes\n * the various steps the online test-runner also takes.\n *\n * @see https://github.com/exercism/typescript-test-runner\n *\n * TypeScript track exercises generally consist of at least two out of three\n * types of tests to run.\n *\n * 1. tsc, the TypeScript compiler. This tests if the TypeScript code is valid\n * 2. tstyche, static analysis tests to see if the types used are expected\n * 3. jest, runtime implementation tests to see if the solution is correct\n *\n * If one of these three fails, this script terminates with -1, -2, or -3\n * respectively. If it succeeds, it terminates with exit code 0.\n *\n * @note you need corepack (bundled with node LTS) enabled in order for this\n * test runner to work as expected. Follow the installation and test\n * instructions if you see errors about corepack or pnp.\n */\n\nimport { execSync } from 'node:child_process'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { exit } from 'node:process'\nimport { URL } from 'node:url'\n\n/**\n * Before executing any tests, the test runner attempts to find the\n * exercise config.json file which has metadata about which types of tests\n * to run for this solution.\n */\nconst metaDirectory = new URL('./.meta/', import.meta.url)\nconst exercismDirectory = new URL('./.exercism/', import.meta.url)\nconst configDirectory = existsSync(metaDirectory)\n ? metaDirectory\n : existsSync(exercismDirectory)\n ? exercismDirectory\n : null\n\nif (configDirectory === null) {\n throw new Error(\n 'Expected .meta or .exercism directory to exist, but I cannot find it.'\n )\n}\n\nconst configFile = new URL('./config.json', configDirectory)\nif (!existsSync(configFile)) {\n throw new Error('Expected config.json to exist at ' + configFile.toString())\n}\n\n// Experimental: import config from './config.json' with { type: 'json' }\n/** @type {import('./config.json') } */\nconst config = JSON.parse(readFileSync(configFile))\n\nconst jest = !config.custom || config.custom['flag.tests.jest']\nconst tstyche = config.custom?.['flag.tests.tstyche']\nconsole.log(\n `[tests] tsc: āœ…, tstyche: ${tstyche ? 'āœ…' : 'āŒ'}, jest: ${jest ? 'āœ…' : 'āŒ'}, `\n)\n\n/**\n * 1. tsc: the typescript compiler\n */\ntry {\n console.log('[tests] tsc (compile)')\n execSync('corepack yarn lint:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n} catch {\n exit(-1)\n}\n\n/**\n * 2. tstyche: type tests\n */\nif (tstyche) {\n try {\n console.log('[tests] tstyche (type tests)')\n execSync('corepack yarn test:types', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-2)\n }\n}\n\n/**\n * 3. jest: implementation tests\n */\nif (jest) {\n try {\n console.log('[tests] tstyche (implementation tests)')\n execSync('corepack yarn test:implementation', {\n stdio: 'inherit',\n cwd: process.cwd(),\n })\n } catch {\n exit(-3)\n }\n}\n\n/**\n * Done! šŸ„³\n */\n" }, { "path": "exercises/practice/wordy/tsconfig.json", "content": "{\n \"display\": \"Configuration for Exercism TypeScript Exercises\",\n \"compilerOptions\": {\n // Allows you to use the newest syntax, and have access to console.log\n // https://www.typescriptlang.org/tsconfig#lib\n \"lib\": [\"ES2020\", \"dom\"],\n // Make sure typescript is configured to output ESM\n // https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c#how-can-i-make-my-typescript-project-output-esm\n \"module\": \"Node16\",\n // Since this project is using babel, TypeScript may target something very\n // high, and babel will make sure it runs on your local Node version.\n // https://babeljs.io/docs/en/\n \"target\": \"ES2020\", // ESLint doesn't support this yet: \"es2022\",\n\n \"strict\": true,\n \"esModuleInterop\": true,\n \"skipLibCheck\": true,\n \"forceConsistentCasingInFileNames\": true,\n\n // Because jest-resolve isn't like node resolve, the absolute path must be .ts\n \"allowImportingTsExtensions\": true,\n \"noEmit\": true,\n\n // Because we'll be using babel: ensure that Babel can safely transpile\n // files in the TypeScript project.\n //\n // https://babeljs.io/docs/en/babel-plugin-transform-typescript/#caveats\n \"isolatedModules\": true\n },\n \"include\": [\n \"*.ts\",\n \"*.tsx\",\n \".meta/*.ts\",\n \".meta/*.tsx\",\n \"__typetests__/*.tst.ts\"\n ],\n \"exclude\": [\"node_modules\"]\n}\n" }, { "path": "exercises/practice/wordy/wordy.test.ts", "content": "import { describe, it, expect, xit } from '@jest/globals'\nimport { answer } from './wordy.ts'\n\ndescribe('Wordy', () => {\n it('just a number', () => {\n expect(answer('What is 5?')).toEqual(5)\n })\n\n xit('just a zero', () => {\n expect(answer('What is 0?')).toEqual(0)\n })\n\n xit('just a negative number', () => {\n expect(answer('What is -123?')).toEqual(-123)\n })\n\n xit('addition', () => {\n expect(answer('What is 1 plus 1?')).toEqual(2)\n })\n\n xit('addition with a left hand zero', () => {\n expect(answer('What is 0 plus 2?')).toEqual(2)\n })\n\n xit('addition with a right hand zero', () => {\n expect(answer('What is 3 plus 0?')).toEqual(3)\n })\n\n xit('more addition', () => {\n expect(answer('What is 53 plus 2?')).toEqual(55)\n })\n\n xit('addition with negative numbers', () => {\n expect(answer('What is -1 plus -10?')).toEqual(-11)\n })\n\n xit('large addition', () => {\n expect(answer('What is 123 plus 45678?')).toEqual(45801)\n })\n\n xit('subtraction', () => {\n expect(answer('What is 4 minus -12?')).toEqual(16)\n })\n\n xit('multiplication', () => {\n expect(answer('What is -3 multiplied by 25?')).toEqual(-75)\n })\n\n xit('division', () => {\n expect(answer('What is 33 divided by -3?')).toEqual(-11)\n })\n\n xit('multiple additions', () => {\n expect(answer('What is 1 plus 1 plus 1?')).toEqual(3)\n })\n\n xit('addition and subtraction', () => {\n expect(answer('What is 1 plus 5 minus -2?')).toEqual(8)\n })\n\n xit('multiple subtraction', () => {\n expect(answer('What is 20 minus 4 minus 13?')).toEqual(3)\n })\n\n xit('subtraction then addition', () => {\n expect(answer('What is 17 minus 6 plus 3?')).toEqual(14)\n })\n\n xit('multiple multiplication', () => {\n expect(answer('What is 2 multiplied by -2 multiplied by 3?')).toEqual(-12)\n })\n\n xit('addition and multiplication', () => {\n expect(answer('What is -3 plus 7 multiplied by -2?')).toEqual(-8)\n })\n\n xit('multiple division', () => {\n expect(answer('What is -12 divided by 2 divided by -3?')).toEqual(2)\n })\n\n xit('unknown operation', () => {\n expect(() => answer('What is 52 cubed?')).toThrow(\n new Error('Unknown operation')\n )\n })\n\n xit('Non math question', () => {\n expect(() => answer('Who is the President of the United States?')).toThrow(\n new Error('Unknown operation')\n )\n })\n\n xit('reject problem missing an operand', () => {\n expect(() => answer('What is 1 plus?')).toThrow(new Error('Syntax error'))\n })\n\n xit('reject problem with no operands or operators', () => {\n expect(() => answer('What is?')).toThrow(new Error('Syntax error'))\n })\n\n xit('reject two operations in a row', () => {\n expect(() => answer('What is 1 plus plus 2?')).toThrow(\n new Error('Syntax error')\n )\n })\n\n xit('reject two numbers in a row', () => {\n expect(() => answer('What is 1 plus 2 1?')).toThrow(\n new Error('Syntax error')\n )\n })\n\n xit('reject postfix notation', () => {\n expect(() => answer('What is 1 2 plus?')).toThrow(new Error('Syntax error'))\n })\n\n xit('reject prefix notation', () => {\n expect(() => answer('What is plus 1 2?')).toThrow(new Error('Syntax error'))\n })\n})\n" }, { "path": "exercises/practice/wordy/wordy.ts", "content": "export const answer = () => {\n throw new Error('Remove this line and implement the function')\n}\n" }, { "path": "exercises/practice/yacht/.docs/instructions.md", "content": "# Instructions\n\nGiven five dice and a category, calculate the score of the dice for that category.\n\n~~~~exercism/note\nYou'll always be presented with five dice.\nEach dice's value will be between one and six inclusively.\nThe dice may be unordered.\n~~~~\n\n## Scores in Yacht\n\n| Category | Score | Description | Example |\n| --------------- | ---------------------- | ---------------------------------------- | ------------------- |\n| Ones | 1 Ɨ number of ones | Any combination | 1 1 1 4 5 scores 3 |\n| Twos | 2 Ɨ number of twos | Any combination | 2 2 3 4 5 scores 4 |\n| Threes | 3 Ɨ number of threes | Any combination | 3 3 3 3 3 scores 15 |\n| Fours | 4 Ɨ number of fours | Any combination | 1 2 3 3 5 scores 0 |\n| Fives | 5 Ɨ number of fives | Any combination | 5 1 5 2 5 scores 15 |\n| Sixes | 6 Ɨ number of sixes | Any combination | 2 3 4 5 6 scores 6 |\n| Full House | Total of the dice | Three of one number and two of another | 3 3 3 5 5 scores 19 |\n| Four of a Kind | Total of the four dice | At least four dice showing the same face | 4 4 4 4 6 scores 16 |\n| Little Straight | 30 points | 1-2-3-4-5 | 1 2 3 4 5 scores 30 |\n| Big Straight | 30 points | 2-3-4-5-6 | 2 3 4 5 6 scores 30 |\n| Choice | Sum of the dice | Any combination | 2 3 3 4 6 scores 18 |\n| Yacht | 50 points | All five dice showing the same face | 4 4 4 4 4 scores 50 |\n\nIf the dice do **not** satisfy the requirements of a category, the score is zero.\nIf, for example, _Four Of A Kind_ is entered in the _Yacht_ category, zero points are scored.\nA _Yacht_ scores zero if entered in the _Full House_ category.\n" }, { "path": "exercises/practice/yacht/.docs/introduction.md", "content": "# Introduction\n\nEach year, something new is \"all the rage\" in your high school.\nThis year it is a dice game: [Yacht][yacht].\n\nThe game of Yacht is from the same family as Poker Dice, Generala and particularly Yahtzee, of which it is a precursor.\nThe game consists of twelve rounds.\nIn each, five dice are rolled and the player chooses one of twelve categories.\nThe chosen category is then used to score the throw of the dice.\n\n[yacht]: https://en.wikipedia.org/wiki/Yacht_(dice_game)\n" }, { "path": "exercises/practice/yacht/.meta/config.json", "content": "{\n \"authors\": [\n \"xavdid\"\n ],\n \"contributors\": [\n \"BNAndras\"\n ],\n \"files\": {\n \"solution\": [\n \"yacht.ts\"\n ],\n \"test\": [\n \"yacht.test.ts\"\n ],\n \"example\": [\n \".meta/proof.ci.ts\"\n ]\n },\n \"blurb\": \"Score a single throw of dice in the game Yacht.\",\n \"custom\": {\n \"version.tests.compatibility\": \"jest-29\",\n \"flag.tests.task-per-describe\": false,\n \"flag.tests.may-run-long\": false,\n \"flag.tests.includes-optional\": false,\n \"flag.tests.jest\": true,\n \"flag.tests.tstyche\": false\n },\n \"source\": \"James Kilfiger, using Wikipedia\",\n \"source_url\": \"https://en.wikipedia.org/wiki/Yacht_(dice_game)\"\n}\n" }, { "path": "exercises/practice/yacht/.meta/proof.ci.ts", "content": "export const enum Category {\n ONES,\n TWOS,\n THREES,\n FOURS,\n FIVES,\n SIXES,\n FULL_HOUSE,\n FOUR_OF_A_KIND,\n LITTLE_STRAIGHT,\n BIG_STRAIGHT,\n CHOICE,\n YACHT,\n}\n\n/**\n * multiplies the number of occurances of a specific value by that number\n */\nconst countSingles = (dice: number[], value: number): number =>\n value * dice.filter((d) => d === value).length\n\n/**\n * sorts a list of numbers in numerically increasing order\n */\nconst sortNumbers = (dice: number[]): number[] =>\n [...dice].sort((a, b) => a - b)\n\n/**\n * build a mapping of the number of occurances of each die. For example. a full house of 1s and 6s will return `{1: 2, 6: 3}`\n */\nconst frequencies = (dice: number[]): Record =>\n dice.reduce(\n (res, d) => ({\n ...res,\n [d]: (res[d] ?? 0) + 1,\n }),\n {} as Record\n )\n\n/**\n * sums a list of numbers\n */\nconst sum = (dice: number[]): number => dice.reduce((res, d) => d + res, 0)\n\n/**\n * compares two list of numbers for equality\n */\nconst eq = (l: number[], r: number[]): boolean =>\n JSON.stringify(l) === JSON.stringify(r)\n\nexport const score = (dice: number[], category: Category): number => {\n switch (category) {\n case Category.ONES:\n return countSingles(dice, 1)\n case Category.TWOS:\n return countSingles(dice, 2)\n case Category.THREES:\n return countSingles(dice, 3)\n case Category.FOURS:\n return countSingles(dice, 4)\n case Category.FIVES:\n return countSingles(dice, 5)\n case Category.SIXES:\n return countSingles(dice, 6)\n case Category.FULL_HOUSE:\n return eq(sortNumbers(Object.values(frequencies(dice))), [2, 3])\n ? sum(dice)\n : 0\n case Category.FOUR_OF_A_KIND:\n return sum(\n Object.entries(frequencies(dice)).map(([d, count]) =>\n count >= 4 ? parseInt(d) * 4 : 0\n )\n )\n case Category.LITTLE_STRAIGHT:\n return eq(sortNumbers(dice), [1, 2, 3, 4, 5]) ? 30 : 0\n case Category.BIG_STRAIGHT:\n return eq(sortNumbers(dice), [2, 3, 4, 5, 6]) ? 30 : 0\n case Category.CHOICE:\n return sum(dice)\n case Category.YACHT:\n return new Set(dice).size === 1 ? 50 : 0\n default:\n throw new Error('unhandled case')\n }\n}\n" }, { "path": "exercises/practice/yacht/.meta/tests.toml", "content": "# This is an auto-generated file.\n#\n# Regenerating this file via `configlet sync` will:\n# - Recreate every `description` key/value pair\n# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications\n# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)\n# - Preserve any other key/value pair\n#\n# As user-added comments (using the # character) will be removed when this file\n# is regenerated, comments can be added via a `comment` key.\n\n[3060e4a5-4063-4deb-a380-a630b43a84b6]\ndescription = \"Yacht\"\n\n[15026df2-f567-482f-b4d5-5297d57769d9]\ndescription = \"Not Yacht\"\n\n[36b6af0c-ca06-4666-97de-5d31213957a4]\ndescription = \"Ones\"\n\n[023a07c8-6c6e-44d0-bc17-efc5e1b8205a]\ndescription = \"Ones, out of order\"\n\n[7189afac-cccd-4a74-8182-1cb1f374e496]\ndescription = \"No ones\"\n\n[793c4292-dd14-49c4-9707-6d9c56cee725]\ndescription = \"Twos\"\n\n[dc41bceb-d0c5-4634-a734-c01b4233a0c6]\ndescription = \"Fours\"\n\n[f6125417-5c8a-4bca-bc5b-b4b76d0d28c8]\ndescription = \"Yacht counted as threes\"\n\n[464fc809-96ed-46e4-acb8-d44e302e9726]\ndescription = \"Yacht of 3s counted as fives\"\n\n[d054227f-3a71-4565-a684-5c7e621ec1e9]\ndescription = \"Fives\"\n\n[e8a036e0-9d21-443a-8b5f-e15a9e19a761]\ndescription = \"Sixes\"\n\n[51cb26db-6b24-49af-a9ff-12f53b252eea]\ndescription = \"Full house two small, three big\"\n\n[1822ca9d-f235-4447-b430-2e8cfc448f0c]\ndescription = \"Full house three small, two big\"\n\n[b208a3fc-db2e-4363-a936-9e9a71e69c07]\ndescription = \"Two pair is not a full house\"\n\n[b90209c3-5956-445b-8a0b-0ac8b906b1c2]\ndescription = \"Four of a kind is not a full house\"\n\n[32a3f4ee-9142-4edf-ba70-6c0f96eb4b0c]\ndescription = \"Yacht is not a full house\"\n\n[b286084d-0568-4460-844a-ba79d71d79c6]\ndescription = \"Four of a Kind\"\n\n[f25c0c90-5397-4732-9779-b1e9b5f612ca]\ndescription = \"Yacht can be scored as Four of a Kind\"\n\n[9f8ef4f0-72bb-401a-a871-cbad39c9cb08]\ndescription = \"Full house is not Four of a Kind\"\n\n[b4743c82-1eb8-4a65-98f7-33ad126905cd]\ndescription = \"Little Straight\"\n\n[7ac08422-41bf-459c-8187-a38a12d080bc]\ndescription = \"Little Straight as Big Straight\"\n\n[97bde8f7-9058-43ea-9de7-0bc3ed6d3002]\ndescription = \"Four in order but not a little straight\"\n\n[cef35ff9-9c5e-4fd2-ae95-6e4af5e95a99]\ndescription = \"No pairs but not a little straight\"\n\n[fd785ad2-c060-4e45-81c6-ea2bbb781b9d]\ndescription = \"Minimum is 1, maximum is 5, but not a little straight\"\n\n[35bd74a6-5cf6-431a-97a3-4f713663f467]\ndescription = \"Big Straight\"\n\n[87c67e1e-3e87-4f3a-a9b1-62927822b250]\ndescription = \"Big Straight as little straight\"\n\n[c1fa0a3a-40ba-4153-a42d-32bc34d2521e]\ndescription = \"No pairs but not a big straight\"\n\n[207e7300-5d10-43e5-afdd-213e3ac8827d]\ndescription = \"Choice\"\n\n[b524c0cf-32d2-4b40-8fb3-be3500f3f135]\ndescription = \"Yacht as choice\"\n" }, { "path": "exercises/practice/yacht/.vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"arcanis.vscode-zipfs\",\n \"dbaeumer.vscode-eslint\",\n \"esbenp.prettier-vscode\"\n ]\n}\n" }, { "path": "exercises/practice/yacht/.vscode/settings.json", "content": "{\n \"cSpell.words\": [\"exercism\"],\n \"search.exclude\": {\n \"**/.yarn\": true,\n \"**/.pnp.*\": true\n }\n}\n" }, { "path": "exercises/practice/yacht/.yarn/releases/yarn-3.6.4.cjs", "content": "#!/usr/bin/env node\n/* eslint-disable */\n//prettier-ignore\n(()=>{var Dge=Object.create;var lS=Object.defineProperty;var kge=Object.getOwnPropertyDescriptor;var Rge=Object.getOwnPropertyNames;var Fge=Object.getPrototypeOf,Nge=Object.prototype.hasOwnProperty;var J=(r=>typeof require<\"u\"?require:typeof Proxy<\"u\"?new Proxy(r,{get:(e,t)=>(typeof require<\"u\"?require:e)[t]}):r)(function(r){if(typeof require<\"u\")return require.apply(this,arguments);throw new Error('Dynamic require of \"'+r+'\" is not supported')});var Tge=(r,e)=>()=>(r&&(e=r(r=0)),e);var w=(r,e)=>()=>(e||r((e={exports:{}}).exports,e),e.exports),ut=(r,e)=>{for(var t in e)lS(r,t,{get:e[t],enumerable:!0})},Lge=(r,e,t,i)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let n of Rge(e))!Nge.call(r,n)&&n!==t&&lS(r,n,{get:()=>e[n],enumerable:!(i=kge(e,n))||i.enumerable});return r};var Pe=(r,e,t)=>(t=r!=null?Dge(Fge(r)):{},Lge(e||!r||!r.__esModule?lS(t,\"default\",{value:r,enumerable:!0}):t,r));var PK=w((zXe,xK)=>{xK.exports=vK;vK.sync=ife;var QK=J(\"fs\");function rfe(r,e){var t=e.pathExt!==void 0?e.pathExt:process.env.PATHEXT;if(!t||(t=t.split(\";\"),t.indexOf(\"\")!==-1))return!0;for(var i=0;i{FK.exports=kK;kK.sync=nfe;var DK=J(\"fs\");function kK(r,e,t){DK.stat(r,function(i,n){t(i,i?!1:RK(n,e))})}function nfe(r,e){return RK(DK.statSync(r),e)}function RK(r,e){return r.isFile()&&sfe(r,e)}function sfe(r,e){var t=r.mode,i=r.uid,n=r.gid,s=e.uid!==void 0?e.uid:process.getuid&&process.getuid(),o=e.gid!==void 0?e.gid:process.getgid&&process.getgid(),a=parseInt(\"100\",8),l=parseInt(\"010\",8),c=parseInt(\"001\",8),u=a|l,g=t&c||t&l&&n===o||t&a&&i===s||t&u&&s===0;return g}});var LK=w((ZXe,TK)=>{var XXe=J(\"fs\"),lI;process.platform===\"win32\"||global.TESTING_WINDOWS?lI=PK():lI=NK();TK.exports=SS;SS.sync=ofe;function SS(r,e,t){if(typeof e==\"function\"&&(t=e,e={}),!t){if(typeof Promise!=\"function\")throw new TypeError(\"callback not provided\");return new Promise(function(i,n){SS(r,e||{},function(s,o){s?n(s):i(o)})})}lI(r,e||{},function(i,n){i&&(i.code===\"EACCES\"||e&&e.ignoreErrors)&&(i=null,n=!1),t(i,n)})}function ofe(r,e){try{return lI.sync(r,e||{})}catch(t){if(e&&e.ignoreErrors||t.code===\"EACCES\")return!1;throw t}}});var YK=w((_Xe,GK)=>{var Dg=process.platform===\"win32\"||process.env.OSTYPE===\"cygwin\"||process.env.OSTYPE===\"msys\",OK=J(\"path\"),afe=Dg?\";\":\":\",MK=LK(),KK=r=>Object.assign(new Error(`not found: ${r}`),{code:\"ENOENT\"}),UK=(r,e)=>{let t=e.colon||afe,i=r.match(/\\//)||Dg&&r.match(/\\\\/)?[\"\"]:[...Dg?[process.cwd()]:[],...(e.path||process.env.PATH||\"\").split(t)],n=Dg?e.pathExt||process.env.PATHEXT||\".EXE;.CMD;.BAT;.COM\":\"\",s=Dg?n.split(t):[\"\"];return Dg&&r.indexOf(\".\")!==-1&&s[0]!==\"\"&&s.unshift(\"\"),{pathEnv:i,pathExt:s,pathExtExe:n}},HK=(r,e,t)=>{typeof e==\"function\"&&(t=e,e={}),e||(e={});let{pathEnv:i,pathExt:n,pathExtExe:s}=UK(r,e),o=[],a=c=>new Promise((u,g)=>{if(c===i.length)return e.all&&o.length?u(o):g(KK(r));let f=i[c],h=/^\".*\"$/.test(f)?f.slice(1,-1):f,p=OK.join(h,r),C=!h&&/^\\.[\\\\\\/]/.test(r)?r.slice(0,2)+p:p;u(l(C,c,0))}),l=(c,u,g)=>new Promise((f,h)=>{if(g===n.length)return f(a(u+1));let p=n[g];MK(c+p,{pathExt:s},(C,y)=>{if(!C&&y)if(e.all)o.push(c+p);else return f(c+p);return f(l(c,u,g+1))})});return t?a(0).then(c=>t(null,c),t):a(0)},Afe=(r,e)=>{e=e||{};let{pathEnv:t,pathExt:i,pathExtExe:n}=UK(r,e),s=[];for(let o=0;o{\"use strict\";var jK=(r={})=>{let e=r.env||process.env;return(r.platform||process.platform)!==\"win32\"?\"PATH\":Object.keys(e).reverse().find(i=>i.toUpperCase()===\"PATH\")||\"Path\"};vS.exports=jK;vS.exports.default=jK});var VK=w((eZe,zK)=>{\"use strict\";var JK=J(\"path\"),lfe=YK(),cfe=qK();function WK(r,e){let t=r.options.env||process.env,i=process.cwd(),n=r.options.cwd!=null,s=n&&process.chdir!==void 0&&!process.chdir.disabled;if(s)try{process.chdir(r.options.cwd)}catch{}let o;try{o=lfe.sync(r.command,{path:t[cfe({env:t})],pathExt:e?JK.delimiter:void 0})}catch{}finally{s&&process.chdir(i)}return o&&(o=JK.resolve(n?r.options.cwd:\"\",o)),o}function ufe(r){return WK(r)||WK(r,!0)}zK.exports=ufe});var XK=w((tZe,PS)=>{\"use strict\";var xS=/([()\\][%!^\"`<>&|;, *?])/g;function gfe(r){return r=r.replace(xS,\"^$1\"),r}function ffe(r,e){return r=`${r}`,r=r.replace(/(\\\\*)\"/g,'$1$1\\\\\"'),r=r.replace(/(\\\\*)$/,\"$1$1\"),r=`\"${r}\"`,r=r.replace(xS,\"^$1\"),e&&(r=r.replace(xS,\"^$1\")),r}PS.exports.command=gfe;PS.exports.argument=ffe});var _K=w((rZe,ZK)=>{\"use strict\";ZK.exports=/^#!(.*)/});var eU=w((iZe,$K)=>{\"use strict\";var hfe=_K();$K.exports=(r=\"\")=>{let e=r.match(hfe);if(!e)return null;let[t,i]=e[0].replace(/#! ?/,\"\").split(\" \"),n=t.split(\"/\").pop();return n===\"env\"?i:i?`${n} ${i}`:n}});var rU=w((nZe,tU)=>{\"use strict\";var DS=J(\"fs\"),pfe=eU();function dfe(r){let t=Buffer.alloc(150),i;try{i=DS.openSync(r,\"r\"),DS.readSync(i,t,0,150,0),DS.closeSync(i)}catch{}return pfe(t.toString())}tU.exports=dfe});var oU=w((sZe,sU)=>{\"use strict\";var Cfe=J(\"path\"),iU=VK(),nU=XK(),mfe=rU(),Efe=process.platform===\"win32\",Ife=/\\.(?:com|exe)$/i,yfe=/node_modules[\\\\/].bin[\\\\/][^\\\\/]+\\.cmd$/i;function wfe(r){r.file=iU(r);let e=r.file&&mfe(r.file);return e?(r.args.unshift(r.file),r.command=e,iU(r)):r.file}function Bfe(r){if(!Efe)return r;let e=wfe(r),t=!Ife.test(e);if(r.options.forceShell||t){let i=yfe.test(e);r.command=Cfe.normalize(r.command),r.command=nU.command(r.command),r.args=r.args.map(s=>nU.argument(s,i));let n=[r.command].concat(r.args).join(\" \");r.args=[\"/d\",\"/s\",\"/c\",`\"${n}\"`],r.command=process.env.comspec||\"cmd.exe\",r.options.windowsVerbatimArguments=!0}return r}function bfe(r,e,t){e&&!Array.isArray(e)&&(t=e,e=null),e=e?e.slice(0):[],t=Object.assign({},t);let i={command:r,args:e,options:t,file:void 0,original:{command:r,args:e}};return t.shell?i:Bfe(i)}sU.exports=bfe});var lU=w((oZe,AU)=>{\"use strict\";var kS=process.platform===\"win32\";function RS(r,e){return Object.assign(new Error(`${e} ${r.command} ENOENT`),{code:\"ENOENT\",errno:\"ENOENT\",syscall:`${e} ${r.command}`,path:r.command,spawnargs:r.args})}function Qfe(r,e){if(!kS)return;let t=r.emit;r.emit=function(i,n){if(i===\"exit\"){let s=aU(n,e,\"spawn\");if(s)return t.call(r,\"error\",s)}return t.apply(r,arguments)}}function aU(r,e){return kS&&r===1&&!e.file?RS(e.original,\"spawn\"):null}function Sfe(r,e){return kS&&r===1&&!e.file?RS(e.original,\"spawnSync\"):null}AU.exports={hookChildProcess:Qfe,verifyENOENT:aU,verifyENOENTSync:Sfe,notFoundError:RS}});var TS=w((aZe,kg)=>{\"use strict\";var cU=J(\"child_process\"),FS=oU(),NS=lU();function uU(r,e,t){let i=FS(r,e,t),n=cU.spawn(i.command,i.args,i.options);return NS.hookChildProcess(n,i),n}function vfe(r,e,t){let i=FS(r,e,t),n=cU.spawnSync(i.command,i.args,i.options);return n.error=n.error||NS.verifyENOENTSync(n.status,i),n}kg.exports=uU;kg.exports.spawn=uU;kg.exports.sync=vfe;kg.exports._parse=FS;kg.exports._enoent=NS});var fU=w((AZe,gU)=>{\"use strict\";function xfe(r,e){function t(){this.constructor=r}t.prototype=e.prototype,r.prototype=new t}function Zl(r,e,t,i){this.message=r,this.expected=e,this.found=t,this.location=i,this.name=\"SyntaxError\",typeof Error.captureStackTrace==\"function\"&&Error.captureStackTrace(this,Zl)}xfe(Zl,Error);Zl.buildMessage=function(r,e){var t={literal:function(c){return'\"'+n(c.text)+'\"'},class:function(c){var u=\"\",g;for(g=0;g0){for(g=1,f=1;g>\",ie=me(\">>\",!1),de=\">&\",_e=me(\">&\",!1),Pt=\">\",It=me(\">\",!1),Or=\"<<<\",ii=me(\"<<<\",!1),gi=\"<&\",hr=me(\"<&\",!1),fi=\"<\",ni=me(\"<\",!1),Ks=function(m){return{type:\"argument\",segments:[].concat(...m)}},pr=function(m){return m},Ii=\"$'\",rs=me(\"$'\",!1),fa=\"'\",dA=me(\"'\",!1),cg=function(m){return[{type:\"text\",text:m}]},is='\"\"',CA=me('\"\"',!1),ha=function(){return{type:\"text\",text:\"\"}},wp='\"',mA=me('\"',!1),EA=function(m){return m},wr=function(m){return{type:\"arithmetic\",arithmetic:m,quoted:!0}},Tl=function(m){return{type:\"shell\",shell:m,quoted:!0}},ug=function(m){return{type:\"variable\",...m,quoted:!0}},yo=function(m){return{type:\"text\",text:m}},gg=function(m){return{type:\"arithmetic\",arithmetic:m,quoted:!1}},Bp=function(m){return{type:\"shell\",shell:m,quoted:!1}},bp=function(m){return{type:\"variable\",...m,quoted:!1}},vr=function(m){return{type:\"glob\",pattern:m}},se=/^[^']/,wo=Je([\"'\"],!0,!1),Fn=function(m){return m.join(\"\")},fg=/^[^$\"]/,bt=Je([\"$\",'\"'],!0,!1),Ll=`\\\\\n`,Nn=me(`\\\\\n`,!1),ns=function(){return\"\"},ss=\"\\\\\",gt=me(\"\\\\\",!1),Bo=/^[\\\\$\"`]/,At=Je([\"\\\\\",\"$\",'\"',\"`\"],!1,!1),ln=function(m){return m},S=\"\\\\a\",Lt=me(\"\\\\a\",!1),hg=function(){return\"a\"},Ol=\"\\\\b\",Qp=me(\"\\\\b\",!1),Sp=function(){return\"\\b\"},vp=/^[Ee]/,xp=Je([\"E\",\"e\"],!1,!1),Pp=function(){return\"\\x1B\"},G=\"\\\\f\",yt=me(\"\\\\f\",!1),IA=function(){return\"\\f\"},zi=\"\\\\n\",Ml=me(\"\\\\n\",!1),Xe=function(){return`\n`},pa=\"\\\\r\",pg=me(\"\\\\r\",!1),OE=function(){return\"\\r\"},Dp=\"\\\\t\",ME=me(\"\\\\t\",!1),ar=function(){return\"\t\"},Tn=\"\\\\v\",Kl=me(\"\\\\v\",!1),kp=function(){return\"\\v\"},Us=/^[\\\\'\"?]/,da=Je([\"\\\\\",\"'\",'\"',\"?\"],!1,!1),cn=function(m){return String.fromCharCode(parseInt(m,16))},Le=\"\\\\x\",dg=me(\"\\\\x\",!1),Ul=\"\\\\u\",Hs=me(\"\\\\u\",!1),Hl=\"\\\\U\",yA=me(\"\\\\U\",!1),Cg=function(m){return String.fromCodePoint(parseInt(m,16))},mg=/^[0-7]/,Ca=Je([[\"0\",\"7\"]],!1,!1),ma=/^[0-9a-fA-f]/,rt=Je([[\"0\",\"9\"],[\"a\",\"f\"],[\"A\",\"f\"]],!1,!1),bo=nt(),wA=\"-\",Gl=me(\"-\",!1),Gs=\"+\",Yl=me(\"+\",!1),KE=\".\",Rp=me(\".\",!1),Eg=function(m,Q,N){return{type:\"number\",value:(m===\"-\"?-1:1)*parseFloat(Q.join(\"\")+\".\"+N.join(\"\"))}},Fp=function(m,Q){return{type:\"number\",value:(m===\"-\"?-1:1)*parseInt(Q.join(\"\"))}},UE=function(m){return{type:\"variable\",...m}},jl=function(m){return{type:\"variable\",name:m}},HE=function(m){return m},Ig=\"*\",BA=me(\"*\",!1),Rr=\"/\",GE=me(\"/\",!1),Ys=function(m,Q,N){return{type:Q===\"*\"?\"multiplication\":\"division\",right:N}},js=function(m,Q){return Q.reduce((N,U)=>({left:N,...U}),m)},yg=function(m,Q,N){return{type:Q===\"+\"?\"addition\":\"subtraction\",right:N}},bA=\"$((\",R=me(\"$((\",!1),q=\"))\",Ce=me(\"))\",!1),Ke=function(m){return m},Re=\"$(\",ze=me(\"$(\",!1),dt=function(m){return m},Ft=\"${\",Ln=me(\"${\",!1),JQ=\":-\",k1=me(\":-\",!1),R1=function(m,Q){return{name:m,defaultValue:Q}},WQ=\":-}\",F1=me(\":-}\",!1),N1=function(m){return{name:m,defaultValue:[]}},zQ=\":+\",T1=me(\":+\",!1),L1=function(m,Q){return{name:m,alternativeValue:Q}},VQ=\":+}\",O1=me(\":+}\",!1),M1=function(m){return{name:m,alternativeValue:[]}},XQ=function(m){return{name:m}},K1=\"$\",U1=me(\"$\",!1),H1=function(m){return e.isGlobPattern(m)},G1=function(m){return m},ZQ=/^[a-zA-Z0-9_]/,_Q=Je([[\"a\",\"z\"],[\"A\",\"Z\"],[\"0\",\"9\"],\"_\"],!1,!1),$Q=function(){return L()},eS=/^[$@*?#a-zA-Z0-9_\\-]/,tS=Je([\"$\",\"@\",\"*\",\"?\",\"#\",[\"a\",\"z\"],[\"A\",\"Z\"],[\"0\",\"9\"],\"_\",\"-\"],!1,!1),Y1=/^[(){}<>$|&; \\t\"']/,wg=Je([\"(\",\")\",\"{\",\"}\",\"<\",\">\",\"$\",\"|\",\"&\",\";\",\" \",\"\t\",'\"',\"'\"],!1,!1),rS=/^[<>&; \\t\"']/,iS=Je([\"<\",\">\",\"&\",\";\",\" \",\"\t\",'\"',\"'\"],!1,!1),YE=/^[ \\t]/,jE=Je([\" \",\"\t\"],!1,!1),b=0,Me=0,QA=[{line:1,column:1}],d=0,E=[],I=0,k;if(\"startRule\"in e){if(!(e.startRule in i))throw new Error(`Can't start parsing from rule \"`+e.startRule+'\".');n=i[e.startRule]}function L(){return r.substring(Me,b)}function Z(){return Et(Me,b)}function te(m,Q){throw Q=Q!==void 0?Q:Et(Me,b),Ri([lt(m)],r.substring(Me,b),Q)}function we(m,Q){throw Q=Q!==void 0?Q:Et(Me,b),On(m,Q)}function me(m,Q){return{type:\"literal\",text:m,ignoreCase:Q}}function Je(m,Q,N){return{type:\"class\",parts:m,inverted:Q,ignoreCase:N}}function nt(){return{type:\"any\"}}function wt(){return{type:\"end\"}}function lt(m){return{type:\"other\",description:m}}function it(m){var Q=QA[m],N;if(Q)return Q;for(N=m-1;!QA[N];)N--;for(Q=QA[N],Q={line:Q.line,column:Q.column};Nd&&(d=b,E=[]),E.push(m))}function On(m,Q){return new Zl(m,null,null,Q)}function Ri(m,Q,N){return new Zl(Zl.buildMessage(m,Q),m,Q,N)}function SA(){var m,Q;return m=b,Q=Mr(),Q===t&&(Q=null),Q!==t&&(Me=m,Q=s(Q)),m=Q,m}function Mr(){var m,Q,N,U,ce;if(m=b,Q=Kr(),Q!==t){for(N=[],U=He();U!==t;)N.push(U),U=He();N!==t?(U=Ea(),U!==t?(ce=os(),ce===t&&(ce=null),ce!==t?(Me=m,Q=o(Q,U,ce),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t)}else b=m,m=t;if(m===t)if(m=b,Q=Kr(),Q!==t){for(N=[],U=He();U!==t;)N.push(U),U=He();N!==t?(U=Ea(),U===t&&(U=null),U!==t?(Me=m,Q=a(Q,U),m=Q):(b=m,m=t)):(b=m,m=t)}else b=m,m=t;return m}function os(){var m,Q,N,U,ce;for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();if(Q!==t)if(N=Mr(),N!==t){for(U=[],ce=He();ce!==t;)U.push(ce),ce=He();U!==t?(Me=m,Q=l(N),m=Q):(b=m,m=t)}else b=m,m=t;else b=m,m=t;return m}function Ea(){var m;return r.charCodeAt(b)===59?(m=c,b++):(m=t,I===0&&be(u)),m===t&&(r.charCodeAt(b)===38?(m=g,b++):(m=t,I===0&&be(f))),m}function Kr(){var m,Q,N;return m=b,Q=j1(),Q!==t?(N=fge(),N===t&&(N=null),N!==t?(Me=m,Q=h(Q,N),m=Q):(b=m,m=t)):(b=m,m=t),m}function fge(){var m,Q,N,U,ce,Se,ht;for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();if(Q!==t)if(N=hge(),N!==t){for(U=[],ce=He();ce!==t;)U.push(ce),ce=He();if(U!==t)if(ce=Kr(),ce!==t){for(Se=[],ht=He();ht!==t;)Se.push(ht),ht=He();Se!==t?(Me=m,Q=p(N,ce),m=Q):(b=m,m=t)}else b=m,m=t;else b=m,m=t}else b=m,m=t;else b=m,m=t;return m}function hge(){var m;return r.substr(b,2)===C?(m=C,b+=2):(m=t,I===0&&be(y)),m===t&&(r.substr(b,2)===B?(m=B,b+=2):(m=t,I===0&&be(v))),m}function j1(){var m,Q,N;return m=b,Q=Cge(),Q!==t?(N=pge(),N===t&&(N=null),N!==t?(Me=m,Q=D(Q,N),m=Q):(b=m,m=t)):(b=m,m=t),m}function pge(){var m,Q,N,U,ce,Se,ht;for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();if(Q!==t)if(N=dge(),N!==t){for(U=[],ce=He();ce!==t;)U.push(ce),ce=He();if(U!==t)if(ce=j1(),ce!==t){for(Se=[],ht=He();ht!==t;)Se.push(ht),ht=He();Se!==t?(Me=m,Q=T(N,ce),m=Q):(b=m,m=t)}else b=m,m=t;else b=m,m=t}else b=m,m=t;else b=m,m=t;return m}function dge(){var m;return r.substr(b,2)===H?(m=H,b+=2):(m=t,I===0&&be(j)),m===t&&(r.charCodeAt(b)===124?(m=$,b++):(m=t,I===0&&be(V))),m}function qE(){var m,Q,N,U,ce,Se;if(m=b,Q=rK(),Q!==t)if(r.charCodeAt(b)===61?(N=W,b++):(N=t,I===0&&be(_)),N!==t)if(U=W1(),U!==t){for(ce=[],Se=He();Se!==t;)ce.push(Se),Se=He();ce!==t?(Me=m,Q=A(Q,U),m=Q):(b=m,m=t)}else b=m,m=t;else b=m,m=t;else b=m,m=t;if(m===t)if(m=b,Q=rK(),Q!==t)if(r.charCodeAt(b)===61?(N=W,b++):(N=t,I===0&&be(_)),N!==t){for(U=[],ce=He();ce!==t;)U.push(ce),ce=He();U!==t?(Me=m,Q=Ae(Q),m=Q):(b=m,m=t)}else b=m,m=t;else b=m,m=t;return m}function Cge(){var m,Q,N,U,ce,Se,ht,Bt,qr,hi,as;for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();if(Q!==t)if(r.charCodeAt(b)===40?(N=ge,b++):(N=t,I===0&&be(re)),N!==t){for(U=[],ce=He();ce!==t;)U.push(ce),ce=He();if(U!==t)if(ce=Mr(),ce!==t){for(Se=[],ht=He();ht!==t;)Se.push(ht),ht=He();if(Se!==t)if(r.charCodeAt(b)===41?(ht=O,b++):(ht=t,I===0&&be(F)),ht!==t){for(Bt=[],qr=He();qr!==t;)Bt.push(qr),qr=He();if(Bt!==t){for(qr=[],hi=Np();hi!==t;)qr.push(hi),hi=Np();if(qr!==t){for(hi=[],as=He();as!==t;)hi.push(as),as=He();hi!==t?(Me=m,Q=ue(ce,qr),m=Q):(b=m,m=t)}else b=m,m=t}else b=m,m=t}else b=m,m=t;else b=m,m=t}else b=m,m=t;else b=m,m=t}else b=m,m=t;else b=m,m=t;if(m===t){for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();if(Q!==t)if(r.charCodeAt(b)===123?(N=pe,b++):(N=t,I===0&&be(ke)),N!==t){for(U=[],ce=He();ce!==t;)U.push(ce),ce=He();if(U!==t)if(ce=Mr(),ce!==t){for(Se=[],ht=He();ht!==t;)Se.push(ht),ht=He();if(Se!==t)if(r.charCodeAt(b)===125?(ht=Fe,b++):(ht=t,I===0&&be(Ne)),ht!==t){for(Bt=[],qr=He();qr!==t;)Bt.push(qr),qr=He();if(Bt!==t){for(qr=[],hi=Np();hi!==t;)qr.push(hi),hi=Np();if(qr!==t){for(hi=[],as=He();as!==t;)hi.push(as),as=He();hi!==t?(Me=m,Q=oe(ce,qr),m=Q):(b=m,m=t)}else b=m,m=t}else b=m,m=t}else b=m,m=t;else b=m,m=t}else b=m,m=t;else b=m,m=t}else b=m,m=t;else b=m,m=t;if(m===t){for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();if(Q!==t){for(N=[],U=qE();U!==t;)N.push(U),U=qE();if(N!==t){for(U=[],ce=He();ce!==t;)U.push(ce),ce=He();if(U!==t){if(ce=[],Se=J1(),Se!==t)for(;Se!==t;)ce.push(Se),Se=J1();else ce=t;if(ce!==t){for(Se=[],ht=He();ht!==t;)Se.push(ht),ht=He();Se!==t?(Me=m,Q=le(N,ce),m=Q):(b=m,m=t)}else b=m,m=t}else b=m,m=t}else b=m,m=t}else b=m,m=t;if(m===t){for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();if(Q!==t){if(N=[],U=qE(),U!==t)for(;U!==t;)N.push(U),U=qE();else N=t;if(N!==t){for(U=[],ce=He();ce!==t;)U.push(ce),ce=He();U!==t?(Me=m,Q=Be(N),m=Q):(b=m,m=t)}else b=m,m=t}else b=m,m=t}}}return m}function q1(){var m,Q,N,U,ce;for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();if(Q!==t){if(N=[],U=JE(),U!==t)for(;U!==t;)N.push(U),U=JE();else N=t;if(N!==t){for(U=[],ce=He();ce!==t;)U.push(ce),ce=He();U!==t?(Me=m,Q=fe(N),m=Q):(b=m,m=t)}else b=m,m=t}else b=m,m=t;return m}function J1(){var m,Q,N;for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();if(Q!==t?(N=Np(),N!==t?(Me=m,Q=ae(N),m=Q):(b=m,m=t)):(b=m,m=t),m===t){for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();Q!==t?(N=JE(),N!==t?(Me=m,Q=ae(N),m=Q):(b=m,m=t)):(b=m,m=t)}return m}function Np(){var m,Q,N,U,ce;for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();return Q!==t?(qe.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(ne)),N===t&&(N=null),N!==t?(U=mge(),U!==t?(ce=JE(),ce!==t?(Me=m,Q=Y(N,U,ce),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t)):(b=m,m=t),m}function mge(){var m;return r.substr(b,2)===he?(m=he,b+=2):(m=t,I===0&&be(ie)),m===t&&(r.substr(b,2)===de?(m=de,b+=2):(m=t,I===0&&be(_e)),m===t&&(r.charCodeAt(b)===62?(m=Pt,b++):(m=t,I===0&&be(It)),m===t&&(r.substr(b,3)===Or?(m=Or,b+=3):(m=t,I===0&&be(ii)),m===t&&(r.substr(b,2)===gi?(m=gi,b+=2):(m=t,I===0&&be(hr)),m===t&&(r.charCodeAt(b)===60?(m=fi,b++):(m=t,I===0&&be(ni))))))),m}function JE(){var m,Q,N;for(m=b,Q=[],N=He();N!==t;)Q.push(N),N=He();return Q!==t?(N=W1(),N!==t?(Me=m,Q=ae(N),m=Q):(b=m,m=t)):(b=m,m=t),m}function W1(){var m,Q,N;if(m=b,Q=[],N=z1(),N!==t)for(;N!==t;)Q.push(N),N=z1();else Q=t;return Q!==t&&(Me=m,Q=Ks(Q)),m=Q,m}function z1(){var m,Q;return m=b,Q=Ege(),Q!==t&&(Me=m,Q=pr(Q)),m=Q,m===t&&(m=b,Q=Ige(),Q!==t&&(Me=m,Q=pr(Q)),m=Q,m===t&&(m=b,Q=yge(),Q!==t&&(Me=m,Q=pr(Q)),m=Q,m===t&&(m=b,Q=wge(),Q!==t&&(Me=m,Q=pr(Q)),m=Q))),m}function Ege(){var m,Q,N,U;return m=b,r.substr(b,2)===Ii?(Q=Ii,b+=2):(Q=t,I===0&&be(rs)),Q!==t?(N=Qge(),N!==t?(r.charCodeAt(b)===39?(U=fa,b++):(U=t,I===0&&be(dA)),U!==t?(Me=m,Q=cg(N),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t),m}function Ige(){var m,Q,N,U;return m=b,r.charCodeAt(b)===39?(Q=fa,b++):(Q=t,I===0&&be(dA)),Q!==t?(N=Bge(),N!==t?(r.charCodeAt(b)===39?(U=fa,b++):(U=t,I===0&&be(dA)),U!==t?(Me=m,Q=cg(N),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t),m}function yge(){var m,Q,N,U;if(m=b,r.substr(b,2)===is?(Q=is,b+=2):(Q=t,I===0&&be(CA)),Q!==t&&(Me=m,Q=ha()),m=Q,m===t)if(m=b,r.charCodeAt(b)===34?(Q=wp,b++):(Q=t,I===0&&be(mA)),Q!==t){for(N=[],U=V1();U!==t;)N.push(U),U=V1();N!==t?(r.charCodeAt(b)===34?(U=wp,b++):(U=t,I===0&&be(mA)),U!==t?(Me=m,Q=EA(N),m=Q):(b=m,m=t)):(b=m,m=t)}else b=m,m=t;return m}function wge(){var m,Q,N;if(m=b,Q=[],N=X1(),N!==t)for(;N!==t;)Q.push(N),N=X1();else Q=t;return Q!==t&&(Me=m,Q=EA(Q)),m=Q,m}function V1(){var m,Q;return m=b,Q=eK(),Q!==t&&(Me=m,Q=wr(Q)),m=Q,m===t&&(m=b,Q=tK(),Q!==t&&(Me=m,Q=Tl(Q)),m=Q,m===t&&(m=b,Q=aS(),Q!==t&&(Me=m,Q=ug(Q)),m=Q,m===t&&(m=b,Q=bge(),Q!==t&&(Me=m,Q=yo(Q)),m=Q))),m}function X1(){var m,Q;return m=b,Q=eK(),Q!==t&&(Me=m,Q=gg(Q)),m=Q,m===t&&(m=b,Q=tK(),Q!==t&&(Me=m,Q=Bp(Q)),m=Q,m===t&&(m=b,Q=aS(),Q!==t&&(Me=m,Q=bp(Q)),m=Q,m===t&&(m=b,Q=xge(),Q!==t&&(Me=m,Q=vr(Q)),m=Q,m===t&&(m=b,Q=vge(),Q!==t&&(Me=m,Q=yo(Q)),m=Q)))),m}function Bge(){var m,Q,N;for(m=b,Q=[],se.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(wo));N!==t;)Q.push(N),se.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(wo));return Q!==t&&(Me=m,Q=Fn(Q)),m=Q,m}function bge(){var m,Q,N;if(m=b,Q=[],N=Z1(),N===t&&(fg.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(bt))),N!==t)for(;N!==t;)Q.push(N),N=Z1(),N===t&&(fg.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(bt)));else Q=t;return Q!==t&&(Me=m,Q=Fn(Q)),m=Q,m}function Z1(){var m,Q,N;return m=b,r.substr(b,2)===Ll?(Q=Ll,b+=2):(Q=t,I===0&&be(Nn)),Q!==t&&(Me=m,Q=ns()),m=Q,m===t&&(m=b,r.charCodeAt(b)===92?(Q=ss,b++):(Q=t,I===0&&be(gt)),Q!==t?(Bo.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(At)),N!==t?(Me=m,Q=ln(N),m=Q):(b=m,m=t)):(b=m,m=t)),m}function Qge(){var m,Q,N;for(m=b,Q=[],N=_1(),N===t&&(se.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(wo)));N!==t;)Q.push(N),N=_1(),N===t&&(se.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(wo)));return Q!==t&&(Me=m,Q=Fn(Q)),m=Q,m}function _1(){var m,Q,N;return m=b,r.substr(b,2)===S?(Q=S,b+=2):(Q=t,I===0&&be(Lt)),Q!==t&&(Me=m,Q=hg()),m=Q,m===t&&(m=b,r.substr(b,2)===Ol?(Q=Ol,b+=2):(Q=t,I===0&&be(Qp)),Q!==t&&(Me=m,Q=Sp()),m=Q,m===t&&(m=b,r.charCodeAt(b)===92?(Q=ss,b++):(Q=t,I===0&&be(gt)),Q!==t?(vp.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(xp)),N!==t?(Me=m,Q=Pp(),m=Q):(b=m,m=t)):(b=m,m=t),m===t&&(m=b,r.substr(b,2)===G?(Q=G,b+=2):(Q=t,I===0&&be(yt)),Q!==t&&(Me=m,Q=IA()),m=Q,m===t&&(m=b,r.substr(b,2)===zi?(Q=zi,b+=2):(Q=t,I===0&&be(Ml)),Q!==t&&(Me=m,Q=Xe()),m=Q,m===t&&(m=b,r.substr(b,2)===pa?(Q=pa,b+=2):(Q=t,I===0&&be(pg)),Q!==t&&(Me=m,Q=OE()),m=Q,m===t&&(m=b,r.substr(b,2)===Dp?(Q=Dp,b+=2):(Q=t,I===0&&be(ME)),Q!==t&&(Me=m,Q=ar()),m=Q,m===t&&(m=b,r.substr(b,2)===Tn?(Q=Tn,b+=2):(Q=t,I===0&&be(Kl)),Q!==t&&(Me=m,Q=kp()),m=Q,m===t&&(m=b,r.charCodeAt(b)===92?(Q=ss,b++):(Q=t,I===0&&be(gt)),Q!==t?(Us.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(da)),N!==t?(Me=m,Q=ln(N),m=Q):(b=m,m=t)):(b=m,m=t),m===t&&(m=Sge()))))))))),m}function Sge(){var m,Q,N,U,ce,Se,ht,Bt,qr,hi,as,AS;return m=b,r.charCodeAt(b)===92?(Q=ss,b++):(Q=t,I===0&&be(gt)),Q!==t?(N=nS(),N!==t?(Me=m,Q=cn(N),m=Q):(b=m,m=t)):(b=m,m=t),m===t&&(m=b,r.substr(b,2)===Le?(Q=Le,b+=2):(Q=t,I===0&&be(dg)),Q!==t?(N=b,U=b,ce=nS(),ce!==t?(Se=Mn(),Se!==t?(ce=[ce,Se],U=ce):(b=U,U=t)):(b=U,U=t),U===t&&(U=nS()),U!==t?N=r.substring(N,b):N=U,N!==t?(Me=m,Q=cn(N),m=Q):(b=m,m=t)):(b=m,m=t),m===t&&(m=b,r.substr(b,2)===Ul?(Q=Ul,b+=2):(Q=t,I===0&&be(Hs)),Q!==t?(N=b,U=b,ce=Mn(),ce!==t?(Se=Mn(),Se!==t?(ht=Mn(),ht!==t?(Bt=Mn(),Bt!==t?(ce=[ce,Se,ht,Bt],U=ce):(b=U,U=t)):(b=U,U=t)):(b=U,U=t)):(b=U,U=t),U!==t?N=r.substring(N,b):N=U,N!==t?(Me=m,Q=cn(N),m=Q):(b=m,m=t)):(b=m,m=t),m===t&&(m=b,r.substr(b,2)===Hl?(Q=Hl,b+=2):(Q=t,I===0&&be(yA)),Q!==t?(N=b,U=b,ce=Mn(),ce!==t?(Se=Mn(),Se!==t?(ht=Mn(),ht!==t?(Bt=Mn(),Bt!==t?(qr=Mn(),qr!==t?(hi=Mn(),hi!==t?(as=Mn(),as!==t?(AS=Mn(),AS!==t?(ce=[ce,Se,ht,Bt,qr,hi,as,AS],U=ce):(b=U,U=t)):(b=U,U=t)):(b=U,U=t)):(b=U,U=t)):(b=U,U=t)):(b=U,U=t)):(b=U,U=t)):(b=U,U=t),U!==t?N=r.substring(N,b):N=U,N!==t?(Me=m,Q=Cg(N),m=Q):(b=m,m=t)):(b=m,m=t)))),m}function nS(){var m;return mg.test(r.charAt(b))?(m=r.charAt(b),b++):(m=t,I===0&&be(Ca)),m}function Mn(){var m;return ma.test(r.charAt(b))?(m=r.charAt(b),b++):(m=t,I===0&&be(rt)),m}function vge(){var m,Q,N,U,ce;if(m=b,Q=[],N=b,r.charCodeAt(b)===92?(U=ss,b++):(U=t,I===0&&be(gt)),U!==t?(r.length>b?(ce=r.charAt(b),b++):(ce=t,I===0&&be(bo)),ce!==t?(Me=N,U=ln(ce),N=U):(b=N,N=t)):(b=N,N=t),N===t&&(N=b,U=b,I++,ce=iK(),I--,ce===t?U=void 0:(b=U,U=t),U!==t?(r.length>b?(ce=r.charAt(b),b++):(ce=t,I===0&&be(bo)),ce!==t?(Me=N,U=ln(ce),N=U):(b=N,N=t)):(b=N,N=t)),N!==t)for(;N!==t;)Q.push(N),N=b,r.charCodeAt(b)===92?(U=ss,b++):(U=t,I===0&&be(gt)),U!==t?(r.length>b?(ce=r.charAt(b),b++):(ce=t,I===0&&be(bo)),ce!==t?(Me=N,U=ln(ce),N=U):(b=N,N=t)):(b=N,N=t),N===t&&(N=b,U=b,I++,ce=iK(),I--,ce===t?U=void 0:(b=U,U=t),U!==t?(r.length>b?(ce=r.charAt(b),b++):(ce=t,I===0&&be(bo)),ce!==t?(Me=N,U=ln(ce),N=U):(b=N,N=t)):(b=N,N=t));else Q=t;return Q!==t&&(Me=m,Q=Fn(Q)),m=Q,m}function sS(){var m,Q,N,U,ce,Se;if(m=b,r.charCodeAt(b)===45?(Q=wA,b++):(Q=t,I===0&&be(Gl)),Q===t&&(r.charCodeAt(b)===43?(Q=Gs,b++):(Q=t,I===0&&be(Yl))),Q===t&&(Q=null),Q!==t){if(N=[],qe.test(r.charAt(b))?(U=r.charAt(b),b++):(U=t,I===0&&be(ne)),U!==t)for(;U!==t;)N.push(U),qe.test(r.charAt(b))?(U=r.charAt(b),b++):(U=t,I===0&&be(ne));else N=t;if(N!==t)if(r.charCodeAt(b)===46?(U=KE,b++):(U=t,I===0&&be(Rp)),U!==t){if(ce=[],qe.test(r.charAt(b))?(Se=r.charAt(b),b++):(Se=t,I===0&&be(ne)),Se!==t)for(;Se!==t;)ce.push(Se),qe.test(r.charAt(b))?(Se=r.charAt(b),b++):(Se=t,I===0&&be(ne));else ce=t;ce!==t?(Me=m,Q=Eg(Q,N,ce),m=Q):(b=m,m=t)}else b=m,m=t;else b=m,m=t}else b=m,m=t;if(m===t){if(m=b,r.charCodeAt(b)===45?(Q=wA,b++):(Q=t,I===0&&be(Gl)),Q===t&&(r.charCodeAt(b)===43?(Q=Gs,b++):(Q=t,I===0&&be(Yl))),Q===t&&(Q=null),Q!==t){if(N=[],qe.test(r.charAt(b))?(U=r.charAt(b),b++):(U=t,I===0&&be(ne)),U!==t)for(;U!==t;)N.push(U),qe.test(r.charAt(b))?(U=r.charAt(b),b++):(U=t,I===0&&be(ne));else N=t;N!==t?(Me=m,Q=Fp(Q,N),m=Q):(b=m,m=t)}else b=m,m=t;if(m===t&&(m=b,Q=aS(),Q!==t&&(Me=m,Q=UE(Q)),m=Q,m===t&&(m=b,Q=ql(),Q!==t&&(Me=m,Q=jl(Q)),m=Q,m===t)))if(m=b,r.charCodeAt(b)===40?(Q=ge,b++):(Q=t,I===0&&be(re)),Q!==t){for(N=[],U=He();U!==t;)N.push(U),U=He();if(N!==t)if(U=$1(),U!==t){for(ce=[],Se=He();Se!==t;)ce.push(Se),Se=He();ce!==t?(r.charCodeAt(b)===41?(Se=O,b++):(Se=t,I===0&&be(F)),Se!==t?(Me=m,Q=HE(U),m=Q):(b=m,m=t)):(b=m,m=t)}else b=m,m=t;else b=m,m=t}else b=m,m=t}return m}function oS(){var m,Q,N,U,ce,Se,ht,Bt;if(m=b,Q=sS(),Q!==t){for(N=[],U=b,ce=[],Se=He();Se!==t;)ce.push(Se),Se=He();if(ce!==t)if(r.charCodeAt(b)===42?(Se=Ig,b++):(Se=t,I===0&&be(BA)),Se===t&&(r.charCodeAt(b)===47?(Se=Rr,b++):(Se=t,I===0&&be(GE))),Se!==t){for(ht=[],Bt=He();Bt!==t;)ht.push(Bt),Bt=He();ht!==t?(Bt=sS(),Bt!==t?(Me=U,ce=Ys(Q,Se,Bt),U=ce):(b=U,U=t)):(b=U,U=t)}else b=U,U=t;else b=U,U=t;for(;U!==t;){for(N.push(U),U=b,ce=[],Se=He();Se!==t;)ce.push(Se),Se=He();if(ce!==t)if(r.charCodeAt(b)===42?(Se=Ig,b++):(Se=t,I===0&&be(BA)),Se===t&&(r.charCodeAt(b)===47?(Se=Rr,b++):(Se=t,I===0&&be(GE))),Se!==t){for(ht=[],Bt=He();Bt!==t;)ht.push(Bt),Bt=He();ht!==t?(Bt=sS(),Bt!==t?(Me=U,ce=Ys(Q,Se,Bt),U=ce):(b=U,U=t)):(b=U,U=t)}else b=U,U=t;else b=U,U=t}N!==t?(Me=m,Q=js(Q,N),m=Q):(b=m,m=t)}else b=m,m=t;return m}function $1(){var m,Q,N,U,ce,Se,ht,Bt;if(m=b,Q=oS(),Q!==t){for(N=[],U=b,ce=[],Se=He();Se!==t;)ce.push(Se),Se=He();if(ce!==t)if(r.charCodeAt(b)===43?(Se=Gs,b++):(Se=t,I===0&&be(Yl)),Se===t&&(r.charCodeAt(b)===45?(Se=wA,b++):(Se=t,I===0&&be(Gl))),Se!==t){for(ht=[],Bt=He();Bt!==t;)ht.push(Bt),Bt=He();ht!==t?(Bt=oS(),Bt!==t?(Me=U,ce=yg(Q,Se,Bt),U=ce):(b=U,U=t)):(b=U,U=t)}else b=U,U=t;else b=U,U=t;for(;U!==t;){for(N.push(U),U=b,ce=[],Se=He();Se!==t;)ce.push(Se),Se=He();if(ce!==t)if(r.charCodeAt(b)===43?(Se=Gs,b++):(Se=t,I===0&&be(Yl)),Se===t&&(r.charCodeAt(b)===45?(Se=wA,b++):(Se=t,I===0&&be(Gl))),Se!==t){for(ht=[],Bt=He();Bt!==t;)ht.push(Bt),Bt=He();ht!==t?(Bt=oS(),Bt!==t?(Me=U,ce=yg(Q,Se,Bt),U=ce):(b=U,U=t)):(b=U,U=t)}else b=U,U=t;else b=U,U=t}N!==t?(Me=m,Q=js(Q,N),m=Q):(b=m,m=t)}else b=m,m=t;return m}function eK(){var m,Q,N,U,ce,Se;if(m=b,r.substr(b,3)===bA?(Q=bA,b+=3):(Q=t,I===0&&be(R)),Q!==t){for(N=[],U=He();U!==t;)N.push(U),U=He();if(N!==t)if(U=$1(),U!==t){for(ce=[],Se=He();Se!==t;)ce.push(Se),Se=He();ce!==t?(r.substr(b,2)===q?(Se=q,b+=2):(Se=t,I===0&&be(Ce)),Se!==t?(Me=m,Q=Ke(U),m=Q):(b=m,m=t)):(b=m,m=t)}else b=m,m=t;else b=m,m=t}else b=m,m=t;return m}function tK(){var m,Q,N,U;return m=b,r.substr(b,2)===Re?(Q=Re,b+=2):(Q=t,I===0&&be(ze)),Q!==t?(N=Mr(),N!==t?(r.charCodeAt(b)===41?(U=O,b++):(U=t,I===0&&be(F)),U!==t?(Me=m,Q=dt(N),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t),m}function aS(){var m,Q,N,U,ce,Se;return m=b,r.substr(b,2)===Ft?(Q=Ft,b+=2):(Q=t,I===0&&be(Ln)),Q!==t?(N=ql(),N!==t?(r.substr(b,2)===JQ?(U=JQ,b+=2):(U=t,I===0&&be(k1)),U!==t?(ce=q1(),ce!==t?(r.charCodeAt(b)===125?(Se=Fe,b++):(Se=t,I===0&&be(Ne)),Se!==t?(Me=m,Q=R1(N,ce),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t)):(b=m,m=t)):(b=m,m=t),m===t&&(m=b,r.substr(b,2)===Ft?(Q=Ft,b+=2):(Q=t,I===0&&be(Ln)),Q!==t?(N=ql(),N!==t?(r.substr(b,3)===WQ?(U=WQ,b+=3):(U=t,I===0&&be(F1)),U!==t?(Me=m,Q=N1(N),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t),m===t&&(m=b,r.substr(b,2)===Ft?(Q=Ft,b+=2):(Q=t,I===0&&be(Ln)),Q!==t?(N=ql(),N!==t?(r.substr(b,2)===zQ?(U=zQ,b+=2):(U=t,I===0&&be(T1)),U!==t?(ce=q1(),ce!==t?(r.charCodeAt(b)===125?(Se=Fe,b++):(Se=t,I===0&&be(Ne)),Se!==t?(Me=m,Q=L1(N,ce),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t)):(b=m,m=t)):(b=m,m=t),m===t&&(m=b,r.substr(b,2)===Ft?(Q=Ft,b+=2):(Q=t,I===0&&be(Ln)),Q!==t?(N=ql(),N!==t?(r.substr(b,3)===VQ?(U=VQ,b+=3):(U=t,I===0&&be(O1)),U!==t?(Me=m,Q=M1(N),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t),m===t&&(m=b,r.substr(b,2)===Ft?(Q=Ft,b+=2):(Q=t,I===0&&be(Ln)),Q!==t?(N=ql(),N!==t?(r.charCodeAt(b)===125?(U=Fe,b++):(U=t,I===0&&be(Ne)),U!==t?(Me=m,Q=XQ(N),m=Q):(b=m,m=t)):(b=m,m=t)):(b=m,m=t),m===t&&(m=b,r.charCodeAt(b)===36?(Q=K1,b++):(Q=t,I===0&&be(U1)),Q!==t?(N=ql(),N!==t?(Me=m,Q=XQ(N),m=Q):(b=m,m=t)):(b=m,m=t)))))),m}function xge(){var m,Q,N;return m=b,Q=Pge(),Q!==t?(Me=b,N=H1(Q),N?N=void 0:N=t,N!==t?(Me=m,Q=G1(Q),m=Q):(b=m,m=t)):(b=m,m=t),m}function Pge(){var m,Q,N,U,ce;if(m=b,Q=[],N=b,U=b,I++,ce=nK(),I--,ce===t?U=void 0:(b=U,U=t),U!==t?(r.length>b?(ce=r.charAt(b),b++):(ce=t,I===0&&be(bo)),ce!==t?(Me=N,U=ln(ce),N=U):(b=N,N=t)):(b=N,N=t),N!==t)for(;N!==t;)Q.push(N),N=b,U=b,I++,ce=nK(),I--,ce===t?U=void 0:(b=U,U=t),U!==t?(r.length>b?(ce=r.charAt(b),b++):(ce=t,I===0&&be(bo)),ce!==t?(Me=N,U=ln(ce),N=U):(b=N,N=t)):(b=N,N=t);else Q=t;return Q!==t&&(Me=m,Q=Fn(Q)),m=Q,m}function rK(){var m,Q,N;if(m=b,Q=[],ZQ.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(_Q)),N!==t)for(;N!==t;)Q.push(N),ZQ.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(_Q));else Q=t;return Q!==t&&(Me=m,Q=$Q()),m=Q,m}function ql(){var m,Q,N;if(m=b,Q=[],eS.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(tS)),N!==t)for(;N!==t;)Q.push(N),eS.test(r.charAt(b))?(N=r.charAt(b),b++):(N=t,I===0&&be(tS));else Q=t;return Q!==t&&(Me=m,Q=$Q()),m=Q,m}function iK(){var m;return Y1.test(r.charAt(b))?(m=r.charAt(b),b++):(m=t,I===0&&be(wg)),m}function nK(){var m;return rS.test(r.charAt(b))?(m=r.charAt(b),b++):(m=t,I===0&&be(iS)),m}function He(){var m,Q;if(m=[],YE.test(r.charAt(b))?(Q=r.charAt(b),b++):(Q=t,I===0&&be(jE)),Q!==t)for(;Q!==t;)m.push(Q),YE.test(r.charAt(b))?(Q=r.charAt(b),b++):(Q=t,I===0&&be(jE));else m=t;return m}if(k=n(),k!==t&&b===r.length)return k;throw k!==t&&b{\"use strict\";function Dfe(r,e){function t(){this.constructor=r}t.prototype=e.prototype,r.prototype=new t}function $l(r,e,t,i){this.message=r,this.expected=e,this.found=t,this.location=i,this.name=\"SyntaxError\",typeof Error.captureStackTrace==\"function\"&&Error.captureStackTrace(this,$l)}Dfe($l,Error);$l.buildMessage=function(r,e){var t={literal:function(c){return'\"'+n(c.text)+'\"'},class:function(c){var u=\"\",g;for(g=0;g0){for(g=1,f=1;gH&&(H=v,j=[]),j.push(ne))}function Ne(ne,Y){return new $l(ne,null,null,Y)}function oe(ne,Y,he){return new $l($l.buildMessage(ne,Y),ne,Y,he)}function le(){var ne,Y,he,ie;return ne=v,Y=Be(),Y!==t?(r.charCodeAt(v)===47?(he=s,v++):(he=t,$===0&&Fe(o)),he!==t?(ie=Be(),ie!==t?(D=ne,Y=a(Y,ie),ne=Y):(v=ne,ne=t)):(v=ne,ne=t)):(v=ne,ne=t),ne===t&&(ne=v,Y=Be(),Y!==t&&(D=ne,Y=l(Y)),ne=Y),ne}function Be(){var ne,Y,he,ie;return ne=v,Y=fe(),Y!==t?(r.charCodeAt(v)===64?(he=c,v++):(he=t,$===0&&Fe(u)),he!==t?(ie=qe(),ie!==t?(D=ne,Y=g(Y,ie),ne=Y):(v=ne,ne=t)):(v=ne,ne=t)):(v=ne,ne=t),ne===t&&(ne=v,Y=fe(),Y!==t&&(D=ne,Y=f(Y)),ne=Y),ne}function fe(){var ne,Y,he,ie,de;return ne=v,r.charCodeAt(v)===64?(Y=c,v++):(Y=t,$===0&&Fe(u)),Y!==t?(he=ae(),he!==t?(r.charCodeAt(v)===47?(ie=s,v++):(ie=t,$===0&&Fe(o)),ie!==t?(de=ae(),de!==t?(D=ne,Y=h(),ne=Y):(v=ne,ne=t)):(v=ne,ne=t)):(v=ne,ne=t)):(v=ne,ne=t),ne===t&&(ne=v,Y=ae(),Y!==t&&(D=ne,Y=h()),ne=Y),ne}function ae(){var ne,Y,he;if(ne=v,Y=[],p.test(r.charAt(v))?(he=r.charAt(v),v++):(he=t,$===0&&Fe(C)),he!==t)for(;he!==t;)Y.push(he),p.test(r.charAt(v))?(he=r.charAt(v),v++):(he=t,$===0&&Fe(C));else Y=t;return Y!==t&&(D=ne,Y=h()),ne=Y,ne}function qe(){var ne,Y,he;if(ne=v,Y=[],y.test(r.charAt(v))?(he=r.charAt(v),v++):(he=t,$===0&&Fe(B)),he!==t)for(;he!==t;)Y.push(he),y.test(r.charAt(v))?(he=r.charAt(v),v++):(he=t,$===0&&Fe(B));else Y=t;return Y!==t&&(D=ne,Y=h()),ne=Y,ne}if(V=n(),V!==t&&v===r.length)return V;throw V!==t&&v{\"use strict\";function mU(r){return typeof r>\"u\"||r===null}function Rfe(r){return typeof r==\"object\"&&r!==null}function Ffe(r){return Array.isArray(r)?r:mU(r)?[]:[r]}function Nfe(r,e){var t,i,n,s;if(e)for(s=Object.keys(e),t=0,i=s.length;t{\"use strict\";function Vp(r,e){Error.call(this),this.name=\"YAMLException\",this.reason=r,this.mark=e,this.message=(this.reason||\"(unknown reason)\")+(this.mark?\" \"+this.mark.toString():\"\"),Error.captureStackTrace?Error.captureStackTrace(this,this.constructor):this.stack=new Error().stack||\"\"}Vp.prototype=Object.create(Error.prototype);Vp.prototype.constructor=Vp;Vp.prototype.toString=function(e){var t=this.name+\": \";return t+=this.reason||\"(unknown reason)\",!e&&this.mark&&(t+=\" \"+this.mark.toString()),t};EU.exports=Vp});var wU=w((SZe,yU)=>{\"use strict\";var IU=tc();function HS(r,e,t,i,n){this.name=r,this.buffer=e,this.position=t,this.line=i,this.column=n}HS.prototype.getSnippet=function(e,t){var i,n,s,o,a;if(!this.buffer)return null;for(e=e||4,t=t||75,i=\"\",n=this.position;n>0&&`\\0\\r\n\\x85\\u2028\\u2029`.indexOf(this.buffer.charAt(n-1))===-1;)if(n-=1,this.position-n>t/2-1){i=\" ... \",n+=5;break}for(s=\"\",o=this.position;ot/2-1){s=\" ... \",o-=5;break}return a=this.buffer.slice(n,o),IU.repeat(\" \",e)+i+a+s+`\n`+IU.repeat(\" \",e+this.position-n+i.length)+\"^\"};HS.prototype.toString=function(e){var t,i=\"\";return this.name&&(i+='in \"'+this.name+'\" '),i+=\"at line \"+(this.line+1)+\", column \"+(this.column+1),e||(t=this.getSnippet(),t&&(i+=`:\n`+t)),i};yU.exports=HS});var si=w((vZe,bU)=>{\"use strict\";var BU=Ng(),Ofe=[\"kind\",\"resolve\",\"construct\",\"instanceOf\",\"predicate\",\"represent\",\"defaultStyle\",\"styleAliases\"],Mfe=[\"scalar\",\"sequence\",\"mapping\"];function Kfe(r){var e={};return r!==null&&Object.keys(r).forEach(function(t){r[t].forEach(function(i){e[String(i)]=t})}),e}function Ufe(r,e){if(e=e||{},Object.keys(e).forEach(function(t){if(Ofe.indexOf(t)===-1)throw new BU('Unknown option \"'+t+'\" is met in definition of \"'+r+'\" YAML type.')}),this.tag=r,this.kind=e.kind||null,this.resolve=e.resolve||function(){return!0},this.construct=e.construct||function(t){return t},this.instanceOf=e.instanceOf||null,this.predicate=e.predicate||null,this.represent=e.represent||null,this.defaultStyle=e.defaultStyle||null,this.styleAliases=Kfe(e.styleAliases||null),Mfe.indexOf(this.kind)===-1)throw new BU('Unknown kind \"'+this.kind+'\" is specified for \"'+r+'\" YAML type.')}bU.exports=Ufe});var rc=w((xZe,SU)=>{\"use strict\";var QU=tc(),dI=Ng(),Hfe=si();function GS(r,e,t){var i=[];return r.include.forEach(function(n){t=GS(n,e,t)}),r[e].forEach(function(n){t.forEach(function(s,o){s.tag===n.tag&&s.kind===n.kind&&i.push(o)}),t.push(n)}),t.filter(function(n,s){return i.indexOf(s)===-1})}function Gfe(){var r={scalar:{},sequence:{},mapping:{},fallback:{}},e,t;function i(n){r[n.kind][n.tag]=r.fallback[n.tag]=n}for(e=0,t=arguments.length;e{\"use strict\";var Yfe=si();vU.exports=new Yfe(\"tag:yaml.org,2002:str\",{kind:\"scalar\",construct:function(r){return r!==null?r:\"\"}})});var DU=w((DZe,PU)=>{\"use strict\";var jfe=si();PU.exports=new jfe(\"tag:yaml.org,2002:seq\",{kind:\"sequence\",construct:function(r){return r!==null?r:[]}})});var RU=w((kZe,kU)=>{\"use strict\";var qfe=si();kU.exports=new qfe(\"tag:yaml.org,2002:map\",{kind:\"mapping\",construct:function(r){return r!==null?r:{}}})});var CI=w((RZe,FU)=>{\"use strict\";var Jfe=rc();FU.exports=new Jfe({explicit:[xU(),DU(),RU()]})});var TU=w((FZe,NU)=>{\"use strict\";var Wfe=si();function zfe(r){if(r===null)return!0;var e=r.length;return e===1&&r===\"~\"||e===4&&(r===\"null\"||r===\"Null\"||r===\"NULL\")}function Vfe(){return null}function Xfe(r){return r===null}NU.exports=new Wfe(\"tag:yaml.org,2002:null\",{kind:\"scalar\",resolve:zfe,construct:Vfe,predicate:Xfe,represent:{canonical:function(){return\"~\"},lowercase:function(){return\"null\"},uppercase:function(){return\"NULL\"},camelcase:function(){return\"Null\"}},defaultStyle:\"lowercase\"})});var OU=w((NZe,LU)=>{\"use strict\";var Zfe=si();function _fe(r){if(r===null)return!1;var e=r.length;return e===4&&(r===\"true\"||r===\"True\"||r===\"TRUE\")||e===5&&(r===\"false\"||r===\"False\"||r===\"FALSE\")}function $fe(r){return r===\"true\"||r===\"True\"||r===\"TRUE\"}function ehe(r){return Object.prototype.toString.call(r)===\"[object Boolean]\"}LU.exports=new Zfe(\"tag:yaml.org,2002:bool\",{kind:\"scalar\",resolve:_fe,construct:$fe,predicate:ehe,represent:{lowercase:function(r){return r?\"true\":\"false\"},uppercase:function(r){return r?\"TRUE\":\"FALSE\"},camelcase:function(r){return r?\"True\":\"False\"}},defaultStyle:\"lowercase\"})});var KU=w((TZe,MU)=>{\"use strict\";var the=tc(),rhe=si();function ihe(r){return 48<=r&&r<=57||65<=r&&r<=70||97<=r&&r<=102}function nhe(r){return 48<=r&&r<=55}function she(r){return 48<=r&&r<=57}function ohe(r){if(r===null)return!1;var e=r.length,t=0,i=!1,n;if(!e)return!1;if(n=r[t],(n===\"-\"||n===\"+\")&&(n=r[++t]),n===\"0\"){if(t+1===e)return!0;if(n=r[++t],n===\"b\"){for(t++;t=0?\"0b\"+r.toString(2):\"-0b\"+r.toString(2).slice(1)},octal:function(r){return r>=0?\"0\"+r.toString(8):\"-0\"+r.toString(8).slice(1)},decimal:function(r){return r.toString(10)},hexadecimal:function(r){return r>=0?\"0x\"+r.toString(16).toUpperCase():\"-0x\"+r.toString(16).toUpperCase().slice(1)}},defaultStyle:\"decimal\",styleAliases:{binary:[2,\"bin\"],octal:[8,\"oct\"],decimal:[10,\"dec\"],hexadecimal:[16,\"hex\"]}})});var GU=w((LZe,HU)=>{\"use strict\";var UU=tc(),lhe=si(),che=new RegExp(\"^(?:[-+]?(?:0|[1-9][0-9_]*)(?:\\\\.[0-9_]*)?(?:[eE][-+]?[0-9]+)?|\\\\.[0-9_]+(?:[eE][-+]?[0-9]+)?|[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\\\\.[0-9_]*|[-+]?\\\\.(?:inf|Inf|INF)|\\\\.(?:nan|NaN|NAN))$\");function uhe(r){return!(r===null||!che.test(r)||r[r.length-1]===\"_\")}function ghe(r){var e,t,i,n;return e=r.replace(/_/g,\"\").toLowerCase(),t=e[0]===\"-\"?-1:1,n=[],\"+-\".indexOf(e[0])>=0&&(e=e.slice(1)),e===\".inf\"?t===1?Number.POSITIVE_INFINITY:Number.NEGATIVE_INFINITY:e===\".nan\"?NaN:e.indexOf(\":\")>=0?(e.split(\":\").forEach(function(s){n.unshift(parseFloat(s,10))}),e=0,i=1,n.forEach(function(s){e+=s*i,i*=60}),t*e):t*parseFloat(e,10)}var fhe=/^[-+]?[0-9]+e/;function hhe(r,e){var t;if(isNaN(r))switch(e){case\"lowercase\":return\".nan\";case\"uppercase\":return\".NAN\";case\"camelcase\":return\".NaN\"}else if(Number.POSITIVE_INFINITY===r)switch(e){case\"lowercase\":return\".inf\";case\"uppercase\":return\".INF\";case\"camelcase\":return\".Inf\"}else if(Number.NEGATIVE_INFINITY===r)switch(e){case\"lowercase\":return\"-.inf\";case\"uppercase\":return\"-.INF\";case\"camelcase\":return\"-.Inf\"}else if(UU.isNegativeZero(r))return\"-0.0\";return t=r.toString(10),fhe.test(t)?t.replace(\"e\",\".e\"):t}function phe(r){return Object.prototype.toString.call(r)===\"[object Number]\"&&(r%1!==0||UU.isNegativeZero(r))}HU.exports=new lhe(\"tag:yaml.org,2002:float\",{kind:\"scalar\",resolve:uhe,construct:ghe,predicate:phe,represent:hhe,defaultStyle:\"lowercase\"})});var YS=w((OZe,YU)=>{\"use strict\";var dhe=rc();YU.exports=new dhe({include:[CI()],implicit:[TU(),OU(),KU(),GU()]})});var jS=w((MZe,jU)=>{\"use strict\";var Che=rc();jU.exports=new Che({include:[YS()]})});var zU=w((KZe,WU)=>{\"use strict\";var mhe=si(),qU=new RegExp(\"^([0-9][0-9][0-9][0-9])-([0-9][0-9])-([0-9][0-9])$\"),JU=new RegExp(\"^([0-9][0-9][0-9][0-9])-([0-9][0-9]?)-([0-9][0-9]?)(?:[Tt]|[ \\\\t]+)([0-9][0-9]?):([0-9][0-9]):([0-9][0-9])(?:\\\\.([0-9]*))?(?:[ \\\\t]*(Z|([-+])([0-9][0-9]?)(?::([0-9][0-9]))?))?$\");function Ehe(r){return r===null?!1:qU.exec(r)!==null||JU.exec(r)!==null}function Ihe(r){var e,t,i,n,s,o,a,l=0,c=null,u,g,f;if(e=qU.exec(r),e===null&&(e=JU.exec(r)),e===null)throw new Error(\"Date resolve error\");if(t=+e[1],i=+e[2]-1,n=+e[3],!e[4])return new Date(Date.UTC(t,i,n));if(s=+e[4],o=+e[5],a=+e[6],e[7]){for(l=e[7].slice(0,3);l.length<3;)l+=\"0\";l=+l}return e[9]&&(u=+e[10],g=+(e[11]||0),c=(u*60+g)*6e4,e[9]===\"-\"&&(c=-c)),f=new Date(Date.UTC(t,i,n,s,o,a,l)),c&&f.setTime(f.getTime()-c),f}function yhe(r){return r.toISOString()}WU.exports=new mhe(\"tag:yaml.org,2002:timestamp\",{kind:\"scalar\",resolve:Ehe,construct:Ihe,instanceOf:Date,represent:yhe})});var XU=w((UZe,VU)=>{\"use strict\";var whe=si();function Bhe(r){return r===\"<<\"||r===null}VU.exports=new whe(\"tag:yaml.org,2002:merge\",{kind:\"scalar\",resolve:Bhe})});var $U=w((HZe,_U)=>{\"use strict\";var ic;try{ZU=J,ic=ZU(\"buffer\").Buffer}catch{}var ZU,bhe=si(),qS=`ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=\n\\r`;function Qhe(r){if(r===null)return!1;var e,t,i=0,n=r.length,s=qS;for(t=0;t64)){if(e<0)return!1;i+=6}return i%8===0}function She(r){var e,t,i=r.replace(/[\\r\\n=]/g,\"\"),n=i.length,s=qS,o=0,a=[];for(e=0;e>16&255),a.push(o>>8&255),a.push(o&255)),o=o<<6|s.indexOf(i.charAt(e));return t=n%4*6,t===0?(a.push(o>>16&255),a.push(o>>8&255),a.push(o&255)):t===18?(a.push(o>>10&255),a.push(o>>2&255)):t===12&&a.push(o>>4&255),ic?ic.from?ic.from(a):new ic(a):a}function vhe(r){var e=\"\",t=0,i,n,s=r.length,o=qS;for(i=0;i>18&63],e+=o[t>>12&63],e+=o[t>>6&63],e+=o[t&63]),t=(t<<8)+r[i];return n=s%3,n===0?(e+=o[t>>18&63],e+=o[t>>12&63],e+=o[t>>6&63],e+=o[t&63]):n===2?(e+=o[t>>10&63],e+=o[t>>4&63],e+=o[t<<2&63],e+=o[64]):n===1&&(e+=o[t>>2&63],e+=o[t<<4&63],e+=o[64],e+=o[64]),e}function xhe(r){return ic&&ic.isBuffer(r)}_U.exports=new bhe(\"tag:yaml.org,2002:binary\",{kind:\"scalar\",resolve:Qhe,construct:She,predicate:xhe,represent:vhe})});var t2=w((YZe,e2)=>{\"use strict\";var Phe=si(),Dhe=Object.prototype.hasOwnProperty,khe=Object.prototype.toString;function Rhe(r){if(r===null)return!0;var e=[],t,i,n,s,o,a=r;for(t=0,i=a.length;t{\"use strict\";var Nhe=si(),The=Object.prototype.toString;function Lhe(r){if(r===null)return!0;var e,t,i,n,s,o=r;for(s=new Array(o.length),e=0,t=o.length;e{\"use strict\";var Mhe=si(),Khe=Object.prototype.hasOwnProperty;function Uhe(r){if(r===null)return!0;var e,t=r;for(e in t)if(Khe.call(t,e)&&t[e]!==null)return!1;return!0}function Hhe(r){return r!==null?r:{}}n2.exports=new Mhe(\"tag:yaml.org,2002:set\",{kind:\"mapping\",resolve:Uhe,construct:Hhe})});var Lg=w((JZe,o2)=>{\"use strict\";var Ghe=rc();o2.exports=new Ghe({include:[jS()],implicit:[zU(),XU()],explicit:[$U(),t2(),i2(),s2()]})});var A2=w((WZe,a2)=>{\"use strict\";var Yhe=si();function jhe(){return!0}function qhe(){}function Jhe(){return\"\"}function Whe(r){return typeof r>\"u\"}a2.exports=new Yhe(\"tag:yaml.org,2002:js/undefined\",{kind:\"scalar\",resolve:jhe,construct:qhe,predicate:Whe,represent:Jhe})});var c2=w((zZe,l2)=>{\"use strict\";var zhe=si();function Vhe(r){if(r===null||r.length===0)return!1;var e=r,t=/\\/([gim]*)$/.exec(r),i=\"\";return!(e[0]===\"/\"&&(t&&(i=t[1]),i.length>3||e[e.length-i.length-1]!==\"/\"))}function Xhe(r){var e=r,t=/\\/([gim]*)$/.exec(r),i=\"\";return e[0]===\"/\"&&(t&&(i=t[1]),e=e.slice(1,e.length-i.length-1)),new RegExp(e,i)}function Zhe(r){var e=\"/\"+r.source+\"/\";return r.global&&(e+=\"g\"),r.multiline&&(e+=\"m\"),r.ignoreCase&&(e+=\"i\"),e}function _he(r){return Object.prototype.toString.call(r)===\"[object RegExp]\"}l2.exports=new zhe(\"tag:yaml.org,2002:js/regexp\",{kind:\"scalar\",resolve:Vhe,construct:Xhe,predicate:_he,represent:Zhe})});var f2=w((VZe,g2)=>{\"use strict\";var mI;try{u2=J,mI=u2(\"esprima\")}catch{typeof window<\"u\"&&(mI=window.esprima)}var u2,$he=si();function epe(r){if(r===null)return!1;try{var e=\"(\"+r+\")\",t=mI.parse(e,{range:!0});return!(t.type!==\"Program\"||t.body.length!==1||t.body[0].type!==\"ExpressionStatement\"||t.body[0].expression.type!==\"ArrowFunctionExpression\"&&t.body[0].expression.type!==\"FunctionExpression\")}catch{return!1}}function tpe(r){var e=\"(\"+r+\")\",t=mI.parse(e,{range:!0}),i=[],n;if(t.type!==\"Program\"||t.body.length!==1||t.body[0].type!==\"ExpressionStatement\"||t.body[0].expression.type!==\"ArrowFunctionExpression\"&&t.body[0].expression.type!==\"FunctionExpression\")throw new Error(\"Failed to resolve function\");return t.body[0].expression.params.forEach(function(s){i.push(s.name)}),n=t.body[0].expression.body.range,t.body[0].expression.body.type===\"BlockStatement\"?new Function(i,e.slice(n[0]+1,n[1]-1)):new Function(i,\"return \"+e.slice(n[0],n[1]))}function rpe(r){return r.toString()}function ipe(r){return Object.prototype.toString.call(r)===\"[object Function]\"}g2.exports=new $he(\"tag:yaml.org,2002:js/function\",{kind:\"scalar\",resolve:epe,construct:tpe,predicate:ipe,represent:rpe})});var Xp=w((ZZe,p2)=>{\"use strict\";var h2=rc();p2.exports=h2.DEFAULT=new h2({include:[Lg()],explicit:[A2(),c2(),f2()]})});var N2=w((_Ze,Zp)=>{\"use strict\";var Ba=tc(),w2=Ng(),npe=wU(),B2=Lg(),spe=Xp(),kA=Object.prototype.hasOwnProperty,EI=1,b2=2,Q2=3,II=4,JS=1,ope=2,d2=3,ape=/[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F-\\x84\\x86-\\x9F\\uFFFE\\uFFFF]|[\\uD800-\\uDBFF](?![\\uDC00-\\uDFFF])|(?:[^\\uD800-\\uDBFF]|^)[\\uDC00-\\uDFFF]/,Ape=/[\\x85\\u2028\\u2029]/,lpe=/[,\\[\\]\\{\\}]/,S2=/^(?:!|!!|![a-z\\-]+!)$/i,v2=/^(?:!|[^,\\[\\]\\{\\}])(?:%[0-9a-f]{2}|[0-9a-z\\-#;\\/\\?:@&=\\+\\$,_\\.!~\\*'\\(\\)\\[\\]])*$/i;function C2(r){return Object.prototype.toString.call(r)}function xo(r){return r===10||r===13}function sc(r){return r===9||r===32}function fn(r){return r===9||r===32||r===10||r===13}function Og(r){return r===44||r===91||r===93||r===123||r===125}function cpe(r){var e;return 48<=r&&r<=57?r-48:(e=r|32,97<=e&&e<=102?e-97+10:-1)}function upe(r){return r===120?2:r===117?4:r===85?8:0}function gpe(r){return 48<=r&&r<=57?r-48:-1}function m2(r){return r===48?\"\\0\":r===97?\"\\x07\":r===98?\"\\b\":r===116||r===9?\"\t\":r===110?`\n`:r===118?\"\\v\":r===102?\"\\f\":r===114?\"\\r\":r===101?\"\\x1B\":r===32?\" \":r===34?'\"':r===47?\"/\":r===92?\"\\\\\":r===78?\"\\x85\":r===95?\"\\xA0\":r===76?\"\\u2028\":r===80?\"\\u2029\":\"\"}function fpe(r){return r<=65535?String.fromCharCode(r):String.fromCharCode((r-65536>>10)+55296,(r-65536&1023)+56320)}var x2=new Array(256),P2=new Array(256);for(nc=0;nc<256;nc++)x2[nc]=m2(nc)?1:0,P2[nc]=m2(nc);var nc;function hpe(r,e){this.input=r,this.filename=e.filename||null,this.schema=e.schema||spe,this.onWarning=e.onWarning||null,this.legacy=e.legacy||!1,this.json=e.json||!1,this.listener=e.listener||null,this.implicitTypes=this.schema.compiledImplicit,this.typeMap=this.schema.compiledTypeMap,this.length=r.length,this.position=0,this.line=0,this.lineStart=0,this.lineIndent=0,this.documents=[]}function D2(r,e){return new w2(e,new npe(r.filename,r.input,r.position,r.line,r.position-r.lineStart))}function ft(r,e){throw D2(r,e)}function yI(r,e){r.onWarning&&r.onWarning.call(null,D2(r,e))}var E2={YAML:function(e,t,i){var n,s,o;e.version!==null&&ft(e,\"duplication of %YAML directive\"),i.length!==1&&ft(e,\"YAML directive accepts exactly one argument\"),n=/^([0-9]+)\\.([0-9]+)$/.exec(i[0]),n===null&&ft(e,\"ill-formed argument of the YAML directive\"),s=parseInt(n[1],10),o=parseInt(n[2],10),s!==1&&ft(e,\"unacceptable YAML version of the document\"),e.version=i[0],e.checkLineBreaks=o<2,o!==1&&o!==2&&yI(e,\"unsupported YAML version of the document\")},TAG:function(e,t,i){var n,s;i.length!==2&&ft(e,\"TAG directive accepts exactly two arguments\"),n=i[0],s=i[1],S2.test(n)||ft(e,\"ill-formed tag handle (first argument) of the TAG directive\"),kA.call(e.tagMap,n)&&ft(e,'there is a previously declared suffix for \"'+n+'\" tag handle'),v2.test(s)||ft(e,\"ill-formed tag prefix (second argument) of the TAG directive\"),e.tagMap[n]=s}};function DA(r,e,t,i){var n,s,o,a;if(e1&&(r.result+=Ba.repeat(`\n`,e-1))}function ppe(r,e,t){var i,n,s,o,a,l,c,u,g=r.kind,f=r.result,h;if(h=r.input.charCodeAt(r.position),fn(h)||Og(h)||h===35||h===38||h===42||h===33||h===124||h===62||h===39||h===34||h===37||h===64||h===96||(h===63||h===45)&&(n=r.input.charCodeAt(r.position+1),fn(n)||t&&Og(n)))return!1;for(r.kind=\"scalar\",r.result=\"\",s=o=r.position,a=!1;h!==0;){if(h===58){if(n=r.input.charCodeAt(r.position+1),fn(n)||t&&Og(n))break}else if(h===35){if(i=r.input.charCodeAt(r.position-1),fn(i))break}else{if(r.position===r.lineStart&&wI(r)||t&&Og(h))break;if(xo(h))if(l=r.line,c=r.lineStart,u=r.lineIndent,zr(r,!1,-1),r.lineIndent>=e){a=!0,h=r.input.charCodeAt(r.position);continue}else{r.position=o,r.line=l,r.lineStart=c,r.lineIndent=u;break}}a&&(DA(r,s,o,!1),zS(r,r.line-l),s=o=r.position,a=!1),sc(h)||(o=r.position+1),h=r.input.charCodeAt(++r.position)}return DA(r,s,o,!1),r.result?!0:(r.kind=g,r.result=f,!1)}function dpe(r,e){var t,i,n;if(t=r.input.charCodeAt(r.position),t!==39)return!1;for(r.kind=\"scalar\",r.result=\"\",r.position++,i=n=r.position;(t=r.input.charCodeAt(r.position))!==0;)if(t===39)if(DA(r,i,r.position,!0),t=r.input.charCodeAt(++r.position),t===39)i=r.position,r.position++,n=r.position;else return!0;else xo(t)?(DA(r,i,n,!0),zS(r,zr(r,!1,e)),i=n=r.position):r.position===r.lineStart&&wI(r)?ft(r,\"unexpected end of the document within a single quoted scalar\"):(r.position++,n=r.position);ft(r,\"unexpected end of the stream within a single quoted scalar\")}function Cpe(r,e){var t,i,n,s,o,a;if(a=r.input.charCodeAt(r.position),a!==34)return!1;for(r.kind=\"scalar\",r.result=\"\",r.position++,t=i=r.position;(a=r.input.charCodeAt(r.position))!==0;){if(a===34)return DA(r,t,r.position,!0),r.position++,!0;if(a===92){if(DA(r,t,r.position,!0),a=r.input.charCodeAt(++r.position),xo(a))zr(r,!1,e);else if(a<256&&x2[a])r.result+=P2[a],r.position++;else if((o=upe(a))>0){for(n=o,s=0;n>0;n--)a=r.input.charCodeAt(++r.position),(o=cpe(a))>=0?s=(s<<4)+o:ft(r,\"expected hexadecimal character\");r.result+=fpe(s),r.position++}else ft(r,\"unknown escape sequence\");t=i=r.position}else xo(a)?(DA(r,t,i,!0),zS(r,zr(r,!1,e)),t=i=r.position):r.position===r.lineStart&&wI(r)?ft(r,\"unexpected end of the document within a double quoted scalar\"):(r.position++,i=r.position)}ft(r,\"unexpected end of the stream within a double quoted scalar\")}function mpe(r,e){var t=!0,i,n=r.tag,s,o=r.anchor,a,l,c,u,g,f={},h,p,C,y;if(y=r.input.charCodeAt(r.position),y===91)l=93,g=!1,s=[];else if(y===123)l=125,g=!0,s={};else return!1;for(r.anchor!==null&&(r.anchorMap[r.anchor]=s),y=r.input.charCodeAt(++r.position);y!==0;){if(zr(r,!0,e),y=r.input.charCodeAt(r.position),y===l)return r.position++,r.tag=n,r.anchor=o,r.kind=g?\"mapping\":\"sequence\",r.result=s,!0;t||ft(r,\"missed comma between flow collection entries\"),p=h=C=null,c=u=!1,y===63&&(a=r.input.charCodeAt(r.position+1),fn(a)&&(c=u=!0,r.position++,zr(r,!0,e))),i=r.line,Kg(r,e,EI,!1,!0),p=r.tag,h=r.result,zr(r,!0,e),y=r.input.charCodeAt(r.position),(u||r.line===i)&&y===58&&(c=!0,y=r.input.charCodeAt(++r.position),zr(r,!0,e),Kg(r,e,EI,!1,!0),C=r.result),g?Mg(r,s,f,p,h,C):c?s.push(Mg(r,null,f,p,h,C)):s.push(h),zr(r,!0,e),y=r.input.charCodeAt(r.position),y===44?(t=!0,y=r.input.charCodeAt(++r.position)):t=!1}ft(r,\"unexpected end of the stream within a flow collection\")}function Epe(r,e){var t,i,n=JS,s=!1,o=!1,a=e,l=0,c=!1,u,g;if(g=r.input.charCodeAt(r.position),g===124)i=!1;else if(g===62)i=!0;else return!1;for(r.kind=\"scalar\",r.result=\"\";g!==0;)if(g=r.input.charCodeAt(++r.position),g===43||g===45)JS===n?n=g===43?d2:ope:ft(r,\"repeat of a chomping mode identifier\");else if((u=gpe(g))>=0)u===0?ft(r,\"bad explicit indentation width of a block scalar; it cannot be less than one\"):o?ft(r,\"repeat of an indentation width identifier\"):(a=e+u-1,o=!0);else break;if(sc(g)){do g=r.input.charCodeAt(++r.position);while(sc(g));if(g===35)do g=r.input.charCodeAt(++r.position);while(!xo(g)&&g!==0)}for(;g!==0;){for(WS(r),r.lineIndent=0,g=r.input.charCodeAt(r.position);(!o||r.lineIndenta&&(a=r.lineIndent),xo(g)){l++;continue}if(r.lineIndente)&&l!==0)ft(r,\"bad indentation of a sequence entry\");else if(r.lineIndente)&&(Kg(r,e,II,!0,n)&&(p?f=r.result:h=r.result),p||(Mg(r,c,u,g,f,h,s,o),g=f=h=null),zr(r,!0,-1),y=r.input.charCodeAt(r.position)),r.lineIndent>e&&y!==0)ft(r,\"bad indentation of a mapping entry\");else if(r.lineIndente?l=1:r.lineIndent===e?l=0:r.lineIndente?l=1:r.lineIndent===e?l=0:r.lineIndent tag; it should be \"scalar\", not \"'+r.kind+'\"'),g=0,f=r.implicitTypes.length;g tag; it should be \"'+h.kind+'\", not \"'+r.kind+'\"'),h.resolve(r.result)?(r.result=h.construct(r.result),r.anchor!==null&&(r.anchorMap[r.anchor]=r.result)):ft(r,\"cannot resolve a node with !<\"+r.tag+\"> explicit tag\")):ft(r,\"unknown tag !<\"+r.tag+\">\");return r.listener!==null&&r.listener(\"close\",r),r.tag!==null||r.anchor!==null||u}function bpe(r){var e=r.position,t,i,n,s=!1,o;for(r.version=null,r.checkLineBreaks=r.legacy,r.tagMap={},r.anchorMap={};(o=r.input.charCodeAt(r.position))!==0&&(zr(r,!0,-1),o=r.input.charCodeAt(r.position),!(r.lineIndent>0||o!==37));){for(s=!0,o=r.input.charCodeAt(++r.position),t=r.position;o!==0&&!fn(o);)o=r.input.charCodeAt(++r.position);for(i=r.input.slice(t,r.position),n=[],i.length<1&&ft(r,\"directive name must not be less than one character in length\");o!==0;){for(;sc(o);)o=r.input.charCodeAt(++r.position);if(o===35){do o=r.input.charCodeAt(++r.position);while(o!==0&&!xo(o));break}if(xo(o))break;for(t=r.position;o!==0&&!fn(o);)o=r.input.charCodeAt(++r.position);n.push(r.input.slice(t,r.position))}o!==0&&WS(r),kA.call(E2,i)?E2[i](r,i,n):yI(r,'unknown document directive \"'+i+'\"')}if(zr(r,!0,-1),r.lineIndent===0&&r.input.charCodeAt(r.position)===45&&r.input.charCodeAt(r.position+1)===45&&r.input.charCodeAt(r.position+2)===45?(r.position+=3,zr(r,!0,-1)):s&&ft(r,\"directives end mark is expected\"),Kg(r,r.lineIndent-1,II,!1,!0),zr(r,!0,-1),r.checkLineBreaks&&Ape.test(r.input.slice(e,r.position))&&yI(r,\"non-ASCII line breaks are interpreted as content\"),r.documents.push(r.result),r.position===r.lineStart&&wI(r)){r.input.charCodeAt(r.position)===46&&(r.position+=3,zr(r,!0,-1));return}if(r.position\"u\"&&(t=e,e=null);var i=k2(r,t);if(typeof e!=\"function\")return i;for(var n=0,s=i.length;n\"u\"&&(t=e,e=null),R2(r,e,Ba.extend({schema:B2},t))}function Spe(r,e){return F2(r,Ba.extend({schema:B2},e))}Zp.exports.loadAll=R2;Zp.exports.load=F2;Zp.exports.safeLoadAll=Qpe;Zp.exports.safeLoad=Spe});var iH=w(($Ze,_S)=>{\"use strict\";var $p=tc(),ed=Ng(),vpe=Xp(),xpe=Lg(),G2=Object.prototype.toString,Y2=Object.prototype.hasOwnProperty,Ppe=9,_p=10,Dpe=13,kpe=32,Rpe=33,Fpe=34,j2=35,Npe=37,Tpe=38,Lpe=39,Ope=42,q2=44,Mpe=45,J2=58,Kpe=61,Upe=62,Hpe=63,Gpe=64,W2=91,z2=93,Ype=96,V2=123,jpe=124,X2=125,Ni={};Ni[0]=\"\\\\0\";Ni[7]=\"\\\\a\";Ni[8]=\"\\\\b\";Ni[9]=\"\\\\t\";Ni[10]=\"\\\\n\";Ni[11]=\"\\\\v\";Ni[12]=\"\\\\f\";Ni[13]=\"\\\\r\";Ni[27]=\"\\\\e\";Ni[34]='\\\\\"';Ni[92]=\"\\\\\\\\\";Ni[133]=\"\\\\N\";Ni[160]=\"\\\\_\";Ni[8232]=\"\\\\L\";Ni[8233]=\"\\\\P\";var qpe=[\"y\",\"Y\",\"yes\",\"Yes\",\"YES\",\"on\",\"On\",\"ON\",\"n\",\"N\",\"no\",\"No\",\"NO\",\"off\",\"Off\",\"OFF\"];function Jpe(r,e){var t,i,n,s,o,a,l;if(e===null)return{};for(t={},i=Object.keys(e),n=0,s=i.length;n0?r.charCodeAt(s-1):null,f=f&&O2(o,a)}else{for(s=0;si&&r[g+1]!==\" \",g=s);else if(!Ug(o))return BI;a=s>0?r.charCodeAt(s-1):null,f=f&&O2(o,a)}c=c||u&&s-g-1>i&&r[g+1]!==\" \"}return!l&&!c?f&&!n(r)?_2:$2:t>9&&Z2(r)?BI:c?tH:eH}function _pe(r,e,t,i){r.dump=function(){if(e.length===0)return\"''\";if(!r.noCompatMode&&qpe.indexOf(e)!==-1)return\"'\"+e+\"'\";var n=r.indent*Math.max(1,t),s=r.lineWidth===-1?-1:Math.max(Math.min(r.lineWidth,40),r.lineWidth-n),o=i||r.flowLevel>-1&&t>=r.flowLevel;function a(l){return zpe(r,l)}switch(Zpe(e,o,r.indent,s,a)){case _2:return e;case $2:return\"'\"+e.replace(/'/g,\"''\")+\"'\";case eH:return\"|\"+M2(e,r.indent)+K2(L2(e,n));case tH:return\">\"+M2(e,r.indent)+K2(L2($pe(e,s),n));case BI:return'\"'+ede(e,s)+'\"';default:throw new ed(\"impossible error: invalid scalar style\")}}()}function M2(r,e){var t=Z2(r)?String(e):\"\",i=r[r.length-1]===`\n`,n=i&&(r[r.length-2]===`\n`||r===`\n`),s=n?\"+\":i?\"\":\"-\";return t+s+`\n`}function K2(r){return r[r.length-1]===`\n`?r.slice(0,-1):r}function $pe(r,e){for(var t=/(\\n+)([^\\n]*)/g,i=function(){var c=r.indexOf(`\n`);return c=c!==-1?c:r.length,t.lastIndex=c,U2(r.slice(0,c),e)}(),n=r[0]===`\n`||r[0]===\" \",s,o;o=t.exec(r);){var a=o[1],l=o[2];s=l[0]===\" \",i+=a+(!n&&!s&&l!==\"\"?`\n`:\"\")+U2(l,e),n=s}return i}function U2(r,e){if(r===\"\"||r[0]===\" \")return r;for(var t=/ [^ ]/g,i,n=0,s,o=0,a=0,l=\"\";i=t.exec(r);)a=i.index,a-n>e&&(s=o>n?o:a,l+=`\n`+r.slice(n,s),n=s+1),o=a;return l+=`\n`,r.length-n>e&&o>n?l+=r.slice(n,o)+`\n`+r.slice(o+1):l+=r.slice(n),l.slice(1)}function ede(r){for(var e=\"\",t,i,n,s=0;s=55296&&t<=56319&&(i=r.charCodeAt(s+1),i>=56320&&i<=57343)){e+=T2((t-55296)*1024+i-56320+65536),s++;continue}n=Ni[t],e+=!n&&Ug(t)?r[s]:n||T2(t)}return e}function tde(r,e,t){var i=\"\",n=r.tag,s,o;for(s=0,o=t.length;s1024&&(u+=\"? \"),u+=r.dump+(r.condenseFlow?'\"':\"\")+\":\"+(r.condenseFlow?\"\":\" \"),oc(r,e,c,!1,!1)&&(u+=r.dump,i+=u));r.tag=n,r.dump=\"{\"+i+\"}\"}function nde(r,e,t,i){var n=\"\",s=r.tag,o=Object.keys(t),a,l,c,u,g,f;if(r.sortKeys===!0)o.sort();else if(typeof r.sortKeys==\"function\")o.sort(r.sortKeys);else if(r.sortKeys)throw new ed(\"sortKeys must be a boolean or a function\");for(a=0,l=o.length;a1024,g&&(r.dump&&_p===r.dump.charCodeAt(0)?f+=\"?\":f+=\"? \"),f+=r.dump,g&&(f+=VS(r,e)),oc(r,e+1,u,!0,g)&&(r.dump&&_p===r.dump.charCodeAt(0)?f+=\":\":f+=\": \",f+=r.dump,n+=f));r.tag=s,r.dump=n||\"{}\"}function H2(r,e,t){var i,n,s,o,a,l;for(n=t?r.explicitTypes:r.implicitTypes,s=0,o=n.length;s tag resolver accepts not \"'+l+'\" style');r.dump=i}return!0}return!1}function oc(r,e,t,i,n,s){r.tag=null,r.dump=t,H2(r,t,!1)||H2(r,t,!0);var o=G2.call(r.dump);i&&(i=r.flowLevel<0||r.flowLevel>e);var a=o===\"[object Object]\"||o===\"[object Array]\",l,c;if(a&&(l=r.duplicates.indexOf(t),c=l!==-1),(r.tag!==null&&r.tag!==\"?\"||c||r.indent!==2&&e>0)&&(n=!1),c&&r.usedDuplicates[l])r.dump=\"*ref_\"+l;else{if(a&&c&&!r.usedDuplicates[l]&&(r.usedDuplicates[l]=!0),o===\"[object Object]\")i&&Object.keys(r.dump).length!==0?(nde(r,e,r.dump,n),c&&(r.dump=\"&ref_\"+l+r.dump)):(ide(r,e,r.dump),c&&(r.dump=\"&ref_\"+l+\" \"+r.dump));else if(o===\"[object Array]\"){var u=r.noArrayIndent&&e>0?e-1:e;i&&r.dump.length!==0?(rde(r,u,r.dump,n),c&&(r.dump=\"&ref_\"+l+r.dump)):(tde(r,u,r.dump),c&&(r.dump=\"&ref_\"+l+\" \"+r.dump))}else if(o===\"[object String]\")r.tag!==\"?\"&&_pe(r,r.dump,e,s);else{if(r.skipInvalid)return!1;throw new ed(\"unacceptable kind of an object to dump \"+o)}r.tag!==null&&r.tag!==\"?\"&&(r.dump=\"!<\"+r.tag+\"> \"+r.dump)}return!0}function sde(r,e){var t=[],i=[],n,s;for(XS(r,t,i),n=0,s=i.length;n{\"use strict\";var bI=N2(),nH=iH();function QI(r){return function(){throw new Error(\"Function \"+r+\" is deprecated and cannot be used.\")}}Fr.exports.Type=si();Fr.exports.Schema=rc();Fr.exports.FAILSAFE_SCHEMA=CI();Fr.exports.JSON_SCHEMA=YS();Fr.exports.CORE_SCHEMA=jS();Fr.exports.DEFAULT_SAFE_SCHEMA=Lg();Fr.exports.DEFAULT_FULL_SCHEMA=Xp();Fr.exports.load=bI.load;Fr.exports.loadAll=bI.loadAll;Fr.exports.safeLoad=bI.safeLoad;Fr.exports.safeLoadAll=bI.safeLoadAll;Fr.exports.dump=nH.dump;Fr.exports.safeDump=nH.safeDump;Fr.exports.YAMLException=Ng();Fr.exports.MINIMAL_SCHEMA=CI();Fr.exports.SAFE_SCHEMA=Lg();Fr.exports.DEFAULT_SCHEMA=Xp();Fr.exports.scan=QI(\"scan\");Fr.exports.parse=QI(\"parse\");Fr.exports.compose=QI(\"compose\");Fr.exports.addConstructor=QI(\"addConstructor\")});var aH=w((t_e,oH)=>{\"use strict\";var ade=sH();oH.exports=ade});var lH=w((r_e,AH)=>{\"use strict\";function Ade(r,e){function t(){this.constructor=r}t.prototype=e.prototype,r.prototype=new t}function ac(r,e,t,i){this.message=r,this.expected=e,this.found=t,this.location=i,this.name=\"SyntaxError\",typeof Error.captureStackTrace==\"function\"&&Error.captureStackTrace(this,ac)}Ade(ac,Error);ac.buildMessage=function(r,e){var t={literal:function(c){return'\"'+n(c.text)+'\"'},class:function(c){var u=\"\",g;for(g=0;g0){for(g=1,f=1;g({[Ke]:Ce})))},H=function(R){return R},j=function(R){return R},$=Us(\"correct indentation\"),V=\" \",W=ar(\" \",!1),_=function(R){return R.length===bA*yg},A=function(R){return R.length===(bA+1)*yg},Ae=function(){return bA++,!0},ge=function(){return bA--,!0},re=function(){return pg()},O=Us(\"pseudostring\"),F=/^[^\\r\\n\\t ?:,\\][{}#&*!|>'\"%@`\\-]/,ue=Tn([\"\\r\",`\n`,\"\t\",\" \",\"?\",\":\",\",\",\"]\",\"[\",\"{\",\"}\",\"#\",\"&\",\"*\",\"!\",\"|\",\">\",\"'\",'\"',\"%\",\"@\",\"`\",\"-\"],!0,!1),pe=/^[^\\r\\n\\t ,\\][{}:#\"']/,ke=Tn([\"\\r\",`\n`,\"\t\",\" \",\",\",\"]\",\"[\",\"{\",\"}\",\":\",\"#\",'\"',\"'\"],!0,!1),Fe=function(){return pg().replace(/^ *| *$/g,\"\")},Ne=\"--\",oe=ar(\"--\",!1),le=/^[a-zA-Z\\/0-9]/,Be=Tn([[\"a\",\"z\"],[\"A\",\"Z\"],\"/\",[\"0\",\"9\"]],!1,!1),fe=/^[^\\r\\n\\t :,]/,ae=Tn([\"\\r\",`\n`,\"\t\",\" \",\":\",\",\"],!0,!1),qe=\"null\",ne=ar(\"null\",!1),Y=function(){return null},he=\"true\",ie=ar(\"true\",!1),de=function(){return!0},_e=\"false\",Pt=ar(\"false\",!1),It=function(){return!1},Or=Us(\"string\"),ii='\"',gi=ar('\"',!1),hr=function(){return\"\"},fi=function(R){return R},ni=function(R){return R.join(\"\")},Ks=/^[^\"\\\\\\0-\\x1F\\x7F]/,pr=Tn(['\"',\"\\\\\",[\"\\0\",\"\u001f\"],\"\\x7F\"],!0,!1),Ii='\\\\\"',rs=ar('\\\\\"',!1),fa=function(){return'\"'},dA=\"\\\\\\\\\",cg=ar(\"\\\\\\\\\",!1),is=function(){return\"\\\\\"},CA=\"\\\\/\",ha=ar(\"\\\\/\",!1),wp=function(){return\"/\"},mA=\"\\\\b\",EA=ar(\"\\\\b\",!1),wr=function(){return\"\\b\"},Tl=\"\\\\f\",ug=ar(\"\\\\f\",!1),yo=function(){return\"\\f\"},gg=\"\\\\n\",Bp=ar(\"\\\\n\",!1),bp=function(){return`\n`},vr=\"\\\\r\",se=ar(\"\\\\r\",!1),wo=function(){return\"\\r\"},Fn=\"\\\\t\",fg=ar(\"\\\\t\",!1),bt=function(){return\"\t\"},Ll=\"\\\\u\",Nn=ar(\"\\\\u\",!1),ns=function(R,q,Ce,Ke){return String.fromCharCode(parseInt(`0x${R}${q}${Ce}${Ke}`))},ss=/^[0-9a-fA-F]/,gt=Tn([[\"0\",\"9\"],[\"a\",\"f\"],[\"A\",\"F\"]],!1,!1),Bo=Us(\"blank space\"),At=/^[ \\t]/,ln=Tn([\" \",\"\t\"],!1,!1),S=Us(\"white space\"),Lt=/^[ \\t\\n\\r]/,hg=Tn([\" \",\"\t\",`\n`,\"\\r\"],!1,!1),Ol=`\\r\n`,Qp=ar(`\\r\n`,!1),Sp=`\n`,vp=ar(`\n`,!1),xp=\"\\r\",Pp=ar(\"\\r\",!1),G=0,yt=0,IA=[{line:1,column:1}],zi=0,Ml=[],Xe=0,pa;if(\"startRule\"in e){if(!(e.startRule in i))throw new Error(`Can't start parsing from rule \"`+e.startRule+'\".');n=i[e.startRule]}function pg(){return r.substring(yt,G)}function OE(){return cn(yt,G)}function Dp(R,q){throw q=q!==void 0?q:cn(yt,G),Ul([Us(R)],r.substring(yt,G),q)}function ME(R,q){throw q=q!==void 0?q:cn(yt,G),dg(R,q)}function ar(R,q){return{type:\"literal\",text:R,ignoreCase:q}}function Tn(R,q,Ce){return{type:\"class\",parts:R,inverted:q,ignoreCase:Ce}}function Kl(){return{type:\"any\"}}function kp(){return{type:\"end\"}}function Us(R){return{type:\"other\",description:R}}function da(R){var q=IA[R],Ce;if(q)return q;for(Ce=R-1;!IA[Ce];)Ce--;for(q=IA[Ce],q={line:q.line,column:q.column};Cezi&&(zi=G,Ml=[]),Ml.push(R))}function dg(R,q){return new ac(R,null,null,q)}function Ul(R,q,Ce){return new ac(ac.buildMessage(R,q),R,q,Ce)}function Hs(){var R;return R=Cg(),R}function Hl(){var R,q,Ce;for(R=G,q=[],Ce=yA();Ce!==t;)q.push(Ce),Ce=yA();return q!==t&&(yt=R,q=s(q)),R=q,R}function yA(){var R,q,Ce,Ke,Re;return R=G,q=ma(),q!==t?(r.charCodeAt(G)===45?(Ce=o,G++):(Ce=t,Xe===0&&Le(a)),Ce!==t?(Ke=Rr(),Ke!==t?(Re=Ca(),Re!==t?(yt=R,q=l(Re),R=q):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t),R}function Cg(){var R,q,Ce;for(R=G,q=[],Ce=mg();Ce!==t;)q.push(Ce),Ce=mg();return q!==t&&(yt=R,q=c(q)),R=q,R}function mg(){var R,q,Ce,Ke,Re,ze,dt,Ft,Ln;if(R=G,q=Rr(),q===t&&(q=null),q!==t){if(Ce=G,r.charCodeAt(G)===35?(Ke=u,G++):(Ke=t,Xe===0&&Le(g)),Ke!==t){if(Re=[],ze=G,dt=G,Xe++,Ft=js(),Xe--,Ft===t?dt=void 0:(G=dt,dt=t),dt!==t?(r.length>G?(Ft=r.charAt(G),G++):(Ft=t,Xe===0&&Le(f)),Ft!==t?(dt=[dt,Ft],ze=dt):(G=ze,ze=t)):(G=ze,ze=t),ze!==t)for(;ze!==t;)Re.push(ze),ze=G,dt=G,Xe++,Ft=js(),Xe--,Ft===t?dt=void 0:(G=dt,dt=t),dt!==t?(r.length>G?(Ft=r.charAt(G),G++):(Ft=t,Xe===0&&Le(f)),Ft!==t?(dt=[dt,Ft],ze=dt):(G=ze,ze=t)):(G=ze,ze=t);else Re=t;Re!==t?(Ke=[Ke,Re],Ce=Ke):(G=Ce,Ce=t)}else G=Ce,Ce=t;if(Ce===t&&(Ce=null),Ce!==t){if(Ke=[],Re=Ys(),Re!==t)for(;Re!==t;)Ke.push(Re),Re=Ys();else Ke=t;Ke!==t?(yt=R,q=h(),R=q):(G=R,R=t)}else G=R,R=t}else G=R,R=t;if(R===t&&(R=G,q=ma(),q!==t?(Ce=Gl(),Ce!==t?(Ke=Rr(),Ke===t&&(Ke=null),Ke!==t?(r.charCodeAt(G)===58?(Re=p,G++):(Re=t,Xe===0&&Le(C)),Re!==t?(ze=Rr(),ze===t&&(ze=null),ze!==t?(dt=Ca(),dt!==t?(yt=R,q=y(Ce,dt),R=q):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t),R===t&&(R=G,q=ma(),q!==t?(Ce=Gs(),Ce!==t?(Ke=Rr(),Ke===t&&(Ke=null),Ke!==t?(r.charCodeAt(G)===58?(Re=p,G++):(Re=t,Xe===0&&Le(C)),Re!==t?(ze=Rr(),ze===t&&(ze=null),ze!==t?(dt=Ca(),dt!==t?(yt=R,q=y(Ce,dt),R=q):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t),R===t))){if(R=G,q=ma(),q!==t)if(Ce=Gs(),Ce!==t)if(Ke=Rr(),Ke!==t)if(Re=KE(),Re!==t){if(ze=[],dt=Ys(),dt!==t)for(;dt!==t;)ze.push(dt),dt=Ys();else ze=t;ze!==t?(yt=R,q=y(Ce,Re),R=q):(G=R,R=t)}else G=R,R=t;else G=R,R=t;else G=R,R=t;else G=R,R=t;if(R===t)if(R=G,q=ma(),q!==t)if(Ce=Gs(),Ce!==t){if(Ke=[],Re=G,ze=Rr(),ze===t&&(ze=null),ze!==t?(r.charCodeAt(G)===44?(dt=B,G++):(dt=t,Xe===0&&Le(v)),dt!==t?(Ft=Rr(),Ft===t&&(Ft=null),Ft!==t?(Ln=Gs(),Ln!==t?(yt=Re,ze=D(Ce,Ln),Re=ze):(G=Re,Re=t)):(G=Re,Re=t)):(G=Re,Re=t)):(G=Re,Re=t),Re!==t)for(;Re!==t;)Ke.push(Re),Re=G,ze=Rr(),ze===t&&(ze=null),ze!==t?(r.charCodeAt(G)===44?(dt=B,G++):(dt=t,Xe===0&&Le(v)),dt!==t?(Ft=Rr(),Ft===t&&(Ft=null),Ft!==t?(Ln=Gs(),Ln!==t?(yt=Re,ze=D(Ce,Ln),Re=ze):(G=Re,Re=t)):(G=Re,Re=t)):(G=Re,Re=t)):(G=Re,Re=t);else Ke=t;Ke!==t?(Re=Rr(),Re===t&&(Re=null),Re!==t?(r.charCodeAt(G)===58?(ze=p,G++):(ze=t,Xe===0&&Le(C)),ze!==t?(dt=Rr(),dt===t&&(dt=null),dt!==t?(Ft=Ca(),Ft!==t?(yt=R,q=T(Ce,Ke,Ft),R=q):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)}else G=R,R=t;else G=R,R=t}return R}function Ca(){var R,q,Ce,Ke,Re,ze,dt;if(R=G,q=G,Xe++,Ce=G,Ke=js(),Ke!==t?(Re=rt(),Re!==t?(r.charCodeAt(G)===45?(ze=o,G++):(ze=t,Xe===0&&Le(a)),ze!==t?(dt=Rr(),dt!==t?(Ke=[Ke,Re,ze,dt],Ce=Ke):(G=Ce,Ce=t)):(G=Ce,Ce=t)):(G=Ce,Ce=t)):(G=Ce,Ce=t),Xe--,Ce!==t?(G=q,q=void 0):q=t,q!==t?(Ce=Ys(),Ce!==t?(Ke=bo(),Ke!==t?(Re=Hl(),Re!==t?(ze=wA(),ze!==t?(yt=R,q=H(Re),R=q):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t),R===t&&(R=G,q=js(),q!==t?(Ce=bo(),Ce!==t?(Ke=Cg(),Ke!==t?(Re=wA(),Re!==t?(yt=R,q=H(Ke),R=q):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t),R===t))if(R=G,q=Yl(),q!==t){if(Ce=[],Ke=Ys(),Ke!==t)for(;Ke!==t;)Ce.push(Ke),Ke=Ys();else Ce=t;Ce!==t?(yt=R,q=j(q),R=q):(G=R,R=t)}else G=R,R=t;return R}function ma(){var R,q,Ce;for(Xe++,R=G,q=[],r.charCodeAt(G)===32?(Ce=V,G++):(Ce=t,Xe===0&&Le(W));Ce!==t;)q.push(Ce),r.charCodeAt(G)===32?(Ce=V,G++):(Ce=t,Xe===0&&Le(W));return q!==t?(yt=G,Ce=_(q),Ce?Ce=void 0:Ce=t,Ce!==t?(q=[q,Ce],R=q):(G=R,R=t)):(G=R,R=t),Xe--,R===t&&(q=t,Xe===0&&Le($)),R}function rt(){var R,q,Ce;for(R=G,q=[],r.charCodeAt(G)===32?(Ce=V,G++):(Ce=t,Xe===0&&Le(W));Ce!==t;)q.push(Ce),r.charCodeAt(G)===32?(Ce=V,G++):(Ce=t,Xe===0&&Le(W));return q!==t?(yt=G,Ce=A(q),Ce?Ce=void 0:Ce=t,Ce!==t?(q=[q,Ce],R=q):(G=R,R=t)):(G=R,R=t),R}function bo(){var R;return yt=G,R=Ae(),R?R=void 0:R=t,R}function wA(){var R;return yt=G,R=ge(),R?R=void 0:R=t,R}function Gl(){var R;return R=jl(),R===t&&(R=Rp()),R}function Gs(){var R,q,Ce;if(R=jl(),R===t){if(R=G,q=[],Ce=Eg(),Ce!==t)for(;Ce!==t;)q.push(Ce),Ce=Eg();else q=t;q!==t&&(yt=R,q=re()),R=q}return R}function Yl(){var R;return R=Fp(),R===t&&(R=UE(),R===t&&(R=jl(),R===t&&(R=Rp()))),R}function KE(){var R;return R=Fp(),R===t&&(R=jl(),R===t&&(R=Eg())),R}function Rp(){var R,q,Ce,Ke,Re,ze;if(Xe++,R=G,F.test(r.charAt(G))?(q=r.charAt(G),G++):(q=t,Xe===0&&Le(ue)),q!==t){for(Ce=[],Ke=G,Re=Rr(),Re===t&&(Re=null),Re!==t?(pe.test(r.charAt(G))?(ze=r.charAt(G),G++):(ze=t,Xe===0&&Le(ke)),ze!==t?(Re=[Re,ze],Ke=Re):(G=Ke,Ke=t)):(G=Ke,Ke=t);Ke!==t;)Ce.push(Ke),Ke=G,Re=Rr(),Re===t&&(Re=null),Re!==t?(pe.test(r.charAt(G))?(ze=r.charAt(G),G++):(ze=t,Xe===0&&Le(ke)),ze!==t?(Re=[Re,ze],Ke=Re):(G=Ke,Ke=t)):(G=Ke,Ke=t);Ce!==t?(yt=R,q=Fe(),R=q):(G=R,R=t)}else G=R,R=t;return Xe--,R===t&&(q=t,Xe===0&&Le(O)),R}function Eg(){var R,q,Ce,Ke,Re;if(R=G,r.substr(G,2)===Ne?(q=Ne,G+=2):(q=t,Xe===0&&Le(oe)),q===t&&(q=null),q!==t)if(le.test(r.charAt(G))?(Ce=r.charAt(G),G++):(Ce=t,Xe===0&&Le(Be)),Ce!==t){for(Ke=[],fe.test(r.charAt(G))?(Re=r.charAt(G),G++):(Re=t,Xe===0&&Le(ae));Re!==t;)Ke.push(Re),fe.test(r.charAt(G))?(Re=r.charAt(G),G++):(Re=t,Xe===0&&Le(ae));Ke!==t?(yt=R,q=Fe(),R=q):(G=R,R=t)}else G=R,R=t;else G=R,R=t;return R}function Fp(){var R,q;return R=G,r.substr(G,4)===qe?(q=qe,G+=4):(q=t,Xe===0&&Le(ne)),q!==t&&(yt=R,q=Y()),R=q,R}function UE(){var R,q;return R=G,r.substr(G,4)===he?(q=he,G+=4):(q=t,Xe===0&&Le(ie)),q!==t&&(yt=R,q=de()),R=q,R===t&&(R=G,r.substr(G,5)===_e?(q=_e,G+=5):(q=t,Xe===0&&Le(Pt)),q!==t&&(yt=R,q=It()),R=q),R}function jl(){var R,q,Ce,Ke;return Xe++,R=G,r.charCodeAt(G)===34?(q=ii,G++):(q=t,Xe===0&&Le(gi)),q!==t?(r.charCodeAt(G)===34?(Ce=ii,G++):(Ce=t,Xe===0&&Le(gi)),Ce!==t?(yt=R,q=hr(),R=q):(G=R,R=t)):(G=R,R=t),R===t&&(R=G,r.charCodeAt(G)===34?(q=ii,G++):(q=t,Xe===0&&Le(gi)),q!==t?(Ce=HE(),Ce!==t?(r.charCodeAt(G)===34?(Ke=ii,G++):(Ke=t,Xe===0&&Le(gi)),Ke!==t?(yt=R,q=fi(Ce),R=q):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)),Xe--,R===t&&(q=t,Xe===0&&Le(Or)),R}function HE(){var R,q,Ce;if(R=G,q=[],Ce=Ig(),Ce!==t)for(;Ce!==t;)q.push(Ce),Ce=Ig();else q=t;return q!==t&&(yt=R,q=ni(q)),R=q,R}function Ig(){var R,q,Ce,Ke,Re,ze;return Ks.test(r.charAt(G))?(R=r.charAt(G),G++):(R=t,Xe===0&&Le(pr)),R===t&&(R=G,r.substr(G,2)===Ii?(q=Ii,G+=2):(q=t,Xe===0&&Le(rs)),q!==t&&(yt=R,q=fa()),R=q,R===t&&(R=G,r.substr(G,2)===dA?(q=dA,G+=2):(q=t,Xe===0&&Le(cg)),q!==t&&(yt=R,q=is()),R=q,R===t&&(R=G,r.substr(G,2)===CA?(q=CA,G+=2):(q=t,Xe===0&&Le(ha)),q!==t&&(yt=R,q=wp()),R=q,R===t&&(R=G,r.substr(G,2)===mA?(q=mA,G+=2):(q=t,Xe===0&&Le(EA)),q!==t&&(yt=R,q=wr()),R=q,R===t&&(R=G,r.substr(G,2)===Tl?(q=Tl,G+=2):(q=t,Xe===0&&Le(ug)),q!==t&&(yt=R,q=yo()),R=q,R===t&&(R=G,r.substr(G,2)===gg?(q=gg,G+=2):(q=t,Xe===0&&Le(Bp)),q!==t&&(yt=R,q=bp()),R=q,R===t&&(R=G,r.substr(G,2)===vr?(q=vr,G+=2):(q=t,Xe===0&&Le(se)),q!==t&&(yt=R,q=wo()),R=q,R===t&&(R=G,r.substr(G,2)===Fn?(q=Fn,G+=2):(q=t,Xe===0&&Le(fg)),q!==t&&(yt=R,q=bt()),R=q,R===t&&(R=G,r.substr(G,2)===Ll?(q=Ll,G+=2):(q=t,Xe===0&&Le(Nn)),q!==t?(Ce=BA(),Ce!==t?(Ke=BA(),Ke!==t?(Re=BA(),Re!==t?(ze=BA(),ze!==t?(yt=R,q=ns(Ce,Ke,Re,ze),R=q):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)):(G=R,R=t)))))))))),R}function BA(){var R;return ss.test(r.charAt(G))?(R=r.charAt(G),G++):(R=t,Xe===0&&Le(gt)),R}function Rr(){var R,q;if(Xe++,R=[],At.test(r.charAt(G))?(q=r.charAt(G),G++):(q=t,Xe===0&&Le(ln)),q!==t)for(;q!==t;)R.push(q),At.test(r.charAt(G))?(q=r.charAt(G),G++):(q=t,Xe===0&&Le(ln));else R=t;return Xe--,R===t&&(q=t,Xe===0&&Le(Bo)),R}function GE(){var R,q;if(Xe++,R=[],Lt.test(r.charAt(G))?(q=r.charAt(G),G++):(q=t,Xe===0&&Le(hg)),q!==t)for(;q!==t;)R.push(q),Lt.test(r.charAt(G))?(q=r.charAt(G),G++):(q=t,Xe===0&&Le(hg));else R=t;return Xe--,R===t&&(q=t,Xe===0&&Le(S)),R}function Ys(){var R,q,Ce,Ke,Re,ze;if(R=G,q=js(),q!==t){for(Ce=[],Ke=G,Re=Rr(),Re===t&&(Re=null),Re!==t?(ze=js(),ze!==t?(Re=[Re,ze],Ke=Re):(G=Ke,Ke=t)):(G=Ke,Ke=t);Ke!==t;)Ce.push(Ke),Ke=G,Re=Rr(),Re===t&&(Re=null),Re!==t?(ze=js(),ze!==t?(Re=[Re,ze],Ke=Re):(G=Ke,Ke=t)):(G=Ke,Ke=t);Ce!==t?(q=[q,Ce],R=q):(G=R,R=t)}else G=R,R=t;return R}function js(){var R;return r.substr(G,2)===Ol?(R=Ol,G+=2):(R=t,Xe===0&&Le(Qp)),R===t&&(r.charCodeAt(G)===10?(R=Sp,G++):(R=t,Xe===0&&Le(vp)),R===t&&(r.charCodeAt(G)===13?(R=xp,G++):(R=t,Xe===0&&Le(Pp)))),R}let yg=2,bA=0;if(pa=n(),pa!==t&&G===r.length)return pa;throw pa!==t&&G{\"use strict\";var hde=r=>{let e=!1,t=!1,i=!1;for(let n=0;n{if(!(typeof r==\"string\"||Array.isArray(r)))throw new TypeError(\"Expected the input to be `string | string[]`\");e=Object.assign({pascalCase:!1},e);let t=n=>e.pascalCase?n.charAt(0).toUpperCase()+n.slice(1):n;return Array.isArray(r)?r=r.map(n=>n.trim()).filter(n=>n.length).join(\"-\"):r=r.trim(),r.length===0?\"\":r.length===1?e.pascalCase?r.toUpperCase():r.toLowerCase():(r!==r.toLowerCase()&&(r=hde(r)),r=r.replace(/^[_.\\- ]+/,\"\").toLowerCase().replace(/[_.\\- ]+(\\w|$)/g,(n,s)=>s.toUpperCase()).replace(/\\d+(\\w|$)/g,n=>n.toUpperCase()),t(r))};ev.exports=hH;ev.exports.default=hH});var dH=w((A_e,pde)=>{pde.exports=[{name:\"AppVeyor\",constant:\"APPVEYOR\",env:\"APPVEYOR\",pr:\"APPVEYOR_PULL_REQUEST_NUMBER\"},{name:\"Azure Pipelines\",constant:\"AZURE_PIPELINES\",env:\"SYSTEM_TEAMFOUNDATIONCOLLECTIONURI\",pr:\"SYSTEM_PULLREQUEST_PULLREQUESTID\"},{name:\"Appcircle\",constant:\"APPCIRCLE\",env:\"AC_APPCIRCLE\"},{name:\"Bamboo\",constant:\"BAMBOO\",env:\"bamboo_planKey\"},{name:\"Bitbucket Pipelines\",constant:\"BITBUCKET\",env:\"BITBUCKET_COMMIT\",pr:\"BITBUCKET_PR_ID\"},{name:\"Bitrise\",constant:\"BITRISE\",env:\"BITRISE_IO\",pr:\"BITRISE_PULL_REQUEST\"},{name:\"Buddy\",constant:\"BUDDY\",env:\"BUDDY_WORKSPACE_ID\",pr:\"BUDDY_EXECUTION_PULL_REQUEST_ID\"},{name:\"Buildkite\",constant:\"BUILDKITE\",env:\"BUILDKITE\",pr:{env:\"BUILDKITE_PULL_REQUEST\",ne:\"false\"}},{name:\"CircleCI\",constant:\"CIRCLE\",env:\"CIRCLECI\",pr:\"CIRCLE_PULL_REQUEST\"},{name:\"Cirrus CI\",constant:\"CIRRUS\",env:\"CIRRUS_CI\",pr:\"CIRRUS_PR\"},{name:\"AWS CodeBuild\",constant:\"CODEBUILD\",env:\"CODEBUILD_BUILD_ARN\"},{name:\"Codefresh\",constant:\"CODEFRESH\",env:\"CF_BUILD_ID\",pr:{any:[\"CF_PULL_REQUEST_NUMBER\",\"CF_PULL_REQUEST_ID\"]}},{name:\"Codeship\",constant:\"CODESHIP\",env:{CI_NAME:\"codeship\"}},{name:\"Drone\",constant:\"DRONE\",env:\"DRONE\",pr:{DRONE_BUILD_EVENT:\"pull_request\"}},{name:\"dsari\",constant:\"DSARI\",env:\"DSARI\"},{name:\"GitHub Actions\",constant:\"GITHUB_ACTIONS\",env:\"GITHUB_ACTIONS\",pr:{GITHUB_EVENT_NAME:\"pull_request\"}},{name:\"GitLab CI\",constant:\"GITLAB\",env:\"GITLAB_CI\",pr:\"CI_MERGE_REQUEST_ID\"},{name:\"GoCD\",constant:\"GOCD\",env:\"GO_PIPELINE_LABEL\"},{name:\"LayerCI\",constant:\"LAYERCI\",env:\"LAYERCI\",pr:\"LAYERCI_PULL_REQUEST\"},{name:\"Hudson\",constant:\"HUDSON\",env:\"HUDSON_URL\"},{name:\"Jenkins\",constant:\"JENKINS\",env:[\"JENKINS_URL\",\"BUILD_ID\"],pr:{any:[\"ghprbPullId\",\"CHANGE_ID\"]}},{name:\"Magnum CI\",constant:\"MAGNUM\",env:\"MAGNUM\"},{name:\"Netlify CI\",constant:\"NETLIFY\",env:\"NETLIFY\",pr:{env:\"PULL_REQUEST\",ne:\"false\"}},{name:\"Nevercode\",constant:\"NEVERCODE\",env:\"NEVERCODE\",pr:{env:\"NEVERCODE_PULL_REQUEST\",ne:\"false\"}},{name:\"Render\",constant:\"RENDER\",env:\"RENDER\",pr:{IS_PULL_REQUEST:\"true\"}},{name:\"Sail CI\",constant:\"SAIL\",env:\"SAILCI\",pr:\"SAIL_PULL_REQUEST_NUMBER\"},{name:\"Semaphore\",constant:\"SEMAPHORE\",env:\"SEMAPHORE\",pr:\"PULL_REQUEST_NUMBER\"},{name:\"Screwdriver\",constant:\"SCREWDRIVER\",env:\"SCREWDRIVER\",pr:{env:\"SD_PULL_REQUEST\",ne:\"false\"}},{name:\"Shippable\",constant:\"SHIPPABLE\",env:\"SHIPPABLE\",pr:{IS_PULL_REQUEST:\"true\"}},{name:\"Solano CI\",constant:\"SOLANO\",env:\"TDDIUM\",pr:\"TDDIUM_PR_ID\"},{name:\"Strider CD\",constant:\"STRIDER\",env:\"STRIDER\"},{name:\"TaskCluster\",constant:\"TASKCLUSTER\",env:[\"TASK_ID\",\"RUN_ID\"]},{name:\"TeamCity\",constant:\"TEAMCITY\",env:\"TEAMCITY_VERSION\"},{name:\"Travis CI\",constant:\"TRAVIS\",env:\"TRAVIS\",pr:{env:\"TRAVIS_PULL_REQUEST\",ne:\"false\"}},{name:\"Vercel\",constant:\"VERCEL\",env:\"NOW_BUILDER\"},{name:\"Visual Studio App Center\",constant:\"APPCENTER\",env:\"APPCENTER_BUILD_ID\"}]});var Ac=w(Un=>{\"use strict\";var mH=dH(),Po=process.env;Object.defineProperty(Un,\"_vendors\",{value:mH.map(function(r){return r.constant})});Un.name=null;Un.isPR=null;mH.forEach(function(r){let t=(Array.isArray(r.env)?r.env:[r.env]).every(function(i){return CH(i)});if(Un[r.constant]=t,t)switch(Un.name=r.name,typeof r.pr){case\"string\":Un.isPR=!!Po[r.pr];break;case\"object\":\"env\"in r.pr?Un.isPR=r.pr.env in Po&&Po[r.pr.env]!==r.pr.ne:\"any\"in r.pr?Un.isPR=r.pr.any.some(function(i){return!!Po[i]}):Un.isPR=CH(r.pr);break;default:Un.isPR=null}});Un.isCI=!!(Po.CI||Po.CONTINUOUS_INTEGRATION||Po.BUILD_NUMBER||Po.RUN_ID||Un.name);function CH(r){return typeof r==\"string\"?!!Po[r]:Object.keys(r).every(function(e){return Po[e]===r[e]})}});var hn={};ut(hn,{KeyRelationship:()=>lc,applyCascade:()=>od,base64RegExp:()=>BH,colorStringAlphaRegExp:()=>wH,colorStringRegExp:()=>yH,computeKey:()=>RA,getPrintable:()=>Vr,hasExactLength:()=>xH,hasForbiddenKeys:()=>Wde,hasKeyRelationship:()=>av,hasMaxLength:()=>Dde,hasMinLength:()=>Pde,hasMutuallyExclusiveKeys:()=>zde,hasRequiredKeys:()=>Jde,hasUniqueItems:()=>kde,isArray:()=>yde,isAtLeast:()=>Nde,isAtMost:()=>Tde,isBase64:()=>jde,isBoolean:()=>mde,isDate:()=>Ide,isDict:()=>Bde,isEnum:()=>Zi,isHexColor:()=>Yde,isISO8601:()=>Gde,isInExclusiveRange:()=>Ode,isInInclusiveRange:()=>Lde,isInstanceOf:()=>Qde,isInteger:()=>Mde,isJSON:()=>qde,isLiteral:()=>dde,isLowerCase:()=>Kde,isNegative:()=>Rde,isNullable:()=>xde,isNumber:()=>Ede,isObject:()=>bde,isOneOf:()=>Sde,isOptional:()=>vde,isPositive:()=>Fde,isString:()=>sd,isTuple:()=>wde,isUUID4:()=>Hde,isUnknown:()=>vH,isUpperCase:()=>Ude,iso8601RegExp:()=>ov,makeCoercionFn:()=>cc,makeSetter:()=>SH,makeTrait:()=>QH,makeValidator:()=>Qt,matchesRegExp:()=>ad,plural:()=>kI,pushError:()=>pt,simpleKeyRegExp:()=>IH,uuid4RegExp:()=>bH});function Qt({test:r}){return QH(r)()}function Vr(r){return r===null?\"null\":r===void 0?\"undefined\":r===\"\"?\"an empty string\":JSON.stringify(r)}function RA(r,e){var t,i,n;return typeof e==\"number\"?`${(t=r==null?void 0:r.p)!==null&&t!==void 0?t:\".\"}[${e}]`:IH.test(e)?`${(i=r==null?void 0:r.p)!==null&&i!==void 0?i:\"\"}.${e}`:`${(n=r==null?void 0:r.p)!==null&&n!==void 0?n:\".\"}[${JSON.stringify(e)}]`}function cc(r,e){return t=>{let i=r[e];return r[e]=t,cc(r,e).bind(null,i)}}function SH(r,e){return t=>{r[e]=t}}function kI(r,e,t){return r===1?e:t}function pt({errors:r,p:e}={},t){return r==null||r.push(`${e!=null?e:\".\"}: ${t}`),!1}function dde(r){return Qt({test:(e,t)=>e!==r?pt(t,`Expected a literal (got ${Vr(r)})`):!0})}function Zi(r){let e=Array.isArray(r)?r:Object.values(r),t=new Set(e);return Qt({test:(i,n)=>t.has(i)?!0:pt(n,`Expected a valid enumeration value (got ${Vr(i)})`)})}var IH,yH,wH,BH,bH,ov,QH,vH,sd,Cde,mde,Ede,Ide,yde,wde,Bde,bde,Qde,Sde,od,vde,xde,Pde,Dde,xH,kde,Rde,Fde,Nde,Tde,Lde,Ode,Mde,ad,Kde,Ude,Hde,Gde,Yde,jde,qde,Jde,Wde,zde,lc,Vde,av,ls=Tge(()=>{IH=/^[a-zA-Z_][a-zA-Z0-9_]*$/,yH=/^#[0-9a-f]{6}$/i,wH=/^#[0-9a-f]{6}([0-9a-f]{2})?$/i,BH=/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/,bH=/^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89aAbB][a-f0-9]{3}-[a-f0-9]{12}$/i,ov=/^(?:[1-9]\\d{3}(-?)(?:(?:0[1-9]|1[0-2])\\1(?:0[1-9]|1\\d|2[0-8])|(?:0[13-9]|1[0-2])\\1(?:29|30)|(?:0[13578]|1[02])(?:\\1)31|00[1-9]|0[1-9]\\d|[12]\\d{2}|3(?:[0-5]\\d|6[0-5]))|(?:[1-9]\\d(?:0[48]|[2468][048]|[13579][26])|(?:[2468][048]|[13579][26])00)(?:(-?)02(?:\\2)29|-?366))T(?:[01]\\d|2[0-3])(:?)[0-5]\\d(?:\\3[0-5]\\d)?(?:Z|[+-][01]\\d(?:\\3[0-5]\\d)?)$/,QH=r=>()=>r;vH=()=>Qt({test:(r,e)=>!0});sd=()=>Qt({test:(r,e)=>typeof r!=\"string\"?pt(e,`Expected a string (got ${Vr(r)})`):!0});Cde=new Map([[\"true\",!0],[\"True\",!0],[\"1\",!0],[1,!0],[\"false\",!1],[\"False\",!1],[\"0\",!1],[0,!1]]),mde=()=>Qt({test:(r,e)=>{var t;if(typeof r!=\"boolean\"){if(typeof(e==null?void 0:e.coercions)<\"u\"){if(typeof(e==null?void 0:e.coercion)>\"u\")return pt(e,\"Unbound coercion result\");let i=Cde.get(r);if(typeof i<\"u\")return e.coercions.push([(t=e.p)!==null&&t!==void 0?t:\".\",e.coercion.bind(null,i)]),!0}return pt(e,`Expected a boolean (got ${Vr(r)})`)}return!0}}),Ede=()=>Qt({test:(r,e)=>{var t;if(typeof r!=\"number\"){if(typeof(e==null?void 0:e.coercions)<\"u\"){if(typeof(e==null?void 0:e.coercion)>\"u\")return pt(e,\"Unbound coercion result\");let i;if(typeof r==\"string\"){let n;try{n=JSON.parse(r)}catch{}if(typeof n==\"number\")if(JSON.stringify(n)===r)i=n;else return pt(e,`Received a number that can't be safely represented by the runtime (${r})`)}if(typeof i<\"u\")return e.coercions.push([(t=e.p)!==null&&t!==void 0?t:\".\",e.coercion.bind(null,i)]),!0}return pt(e,`Expected a number (got ${Vr(r)})`)}return!0}}),Ide=()=>Qt({test:(r,e)=>{var t;if(!(r instanceof Date)){if(typeof(e==null?void 0:e.coercions)<\"u\"){if(typeof(e==null?void 0:e.coercion)>\"u\")return pt(e,\"Unbound coercion result\");let i;if(typeof r==\"string\"&&ov.test(r))i=new Date(r);else{let n;if(typeof r==\"string\"){let s;try{s=JSON.parse(r)}catch{}typeof s==\"number\"&&(n=s)}else typeof r==\"number\"&&(n=r);if(typeof n<\"u\")if(Number.isSafeInteger(n)||!Number.isSafeInteger(n*1e3))i=new Date(n*1e3);else return pt(e,`Received a timestamp that can't be safely represented by the runtime (${r})`)}if(typeof i<\"u\")return e.coercions.push([(t=e.p)!==null&&t!==void 0?t:\".\",e.coercion.bind(null,i)]),!0}return pt(e,`Expected a date (got ${Vr(r)})`)}return!0}}),yde=(r,{delimiter:e}={})=>Qt({test:(t,i)=>{var n;if(typeof t==\"string\"&&typeof e<\"u\"&&typeof(i==null?void 0:i.coercions)<\"u\"){if(typeof(i==null?void 0:i.coercion)>\"u\")return pt(i,\"Unbound coercion result\");t=t.split(e),i.coercions.push([(n=i.p)!==null&&n!==void 0?n:\".\",i.coercion.bind(null,t)])}if(!Array.isArray(t))return pt(i,`Expected an array (got ${Vr(t)})`);let s=!0;for(let o=0,a=t.length;o{let t=xH(r.length);return Qt({test:(i,n)=>{var s;if(typeof i==\"string\"&&typeof e<\"u\"&&typeof(n==null?void 0:n.coercions)<\"u\"){if(typeof(n==null?void 0:n.coercion)>\"u\")return pt(n,\"Unbound coercion result\");i=i.split(e),n.coercions.push([(s=n.p)!==null&&s!==void 0?s:\".\",n.coercion.bind(null,i)])}if(!Array.isArray(i))return pt(n,`Expected a tuple (got ${Vr(i)})`);let o=t(i,Object.assign({},n));for(let a=0,l=i.length;aQt({test:(t,i)=>{if(typeof t!=\"object\"||t===null)return pt(i,`Expected an object (got ${Vr(t)})`);let n=Object.keys(t),s=!0;for(let o=0,a=n.length;o{let t=Object.keys(r);return Qt({test:(i,n)=>{if(typeof i!=\"object\"||i===null)return pt(n,`Expected an object (got ${Vr(i)})`);let s=new Set([...t,...Object.keys(i)]),o={},a=!0;for(let l of s){if(l===\"constructor\"||l===\"__proto__\")a=pt(Object.assign(Object.assign({},n),{p:RA(n,l)}),\"Unsafe property name\");else{let c=Object.prototype.hasOwnProperty.call(r,l)?r[l]:void 0,u=Object.prototype.hasOwnProperty.call(i,l)?i[l]:void 0;typeof c<\"u\"?a=c(u,Object.assign(Object.assign({},n),{p:RA(n,l),coercion:cc(i,l)}))&&a:e===null?a=pt(Object.assign(Object.assign({},n),{p:RA(n,l)}),`Extraneous property (got ${Vr(u)})`):Object.defineProperty(o,l,{enumerable:!0,get:()=>u,set:SH(i,l)})}if(!a&&(n==null?void 0:n.errors)==null)break}return e!==null&&(a||(n==null?void 0:n.errors)!=null)&&(a=e(o,n)&&a),a}})},Qde=r=>Qt({test:(e,t)=>e instanceof r?!0:pt(t,`Expected an instance of ${r.name} (got ${Vr(e)})`)}),Sde=(r,{exclusive:e=!1}={})=>Qt({test:(t,i)=>{var n,s,o;let a=[],l=typeof(i==null?void 0:i.errors)<\"u\"?[]:void 0;for(let c=0,u=r.length;c1?pt(i,`Expected to match exactly a single predicate (matched ${a.join(\", \")})`):(o=i==null?void 0:i.errors)===null||o===void 0||o.push(...l),!1}}),od=(r,e)=>Qt({test:(t,i)=>{var n,s;let o={value:t},a=typeof(i==null?void 0:i.coercions)<\"u\"?cc(o,\"value\"):void 0,l=typeof(i==null?void 0:i.coercions)<\"u\"?[]:void 0;if(!r(t,Object.assign(Object.assign({},i),{coercion:a,coercions:l})))return!1;let c=[];if(typeof l<\"u\")for(let[,u]of l)c.push(u());try{if(typeof(i==null?void 0:i.coercions)<\"u\"){if(o.value!==t){if(typeof(i==null?void 0:i.coercion)>\"u\")return pt(i,\"Unbound coercion result\");i.coercions.push([(n=i.p)!==null&&n!==void 0?n:\".\",i.coercion.bind(null,o.value)])}(s=i==null?void 0:i.coercions)===null||s===void 0||s.push(...l)}return e.every(u=>u(o.value,i))}finally{for(let u of c)u()}}}),vde=r=>Qt({test:(e,t)=>typeof e>\"u\"?!0:r(e,t)}),xde=r=>Qt({test:(e,t)=>e===null?!0:r(e,t)}),Pde=r=>Qt({test:(e,t)=>e.length>=r?!0:pt(t,`Expected to have a length of at least ${r} elements (got ${e.length})`)}),Dde=r=>Qt({test:(e,t)=>e.length<=r?!0:pt(t,`Expected to have a length of at most ${r} elements (got ${e.length})`)}),xH=r=>Qt({test:(e,t)=>e.length!==r?pt(t,`Expected to have a length of exactly ${r} elements (got ${e.length})`):!0}),kde=({map:r}={})=>Qt({test:(e,t)=>{let i=new Set,n=new Set;for(let s=0,o=e.length;sQt({test:(r,e)=>r<=0?!0:pt(e,`Expected to be negative (got ${r})`)}),Fde=()=>Qt({test:(r,e)=>r>=0?!0:pt(e,`Expected to be positive (got ${r})`)}),Nde=r=>Qt({test:(e,t)=>e>=r?!0:pt(t,`Expected to be at least ${r} (got ${e})`)}),Tde=r=>Qt({test:(e,t)=>e<=r?!0:pt(t,`Expected to be at most ${r} (got ${e})`)}),Lde=(r,e)=>Qt({test:(t,i)=>t>=r&&t<=e?!0:pt(i,`Expected to be in the [${r}; ${e}] range (got ${t})`)}),Ode=(r,e)=>Qt({test:(t,i)=>t>=r&&tQt({test:(e,t)=>e!==Math.round(e)?pt(t,`Expected to be an integer (got ${e})`):Number.isSafeInteger(e)?!0:pt(t,`Expected to be a safe integer (got ${e})`)}),ad=r=>Qt({test:(e,t)=>r.test(e)?!0:pt(t,`Expected to match the pattern ${r.toString()} (got ${Vr(e)})`)}),Kde=()=>Qt({test:(r,e)=>r!==r.toLowerCase()?pt(e,`Expected to be all-lowercase (got ${r})`):!0}),Ude=()=>Qt({test:(r,e)=>r!==r.toUpperCase()?pt(e,`Expected to be all-uppercase (got ${r})`):!0}),Hde=()=>Qt({test:(r,e)=>bH.test(r)?!0:pt(e,`Expected to be a valid UUID v4 (got ${Vr(r)})`)}),Gde=()=>Qt({test:(r,e)=>ov.test(r)?!1:pt(e,`Expected to be a valid ISO 8601 date string (got ${Vr(r)})`)}),Yde=({alpha:r=!1})=>Qt({test:(e,t)=>(r?yH.test(e):wH.test(e))?!0:pt(t,`Expected to be a valid hexadecimal color string (got ${Vr(e)})`)}),jde=()=>Qt({test:(r,e)=>BH.test(r)?!0:pt(e,`Expected to be a valid base 64 string (got ${Vr(r)})`)}),qde=(r=vH())=>Qt({test:(e,t)=>{let i;try{i=JSON.parse(e)}catch{return pt(t,`Expected to be a valid JSON string (got ${Vr(e)})`)}return r(i,t)}}),Jde=r=>{let e=new Set(r);return Qt({test:(t,i)=>{let n=new Set(Object.keys(t)),s=[];for(let o of e)n.has(o)||s.push(o);return s.length>0?pt(i,`Missing required ${kI(s.length,\"property\",\"properties\")} ${s.map(o=>`\"${o}\"`).join(\", \")}`):!0}})},Wde=r=>{let e=new Set(r);return Qt({test:(t,i)=>{let n=new Set(Object.keys(t)),s=[];for(let o of e)n.has(o)&&s.push(o);return s.length>0?pt(i,`Forbidden ${kI(s.length,\"property\",\"properties\")} ${s.map(o=>`\"${o}\"`).join(\", \")}`):!0}})},zde=r=>{let e=new Set(r);return Qt({test:(t,i)=>{let n=new Set(Object.keys(t)),s=[];for(let o of e)n.has(o)&&s.push(o);return s.length>1?pt(i,`Mutually exclusive properties ${s.map(o=>`\"${o}\"`).join(\", \")}`):!0}})};(function(r){r.Forbids=\"Forbids\",r.Requires=\"Requires\"})(lc||(lc={}));Vde={[lc.Forbids]:{expect:!1,message:\"forbids using\"},[lc.Requires]:{expect:!0,message:\"requires using\"}},av=(r,e,t,{ignore:i=[]}={})=>{let n=new Set(i),s=new Set(t),o=Vde[e];return Qt({test:(a,l)=>{let c=new Set(Object.keys(a));if(!c.has(r)||n.has(a[r]))return!0;let u=[];for(let g of s)(c.has(g)&&!n.has(a[g]))!==o.expect&&u.push(g);return u.length>=1?pt(l,`Property \"${r}\" ${o.message} ${kI(u.length,\"property\",\"properties\")} ${u.map(g=>`\"${g}\"`).join(\", \")}`):!0}})}});var qH=w((A$e,jH)=>{\"use strict\";jH.exports=(r,...e)=>new Promise(t=>{t(r(...e))})});var Jg=w((l$e,pv)=>{\"use strict\";var gCe=qH(),JH=r=>{if(r<1)throw new TypeError(\"Expected `concurrency` to be a number from 1 and up\");let e=[],t=0,i=()=>{t--,e.length>0&&e.shift()()},n=(a,l,...c)=>{t++;let u=gCe(a,...c);l(u),u.then(i,i)},s=(a,l,...c)=>{tnew Promise(c=>s(a,c,...l));return Object.defineProperties(o,{activeCount:{get:()=>t},pendingCount:{get:()=>e.length}}),o};pv.exports=JH;pv.exports.default=JH});var gd=w((u$e,WH)=>{var fCe=\"2.0.0\",hCe=Number.MAX_SAFE_INTEGER||9007199254740991,pCe=16;WH.exports={SEMVER_SPEC_VERSION:fCe,MAX_LENGTH:256,MAX_SAFE_INTEGER:hCe,MAX_SAFE_COMPONENT_LENGTH:pCe}});var fd=w((g$e,zH)=>{var dCe=typeof process==\"object\"&&process.env&&process.env.NODE_DEBUG&&/\\bsemver\\b/i.test(process.env.NODE_DEBUG)?(...r)=>console.error(\"SEMVER\",...r):()=>{};zH.exports=dCe});var uc=w((NA,VH)=>{var{MAX_SAFE_COMPONENT_LENGTH:dv}=gd(),CCe=fd();NA=VH.exports={};var mCe=NA.re=[],et=NA.src=[],tt=NA.t={},ECe=0,St=(r,e,t)=>{let i=ECe++;CCe(i,e),tt[r]=i,et[i]=e,mCe[i]=new RegExp(e,t?\"g\":void 0)};St(\"NUMERICIDENTIFIER\",\"0|[1-9]\\\\d*\");St(\"NUMERICIDENTIFIERLOOSE\",\"[0-9]+\");St(\"NONNUMERICIDENTIFIER\",\"\\\\d*[a-zA-Z-][a-zA-Z0-9-]*\");St(\"MAINVERSION\",`(${et[tt.NUMERICIDENTIFIER]})\\\\.(${et[tt.NUMERICIDENTIFIER]})\\\\.(${et[tt.NUMERICIDENTIFIER]})`);St(\"MAINVERSIONLOOSE\",`(${et[tt.NUMERICIDENTIFIERLOOSE]})\\\\.(${et[tt.NUMERICIDENTIFIERLOOSE]})\\\\.(${et[tt.NUMERICIDENTIFIERLOOSE]})`);St(\"PRERELEASEIDENTIFIER\",`(?:${et[tt.NUMERICIDENTIFIER]}|${et[tt.NONNUMERICIDENTIFIER]})`);St(\"PRERELEASEIDENTIFIERLOOSE\",`(?:${et[tt.NUMERICIDENTIFIERLOOSE]}|${et[tt.NONNUMERICIDENTIFIER]})`);St(\"PRERELEASE\",`(?:-(${et[tt.PRERELEASEIDENTIFIER]}(?:\\\\.${et[tt.PRERELEASEIDENTIFIER]})*))`);St(\"PRERELEASELOOSE\",`(?:-?(${et[tt.PRERELEASEIDENTIFIERLOOSE]}(?:\\\\.${et[tt.PRERELEASEIDENTIFIERLOOSE]})*))`);St(\"BUILDIDENTIFIER\",\"[0-9A-Za-z-]+\");St(\"BUILD\",`(?:\\\\+(${et[tt.BUILDIDENTIFIER]}(?:\\\\.${et[tt.BUILDIDENTIFIER]})*))`);St(\"FULLPLAIN\",`v?${et[tt.MAINVERSION]}${et[tt.PRERELEASE]}?${et[tt.BUILD]}?`);St(\"FULL\",`^${et[tt.FULLPLAIN]}$`);St(\"LOOSEPLAIN\",`[v=\\\\s]*${et[tt.MAINVERSIONLOOSE]}${et[tt.PRERELEASELOOSE]}?${et[tt.BUILD]}?`);St(\"LOOSE\",`^${et[tt.LOOSEPLAIN]}$`);St(\"GTLT\",\"((?:<|>)?=?)\");St(\"XRANGEIDENTIFIERLOOSE\",`${et[tt.NUMERICIDENTIFIERLOOSE]}|x|X|\\\\*`);St(\"XRANGEIDENTIFIER\",`${et[tt.NUMERICIDENTIFIER]}|x|X|\\\\*`);St(\"XRANGEPLAIN\",`[v=\\\\s]*(${et[tt.XRANGEIDENTIFIER]})(?:\\\\.(${et[tt.XRANGEIDENTIFIER]})(?:\\\\.(${et[tt.XRANGEIDENTIFIER]})(?:${et[tt.PRERELEASE]})?${et[tt.BUILD]}?)?)?`);St(\"XRANGEPLAINLOOSE\",`[v=\\\\s]*(${et[tt.XRANGEIDENTIFIERLOOSE]})(?:\\\\.(${et[tt.XRANGEIDENTIFIERLOOSE]})(?:\\\\.(${et[tt.XRANGEIDENTIFIERLOOSE]})(?:${et[tt.PRERELEASELOOSE]})?${et[tt.BUILD]}?)?)?`);St(\"XRANGE\",`^${et[tt.GTLT]}\\\\s*${et[tt.XRANGEPLAIN]}$`);St(\"XRANGELOOSE\",`^${et[tt.GTLT]}\\\\s*${et[tt.XRANGEPLAINLOOSE]}$`);St(\"COERCE\",`(^|[^\\\\d])(\\\\d{1,${dv}})(?:\\\\.(\\\\d{1,${dv}}))?(?:\\\\.(\\\\d{1,${dv}}))?(?:$|[^\\\\d])`);St(\"COERCERTL\",et[tt.COERCE],!0);St(\"LONETILDE\",\"(?:~>?)\");St(\"TILDETRIM\",`(\\\\s*)${et[tt.LONETILDE]}\\\\s+`,!0);NA.tildeTrimReplace=\"$1~\";St(\"TILDE\",`^${et[tt.LONETILDE]}${et[tt.XRANGEPLAIN]}$`);St(\"TILDELOOSE\",`^${et[tt.LONETILDE]}${et[tt.XRANGEPLAINLOOSE]}$`);St(\"LONECARET\",\"(?:\\\\^)\");St(\"CARETTRIM\",`(\\\\s*)${et[tt.LONECARET]}\\\\s+`,!0);NA.caretTrimReplace=\"$1^\";St(\"CARET\",`^${et[tt.LONECARET]}${et[tt.XRANGEPLAIN]}$`);St(\"CARETLOOSE\",`^${et[tt.LONECARET]}${et[tt.XRANGEPLAINLOOSE]}$`);St(\"COMPARATORLOOSE\",`^${et[tt.GTLT]}\\\\s*(${et[tt.LOOSEPLAIN]})$|^$`);St(\"COMPARATOR\",`^${et[tt.GTLT]}\\\\s*(${et[tt.FULLPLAIN]})$|^$`);St(\"COMPARATORTRIM\",`(\\\\s*)${et[tt.GTLT]}\\\\s*(${et[tt.LOOSEPLAIN]}|${et[tt.XRANGEPLAIN]})`,!0);NA.comparatorTrimReplace=\"$1$2$3\";St(\"HYPHENRANGE\",`^\\\\s*(${et[tt.XRANGEPLAIN]})\\\\s+-\\\\s+(${et[tt.XRANGEPLAIN]})\\\\s*$`);St(\"HYPHENRANGELOOSE\",`^\\\\s*(${et[tt.XRANGEPLAINLOOSE]})\\\\s+-\\\\s+(${et[tt.XRANGEPLAINLOOSE]})\\\\s*$`);St(\"STAR\",\"(<|>)?=?\\\\s*\\\\*\");St(\"GTE0\",\"^\\\\s*>=\\\\s*0.0.0\\\\s*$\");St(\"GTE0PRE\",\"^\\\\s*>=\\\\s*0.0.0-0\\\\s*$\")});var hd=w((f$e,XH)=>{var ICe=[\"includePrerelease\",\"loose\",\"rtl\"],yCe=r=>r?typeof r!=\"object\"?{loose:!0}:ICe.filter(e=>r[e]).reduce((e,t)=>(e[t]=!0,e),{}):{};XH.exports=yCe});var OI=w((h$e,$H)=>{var ZH=/^[0-9]+$/,_H=(r,e)=>{let t=ZH.test(r),i=ZH.test(e);return t&&i&&(r=+r,e=+e),r===e?0:t&&!i?-1:i&&!t?1:r_H(e,r);$H.exports={compareIdentifiers:_H,rcompareIdentifiers:wCe}});var Li=w((p$e,iG)=>{var MI=fd(),{MAX_LENGTH:eG,MAX_SAFE_INTEGER:KI}=gd(),{re:tG,t:rG}=uc(),BCe=hd(),{compareIdentifiers:pd}=OI(),Yn=class{constructor(e,t){if(t=BCe(t),e instanceof Yn){if(e.loose===!!t.loose&&e.includePrerelease===!!t.includePrerelease)return e;e=e.version}else if(typeof e!=\"string\")throw new TypeError(`Invalid Version: ${e}`);if(e.length>eG)throw new TypeError(`version is longer than ${eG} characters`);MI(\"SemVer\",e,t),this.options=t,this.loose=!!t.loose,this.includePrerelease=!!t.includePrerelease;let i=e.trim().match(t.loose?tG[rG.LOOSE]:tG[rG.FULL]);if(!i)throw new TypeError(`Invalid Version: ${e}`);if(this.raw=e,this.major=+i[1],this.minor=+i[2],this.patch=+i[3],this.major>KI||this.major<0)throw new TypeError(\"Invalid major version\");if(this.minor>KI||this.minor<0)throw new TypeError(\"Invalid minor version\");if(this.patch>KI||this.patch<0)throw new TypeError(\"Invalid patch version\");i[4]?this.prerelease=i[4].split(\".\").map(n=>{if(/^[0-9]+$/.test(n)){let s=+n;if(s>=0&&s=0;)typeof this.prerelease[i]==\"number\"&&(this.prerelease[i]++,i=-2);i===-1&&this.prerelease.push(0)}t&&(this.prerelease[0]===t?isNaN(this.prerelease[1])&&(this.prerelease=[t,0]):this.prerelease=[t,0]);break;default:throw new Error(`invalid increment argument: ${e}`)}return this.format(),this.raw=this.version,this}};iG.exports=Yn});var gc=w((d$e,aG)=>{var{MAX_LENGTH:bCe}=gd(),{re:nG,t:sG}=uc(),oG=Li(),QCe=hd(),SCe=(r,e)=>{if(e=QCe(e),r instanceof oG)return r;if(typeof r!=\"string\"||r.length>bCe||!(e.loose?nG[sG.LOOSE]:nG[sG.FULL]).test(r))return null;try{return new oG(r,e)}catch{return null}};aG.exports=SCe});var lG=w((C$e,AG)=>{var vCe=gc(),xCe=(r,e)=>{let t=vCe(r,e);return t?t.version:null};AG.exports=xCe});var uG=w((m$e,cG)=>{var PCe=gc(),DCe=(r,e)=>{let t=PCe(r.trim().replace(/^[=v]+/,\"\"),e);return t?t.version:null};cG.exports=DCe});var fG=w((E$e,gG)=>{var kCe=Li(),RCe=(r,e,t,i)=>{typeof t==\"string\"&&(i=t,t=void 0);try{return new kCe(r,t).inc(e,i).version}catch{return null}};gG.exports=RCe});var cs=w((I$e,pG)=>{var hG=Li(),FCe=(r,e,t)=>new hG(r,t).compare(new hG(e,t));pG.exports=FCe});var UI=w((y$e,dG)=>{var NCe=cs(),TCe=(r,e,t)=>NCe(r,e,t)===0;dG.exports=TCe});var EG=w((w$e,mG)=>{var CG=gc(),LCe=UI(),OCe=(r,e)=>{if(LCe(r,e))return null;{let t=CG(r),i=CG(e),n=t.prerelease.length||i.prerelease.length,s=n?\"pre\":\"\",o=n?\"prerelease\":\"\";for(let a in t)if((a===\"major\"||a===\"minor\"||a===\"patch\")&&t[a]!==i[a])return s+a;return o}};mG.exports=OCe});var yG=w((B$e,IG)=>{var MCe=Li(),KCe=(r,e)=>new MCe(r,e).major;IG.exports=KCe});var BG=w((b$e,wG)=>{var UCe=Li(),HCe=(r,e)=>new UCe(r,e).minor;wG.exports=HCe});var QG=w((Q$e,bG)=>{var GCe=Li(),YCe=(r,e)=>new GCe(r,e).patch;bG.exports=YCe});var vG=w((S$e,SG)=>{var jCe=gc(),qCe=(r,e)=>{let t=jCe(r,e);return t&&t.prerelease.length?t.prerelease:null};SG.exports=qCe});var PG=w((v$e,xG)=>{var JCe=cs(),WCe=(r,e,t)=>JCe(e,r,t);xG.exports=WCe});var kG=w((x$e,DG)=>{var zCe=cs(),VCe=(r,e)=>zCe(r,e,!0);DG.exports=VCe});var HI=w((P$e,FG)=>{var RG=Li(),XCe=(r,e,t)=>{let i=new RG(r,t),n=new RG(e,t);return i.compare(n)||i.compareBuild(n)};FG.exports=XCe});var TG=w((D$e,NG)=>{var ZCe=HI(),_Ce=(r,e)=>r.sort((t,i)=>ZCe(t,i,e));NG.exports=_Ce});var OG=w((k$e,LG)=>{var $Ce=HI(),eme=(r,e)=>r.sort((t,i)=>$Ce(i,t,e));LG.exports=eme});var dd=w((R$e,MG)=>{var tme=cs(),rme=(r,e,t)=>tme(r,e,t)>0;MG.exports=rme});var GI=w((F$e,KG)=>{var ime=cs(),nme=(r,e,t)=>ime(r,e,t)<0;KG.exports=nme});var Cv=w((N$e,UG)=>{var sme=cs(),ome=(r,e,t)=>sme(r,e,t)!==0;UG.exports=ome});var YI=w((T$e,HG)=>{var ame=cs(),Ame=(r,e,t)=>ame(r,e,t)>=0;HG.exports=Ame});var jI=w((L$e,GG)=>{var lme=cs(),cme=(r,e,t)=>lme(r,e,t)<=0;GG.exports=cme});var mv=w((O$e,YG)=>{var ume=UI(),gme=Cv(),fme=dd(),hme=YI(),pme=GI(),dme=jI(),Cme=(r,e,t,i)=>{switch(e){case\"===\":return typeof r==\"object\"&&(r=r.version),typeof t==\"object\"&&(t=t.version),r===t;case\"!==\":return typeof r==\"object\"&&(r=r.version),typeof t==\"object\"&&(t=t.version),r!==t;case\"\":case\"=\":case\"==\":return ume(r,t,i);case\"!=\":return gme(r,t,i);case\">\":return fme(r,t,i);case\">=\":return hme(r,t,i);case\"<\":return pme(r,t,i);case\"<=\":return dme(r,t,i);default:throw new TypeError(`Invalid operator: ${e}`)}};YG.exports=Cme});var qG=w((M$e,jG)=>{var mme=Li(),Eme=gc(),{re:qI,t:JI}=uc(),Ime=(r,e)=>{if(r instanceof mme)return r;if(typeof r==\"number\"&&(r=String(r)),typeof r!=\"string\")return null;e=e||{};let t=null;if(!e.rtl)t=r.match(qI[JI.COERCE]);else{let i;for(;(i=qI[JI.COERCERTL].exec(r))&&(!t||t.index+t[0].length!==r.length);)(!t||i.index+i[0].length!==t.index+t[0].length)&&(t=i),qI[JI.COERCERTL].lastIndex=i.index+i[1].length+i[2].length;qI[JI.COERCERTL].lastIndex=-1}return t===null?null:Eme(`${t[2]}.${t[3]||\"0\"}.${t[4]||\"0\"}`,e)};jG.exports=Ime});var WG=w((K$e,JG)=>{\"use strict\";JG.exports=function(r){r.prototype[Symbol.iterator]=function*(){for(let e=this.head;e;e=e.next)yield e.value}}});var WI=w((U$e,zG)=>{\"use strict\";zG.exports=Ht;Ht.Node=fc;Ht.create=Ht;function Ht(r){var e=this;if(e instanceof Ht||(e=new Ht),e.tail=null,e.head=null,e.length=0,r&&typeof r.forEach==\"function\")r.forEach(function(n){e.push(n)});else if(arguments.length>0)for(var t=0,i=arguments.length;t1)t=e;else if(this.head)i=this.head.next,t=this.head.value;else throw new TypeError(\"Reduce of empty list with no initial value\");for(var n=0;i!==null;n++)t=r(t,i.value,n),i=i.next;return t};Ht.prototype.reduceReverse=function(r,e){var t,i=this.tail;if(arguments.length>1)t=e;else if(this.tail)i=this.tail.prev,t=this.tail.value;else throw new TypeError(\"Reduce of empty list with no initial value\");for(var n=this.length-1;i!==null;n--)t=r(t,i.value,n),i=i.prev;return t};Ht.prototype.toArray=function(){for(var r=new Array(this.length),e=0,t=this.head;t!==null;e++)r[e]=t.value,t=t.next;return r};Ht.prototype.toArrayReverse=function(){for(var r=new Array(this.length),e=0,t=this.tail;t!==null;e++)r[e]=t.value,t=t.prev;return r};Ht.prototype.slice=function(r,e){e=e||this.length,e<0&&(e+=this.length),r=r||0,r<0&&(r+=this.length);var t=new Ht;if(ethis.length&&(e=this.length);for(var i=0,n=this.head;n!==null&&ithis.length&&(e=this.length);for(var i=this.length,n=this.tail;n!==null&&i>e;i--)n=n.prev;for(;n!==null&&i>r;i--,n=n.prev)t.push(n.value);return t};Ht.prototype.splice=function(r,e,...t){r>this.length&&(r=this.length-1),r<0&&(r=this.length+r);for(var i=0,n=this.head;n!==null&&i{\"use strict\";var bme=WI(),hc=Symbol(\"max\"),va=Symbol(\"length\"),Wg=Symbol(\"lengthCalculator\"),md=Symbol(\"allowStale\"),pc=Symbol(\"maxAge\"),Sa=Symbol(\"dispose\"),VG=Symbol(\"noDisposeOnSet\"),di=Symbol(\"lruList\"),Zs=Symbol(\"cache\"),ZG=Symbol(\"updateAgeOnGet\"),Ev=()=>1,yv=class{constructor(e){if(typeof e==\"number\"&&(e={max:e}),e||(e={}),e.max&&(typeof e.max!=\"number\"||e.max<0))throw new TypeError(\"max must be a non-negative number\");let t=this[hc]=e.max||1/0,i=e.length||Ev;if(this[Wg]=typeof i!=\"function\"?Ev:i,this[md]=e.stale||!1,e.maxAge&&typeof e.maxAge!=\"number\")throw new TypeError(\"maxAge must be a number\");this[pc]=e.maxAge||0,this[Sa]=e.dispose,this[VG]=e.noDisposeOnSet||!1,this[ZG]=e.updateAgeOnGet||!1,this.reset()}set max(e){if(typeof e!=\"number\"||e<0)throw new TypeError(\"max must be a non-negative number\");this[hc]=e||1/0,Cd(this)}get max(){return this[hc]}set allowStale(e){this[md]=!!e}get allowStale(){return this[md]}set maxAge(e){if(typeof e!=\"number\")throw new TypeError(\"maxAge must be a non-negative number\");this[pc]=e,Cd(this)}get maxAge(){return this[pc]}set lengthCalculator(e){typeof e!=\"function\"&&(e=Ev),e!==this[Wg]&&(this[Wg]=e,this[va]=0,this[di].forEach(t=>{t.length=this[Wg](t.value,t.key),this[va]+=t.length})),Cd(this)}get lengthCalculator(){return this[Wg]}get length(){return this[va]}get itemCount(){return this[di].length}rforEach(e,t){t=t||this;for(let i=this[di].tail;i!==null;){let n=i.prev;XG(this,e,i,t),i=n}}forEach(e,t){t=t||this;for(let i=this[di].head;i!==null;){let n=i.next;XG(this,e,i,t),i=n}}keys(){return this[di].toArray().map(e=>e.key)}values(){return this[di].toArray().map(e=>e.value)}reset(){this[Sa]&&this[di]&&this[di].length&&this[di].forEach(e=>this[Sa](e.key,e.value)),this[Zs]=new Map,this[di]=new bme,this[va]=0}dump(){return this[di].map(e=>zI(this,e)?!1:{k:e.key,v:e.value,e:e.now+(e.maxAge||0)}).toArray().filter(e=>e)}dumpLru(){return this[di]}set(e,t,i){if(i=i||this[pc],i&&typeof i!=\"number\")throw new TypeError(\"maxAge must be a number\");let n=i?Date.now():0,s=this[Wg](t,e);if(this[Zs].has(e)){if(s>this[hc])return zg(this,this[Zs].get(e)),!1;let l=this[Zs].get(e).value;return this[Sa]&&(this[VG]||this[Sa](e,l.value)),l.now=n,l.maxAge=i,l.value=t,this[va]+=s-l.length,l.length=s,this.get(e),Cd(this),!0}let o=new wv(e,t,s,n,i);return o.length>this[hc]?(this[Sa]&&this[Sa](e,t),!1):(this[va]+=o.length,this[di].unshift(o),this[Zs].set(e,this[di].head),Cd(this),!0)}has(e){if(!this[Zs].has(e))return!1;let t=this[Zs].get(e).value;return!zI(this,t)}get(e){return Iv(this,e,!0)}peek(e){return Iv(this,e,!1)}pop(){let e=this[di].tail;return e?(zg(this,e),e.value):null}del(e){zg(this,this[Zs].get(e))}load(e){this.reset();let t=Date.now();for(let i=e.length-1;i>=0;i--){let n=e[i],s=n.e||0;if(s===0)this.set(n.k,n.v);else{let o=s-t;o>0&&this.set(n.k,n.v,o)}}}prune(){this[Zs].forEach((e,t)=>Iv(this,t,!1))}},Iv=(r,e,t)=>{let i=r[Zs].get(e);if(i){let n=i.value;if(zI(r,n)){if(zg(r,i),!r[md])return}else t&&(r[ZG]&&(i.value.now=Date.now()),r[di].unshiftNode(i));return n.value}},zI=(r,e)=>{if(!e||!e.maxAge&&!r[pc])return!1;let t=Date.now()-e.now;return e.maxAge?t>e.maxAge:r[pc]&&t>r[pc]},Cd=r=>{if(r[va]>r[hc])for(let e=r[di].tail;r[va]>r[hc]&&e!==null;){let t=e.prev;zg(r,e),e=t}},zg=(r,e)=>{if(e){let t=e.value;r[Sa]&&r[Sa](t.key,t.value),r[va]-=t.length,r[Zs].delete(t.key),r[di].removeNode(e)}},wv=class{constructor(e,t,i,n,s){this.key=e,this.value=t,this.length=i,this.now=n,this.maxAge=s||0}},XG=(r,e,t,i)=>{let n=t.value;zI(r,n)&&(zg(r,t),r[md]||(n=void 0)),n&&e.call(i,n.value,n.key,r)};_G.exports=yv});var us=w((G$e,iY)=>{var dc=class{constructor(e,t){if(t=Sme(t),e instanceof dc)return e.loose===!!t.loose&&e.includePrerelease===!!t.includePrerelease?e:new dc(e.raw,t);if(e instanceof Bv)return this.raw=e.value,this.set=[[e]],this.format(),this;if(this.options=t,this.loose=!!t.loose,this.includePrerelease=!!t.includePrerelease,this.raw=e,this.set=e.split(/\\s*\\|\\|\\s*/).map(i=>this.parseRange(i.trim())).filter(i=>i.length),!this.set.length)throw new TypeError(`Invalid SemVer Range: ${e}`);if(this.set.length>1){let i=this.set[0];if(this.set=this.set.filter(n=>!tY(n[0])),this.set.length===0)this.set=[i];else if(this.set.length>1){for(let n of this.set)if(n.length===1&&kme(n[0])){this.set=[n];break}}}this.format()}format(){return this.range=this.set.map(e=>e.join(\" \").trim()).join(\"||\").trim(),this.range}toString(){return this.range}parseRange(e){e=e.trim();let i=`parseRange:${Object.keys(this.options).join(\",\")}:${e}`,n=eY.get(i);if(n)return n;let s=this.options.loose,o=s?Oi[bi.HYPHENRANGELOOSE]:Oi[bi.HYPHENRANGE];e=e.replace(o,Hme(this.options.includePrerelease)),Hr(\"hyphen replace\",e),e=e.replace(Oi[bi.COMPARATORTRIM],xme),Hr(\"comparator trim\",e,Oi[bi.COMPARATORTRIM]),e=e.replace(Oi[bi.TILDETRIM],Pme),e=e.replace(Oi[bi.CARETTRIM],Dme),e=e.split(/\\s+/).join(\" \");let a=s?Oi[bi.COMPARATORLOOSE]:Oi[bi.COMPARATOR],l=e.split(\" \").map(f=>Rme(f,this.options)).join(\" \").split(/\\s+/).map(f=>Ume(f,this.options)).filter(this.options.loose?f=>!!f.match(a):()=>!0).map(f=>new Bv(f,this.options)),c=l.length,u=new Map;for(let f of l){if(tY(f))return[f];u.set(f.value,f)}u.size>1&&u.has(\"\")&&u.delete(\"\");let g=[...u.values()];return eY.set(i,g),g}intersects(e,t){if(!(e instanceof dc))throw new TypeError(\"a Range is required\");return this.set.some(i=>rY(i,t)&&e.set.some(n=>rY(n,t)&&i.every(s=>n.every(o=>s.intersects(o,t)))))}test(e){if(!e)return!1;if(typeof e==\"string\")try{e=new vme(e,this.options)}catch{return!1}for(let t=0;tr.value===\"<0.0.0-0\",kme=r=>r.value===\"\",rY=(r,e)=>{let t=!0,i=r.slice(),n=i.pop();for(;t&&i.length;)t=i.every(s=>n.intersects(s,e)),n=i.pop();return t},Rme=(r,e)=>(Hr(\"comp\",r,e),r=Tme(r,e),Hr(\"caret\",r),r=Fme(r,e),Hr(\"tildes\",r),r=Ome(r,e),Hr(\"xrange\",r),r=Kme(r,e),Hr(\"stars\",r),r),$i=r=>!r||r.toLowerCase()===\"x\"||r===\"*\",Fme=(r,e)=>r.trim().split(/\\s+/).map(t=>Nme(t,e)).join(\" \"),Nme=(r,e)=>{let t=e.loose?Oi[bi.TILDELOOSE]:Oi[bi.TILDE];return r.replace(t,(i,n,s,o,a)=>{Hr(\"tilde\",r,i,n,s,o,a);let l;return $i(n)?l=\"\":$i(s)?l=`>=${n}.0.0 <${+n+1}.0.0-0`:$i(o)?l=`>=${n}.${s}.0 <${n}.${+s+1}.0-0`:a?(Hr(\"replaceTilde pr\",a),l=`>=${n}.${s}.${o}-${a} <${n}.${+s+1}.0-0`):l=`>=${n}.${s}.${o} <${n}.${+s+1}.0-0`,Hr(\"tilde return\",l),l})},Tme=(r,e)=>r.trim().split(/\\s+/).map(t=>Lme(t,e)).join(\" \"),Lme=(r,e)=>{Hr(\"caret\",r,e);let t=e.loose?Oi[bi.CARETLOOSE]:Oi[bi.CARET],i=e.includePrerelease?\"-0\":\"\";return r.replace(t,(n,s,o,a,l)=>{Hr(\"caret\",r,n,s,o,a,l);let c;return $i(s)?c=\"\":$i(o)?c=`>=${s}.0.0${i} <${+s+1}.0.0-0`:$i(a)?s===\"0\"?c=`>=${s}.${o}.0${i} <${s}.${+o+1}.0-0`:c=`>=${s}.${o}.0${i} <${+s+1}.0.0-0`:l?(Hr(\"replaceCaret pr\",l),s===\"0\"?o===\"0\"?c=`>=${s}.${o}.${a}-${l} <${s}.${o}.${+a+1}-0`:c=`>=${s}.${o}.${a}-${l} <${s}.${+o+1}.0-0`:c=`>=${s}.${o}.${a}-${l} <${+s+1}.0.0-0`):(Hr(\"no pr\"),s===\"0\"?o===\"0\"?c=`>=${s}.${o}.${a}${i} <${s}.${o}.${+a+1}-0`:c=`>=${s}.${o}.${a}${i} <${s}.${+o+1}.0-0`:c=`>=${s}.${o}.${a} <${+s+1}.0.0-0`),Hr(\"caret return\",c),c})},Ome=(r,e)=>(Hr(\"replaceXRanges\",r,e),r.split(/\\s+/).map(t=>Mme(t,e)).join(\" \")),Mme=(r,e)=>{r=r.trim();let t=e.loose?Oi[bi.XRANGELOOSE]:Oi[bi.XRANGE];return r.replace(t,(i,n,s,o,a,l)=>{Hr(\"xRange\",r,i,n,s,o,a,l);let c=$i(s),u=c||$i(o),g=u||$i(a),f=g;return n===\"=\"&&f&&(n=\"\"),l=e.includePrerelease?\"-0\":\"\",c?n===\">\"||n===\"<\"?i=\"<0.0.0-0\":i=\"*\":n&&f?(u&&(o=0),a=0,n===\">\"?(n=\">=\",u?(s=+s+1,o=0,a=0):(o=+o+1,a=0)):n===\"<=\"&&(n=\"<\",u?s=+s+1:o=+o+1),n===\"<\"&&(l=\"-0\"),i=`${n+s}.${o}.${a}${l}`):u?i=`>=${s}.0.0${l} <${+s+1}.0.0-0`:g&&(i=`>=${s}.${o}.0${l} <${s}.${+o+1}.0-0`),Hr(\"xRange return\",i),i})},Kme=(r,e)=>(Hr(\"replaceStars\",r,e),r.trim().replace(Oi[bi.STAR],\"\")),Ume=(r,e)=>(Hr(\"replaceGTE0\",r,e),r.trim().replace(Oi[e.includePrerelease?bi.GTE0PRE:bi.GTE0],\"\")),Hme=r=>(e,t,i,n,s,o,a,l,c,u,g,f,h)=>($i(i)?t=\"\":$i(n)?t=`>=${i}.0.0${r?\"-0\":\"\"}`:$i(s)?t=`>=${i}.${n}.0${r?\"-0\":\"\"}`:o?t=`>=${t}`:t=`>=${t}${r?\"-0\":\"\"}`,$i(c)?l=\"\":$i(u)?l=`<${+c+1}.0.0-0`:$i(g)?l=`<${c}.${+u+1}.0-0`:f?l=`<=${c}.${u}.${g}-${f}`:r?l=`<${c}.${u}.${+g+1}-0`:l=`<=${l}`,`${t} ${l}`.trim()),Gme=(r,e,t)=>{for(let i=0;i0){let n=r[i].semver;if(n.major===e.major&&n.minor===e.minor&&n.patch===e.patch)return!0}return!1}return!0}});var Ed=w((Y$e,AY)=>{var Id=Symbol(\"SemVer ANY\"),Vg=class{static get ANY(){return Id}constructor(e,t){if(t=Yme(t),e instanceof Vg){if(e.loose===!!t.loose)return e;e=e.value}Qv(\"comparator\",e,t),this.options=t,this.loose=!!t.loose,this.parse(e),this.semver===Id?this.value=\"\":this.value=this.operator+this.semver.version,Qv(\"comp\",this)}parse(e){let t=this.options.loose?nY[sY.COMPARATORLOOSE]:nY[sY.COMPARATOR],i=e.match(t);if(!i)throw new TypeError(`Invalid comparator: ${e}`);this.operator=i[1]!==void 0?i[1]:\"\",this.operator===\"=\"&&(this.operator=\"\"),i[2]?this.semver=new oY(i[2],this.options.loose):this.semver=Id}toString(){return this.value}test(e){if(Qv(\"Comparator.test\",e,this.options.loose),this.semver===Id||e===Id)return!0;if(typeof e==\"string\")try{e=new oY(e,this.options)}catch{return!1}return bv(e,this.operator,this.semver,this.options)}intersects(e,t){if(!(e instanceof Vg))throw new TypeError(\"a Comparator is required\");if((!t||typeof t!=\"object\")&&(t={loose:!!t,includePrerelease:!1}),this.operator===\"\")return this.value===\"\"?!0:new aY(e.value,t).test(this.value);if(e.operator===\"\")return e.value===\"\"?!0:new aY(this.value,t).test(e.semver);let i=(this.operator===\">=\"||this.operator===\">\")&&(e.operator===\">=\"||e.operator===\">\"),n=(this.operator===\"<=\"||this.operator===\"<\")&&(e.operator===\"<=\"||e.operator===\"<\"),s=this.semver.version===e.semver.version,o=(this.operator===\">=\"||this.operator===\"<=\")&&(e.operator===\">=\"||e.operator===\"<=\"),a=bv(this.semver,\"<\",e.semver,t)&&(this.operator===\">=\"||this.operator===\">\")&&(e.operator===\"<=\"||e.operator===\"<\"),l=bv(this.semver,\">\",e.semver,t)&&(this.operator===\"<=\"||this.operator===\"<\")&&(e.operator===\">=\"||e.operator===\">\");return i||n||s&&o||a||l}};AY.exports=Vg;var Yme=hd(),{re:nY,t:sY}=uc(),bv=mv(),Qv=fd(),oY=Li(),aY=us()});var yd=w((j$e,lY)=>{var jme=us(),qme=(r,e,t)=>{try{e=new jme(e,t)}catch{return!1}return e.test(r)};lY.exports=qme});var uY=w((q$e,cY)=>{var Jme=us(),Wme=(r,e)=>new Jme(r,e).set.map(t=>t.map(i=>i.value).join(\" \").trim().split(\" \"));cY.exports=Wme});var fY=w((J$e,gY)=>{var zme=Li(),Vme=us(),Xme=(r,e,t)=>{let i=null,n=null,s=null;try{s=new Vme(e,t)}catch{return null}return r.forEach(o=>{s.test(o)&&(!i||n.compare(o)===-1)&&(i=o,n=new zme(i,t))}),i};gY.exports=Xme});var pY=w((W$e,hY)=>{var Zme=Li(),_me=us(),$me=(r,e,t)=>{let i=null,n=null,s=null;try{s=new _me(e,t)}catch{return null}return r.forEach(o=>{s.test(o)&&(!i||n.compare(o)===1)&&(i=o,n=new Zme(i,t))}),i};hY.exports=$me});var mY=w((z$e,CY)=>{var Sv=Li(),eEe=us(),dY=dd(),tEe=(r,e)=>{r=new eEe(r,e);let t=new Sv(\"0.0.0\");if(r.test(t)||(t=new Sv(\"0.0.0-0\"),r.test(t)))return t;t=null;for(let i=0;i{let a=new Sv(o.semver.version);switch(o.operator){case\">\":a.prerelease.length===0?a.patch++:a.prerelease.push(0),a.raw=a.format();case\"\":case\">=\":(!s||dY(a,s))&&(s=a);break;case\"<\":case\"<=\":break;default:throw new Error(`Unexpected operation: ${o.operator}`)}}),s&&(!t||dY(t,s))&&(t=s)}return t&&r.test(t)?t:null};CY.exports=tEe});var IY=w((V$e,EY)=>{var rEe=us(),iEe=(r,e)=>{try{return new rEe(r,e).range||\"*\"}catch{return null}};EY.exports=iEe});var VI=w((X$e,bY)=>{var nEe=Li(),BY=Ed(),{ANY:sEe}=BY,oEe=us(),aEe=yd(),yY=dd(),wY=GI(),AEe=jI(),lEe=YI(),cEe=(r,e,t,i)=>{r=new nEe(r,i),e=new oEe(e,i);let n,s,o,a,l;switch(t){case\">\":n=yY,s=AEe,o=wY,a=\">\",l=\">=\";break;case\"<\":n=wY,s=lEe,o=yY,a=\"<\",l=\"<=\";break;default:throw new TypeError('Must provide a hilo val of \"<\" or \">\"')}if(aEe(r,e,i))return!1;for(let c=0;c{h.semver===sEe&&(h=new BY(\">=0.0.0\")),g=g||h,f=f||h,n(h.semver,g.semver,i)?g=h:o(h.semver,f.semver,i)&&(f=h)}),g.operator===a||g.operator===l||(!f.operator||f.operator===a)&&s(r,f.semver))return!1;if(f.operator===l&&o(r,f.semver))return!1}return!0};bY.exports=cEe});var SY=w((Z$e,QY)=>{var uEe=VI(),gEe=(r,e,t)=>uEe(r,e,\">\",t);QY.exports=gEe});var xY=w((_$e,vY)=>{var fEe=VI(),hEe=(r,e,t)=>fEe(r,e,\"<\",t);vY.exports=hEe});var kY=w(($$e,DY)=>{var PY=us(),pEe=(r,e,t)=>(r=new PY(r,t),e=new PY(e,t),r.intersects(e));DY.exports=pEe});var FY=w((eet,RY)=>{var dEe=yd(),CEe=cs();RY.exports=(r,e,t)=>{let i=[],n=null,s=null,o=r.sort((u,g)=>CEe(u,g,t));for(let u of o)dEe(u,e,t)?(s=u,n||(n=u)):(s&&i.push([n,s]),s=null,n=null);n&&i.push([n,null]);let a=[];for(let[u,g]of i)u===g?a.push(u):!g&&u===o[0]?a.push(\"*\"):g?u===o[0]?a.push(`<=${g}`):a.push(`${u} - ${g}`):a.push(`>=${u}`);let l=a.join(\" || \"),c=typeof e.raw==\"string\"?e.raw:String(e);return l.length{var NY=us(),XI=Ed(),{ANY:vv}=XI,wd=yd(),xv=cs(),mEe=(r,e,t={})=>{if(r===e)return!0;r=new NY(r,t),e=new NY(e,t);let i=!1;e:for(let n of r.set){for(let s of e.set){let o=EEe(n,s,t);if(i=i||o!==null,o)continue e}if(i)return!1}return!0},EEe=(r,e,t)=>{if(r===e)return!0;if(r.length===1&&r[0].semver===vv){if(e.length===1&&e[0].semver===vv)return!0;t.includePrerelease?r=[new XI(\">=0.0.0-0\")]:r=[new XI(\">=0.0.0\")]}if(e.length===1&&e[0].semver===vv){if(t.includePrerelease)return!0;e=[new XI(\">=0.0.0\")]}let i=new Set,n,s;for(let h of r)h.operator===\">\"||h.operator===\">=\"?n=TY(n,h,t):h.operator===\"<\"||h.operator===\"<=\"?s=LY(s,h,t):i.add(h.semver);if(i.size>1)return null;let o;if(n&&s){if(o=xv(n.semver,s.semver,t),o>0)return null;if(o===0&&(n.operator!==\">=\"||s.operator!==\"<=\"))return null}for(let h of i){if(n&&!wd(h,String(n),t)||s&&!wd(h,String(s),t))return null;for(let p of e)if(!wd(h,String(p),t))return!1;return!0}let a,l,c,u,g=s&&!t.includePrerelease&&s.semver.prerelease.length?s.semver:!1,f=n&&!t.includePrerelease&&n.semver.prerelease.length?n.semver:!1;g&&g.prerelease.length===1&&s.operator===\"<\"&&g.prerelease[0]===0&&(g=!1);for(let h of e){if(u=u||h.operator===\">\"||h.operator===\">=\",c=c||h.operator===\"<\"||h.operator===\"<=\",n){if(f&&h.semver.prerelease&&h.semver.prerelease.length&&h.semver.major===f.major&&h.semver.minor===f.minor&&h.semver.patch===f.patch&&(f=!1),h.operator===\">\"||h.operator===\">=\"){if(a=TY(n,h,t),a===h&&a!==n)return!1}else if(n.operator===\">=\"&&!wd(n.semver,String(h),t))return!1}if(s){if(g&&h.semver.prerelease&&h.semver.prerelease.length&&h.semver.major===g.major&&h.semver.minor===g.minor&&h.semver.patch===g.patch&&(g=!1),h.operator===\"<\"||h.operator===\"<=\"){if(l=LY(s,h,t),l===h&&l!==s)return!1}else if(s.operator===\"<=\"&&!wd(s.semver,String(h),t))return!1}if(!h.operator&&(s||n)&&o!==0)return!1}return!(n&&c&&!s&&o!==0||s&&u&&!n&&o!==0||f||g)},TY=(r,e,t)=>{if(!r)return e;let i=xv(r.semver,e.semver,t);return i>0?r:i<0||e.operator===\">\"&&r.operator===\">=\"?e:r},LY=(r,e,t)=>{if(!r)return e;let i=xv(r.semver,e.semver,t);return i<0?r:i>0||e.operator===\"<\"&&r.operator===\"<=\"?e:r};OY.exports=mEe});var Xr=w((ret,KY)=>{var Pv=uc();KY.exports={re:Pv.re,src:Pv.src,tokens:Pv.t,SEMVER_SPEC_VERSION:gd().SEMVER_SPEC_VERSION,SemVer:Li(),compareIdentifiers:OI().compareIdentifiers,rcompareIdentifiers:OI().rcompareIdentifiers,parse:gc(),valid:lG(),clean:uG(),inc:fG(),diff:EG(),major:yG(),minor:BG(),patch:QG(),prerelease:vG(),compare:cs(),rcompare:PG(),compareLoose:kG(),compareBuild:HI(),sort:TG(),rsort:OG(),gt:dd(),lt:GI(),eq:UI(),neq:Cv(),gte:YI(),lte:jI(),cmp:mv(),coerce:qG(),Comparator:Ed(),Range:us(),satisfies:yd(),toComparators:uY(),maxSatisfying:fY(),minSatisfying:pY(),minVersion:mY(),validRange:IY(),outside:VI(),gtr:SY(),ltr:xY(),intersects:kY(),simplifyRange:FY(),subset:MY()}});var Dv=w(ZI=>{\"use strict\";Object.defineProperty(ZI,\"__esModule\",{value:!0});ZI.VERSION=void 0;ZI.VERSION=\"9.1.0\"});var Gt=w((exports,module)=>{\"use strict\";var __spreadArray=exports&&exports.__spreadArray||function(r,e,t){if(t||arguments.length===2)for(var i=0,n=e.length,s;i{(function(r,e){typeof define==\"function\"&&define.amd?define([],e):typeof _I==\"object\"&&_I.exports?_I.exports=e():r.regexpToAst=e()})(typeof self<\"u\"?self:UY,function(){function r(){}r.prototype.saveState=function(){return{idx:this.idx,input:this.input,groupIdx:this.groupIdx}},r.prototype.restoreState=function(p){this.idx=p.idx,this.input=p.input,this.groupIdx=p.groupIdx},r.prototype.pattern=function(p){this.idx=0,this.input=p,this.groupIdx=0,this.consumeChar(\"/\");var C=this.disjunction();this.consumeChar(\"/\");for(var y={type:\"Flags\",loc:{begin:this.idx,end:p.length},global:!1,ignoreCase:!1,multiLine:!1,unicode:!1,sticky:!1};this.isRegExpFlag();)switch(this.popChar()){case\"g\":o(y,\"global\");break;case\"i\":o(y,\"ignoreCase\");break;case\"m\":o(y,\"multiLine\");break;case\"u\":o(y,\"unicode\");break;case\"y\":o(y,\"sticky\");break}if(this.idx!==this.input.length)throw Error(\"Redundant input: \"+this.input.substring(this.idx));return{type:\"Pattern\",flags:y,value:C,loc:this.loc(0)}},r.prototype.disjunction=function(){var p=[],C=this.idx;for(p.push(this.alternative());this.peekChar()===\"|\";)this.consumeChar(\"|\"),p.push(this.alternative());return{type:\"Disjunction\",value:p,loc:this.loc(C)}},r.prototype.alternative=function(){for(var p=[],C=this.idx;this.isTerm();)p.push(this.term());return{type:\"Alternative\",value:p,loc:this.loc(C)}},r.prototype.term=function(){return this.isAssertion()?this.assertion():this.atom()},r.prototype.assertion=function(){var p=this.idx;switch(this.popChar()){case\"^\":return{type:\"StartAnchor\",loc:this.loc(p)};case\"$\":return{type:\"EndAnchor\",loc:this.loc(p)};case\"\\\\\":switch(this.popChar()){case\"b\":return{type:\"WordBoundary\",loc:this.loc(p)};case\"B\":return{type:\"NonWordBoundary\",loc:this.loc(p)}}throw Error(\"Invalid Assertion Escape\");case\"(\":this.consumeChar(\"?\");var C;switch(this.popChar()){case\"=\":C=\"Lookahead\";break;case\"!\":C=\"NegativeLookahead\";break}a(C);var y=this.disjunction();return this.consumeChar(\")\"),{type:C,value:y,loc:this.loc(p)}}l()},r.prototype.quantifier=function(p){var C,y=this.idx;switch(this.popChar()){case\"*\":C={atLeast:0,atMost:1/0};break;case\"+\":C={atLeast:1,atMost:1/0};break;case\"?\":C={atLeast:0,atMost:1};break;case\"{\":var B=this.integerIncludingZero();switch(this.popChar()){case\"}\":C={atLeast:B,atMost:B};break;case\",\":var v;this.isDigit()?(v=this.integerIncludingZero(),C={atLeast:B,atMost:v}):C={atLeast:B,atMost:1/0},this.consumeChar(\"}\");break}if(p===!0&&C===void 0)return;a(C);break}if(!(p===!0&&C===void 0))return a(C),this.peekChar(0)===\"?\"?(this.consumeChar(\"?\"),C.greedy=!1):C.greedy=!0,C.type=\"Quantifier\",C.loc=this.loc(y),C},r.prototype.atom=function(){var p,C=this.idx;switch(this.peekChar()){case\".\":p=this.dotAll();break;case\"\\\\\":p=this.atomEscape();break;case\"[\":p=this.characterClass();break;case\"(\":p=this.group();break}return p===void 0&&this.isPatternCharacter()&&(p=this.patternCharacter()),a(p),p.loc=this.loc(C),this.isQuantifier()&&(p.quantifier=this.quantifier()),p},r.prototype.dotAll=function(){return this.consumeChar(\".\"),{type:\"Set\",complement:!0,value:[n(`\n`),n(\"\\r\"),n(\"\\u2028\"),n(\"\\u2029\")]}},r.prototype.atomEscape=function(){switch(this.consumeChar(\"\\\\\"),this.peekChar()){case\"1\":case\"2\":case\"3\":case\"4\":case\"5\":case\"6\":case\"7\":case\"8\":case\"9\":return this.decimalEscapeAtom();case\"d\":case\"D\":case\"s\":case\"S\":case\"w\":case\"W\":return this.characterClassEscape();case\"f\":case\"n\":case\"r\":case\"t\":case\"v\":return this.controlEscapeAtom();case\"c\":return this.controlLetterEscapeAtom();case\"0\":return this.nulCharacterAtom();case\"x\":return this.hexEscapeSequenceAtom();case\"u\":return this.regExpUnicodeEscapeSequenceAtom();default:return this.identityEscapeAtom()}},r.prototype.decimalEscapeAtom=function(){var p=this.positiveInteger();return{type:\"GroupBackReference\",value:p}},r.prototype.characterClassEscape=function(){var p,C=!1;switch(this.popChar()){case\"d\":p=u;break;case\"D\":p=u,C=!0;break;case\"s\":p=f;break;case\"S\":p=f,C=!0;break;case\"w\":p=g;break;case\"W\":p=g,C=!0;break}return a(p),{type:\"Set\",value:p,complement:C}},r.prototype.controlEscapeAtom=function(){var p;switch(this.popChar()){case\"f\":p=n(\"\\f\");break;case\"n\":p=n(`\n`);break;case\"r\":p=n(\"\\r\");break;case\"t\":p=n(\"\t\");break;case\"v\":p=n(\"\\v\");break}return a(p),{type:\"Character\",value:p}},r.prototype.controlLetterEscapeAtom=function(){this.consumeChar(\"c\");var p=this.popChar();if(/[a-zA-Z]/.test(p)===!1)throw Error(\"Invalid \");var C=p.toUpperCase().charCodeAt(0)-64;return{type:\"Character\",value:C}},r.prototype.nulCharacterAtom=function(){return this.consumeChar(\"0\"),{type:\"Character\",value:n(\"\\0\")}},r.prototype.hexEscapeSequenceAtom=function(){return this.consumeChar(\"x\"),this.parseHexDigits(2)},r.prototype.regExpUnicodeEscapeSequenceAtom=function(){return this.consumeChar(\"u\"),this.parseHexDigits(4)},r.prototype.identityEscapeAtom=function(){var p=this.popChar();return{type:\"Character\",value:n(p)}},r.prototype.classPatternCharacterAtom=function(){switch(this.peekChar()){case`\n`:case\"\\r\":case\"\\u2028\":case\"\\u2029\":case\"\\\\\":case\"]\":throw Error(\"TBD\");default:var p=this.popChar();return{type:\"Character\",value:n(p)}}},r.prototype.characterClass=function(){var p=[],C=!1;for(this.consumeChar(\"[\"),this.peekChar(0)===\"^\"&&(this.consumeChar(\"^\"),C=!0);this.isClassAtom();){var y=this.classAtom(),B=y.type===\"Character\";if(B&&this.isRangeDash()){this.consumeChar(\"-\");var v=this.classAtom(),D=v.type===\"Character\";if(D){if(v.value=this.input.length)throw Error(\"Unexpected end of input\");this.idx++},r.prototype.loc=function(p){return{begin:p,end:this.idx}};var e=/[0-9a-fA-F]/,t=/[0-9]/,i=/[1-9]/;function n(p){return p.charCodeAt(0)}function s(p,C){p.length!==void 0?p.forEach(function(y){C.push(y)}):C.push(p)}function o(p,C){if(p[C]===!0)throw\"duplicate flag \"+C;p[C]=!0}function a(p){if(p===void 0)throw Error(\"Internal Error - Should never get here!\")}function l(){throw Error(\"Internal Error - Should never get here!\")}var c,u=[];for(c=n(\"0\");c<=n(\"9\");c++)u.push(c);var g=[n(\"_\")].concat(u);for(c=n(\"a\");c<=n(\"z\");c++)g.push(c);for(c=n(\"A\");c<=n(\"Z\");c++)g.push(c);var f=[n(\" \"),n(\"\\f\"),n(`\n`),n(\"\\r\"),n(\"\t\"),n(\"\\v\"),n(\"\t\"),n(\"\\xA0\"),n(\"\\u1680\"),n(\"\\u2000\"),n(\"\\u2001\"),n(\"\\u2002\"),n(\"\\u2003\"),n(\"\\u2004\"),n(\"\\u2005\"),n(\"\\u2006\"),n(\"\\u2007\"),n(\"\\u2008\"),n(\"\\u2009\"),n(\"\\u200A\"),n(\"\\u2028\"),n(\"\\u2029\"),n(\"\\u202F\"),n(\"\\u205F\"),n(\"\\u3000\"),n(\"\\uFEFF\")];function h(){}return h.prototype.visitChildren=function(p){for(var C in p){var y=p[C];p.hasOwnProperty(C)&&(y.type!==void 0?this.visit(y):Array.isArray(y)&&y.forEach(function(B){this.visit(B)},this))}},h.prototype.visit=function(p){switch(p.type){case\"Pattern\":this.visitPattern(p);break;case\"Flags\":this.visitFlags(p);break;case\"Disjunction\":this.visitDisjunction(p);break;case\"Alternative\":this.visitAlternative(p);break;case\"StartAnchor\":this.visitStartAnchor(p);break;case\"EndAnchor\":this.visitEndAnchor(p);break;case\"WordBoundary\":this.visitWordBoundary(p);break;case\"NonWordBoundary\":this.visitNonWordBoundary(p);break;case\"Lookahead\":this.visitLookahead(p);break;case\"NegativeLookahead\":this.visitNegativeLookahead(p);break;case\"Character\":this.visitCharacter(p);break;case\"Set\":this.visitSet(p);break;case\"Group\":this.visitGroup(p);break;case\"GroupBackReference\":this.visitGroupBackReference(p);break;case\"Quantifier\":this.visitQuantifier(p);break}this.visitChildren(p)},h.prototype.visitPattern=function(p){},h.prototype.visitFlags=function(p){},h.prototype.visitDisjunction=function(p){},h.prototype.visitAlternative=function(p){},h.prototype.visitStartAnchor=function(p){},h.prototype.visitEndAnchor=function(p){},h.prototype.visitWordBoundary=function(p){},h.prototype.visitNonWordBoundary=function(p){},h.prototype.visitLookahead=function(p){},h.prototype.visitNegativeLookahead=function(p){},h.prototype.visitCharacter=function(p){},h.prototype.visitSet=function(p){},h.prototype.visitGroup=function(p){},h.prototype.visitGroupBackReference=function(p){},h.prototype.visitQuantifier=function(p){},{RegExpParser:r,BaseRegExpVisitor:h,VERSION:\"0.5.0\"}})});var ty=w(Xg=>{\"use strict\";Object.defineProperty(Xg,\"__esModule\",{value:!0});Xg.clearRegExpParserCache=Xg.getRegExpAst=void 0;var IEe=$I(),ey={},yEe=new IEe.RegExpParser;function wEe(r){var e=r.toString();if(ey.hasOwnProperty(e))return ey[e];var t=yEe.pattern(e);return ey[e]=t,t}Xg.getRegExpAst=wEe;function BEe(){ey={}}Xg.clearRegExpParserCache=BEe});var qY=w(Cn=>{\"use strict\";var bEe=Cn&&Cn.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(Cn,\"__esModule\",{value:!0});Cn.canMatchCharCode=Cn.firstCharOptimizedIndices=Cn.getOptimizedStartCodesIndices=Cn.failedOptimizationPrefixMsg=void 0;var GY=$I(),gs=Gt(),YY=ty(),xa=Rv(),jY=\"Complement Sets are not supported for first char optimization\";Cn.failedOptimizationPrefixMsg=`Unable to use \"first char\" lexer optimizations:\n`;function QEe(r,e){e===void 0&&(e=!1);try{var t=(0,YY.getRegExpAst)(r),i=iy(t.value,{},t.flags.ignoreCase);return i}catch(s){if(s.message===jY)e&&(0,gs.PRINT_WARNING)(\"\"+Cn.failedOptimizationPrefixMsg+(\"\tUnable to optimize: < \"+r.toString()+` >\n`)+`\tComplement Sets cannot be automatically optimized.\n\tThis will disable the lexer's first char optimizations.\n\tSee: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#COMPLEMENT for details.`);else{var n=\"\";e&&(n=`\n\tThis will disable the lexer's first char optimizations.\n\tSee: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#REGEXP_PARSING for details.`),(0,gs.PRINT_ERROR)(Cn.failedOptimizationPrefixMsg+`\n`+(\"\tFailed parsing: < \"+r.toString()+` >\n`)+(\"\tUsing the regexp-to-ast library version: \"+GY.VERSION+`\n`)+\"\tPlease open an issue at: https://github.com/bd82/regexp-to-ast/issues\"+n)}}return[]}Cn.getOptimizedStartCodesIndices=QEe;function iy(r,e,t){switch(r.type){case\"Disjunction\":for(var i=0;i=xa.minOptimizationVal)for(var f=u.from>=xa.minOptimizationVal?u.from:xa.minOptimizationVal,h=u.to,p=(0,xa.charCodeToOptimizedIndex)(f),C=(0,xa.charCodeToOptimizedIndex)(h),y=p;y<=C;y++)e[y]=y}}});break;case\"Group\":iy(o.value,e,t);break;default:throw Error(\"Non Exhaustive Match\")}var a=o.quantifier!==void 0&&o.quantifier.atLeast===0;if(o.type===\"Group\"&&kv(o)===!1||o.type!==\"Group\"&&a===!1)break}break;default:throw Error(\"non exhaustive match!\")}return(0,gs.values)(e)}Cn.firstCharOptimizedIndices=iy;function ry(r,e,t){var i=(0,xa.charCodeToOptimizedIndex)(r);e[i]=i,t===!0&&SEe(r,e)}function SEe(r,e){var t=String.fromCharCode(r),i=t.toUpperCase();if(i!==t){var n=(0,xa.charCodeToOptimizedIndex)(i.charCodeAt(0));e[n]=n}else{var s=t.toLowerCase();if(s!==t){var n=(0,xa.charCodeToOptimizedIndex)(s.charCodeAt(0));e[n]=n}}}function HY(r,e){return(0,gs.find)(r.value,function(t){if(typeof t==\"number\")return(0,gs.contains)(e,t);var i=t;return(0,gs.find)(e,function(n){return i.from<=n&&n<=i.to})!==void 0})}function kv(r){return r.quantifier&&r.quantifier.atLeast===0?!0:r.value?(0,gs.isArray)(r.value)?(0,gs.every)(r.value,kv):kv(r.value):!1}var vEe=function(r){bEe(e,r);function e(t){var i=r.call(this)||this;return i.targetCharCodes=t,i.found=!1,i}return e.prototype.visitChildren=function(t){if(this.found!==!0){switch(t.type){case\"Lookahead\":this.visitLookahead(t);return;case\"NegativeLookahead\":this.visitNegativeLookahead(t);return}r.prototype.visitChildren.call(this,t)}},e.prototype.visitCharacter=function(t){(0,gs.contains)(this.targetCharCodes,t.value)&&(this.found=!0)},e.prototype.visitSet=function(t){t.complement?HY(t,this.targetCharCodes)===void 0&&(this.found=!0):HY(t,this.targetCharCodes)!==void 0&&(this.found=!0)},e}(GY.BaseRegExpVisitor);function xEe(r,e){if(e instanceof RegExp){var t=(0,YY.getRegExpAst)(e),i=new vEe(r);return i.visit(t),i.found}else return(0,gs.find)(e,function(n){return(0,gs.contains)(r,n.charCodeAt(0))})!==void 0}Cn.canMatchCharCode=xEe});var Rv=w(Ve=>{\"use strict\";var JY=Ve&&Ve.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(Ve,\"__esModule\",{value:!0});Ve.charCodeToOptimizedIndex=Ve.minOptimizationVal=Ve.buildLineBreakIssueMessage=Ve.LineTerminatorOptimizedTester=Ve.isShortPattern=Ve.isCustomPattern=Ve.cloneEmptyGroups=Ve.performWarningRuntimeChecks=Ve.performRuntimeChecks=Ve.addStickyFlag=Ve.addStartOfInput=Ve.findUnreachablePatterns=Ve.findModesThatDoNotExist=Ve.findInvalidGroupType=Ve.findDuplicatePatterns=Ve.findUnsupportedFlags=Ve.findStartOfInputAnchor=Ve.findEmptyMatchRegExps=Ve.findEndOfInputAnchor=Ve.findInvalidPatterns=Ve.findMissingPatterns=Ve.validatePatterns=Ve.analyzeTokenTypes=Ve.enableSticky=Ve.disableSticky=Ve.SUPPORT_STICKY=Ve.MODES=Ve.DEFAULT_MODE=void 0;var WY=$I(),ir=Bd(),xe=Gt(),Zg=qY(),zY=ty(),ko=\"PATTERN\";Ve.DEFAULT_MODE=\"defaultMode\";Ve.MODES=\"modes\";Ve.SUPPORT_STICKY=typeof new RegExp(\"(?:)\").sticky==\"boolean\";function PEe(){Ve.SUPPORT_STICKY=!1}Ve.disableSticky=PEe;function DEe(){Ve.SUPPORT_STICKY=!0}Ve.enableSticky=DEe;function kEe(r,e){e=(0,xe.defaults)(e,{useSticky:Ve.SUPPORT_STICKY,debug:!1,safeMode:!1,positionTracking:\"full\",lineTerminatorCharacters:[\"\\r\",`\n`],tracer:function(v,D){return D()}});var t=e.tracer;t(\"initCharCodeToOptimizedIndexMap\",function(){HEe()});var i;t(\"Reject Lexer.NA\",function(){i=(0,xe.reject)(r,function(v){return v[ko]===ir.Lexer.NA})});var n=!1,s;t(\"Transform Patterns\",function(){n=!1,s=(0,xe.map)(i,function(v){var D=v[ko];if((0,xe.isRegExp)(D)){var T=D.source;return T.length===1&&T!==\"^\"&&T!==\"$\"&&T!==\".\"&&!D.ignoreCase?T:T.length===2&&T[0]===\"\\\\\"&&!(0,xe.contains)([\"d\",\"D\",\"s\",\"S\",\"t\",\"r\",\"n\",\"t\",\"0\",\"c\",\"b\",\"B\",\"f\",\"v\",\"w\",\"W\"],T[1])?T[1]:e.useSticky?Tv(D):Nv(D)}else{if((0,xe.isFunction)(D))return n=!0,{exec:D};if((0,xe.has)(D,\"exec\"))return n=!0,D;if(typeof D==\"string\"){if(D.length===1)return D;var H=D.replace(/[\\\\^$.*+?()[\\]{}|]/g,\"\\\\$&\"),j=new RegExp(H);return e.useSticky?Tv(j):Nv(j)}else throw Error(\"non exhaustive match\")}})});var o,a,l,c,u;t(\"misc mapping\",function(){o=(0,xe.map)(i,function(v){return v.tokenTypeIdx}),a=(0,xe.map)(i,function(v){var D=v.GROUP;if(D!==ir.Lexer.SKIPPED){if((0,xe.isString)(D))return D;if((0,xe.isUndefined)(D))return!1;throw Error(\"non exhaustive match\")}}),l=(0,xe.map)(i,function(v){var D=v.LONGER_ALT;if(D){var T=(0,xe.isArray)(D)?(0,xe.map)(D,function(H){return(0,xe.indexOf)(i,H)}):[(0,xe.indexOf)(i,D)];return T}}),c=(0,xe.map)(i,function(v){return v.PUSH_MODE}),u=(0,xe.map)(i,function(v){return(0,xe.has)(v,\"POP_MODE\")})});var g;t(\"Line Terminator Handling\",function(){var v=Aj(e.lineTerminatorCharacters);g=(0,xe.map)(i,function(D){return!1}),e.positionTracking!==\"onlyOffset\"&&(g=(0,xe.map)(i,function(D){if((0,xe.has)(D,\"LINE_BREAKS\"))return D.LINE_BREAKS;if(oj(D,v)===!1)return(0,Zg.canMatchCharCode)(v,D.PATTERN)}))});var f,h,p,C;t(\"Misc Mapping #2\",function(){f=(0,xe.map)(i,Ov),h=(0,xe.map)(s,sj),p=(0,xe.reduce)(i,function(v,D){var T=D.GROUP;return(0,xe.isString)(T)&&T!==ir.Lexer.SKIPPED&&(v[T]=[]),v},{}),C=(0,xe.map)(s,function(v,D){return{pattern:s[D],longerAlt:l[D],canLineTerminator:g[D],isCustom:f[D],short:h[D],group:a[D],push:c[D],pop:u[D],tokenTypeIdx:o[D],tokenType:i[D]}})});var y=!0,B=[];return e.safeMode||t(\"First Char Optimization\",function(){B=(0,xe.reduce)(i,function(v,D,T){if(typeof D.PATTERN==\"string\"){var H=D.PATTERN.charCodeAt(0),j=Lv(H);Fv(v,j,C[T])}else if((0,xe.isArray)(D.START_CHARS_HINT)){var $;(0,xe.forEach)(D.START_CHARS_HINT,function(W){var _=typeof W==\"string\"?W.charCodeAt(0):W,A=Lv(_);$!==A&&($=A,Fv(v,A,C[T]))})}else if((0,xe.isRegExp)(D.PATTERN))if(D.PATTERN.unicode)y=!1,e.ensureOptimizations&&(0,xe.PRINT_ERROR)(\"\"+Zg.failedOptimizationPrefixMsg+(\"\tUnable to analyze < \"+D.PATTERN.toString()+` > pattern.\n`)+`\tThe regexp unicode flag is not currently supported by the regexp-to-ast library.\n\tThis will disable the lexer's first char optimizations.\n\tFor details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#UNICODE_OPTIMIZE`);else{var V=(0,Zg.getOptimizedStartCodesIndices)(D.PATTERN,e.ensureOptimizations);(0,xe.isEmpty)(V)&&(y=!1),(0,xe.forEach)(V,function(W){Fv(v,W,C[T])})}else e.ensureOptimizations&&(0,xe.PRINT_ERROR)(\"\"+Zg.failedOptimizationPrefixMsg+(\"\tTokenType: <\"+D.name+`> is using a custom token pattern without providing parameter.\n`)+`\tThis will disable the lexer's first char optimizations.\n\tFor details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#CUSTOM_OPTIMIZE`),y=!1;return v},[])}),t(\"ArrayPacking\",function(){B=(0,xe.packArray)(B)}),{emptyGroups:p,patternIdxToConfig:C,charCodeToPatternIdxToConfig:B,hasCustom:n,canBeOptimized:y}}Ve.analyzeTokenTypes=kEe;function REe(r,e){var t=[],i=VY(r);t=t.concat(i.errors);var n=XY(i.valid),s=n.valid;return t=t.concat(n.errors),t=t.concat(FEe(s)),t=t.concat(rj(s)),t=t.concat(ij(s,e)),t=t.concat(nj(s)),t}Ve.validatePatterns=REe;function FEe(r){var e=[],t=(0,xe.filter)(r,function(i){return(0,xe.isRegExp)(i[ko])});return e=e.concat(ZY(t)),e=e.concat($Y(t)),e=e.concat(ej(t)),e=e.concat(tj(t)),e=e.concat(_Y(t)),e}function VY(r){var e=(0,xe.filter)(r,function(n){return!(0,xe.has)(n,ko)}),t=(0,xe.map)(e,function(n){return{message:\"Token Type: ->\"+n.name+\"<- missing static 'PATTERN' property\",type:ir.LexerDefinitionErrorType.MISSING_PATTERN,tokenTypes:[n]}}),i=(0,xe.difference)(r,e);return{errors:t,valid:i}}Ve.findMissingPatterns=VY;function XY(r){var e=(0,xe.filter)(r,function(n){var s=n[ko];return!(0,xe.isRegExp)(s)&&!(0,xe.isFunction)(s)&&!(0,xe.has)(s,\"exec\")&&!(0,xe.isString)(s)}),t=(0,xe.map)(e,function(n){return{message:\"Token Type: ->\"+n.name+\"<- static 'PATTERN' can only be a RegExp, a Function matching the {CustomPatternMatcherFunc} type or an Object matching the {ICustomPattern} interface.\",type:ir.LexerDefinitionErrorType.INVALID_PATTERN,tokenTypes:[n]}}),i=(0,xe.difference)(r,e);return{errors:t,valid:i}}Ve.findInvalidPatterns=XY;var NEe=/[^\\\\][\\$]/;function ZY(r){var e=function(n){JY(s,n);function s(){var o=n!==null&&n.apply(this,arguments)||this;return o.found=!1,o}return s.prototype.visitEndAnchor=function(o){this.found=!0},s}(WY.BaseRegExpVisitor),t=(0,xe.filter)(r,function(n){var s=n[ko];try{var o=(0,zY.getRegExpAst)(s),a=new e;return a.visit(o),a.found}catch{return NEe.test(s.source)}}),i=(0,xe.map)(t,function(n){return{message:`Unexpected RegExp Anchor Error:\n\tToken Type: ->`+n.name+`<- static 'PATTERN' cannot contain end of input anchor '$'\n\tSee chevrotain.io/docs/guide/resolving_lexer_errors.html#ANCHORS\tfor details.`,type:ir.LexerDefinitionErrorType.EOI_ANCHOR_FOUND,tokenTypes:[n]}});return i}Ve.findEndOfInputAnchor=ZY;function _Y(r){var e=(0,xe.filter)(r,function(i){var n=i[ko];return n.test(\"\")}),t=(0,xe.map)(e,function(i){return{message:\"Token Type: ->\"+i.name+\"<- static 'PATTERN' must not match an empty string\",type:ir.LexerDefinitionErrorType.EMPTY_MATCH_PATTERN,tokenTypes:[i]}});return t}Ve.findEmptyMatchRegExps=_Y;var TEe=/[^\\\\[][\\^]|^\\^/;function $Y(r){var e=function(n){JY(s,n);function s(){var o=n!==null&&n.apply(this,arguments)||this;return o.found=!1,o}return s.prototype.visitStartAnchor=function(o){this.found=!0},s}(WY.BaseRegExpVisitor),t=(0,xe.filter)(r,function(n){var s=n[ko];try{var o=(0,zY.getRegExpAst)(s),a=new e;return a.visit(o),a.found}catch{return TEe.test(s.source)}}),i=(0,xe.map)(t,function(n){return{message:`Unexpected RegExp Anchor Error:\n\tToken Type: ->`+n.name+`<- static 'PATTERN' cannot contain start of input anchor '^'\n\tSee https://chevrotain.io/docs/guide/resolving_lexer_errors.html#ANCHORS\tfor details.`,type:ir.LexerDefinitionErrorType.SOI_ANCHOR_FOUND,tokenTypes:[n]}});return i}Ve.findStartOfInputAnchor=$Y;function ej(r){var e=(0,xe.filter)(r,function(i){var n=i[ko];return n instanceof RegExp&&(n.multiline||n.global)}),t=(0,xe.map)(e,function(i){return{message:\"Token Type: ->\"+i.name+\"<- static 'PATTERN' may NOT contain global('g') or multiline('m')\",type:ir.LexerDefinitionErrorType.UNSUPPORTED_FLAGS_FOUND,tokenTypes:[i]}});return t}Ve.findUnsupportedFlags=ej;function tj(r){var e=[],t=(0,xe.map)(r,function(s){return(0,xe.reduce)(r,function(o,a){return s.PATTERN.source===a.PATTERN.source&&!(0,xe.contains)(e,a)&&a.PATTERN!==ir.Lexer.NA&&(e.push(a),o.push(a)),o},[])});t=(0,xe.compact)(t);var i=(0,xe.filter)(t,function(s){return s.length>1}),n=(0,xe.map)(i,function(s){var o=(0,xe.map)(s,function(l){return l.name}),a=(0,xe.first)(s).PATTERN;return{message:\"The same RegExp pattern ->\"+a+\"<-\"+(\"has been used in all of the following Token Types: \"+o.join(\", \")+\" <-\"),type:ir.LexerDefinitionErrorType.DUPLICATE_PATTERNS_FOUND,tokenTypes:s}});return n}Ve.findDuplicatePatterns=tj;function rj(r){var e=(0,xe.filter)(r,function(i){if(!(0,xe.has)(i,\"GROUP\"))return!1;var n=i.GROUP;return n!==ir.Lexer.SKIPPED&&n!==ir.Lexer.NA&&!(0,xe.isString)(n)}),t=(0,xe.map)(e,function(i){return{message:\"Token Type: ->\"+i.name+\"<- static 'GROUP' can only be Lexer.SKIPPED/Lexer.NA/A String\",type:ir.LexerDefinitionErrorType.INVALID_GROUP_TYPE_FOUND,tokenTypes:[i]}});return t}Ve.findInvalidGroupType=rj;function ij(r,e){var t=(0,xe.filter)(r,function(n){return n.PUSH_MODE!==void 0&&!(0,xe.contains)(e,n.PUSH_MODE)}),i=(0,xe.map)(t,function(n){var s=\"Token Type: ->\"+n.name+\"<- static 'PUSH_MODE' value cannot refer to a Lexer Mode ->\"+n.PUSH_MODE+\"<-which does not exist\";return{message:s,type:ir.LexerDefinitionErrorType.PUSH_MODE_DOES_NOT_EXIST,tokenTypes:[n]}});return i}Ve.findModesThatDoNotExist=ij;function nj(r){var e=[],t=(0,xe.reduce)(r,function(i,n,s){var o=n.PATTERN;return o===ir.Lexer.NA||((0,xe.isString)(o)?i.push({str:o,idx:s,tokenType:n}):(0,xe.isRegExp)(o)&&OEe(o)&&i.push({str:o.source,idx:s,tokenType:n})),i},[]);return(0,xe.forEach)(r,function(i,n){(0,xe.forEach)(t,function(s){var o=s.str,a=s.idx,l=s.tokenType;if(n\"+l.name+`<- can never be matched.\n`+(\"Because it appears AFTER the Token Type ->\"+i.name+\"<-\")+`in the lexer's definition.\nSee https://chevrotain.io/docs/guide/resolving_lexer_errors.html#UNREACHABLE`;e.push({message:c,type:ir.LexerDefinitionErrorType.UNREACHABLE_PATTERN,tokenTypes:[i,l]})}})}),e}Ve.findUnreachablePatterns=nj;function LEe(r,e){if((0,xe.isRegExp)(e)){var t=e.exec(r);return t!==null&&t.index===0}else{if((0,xe.isFunction)(e))return e(r,0,[],{});if((0,xe.has)(e,\"exec\"))return e.exec(r,0,[],{});if(typeof e==\"string\")return e===r;throw Error(\"non exhaustive match\")}}function OEe(r){var e=[\".\",\"\\\\\",\"[\",\"]\",\"|\",\"^\",\"$\",\"(\",\")\",\"?\",\"*\",\"+\",\"{\"];return(0,xe.find)(e,function(t){return r.source.indexOf(t)!==-1})===void 0}function Nv(r){var e=r.ignoreCase?\"i\":\"\";return new RegExp(\"^(?:\"+r.source+\")\",e)}Ve.addStartOfInput=Nv;function Tv(r){var e=r.ignoreCase?\"iy\":\"y\";return new RegExp(\"\"+r.source,e)}Ve.addStickyFlag=Tv;function MEe(r,e,t){var i=[];return(0,xe.has)(r,Ve.DEFAULT_MODE)||i.push({message:\"A MultiMode Lexer cannot be initialized without a <\"+Ve.DEFAULT_MODE+`> property in its definition\n`,type:ir.LexerDefinitionErrorType.MULTI_MODE_LEXER_WITHOUT_DEFAULT_MODE}),(0,xe.has)(r,Ve.MODES)||i.push({message:\"A MultiMode Lexer cannot be initialized without a <\"+Ve.MODES+`> property in its definition\n`,type:ir.LexerDefinitionErrorType.MULTI_MODE_LEXER_WITHOUT_MODES_PROPERTY}),(0,xe.has)(r,Ve.MODES)&&(0,xe.has)(r,Ve.DEFAULT_MODE)&&!(0,xe.has)(r.modes,r.defaultMode)&&i.push({message:\"A MultiMode Lexer cannot be initialized with a \"+Ve.DEFAULT_MODE+\": <\"+r.defaultMode+`>which does not exist\n`,type:ir.LexerDefinitionErrorType.MULTI_MODE_LEXER_DEFAULT_MODE_VALUE_DOES_NOT_EXIST}),(0,xe.has)(r,Ve.MODES)&&(0,xe.forEach)(r.modes,function(n,s){(0,xe.forEach)(n,function(o,a){(0,xe.isUndefined)(o)&&i.push({message:\"A Lexer cannot be initialized using an undefined Token Type. Mode:\"+(\"<\"+s+\"> at index: <\"+a+`>\n`),type:ir.LexerDefinitionErrorType.LEXER_DEFINITION_CANNOT_CONTAIN_UNDEFINED})})}),i}Ve.performRuntimeChecks=MEe;function KEe(r,e,t){var i=[],n=!1,s=(0,xe.compact)((0,xe.flatten)((0,xe.mapValues)(r.modes,function(l){return l}))),o=(0,xe.reject)(s,function(l){return l[ko]===ir.Lexer.NA}),a=Aj(t);return e&&(0,xe.forEach)(o,function(l){var c=oj(l,a);if(c!==!1){var u=aj(l,c),g={message:u,type:c.issue,tokenType:l};i.push(g)}else(0,xe.has)(l,\"LINE_BREAKS\")?l.LINE_BREAKS===!0&&(n=!0):(0,Zg.canMatchCharCode)(a,l.PATTERN)&&(n=!0)}),e&&!n&&i.push({message:`Warning: No LINE_BREAKS Found.\n\tThis Lexer has been defined to track line and column information,\n\tBut none of the Token Types can be identified as matching a line terminator.\n\tSee https://chevrotain.io/docs/guide/resolving_lexer_errors.html#LINE_BREAKS \n\tfor details.`,type:ir.LexerDefinitionErrorType.NO_LINE_BREAKS_FLAGS}),i}Ve.performWarningRuntimeChecks=KEe;function UEe(r){var e={},t=(0,xe.keys)(r);return(0,xe.forEach)(t,function(i){var n=r[i];if((0,xe.isArray)(n))e[i]=[];else throw Error(\"non exhaustive match\")}),e}Ve.cloneEmptyGroups=UEe;function Ov(r){var e=r.PATTERN;if((0,xe.isRegExp)(e))return!1;if((0,xe.isFunction)(e))return!0;if((0,xe.has)(e,\"exec\"))return!0;if((0,xe.isString)(e))return!1;throw Error(\"non exhaustive match\")}Ve.isCustomPattern=Ov;function sj(r){return(0,xe.isString)(r)&&r.length===1?r.charCodeAt(0):!1}Ve.isShortPattern=sj;Ve.LineTerminatorOptimizedTester={test:function(r){for(var e=r.length,t=this.lastIndex;t Token Type\n`)+(\"\t Root cause: \"+e.errMsg+`.\n`)+\"\tFor details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#IDENTIFY_TERMINATOR\";if(e.issue===ir.LexerDefinitionErrorType.CUSTOM_LINE_BREAK)return`Warning: A Custom Token Pattern should specify the option.\n`+(\"\tThe problem is in the <\"+r.name+`> Token Type\n`)+\"\tFor details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#CUSTOM_LINE_BREAK\";throw Error(\"non exhaustive match\")}Ve.buildLineBreakIssueMessage=aj;function Aj(r){var e=(0,xe.map)(r,function(t){return(0,xe.isString)(t)&&t.length>0?t.charCodeAt(0):t});return e}function Fv(r,e,t){r[e]===void 0?r[e]=[t]:r[e].push(t)}Ve.minOptimizationVal=256;var ny=[];function Lv(r){return r255?255+~~(r/255):r}}});var _g=w(Nt=>{\"use strict\";Object.defineProperty(Nt,\"__esModule\",{value:!0});Nt.isTokenType=Nt.hasExtendingTokensTypesMapProperty=Nt.hasExtendingTokensTypesProperty=Nt.hasCategoriesProperty=Nt.hasShortKeyProperty=Nt.singleAssignCategoriesToksMap=Nt.assignCategoriesMapProp=Nt.assignCategoriesTokensProp=Nt.assignTokenDefaultProps=Nt.expandCategories=Nt.augmentTokenTypes=Nt.tokenIdxToClass=Nt.tokenShortNameIdx=Nt.tokenStructuredMatcherNoCategories=Nt.tokenStructuredMatcher=void 0;var Zr=Gt();function GEe(r,e){var t=r.tokenTypeIdx;return t===e.tokenTypeIdx?!0:e.isParent===!0&&e.categoryMatchesMap[t]===!0}Nt.tokenStructuredMatcher=GEe;function YEe(r,e){return r.tokenTypeIdx===e.tokenTypeIdx}Nt.tokenStructuredMatcherNoCategories=YEe;Nt.tokenShortNameIdx=1;Nt.tokenIdxToClass={};function jEe(r){var e=lj(r);cj(e),gj(e),uj(e),(0,Zr.forEach)(e,function(t){t.isParent=t.categoryMatches.length>0})}Nt.augmentTokenTypes=jEe;function lj(r){for(var e=(0,Zr.cloneArr)(r),t=r,i=!0;i;){t=(0,Zr.compact)((0,Zr.flatten)((0,Zr.map)(t,function(s){return s.CATEGORIES})));var n=(0,Zr.difference)(t,e);e=e.concat(n),(0,Zr.isEmpty)(n)?i=!1:t=n}return e}Nt.expandCategories=lj;function cj(r){(0,Zr.forEach)(r,function(e){fj(e)||(Nt.tokenIdxToClass[Nt.tokenShortNameIdx]=e,e.tokenTypeIdx=Nt.tokenShortNameIdx++),Mv(e)&&!(0,Zr.isArray)(e.CATEGORIES)&&(e.CATEGORIES=[e.CATEGORIES]),Mv(e)||(e.CATEGORIES=[]),hj(e)||(e.categoryMatches=[]),pj(e)||(e.categoryMatchesMap={})})}Nt.assignTokenDefaultProps=cj;function uj(r){(0,Zr.forEach)(r,function(e){e.categoryMatches=[],(0,Zr.forEach)(e.categoryMatchesMap,function(t,i){e.categoryMatches.push(Nt.tokenIdxToClass[i].tokenTypeIdx)})})}Nt.assignCategoriesTokensProp=uj;function gj(r){(0,Zr.forEach)(r,function(e){Kv([],e)})}Nt.assignCategoriesMapProp=gj;function Kv(r,e){(0,Zr.forEach)(r,function(t){e.categoryMatchesMap[t.tokenTypeIdx]=!0}),(0,Zr.forEach)(e.CATEGORIES,function(t){var i=r.concat(e);(0,Zr.contains)(i,t)||Kv(i,t)})}Nt.singleAssignCategoriesToksMap=Kv;function fj(r){return(0,Zr.has)(r,\"tokenTypeIdx\")}Nt.hasShortKeyProperty=fj;function Mv(r){return(0,Zr.has)(r,\"CATEGORIES\")}Nt.hasCategoriesProperty=Mv;function hj(r){return(0,Zr.has)(r,\"categoryMatches\")}Nt.hasExtendingTokensTypesProperty=hj;function pj(r){return(0,Zr.has)(r,\"categoryMatchesMap\")}Nt.hasExtendingTokensTypesMapProperty=pj;function qEe(r){return(0,Zr.has)(r,\"tokenTypeIdx\")}Nt.isTokenType=qEe});var Uv=w(sy=>{\"use strict\";Object.defineProperty(sy,\"__esModule\",{value:!0});sy.defaultLexerErrorProvider=void 0;sy.defaultLexerErrorProvider={buildUnableToPopLexerModeMessage:function(r){return\"Unable to pop Lexer Mode after encountering Token ->\"+r.image+\"<- The Mode Stack is empty\"},buildUnexpectedCharactersMessage:function(r,e,t,i,n){return\"unexpected character: ->\"+r.charAt(e)+\"<- at offset: \"+e+\",\"+(\" skipped \"+t+\" characters.\")}}});var Bd=w(Cc=>{\"use strict\";Object.defineProperty(Cc,\"__esModule\",{value:!0});Cc.Lexer=Cc.LexerDefinitionErrorType=void 0;var _s=Rv(),nr=Gt(),JEe=_g(),WEe=Uv(),zEe=ty(),VEe;(function(r){r[r.MISSING_PATTERN=0]=\"MISSING_PATTERN\",r[r.INVALID_PATTERN=1]=\"INVALID_PATTERN\",r[r.EOI_ANCHOR_FOUND=2]=\"EOI_ANCHOR_FOUND\",r[r.UNSUPPORTED_FLAGS_FOUND=3]=\"UNSUPPORTED_FLAGS_FOUND\",r[r.DUPLICATE_PATTERNS_FOUND=4]=\"DUPLICATE_PATTERNS_FOUND\",r[r.INVALID_GROUP_TYPE_FOUND=5]=\"INVALID_GROUP_TYPE_FOUND\",r[r.PUSH_MODE_DOES_NOT_EXIST=6]=\"PUSH_MODE_DOES_NOT_EXIST\",r[r.MULTI_MODE_LEXER_WITHOUT_DEFAULT_MODE=7]=\"MULTI_MODE_LEXER_WITHOUT_DEFAULT_MODE\",r[r.MULTI_MODE_LEXER_WITHOUT_MODES_PROPERTY=8]=\"MULTI_MODE_LEXER_WITHOUT_MODES_PROPERTY\",r[r.MULTI_MODE_LEXER_DEFAULT_MODE_VALUE_DOES_NOT_EXIST=9]=\"MULTI_MODE_LEXER_DEFAULT_MODE_VALUE_DOES_NOT_EXIST\",r[r.LEXER_DEFINITION_CANNOT_CONTAIN_UNDEFINED=10]=\"LEXER_DEFINITION_CANNOT_CONTAIN_UNDEFINED\",r[r.SOI_ANCHOR_FOUND=11]=\"SOI_ANCHOR_FOUND\",r[r.EMPTY_MATCH_PATTERN=12]=\"EMPTY_MATCH_PATTERN\",r[r.NO_LINE_BREAKS_FLAGS=13]=\"NO_LINE_BREAKS_FLAGS\",r[r.UNREACHABLE_PATTERN=14]=\"UNREACHABLE_PATTERN\",r[r.IDENTIFY_TERMINATOR=15]=\"IDENTIFY_TERMINATOR\",r[r.CUSTOM_LINE_BREAK=16]=\"CUSTOM_LINE_BREAK\"})(VEe=Cc.LexerDefinitionErrorType||(Cc.LexerDefinitionErrorType={}));var bd={deferDefinitionErrorsHandling:!1,positionTracking:\"full\",lineTerminatorsPattern:/\\n|\\r\\n?/g,lineTerminatorCharacters:[`\n`,\"\\r\"],ensureOptimizations:!1,safeMode:!1,errorMessageProvider:WEe.defaultLexerErrorProvider,traceInitPerf:!1,skipValidations:!1};Object.freeze(bd);var XEe=function(){function r(e,t){var i=this;if(t===void 0&&(t=bd),this.lexerDefinition=e,this.lexerDefinitionErrors=[],this.lexerDefinitionWarning=[],this.patternIdxToConfig={},this.charCodeToPatternIdxToConfig={},this.modes=[],this.emptyGroups={},this.config=void 0,this.trackStartLines=!0,this.trackEndLines=!0,this.hasCustom=!1,this.canModeBeOptimized={},typeof t==\"boolean\")throw Error(`The second argument to the Lexer constructor is now an ILexerConfig Object.\na boolean 2nd argument is no longer supported`);this.config=(0,nr.merge)(bd,t);var n=this.config.traceInitPerf;n===!0?(this.traceInitMaxIdent=1/0,this.traceInitPerf=!0):typeof n==\"number\"&&(this.traceInitMaxIdent=n,this.traceInitPerf=!0),this.traceInitIndent=-1,this.TRACE_INIT(\"Lexer Constructor\",function(){var s,o=!0;i.TRACE_INIT(\"Lexer Config handling\",function(){if(i.config.lineTerminatorsPattern===bd.lineTerminatorsPattern)i.config.lineTerminatorsPattern=_s.LineTerminatorOptimizedTester;else if(i.config.lineTerminatorCharacters===bd.lineTerminatorCharacters)throw Error(`Error: Missing property on the Lexer config.\n\tFor details See: https://chevrotain.io/docs/guide/resolving_lexer_errors.html#MISSING_LINE_TERM_CHARS`);if(t.safeMode&&t.ensureOptimizations)throw Error('\"safeMode\" and \"ensureOptimizations\" flags are mutually exclusive.');i.trackStartLines=/full|onlyStart/i.test(i.config.positionTracking),i.trackEndLines=/full/i.test(i.config.positionTracking),(0,nr.isArray)(e)?(s={modes:{}},s.modes[_s.DEFAULT_MODE]=(0,nr.cloneArr)(e),s[_s.DEFAULT_MODE]=_s.DEFAULT_MODE):(o=!1,s=(0,nr.cloneObj)(e))}),i.config.skipValidations===!1&&(i.TRACE_INIT(\"performRuntimeChecks\",function(){i.lexerDefinitionErrors=i.lexerDefinitionErrors.concat((0,_s.performRuntimeChecks)(s,i.trackStartLines,i.config.lineTerminatorCharacters))}),i.TRACE_INIT(\"performWarningRuntimeChecks\",function(){i.lexerDefinitionWarning=i.lexerDefinitionWarning.concat((0,_s.performWarningRuntimeChecks)(s,i.trackStartLines,i.config.lineTerminatorCharacters))})),s.modes=s.modes?s.modes:{},(0,nr.forEach)(s.modes,function(u,g){s.modes[g]=(0,nr.reject)(u,function(f){return(0,nr.isUndefined)(f)})});var a=(0,nr.keys)(s.modes);if((0,nr.forEach)(s.modes,function(u,g){i.TRACE_INIT(\"Mode: <\"+g+\"> processing\",function(){if(i.modes.push(g),i.config.skipValidations===!1&&i.TRACE_INIT(\"validatePatterns\",function(){i.lexerDefinitionErrors=i.lexerDefinitionErrors.concat((0,_s.validatePatterns)(u,a))}),(0,nr.isEmpty)(i.lexerDefinitionErrors)){(0,JEe.augmentTokenTypes)(u);var f;i.TRACE_INIT(\"analyzeTokenTypes\",function(){f=(0,_s.analyzeTokenTypes)(u,{lineTerminatorCharacters:i.config.lineTerminatorCharacters,positionTracking:t.positionTracking,ensureOptimizations:t.ensureOptimizations,safeMode:t.safeMode,tracer:i.TRACE_INIT.bind(i)})}),i.patternIdxToConfig[g]=f.patternIdxToConfig,i.charCodeToPatternIdxToConfig[g]=f.charCodeToPatternIdxToConfig,i.emptyGroups=(0,nr.merge)(i.emptyGroups,f.emptyGroups),i.hasCustom=f.hasCustom||i.hasCustom,i.canModeBeOptimized[g]=f.canBeOptimized}})}),i.defaultMode=s.defaultMode,!(0,nr.isEmpty)(i.lexerDefinitionErrors)&&!i.config.deferDefinitionErrorsHandling){var l=(0,nr.map)(i.lexerDefinitionErrors,function(u){return u.message}),c=l.join(`-----------------------\n`);throw new Error(`Errors detected in definition of Lexer:\n`+c)}(0,nr.forEach)(i.lexerDefinitionWarning,function(u){(0,nr.PRINT_WARNING)(u.message)}),i.TRACE_INIT(\"Choosing sub-methods implementations\",function(){if(_s.SUPPORT_STICKY?(i.chopInput=nr.IDENTITY,i.match=i.matchWithTest):(i.updateLastIndex=nr.NOOP,i.match=i.matchWithExec),o&&(i.handleModes=nr.NOOP),i.trackStartLines===!1&&(i.computeNewColumn=nr.IDENTITY),i.trackEndLines===!1&&(i.updateTokenEndLineColumnLocation=nr.NOOP),/full/i.test(i.config.positionTracking))i.createTokenInstance=i.createFullToken;else if(/onlyStart/i.test(i.config.positionTracking))i.createTokenInstance=i.createStartOnlyToken;else if(/onlyOffset/i.test(i.config.positionTracking))i.createTokenInstance=i.createOffsetOnlyToken;else throw Error('Invalid config option: \"'+i.config.positionTracking+'\"');i.hasCustom?(i.addToken=i.addTokenUsingPush,i.handlePayload=i.handlePayloadWithCustom):(i.addToken=i.addTokenUsingMemberAccess,i.handlePayload=i.handlePayloadNoCustom)}),i.TRACE_INIT(\"Failed Optimization Warnings\",function(){var u=(0,nr.reduce)(i.canModeBeOptimized,function(g,f,h){return f===!1&&g.push(h),g},[]);if(t.ensureOptimizations&&!(0,nr.isEmpty)(u))throw Error(\"Lexer Modes: < \"+u.join(\", \")+` > cannot be optimized.\n\t Disable the \"ensureOptimizations\" lexer config flag to silently ignore this and run the lexer in an un-optimized mode.\n\t Or inspect the console log for details on how to resolve these issues.`)}),i.TRACE_INIT(\"clearRegExpParserCache\",function(){(0,zEe.clearRegExpParserCache)()}),i.TRACE_INIT(\"toFastProperties\",function(){(0,nr.toFastProperties)(i)})})}return r.prototype.tokenize=function(e,t){if(t===void 0&&(t=this.defaultMode),!(0,nr.isEmpty)(this.lexerDefinitionErrors)){var i=(0,nr.map)(this.lexerDefinitionErrors,function(o){return o.message}),n=i.join(`-----------------------\n`);throw new Error(`Unable to Tokenize because Errors detected in definition of Lexer:\n`+n)}var s=this.tokenizeInternal(e,t);return s},r.prototype.tokenizeInternal=function(e,t){var i=this,n,s,o,a,l,c,u,g,f,h,p,C,y,B,v,D,T=e,H=T.length,j=0,$=0,V=this.hasCustom?0:Math.floor(e.length/10),W=new Array(V),_=[],A=this.trackStartLines?1:void 0,Ae=this.trackStartLines?1:void 0,ge=(0,_s.cloneEmptyGroups)(this.emptyGroups),re=this.trackStartLines,O=this.config.lineTerminatorsPattern,F=0,ue=[],pe=[],ke=[],Fe=[];Object.freeze(Fe);var Ne=void 0;function oe(){return ue}function le(pr){var Ii=(0,_s.charCodeToOptimizedIndex)(pr),rs=pe[Ii];return rs===void 0?Fe:rs}var Be=function(pr){if(ke.length===1&&pr.tokenType.PUSH_MODE===void 0){var Ii=i.config.errorMessageProvider.buildUnableToPopLexerModeMessage(pr);_.push({offset:pr.startOffset,line:pr.startLine!==void 0?pr.startLine:void 0,column:pr.startColumn!==void 0?pr.startColumn:void 0,length:pr.image.length,message:Ii})}else{ke.pop();var rs=(0,nr.last)(ke);ue=i.patternIdxToConfig[rs],pe=i.charCodeToPatternIdxToConfig[rs],F=ue.length;var fa=i.canModeBeOptimized[rs]&&i.config.safeMode===!1;pe&&fa?Ne=le:Ne=oe}};function fe(pr){ke.push(pr),pe=this.charCodeToPatternIdxToConfig[pr],ue=this.patternIdxToConfig[pr],F=ue.length,F=ue.length;var Ii=this.canModeBeOptimized[pr]&&this.config.safeMode===!1;pe&&Ii?Ne=le:Ne=oe}fe.call(this,t);for(var ae;jc.length){c=a,u=g,ae=_e;break}}}break}}if(c!==null){if(f=c.length,h=ae.group,h!==void 0&&(p=ae.tokenTypeIdx,C=this.createTokenInstance(c,j,p,ae.tokenType,A,Ae,f),this.handlePayload(C,u),h===!1?$=this.addToken(W,$,C):ge[h].push(C)),e=this.chopInput(e,f),j=j+f,Ae=this.computeNewColumn(Ae,f),re===!0&&ae.canLineTerminator===!0){var It=0,Or=void 0,ii=void 0;O.lastIndex=0;do Or=O.test(c),Or===!0&&(ii=O.lastIndex-1,It++);while(Or===!0);It!==0&&(A=A+It,Ae=f-ii,this.updateTokenEndLineColumnLocation(C,h,ii,It,A,Ae,f))}this.handleModes(ae,Be,fe,C)}else{for(var gi=j,hr=A,fi=Ae,ni=!1;!ni&&j <\"+e+\">\");var n=(0,nr.timer)(t),s=n.time,o=n.value,a=s>10?console.warn:console.log;return this.traceInitIndent time: \"+s+\"ms\"),this.traceInitIndent--,o}else return t()},r.SKIPPED=\"This marks a skipped Token pattern, this means each token identified by it willbe consumed and then thrown into oblivion, this can be used to for example to completely ignore whitespace.\",r.NA=/NOT_APPLICABLE/,r}();Cc.Lexer=XEe});var TA=w(Qi=>{\"use strict\";Object.defineProperty(Qi,\"__esModule\",{value:!0});Qi.tokenMatcher=Qi.createTokenInstance=Qi.EOF=Qi.createToken=Qi.hasTokenLabel=Qi.tokenName=Qi.tokenLabel=void 0;var $s=Gt(),ZEe=Bd(),Hv=_g();function _Ee(r){return bj(r)?r.LABEL:r.name}Qi.tokenLabel=_Ee;function $Ee(r){return r.name}Qi.tokenName=$Ee;function bj(r){return(0,$s.isString)(r.LABEL)&&r.LABEL!==\"\"}Qi.hasTokenLabel=bj;var eIe=\"parent\",dj=\"categories\",Cj=\"label\",mj=\"group\",Ej=\"push_mode\",Ij=\"pop_mode\",yj=\"longer_alt\",wj=\"line_breaks\",Bj=\"start_chars_hint\";function Qj(r){return tIe(r)}Qi.createToken=Qj;function tIe(r){var e=r.pattern,t={};if(t.name=r.name,(0,$s.isUndefined)(e)||(t.PATTERN=e),(0,$s.has)(r,eIe))throw`The parent property is no longer supported.\nSee: https://github.com/chevrotain/chevrotain/issues/564#issuecomment-349062346 for details.`;return(0,$s.has)(r,dj)&&(t.CATEGORIES=r[dj]),(0,Hv.augmentTokenTypes)([t]),(0,$s.has)(r,Cj)&&(t.LABEL=r[Cj]),(0,$s.has)(r,mj)&&(t.GROUP=r[mj]),(0,$s.has)(r,Ij)&&(t.POP_MODE=r[Ij]),(0,$s.has)(r,Ej)&&(t.PUSH_MODE=r[Ej]),(0,$s.has)(r,yj)&&(t.LONGER_ALT=r[yj]),(0,$s.has)(r,wj)&&(t.LINE_BREAKS=r[wj]),(0,$s.has)(r,Bj)&&(t.START_CHARS_HINT=r[Bj]),t}Qi.EOF=Qj({name:\"EOF\",pattern:ZEe.Lexer.NA});(0,Hv.augmentTokenTypes)([Qi.EOF]);function rIe(r,e,t,i,n,s,o,a){return{image:e,startOffset:t,endOffset:i,startLine:n,endLine:s,startColumn:o,endColumn:a,tokenTypeIdx:r.tokenTypeIdx,tokenType:r}}Qi.createTokenInstance=rIe;function iIe(r,e){return(0,Hv.tokenStructuredMatcher)(r,e)}Qi.tokenMatcher=iIe});var mn=w(zt=>{\"use strict\";var Pa=zt&&zt.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(zt,\"__esModule\",{value:!0});zt.serializeProduction=zt.serializeGrammar=zt.Terminal=zt.Alternation=zt.RepetitionWithSeparator=zt.Repetition=zt.RepetitionMandatoryWithSeparator=zt.RepetitionMandatory=zt.Option=zt.Alternative=zt.Rule=zt.NonTerminal=zt.AbstractProduction=void 0;var Ar=Gt(),nIe=TA(),Ro=function(){function r(e){this._definition=e}return Object.defineProperty(r.prototype,\"definition\",{get:function(){return this._definition},set:function(e){this._definition=e},enumerable:!1,configurable:!0}),r.prototype.accept=function(e){e.visit(this),(0,Ar.forEach)(this.definition,function(t){t.accept(e)})},r}();zt.AbstractProduction=Ro;var Sj=function(r){Pa(e,r);function e(t){var i=r.call(this,[])||this;return i.idx=1,(0,Ar.assign)(i,(0,Ar.pick)(t,function(n){return n!==void 0})),i}return Object.defineProperty(e.prototype,\"definition\",{get:function(){return this.referencedRule!==void 0?this.referencedRule.definition:[]},set:function(t){},enumerable:!1,configurable:!0}),e.prototype.accept=function(t){t.visit(this)},e}(Ro);zt.NonTerminal=Sj;var vj=function(r){Pa(e,r);function e(t){var i=r.call(this,t.definition)||this;return i.orgText=\"\",(0,Ar.assign)(i,(0,Ar.pick)(t,function(n){return n!==void 0})),i}return e}(Ro);zt.Rule=vj;var xj=function(r){Pa(e,r);function e(t){var i=r.call(this,t.definition)||this;return i.ignoreAmbiguities=!1,(0,Ar.assign)(i,(0,Ar.pick)(t,function(n){return n!==void 0})),i}return e}(Ro);zt.Alternative=xj;var Pj=function(r){Pa(e,r);function e(t){var i=r.call(this,t.definition)||this;return i.idx=1,(0,Ar.assign)(i,(0,Ar.pick)(t,function(n){return n!==void 0})),i}return e}(Ro);zt.Option=Pj;var Dj=function(r){Pa(e,r);function e(t){var i=r.call(this,t.definition)||this;return i.idx=1,(0,Ar.assign)(i,(0,Ar.pick)(t,function(n){return n!==void 0})),i}return e}(Ro);zt.RepetitionMandatory=Dj;var kj=function(r){Pa(e,r);function e(t){var i=r.call(this,t.definition)||this;return i.idx=1,(0,Ar.assign)(i,(0,Ar.pick)(t,function(n){return n!==void 0})),i}return e}(Ro);zt.RepetitionMandatoryWithSeparator=kj;var Rj=function(r){Pa(e,r);function e(t){var i=r.call(this,t.definition)||this;return i.idx=1,(0,Ar.assign)(i,(0,Ar.pick)(t,function(n){return n!==void 0})),i}return e}(Ro);zt.Repetition=Rj;var Fj=function(r){Pa(e,r);function e(t){var i=r.call(this,t.definition)||this;return i.idx=1,(0,Ar.assign)(i,(0,Ar.pick)(t,function(n){return n!==void 0})),i}return e}(Ro);zt.RepetitionWithSeparator=Fj;var Nj=function(r){Pa(e,r);function e(t){var i=r.call(this,t.definition)||this;return i.idx=1,i.ignoreAmbiguities=!1,i.hasPredicates=!1,(0,Ar.assign)(i,(0,Ar.pick)(t,function(n){return n!==void 0})),i}return Object.defineProperty(e.prototype,\"definition\",{get:function(){return this._definition},set:function(t){this._definition=t},enumerable:!1,configurable:!0}),e}(Ro);zt.Alternation=Nj;var oy=function(){function r(e){this.idx=1,(0,Ar.assign)(this,(0,Ar.pick)(e,function(t){return t!==void 0}))}return r.prototype.accept=function(e){e.visit(this)},r}();zt.Terminal=oy;function sIe(r){return(0,Ar.map)(r,Qd)}zt.serializeGrammar=sIe;function Qd(r){function e(s){return(0,Ar.map)(s,Qd)}if(r instanceof Sj){var t={type:\"NonTerminal\",name:r.nonTerminalName,idx:r.idx};return(0,Ar.isString)(r.label)&&(t.label=r.label),t}else{if(r instanceof xj)return{type:\"Alternative\",definition:e(r.definition)};if(r instanceof Pj)return{type:\"Option\",idx:r.idx,definition:e(r.definition)};if(r instanceof Dj)return{type:\"RepetitionMandatory\",idx:r.idx,definition:e(r.definition)};if(r instanceof kj)return{type:\"RepetitionMandatoryWithSeparator\",idx:r.idx,separator:Qd(new oy({terminalType:r.separator})),definition:e(r.definition)};if(r instanceof Fj)return{type:\"RepetitionWithSeparator\",idx:r.idx,separator:Qd(new oy({terminalType:r.separator})),definition:e(r.definition)};if(r instanceof Rj)return{type:\"Repetition\",idx:r.idx,definition:e(r.definition)};if(r instanceof Nj)return{type:\"Alternation\",idx:r.idx,definition:e(r.definition)};if(r instanceof oy){var i={type:\"Terminal\",name:r.terminalType.name,label:(0,nIe.tokenLabel)(r.terminalType),idx:r.idx};(0,Ar.isString)(r.label)&&(i.terminalLabel=r.label);var n=r.terminalType.PATTERN;return r.terminalType.PATTERN&&(i.pattern=(0,Ar.isRegExp)(n)?n.source:n),i}else{if(r instanceof vj)return{type:\"Rule\",name:r.name,orgText:r.orgText,definition:e(r.definition)};throw Error(\"non exhaustive match\")}}}zt.serializeProduction=Qd});var Ay=w(ay=>{\"use strict\";Object.defineProperty(ay,\"__esModule\",{value:!0});ay.RestWalker=void 0;var Gv=Gt(),En=mn(),oIe=function(){function r(){}return r.prototype.walk=function(e,t){var i=this;t===void 0&&(t=[]),(0,Gv.forEach)(e.definition,function(n,s){var o=(0,Gv.drop)(e.definition,s+1);if(n instanceof En.NonTerminal)i.walkProdRef(n,o,t);else if(n instanceof En.Terminal)i.walkTerminal(n,o,t);else if(n instanceof En.Alternative)i.walkFlat(n,o,t);else if(n instanceof En.Option)i.walkOption(n,o,t);else if(n instanceof En.RepetitionMandatory)i.walkAtLeastOne(n,o,t);else if(n instanceof En.RepetitionMandatoryWithSeparator)i.walkAtLeastOneSep(n,o,t);else if(n instanceof En.RepetitionWithSeparator)i.walkManySep(n,o,t);else if(n instanceof En.Repetition)i.walkMany(n,o,t);else if(n instanceof En.Alternation)i.walkOr(n,o,t);else throw Error(\"non exhaustive match\")})},r.prototype.walkTerminal=function(e,t,i){},r.prototype.walkProdRef=function(e,t,i){},r.prototype.walkFlat=function(e,t,i){var n=t.concat(i);this.walk(e,n)},r.prototype.walkOption=function(e,t,i){var n=t.concat(i);this.walk(e,n)},r.prototype.walkAtLeastOne=function(e,t,i){var n=[new En.Option({definition:e.definition})].concat(t,i);this.walk(e,n)},r.prototype.walkAtLeastOneSep=function(e,t,i){var n=Tj(e,t,i);this.walk(e,n)},r.prototype.walkMany=function(e,t,i){var n=[new En.Option({definition:e.definition})].concat(t,i);this.walk(e,n)},r.prototype.walkManySep=function(e,t,i){var n=Tj(e,t,i);this.walk(e,n)},r.prototype.walkOr=function(e,t,i){var n=this,s=t.concat(i);(0,Gv.forEach)(e.definition,function(o){var a=new En.Alternative({definition:[o]});n.walk(a,s)})},r}();ay.RestWalker=oIe;function Tj(r,e,t){var i=[new En.Option({definition:[new En.Terminal({terminalType:r.separator})].concat(r.definition)})],n=i.concat(e,t);return n}});var $g=w(ly=>{\"use strict\";Object.defineProperty(ly,\"__esModule\",{value:!0});ly.GAstVisitor=void 0;var Fo=mn(),aIe=function(){function r(){}return r.prototype.visit=function(e){var t=e;switch(t.constructor){case Fo.NonTerminal:return this.visitNonTerminal(t);case Fo.Alternative:return this.visitAlternative(t);case Fo.Option:return this.visitOption(t);case Fo.RepetitionMandatory:return this.visitRepetitionMandatory(t);case Fo.RepetitionMandatoryWithSeparator:return this.visitRepetitionMandatoryWithSeparator(t);case Fo.RepetitionWithSeparator:return this.visitRepetitionWithSeparator(t);case Fo.Repetition:return this.visitRepetition(t);case Fo.Alternation:return this.visitAlternation(t);case Fo.Terminal:return this.visitTerminal(t);case Fo.Rule:return this.visitRule(t);default:throw Error(\"non exhaustive match\")}},r.prototype.visitNonTerminal=function(e){},r.prototype.visitAlternative=function(e){},r.prototype.visitOption=function(e){},r.prototype.visitRepetition=function(e){},r.prototype.visitRepetitionMandatory=function(e){},r.prototype.visitRepetitionMandatoryWithSeparator=function(e){},r.prototype.visitRepetitionWithSeparator=function(e){},r.prototype.visitAlternation=function(e){},r.prototype.visitTerminal=function(e){},r.prototype.visitRule=function(e){},r}();ly.GAstVisitor=aIe});var vd=w(Mi=>{\"use strict\";var AIe=Mi&&Mi.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(Mi,\"__esModule\",{value:!0});Mi.collectMethods=Mi.DslMethodsCollectorVisitor=Mi.getProductionDslName=Mi.isBranchingProd=Mi.isOptionalProd=Mi.isSequenceProd=void 0;var Sd=Gt(),br=mn(),lIe=$g();function cIe(r){return r instanceof br.Alternative||r instanceof br.Option||r instanceof br.Repetition||r instanceof br.RepetitionMandatory||r instanceof br.RepetitionMandatoryWithSeparator||r instanceof br.RepetitionWithSeparator||r instanceof br.Terminal||r instanceof br.Rule}Mi.isSequenceProd=cIe;function Yv(r,e){e===void 0&&(e=[]);var t=r instanceof br.Option||r instanceof br.Repetition||r instanceof br.RepetitionWithSeparator;return t?!0:r instanceof br.Alternation?(0,Sd.some)(r.definition,function(i){return Yv(i,e)}):r instanceof br.NonTerminal&&(0,Sd.contains)(e,r)?!1:r instanceof br.AbstractProduction?(r instanceof br.NonTerminal&&e.push(r),(0,Sd.every)(r.definition,function(i){return Yv(i,e)})):!1}Mi.isOptionalProd=Yv;function uIe(r){return r instanceof br.Alternation}Mi.isBranchingProd=uIe;function gIe(r){if(r instanceof br.NonTerminal)return\"SUBRULE\";if(r instanceof br.Option)return\"OPTION\";if(r instanceof br.Alternation)return\"OR\";if(r instanceof br.RepetitionMandatory)return\"AT_LEAST_ONE\";if(r instanceof br.RepetitionMandatoryWithSeparator)return\"AT_LEAST_ONE_SEP\";if(r instanceof br.RepetitionWithSeparator)return\"MANY_SEP\";if(r instanceof br.Repetition)return\"MANY\";if(r instanceof br.Terminal)return\"CONSUME\";throw Error(\"non exhaustive match\")}Mi.getProductionDslName=gIe;var Lj=function(r){AIe(e,r);function e(){var t=r!==null&&r.apply(this,arguments)||this;return t.separator=\"-\",t.dslMethods={option:[],alternation:[],repetition:[],repetitionWithSeparator:[],repetitionMandatory:[],repetitionMandatoryWithSeparator:[]},t}return e.prototype.reset=function(){this.dslMethods={option:[],alternation:[],repetition:[],repetitionWithSeparator:[],repetitionMandatory:[],repetitionMandatoryWithSeparator:[]}},e.prototype.visitTerminal=function(t){var i=t.terminalType.name+this.separator+\"Terminal\";(0,Sd.has)(this.dslMethods,i)||(this.dslMethods[i]=[]),this.dslMethods[i].push(t)},e.prototype.visitNonTerminal=function(t){var i=t.nonTerminalName+this.separator+\"Terminal\";(0,Sd.has)(this.dslMethods,i)||(this.dslMethods[i]=[]),this.dslMethods[i].push(t)},e.prototype.visitOption=function(t){this.dslMethods.option.push(t)},e.prototype.visitRepetitionWithSeparator=function(t){this.dslMethods.repetitionWithSeparator.push(t)},e.prototype.visitRepetitionMandatory=function(t){this.dslMethods.repetitionMandatory.push(t)},e.prototype.visitRepetitionMandatoryWithSeparator=function(t){this.dslMethods.repetitionMandatoryWithSeparator.push(t)},e.prototype.visitRepetition=function(t){this.dslMethods.repetition.push(t)},e.prototype.visitAlternation=function(t){this.dslMethods.alternation.push(t)},e}(lIe.GAstVisitor);Mi.DslMethodsCollectorVisitor=Lj;var cy=new Lj;function fIe(r){cy.reset(),r.accept(cy);var e=cy.dslMethods;return cy.reset(),e}Mi.collectMethods=fIe});var qv=w(No=>{\"use strict\";Object.defineProperty(No,\"__esModule\",{value:!0});No.firstForTerminal=No.firstForBranching=No.firstForSequence=No.first=void 0;var uy=Gt(),Oj=mn(),jv=vd();function gy(r){if(r instanceof Oj.NonTerminal)return gy(r.referencedRule);if(r instanceof Oj.Terminal)return Uj(r);if((0,jv.isSequenceProd)(r))return Mj(r);if((0,jv.isBranchingProd)(r))return Kj(r);throw Error(\"non exhaustive match\")}No.first=gy;function Mj(r){for(var e=[],t=r.definition,i=0,n=t.length>i,s,o=!0;n&&o;)s=t[i],o=(0,jv.isOptionalProd)(s),e=e.concat(gy(s)),i=i+1,n=t.length>i;return(0,uy.uniq)(e)}No.firstForSequence=Mj;function Kj(r){var e=(0,uy.map)(r.definition,function(t){return gy(t)});return(0,uy.uniq)((0,uy.flatten)(e))}No.firstForBranching=Kj;function Uj(r){return[r.terminalType]}No.firstForTerminal=Uj});var Jv=w(fy=>{\"use strict\";Object.defineProperty(fy,\"__esModule\",{value:!0});fy.IN=void 0;fy.IN=\"_~IN~_\"});var qj=w(fs=>{\"use strict\";var hIe=fs&&fs.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(fs,\"__esModule\",{value:!0});fs.buildInProdFollowPrefix=fs.buildBetweenProdsFollowPrefix=fs.computeAllProdsFollows=fs.ResyncFollowsWalker=void 0;var pIe=Ay(),dIe=qv(),Hj=Gt(),Gj=Jv(),CIe=mn(),Yj=function(r){hIe(e,r);function e(t){var i=r.call(this)||this;return i.topProd=t,i.follows={},i}return e.prototype.startWalking=function(){return this.walk(this.topProd),this.follows},e.prototype.walkTerminal=function(t,i,n){},e.prototype.walkProdRef=function(t,i,n){var s=jj(t.referencedRule,t.idx)+this.topProd.name,o=i.concat(n),a=new CIe.Alternative({definition:o}),l=(0,dIe.first)(a);this.follows[s]=l},e}(pIe.RestWalker);fs.ResyncFollowsWalker=Yj;function mIe(r){var e={};return(0,Hj.forEach)(r,function(t){var i=new Yj(t).startWalking();(0,Hj.assign)(e,i)}),e}fs.computeAllProdsFollows=mIe;function jj(r,e){return r.name+e+Gj.IN}fs.buildBetweenProdsFollowPrefix=jj;function EIe(r){var e=r.terminalType.name;return e+r.idx+Gj.IN}fs.buildInProdFollowPrefix=EIe});var xd=w(Da=>{\"use strict\";Object.defineProperty(Da,\"__esModule\",{value:!0});Da.defaultGrammarValidatorErrorProvider=Da.defaultGrammarResolverErrorProvider=Da.defaultParserErrorProvider=void 0;var ef=TA(),IIe=Gt(),eo=Gt(),Wv=mn(),Jj=vd();Da.defaultParserErrorProvider={buildMismatchTokenMessage:function(r){var e=r.expected,t=r.actual,i=r.previous,n=r.ruleName,s=(0,ef.hasTokenLabel)(e),o=s?\"--> \"+(0,ef.tokenLabel)(e)+\" <--\":\"token of type --> \"+e.name+\" <--\",a=\"Expecting \"+o+\" but found --> '\"+t.image+\"' <--\";return a},buildNotAllInputParsedMessage:function(r){var e=r.firstRedundant,t=r.ruleName;return\"Redundant input, expecting EOF but found: \"+e.image},buildNoViableAltMessage:function(r){var e=r.expectedPathsPerAlt,t=r.actual,i=r.previous,n=r.customUserDescription,s=r.ruleName,o=\"Expecting: \",a=(0,eo.first)(t).image,l=`\nbut found: '`+a+\"'\";if(n)return o+n+l;var c=(0,eo.reduce)(e,function(h,p){return h.concat(p)},[]),u=(0,eo.map)(c,function(h){return\"[\"+(0,eo.map)(h,function(p){return(0,ef.tokenLabel)(p)}).join(\", \")+\"]\"}),g=(0,eo.map)(u,function(h,p){return\" \"+(p+1)+\". \"+h}),f=`one of these possible Token sequences:\n`+g.join(`\n`);return o+f+l},buildEarlyExitMessage:function(r){var e=r.expectedIterationPaths,t=r.actual,i=r.customUserDescription,n=r.ruleName,s=\"Expecting: \",o=(0,eo.first)(t).image,a=`\nbut found: '`+o+\"'\";if(i)return s+i+a;var l=(0,eo.map)(e,function(u){return\"[\"+(0,eo.map)(u,function(g){return(0,ef.tokenLabel)(g)}).join(\",\")+\"]\"}),c=`expecting at least one iteration which starts with one of these possible Token sequences::\n `+(\"<\"+l.join(\" ,\")+\">\");return s+c+a}};Object.freeze(Da.defaultParserErrorProvider);Da.defaultGrammarResolverErrorProvider={buildRuleNotFoundError:function(r,e){var t=\"Invalid grammar, reference to a rule which is not defined: ->\"+e.nonTerminalName+`<-\ninside top level rule: ->`+r.name+\"<-\";return t}};Da.defaultGrammarValidatorErrorProvider={buildDuplicateFoundError:function(r,e){function t(u){return u instanceof Wv.Terminal?u.terminalType.name:u instanceof Wv.NonTerminal?u.nonTerminalName:\"\"}var i=r.name,n=(0,eo.first)(e),s=n.idx,o=(0,Jj.getProductionDslName)(n),a=t(n),l=s>0,c=\"->\"+o+(l?s:\"\")+\"<- \"+(a?\"with argument: ->\"+a+\"<-\":\"\")+`\n appears more than once (`+e.length+\" times) in the top level rule: ->\"+i+`<-. \n For further details see: https://chevrotain.io/docs/FAQ.html#NUMERICAL_SUFFIXES \n `;return c=c.replace(/[ \\t]+/g,\" \"),c=c.replace(/\\s\\s+/g,`\n`),c},buildNamespaceConflictError:function(r){var e=`Namespace conflict found in grammar.\n`+(\"The grammar has both a Terminal(Token) and a Non-Terminal(Rule) named: <\"+r.name+`>.\n`)+`To resolve this make sure each Terminal and Non-Terminal names are unique\nThis is easy to accomplish by using the convention that Terminal names start with an uppercase letter\nand Non-Terminal names start with a lower case letter.`;return e},buildAlternationPrefixAmbiguityError:function(r){var e=(0,eo.map)(r.prefixPath,function(n){return(0,ef.tokenLabel)(n)}).join(\", \"),t=r.alternation.idx===0?\"\":r.alternation.idx,i=\"Ambiguous alternatives: <\"+r.ambiguityIndices.join(\" ,\")+`> due to common lookahead prefix\n`+(\"in inside <\"+r.topLevelRule.name+`> Rule,\n`)+(\"<\"+e+`> may appears as a prefix path in all these alternatives.\n`)+`See: https://chevrotain.io/docs/guide/resolving_grammar_errors.html#COMMON_PREFIX\nFor Further details.`;return i},buildAlternationAmbiguityError:function(r){var e=(0,eo.map)(r.prefixPath,function(n){return(0,ef.tokenLabel)(n)}).join(\", \"),t=r.alternation.idx===0?\"\":r.alternation.idx,i=\"Ambiguous Alternatives Detected: <\"+r.ambiguityIndices.join(\" ,\")+\"> in \"+(\" inside <\"+r.topLevelRule.name+`> Rule,\n`)+(\"<\"+e+`> may appears as a prefix path in all these alternatives.\n`);return i=i+`See: https://chevrotain.io/docs/guide/resolving_grammar_errors.html#AMBIGUOUS_ALTERNATIVES\nFor Further details.`,i},buildEmptyRepetitionError:function(r){var e=(0,Jj.getProductionDslName)(r.repetition);r.repetition.idx!==0&&(e+=r.repetition.idx);var t=\"The repetition <\"+e+\"> within Rule <\"+r.topLevelRule.name+`> can never consume any tokens.\nThis could lead to an infinite loop.`;return t},buildTokenNameError:function(r){return\"deprecated\"},buildEmptyAlternationError:function(r){var e=\"Ambiguous empty alternative: <\"+(r.emptyChoiceIdx+1)+\">\"+(\" in inside <\"+r.topLevelRule.name+`> Rule.\n`)+\"Only the last alternative may be an empty alternative.\";return e},buildTooManyAlternativesError:function(r){var e=`An Alternation cannot have more than 256 alternatives:\n`+(\" inside <\"+r.topLevelRule.name+`> Rule.\n has `+(r.alternation.definition.length+1)+\" alternatives.\");return e},buildLeftRecursionError:function(r){var e=r.topLevelRule.name,t=IIe.map(r.leftRecursionPath,function(s){return s.name}),i=e+\" --> \"+t.concat([e]).join(\" --> \"),n=`Left Recursion found in grammar.\n`+(\"rule: <\"+e+`> can be invoked from itself (directly or indirectly)\n`)+(`without consuming any Tokens. The grammar path that causes this is: \n `+i+`\n`)+` To fix this refactor your grammar to remove the left recursion.\nsee: https://en.wikipedia.org/wiki/LL_parser#Left_Factoring.`;return n},buildInvalidRuleNameError:function(r){return\"deprecated\"},buildDuplicateRuleNameError:function(r){var e;r.topLevelRule instanceof Wv.Rule?e=r.topLevelRule.name:e=r.topLevelRule;var t=\"Duplicate definition, rule: ->\"+e+\"<- is already defined in the grammar: ->\"+r.grammarName+\"<-\";return t}}});var Vj=w(LA=>{\"use strict\";var yIe=LA&&LA.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(LA,\"__esModule\",{value:!0});LA.GastRefResolverVisitor=LA.resolveGrammar=void 0;var wIe=jn(),Wj=Gt(),BIe=$g();function bIe(r,e){var t=new zj(r,e);return t.resolveRefs(),t.errors}LA.resolveGrammar=bIe;var zj=function(r){yIe(e,r);function e(t,i){var n=r.call(this)||this;return n.nameToTopRule=t,n.errMsgProvider=i,n.errors=[],n}return e.prototype.resolveRefs=function(){var t=this;(0,Wj.forEach)((0,Wj.values)(this.nameToTopRule),function(i){t.currTopLevel=i,i.accept(t)})},e.prototype.visitNonTerminal=function(t){var i=this.nameToTopRule[t.nonTerminalName];if(i)t.referencedRule=i;else{var n=this.errMsgProvider.buildRuleNotFoundError(this.currTopLevel,t);this.errors.push({message:n,type:wIe.ParserDefinitionErrorType.UNRESOLVED_SUBRULE_REF,ruleName:this.currTopLevel.name,unresolvedRefName:t.nonTerminalName})}},e}(BIe.GAstVisitor);LA.GastRefResolverVisitor=zj});var Dd=w(Nr=>{\"use strict\";var mc=Nr&&Nr.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(Nr,\"__esModule\",{value:!0});Nr.nextPossibleTokensAfter=Nr.possiblePathsFrom=Nr.NextTerminalAfterAtLeastOneSepWalker=Nr.NextTerminalAfterAtLeastOneWalker=Nr.NextTerminalAfterManySepWalker=Nr.NextTerminalAfterManyWalker=Nr.AbstractNextTerminalAfterProductionWalker=Nr.NextAfterTokenWalker=Nr.AbstractNextPossibleTokensWalker=void 0;var Xj=Ay(),Kt=Gt(),QIe=qv(),kt=mn(),Zj=function(r){mc(e,r);function e(t,i){var n=r.call(this)||this;return n.topProd=t,n.path=i,n.possibleTokTypes=[],n.nextProductionName=\"\",n.nextProductionOccurrence=0,n.found=!1,n.isAtEndOfPath=!1,n}return e.prototype.startWalking=function(){if(this.found=!1,this.path.ruleStack[0]!==this.topProd.name)throw Error(\"The path does not start with the walker's top Rule!\");return this.ruleStack=(0,Kt.cloneArr)(this.path.ruleStack).reverse(),this.occurrenceStack=(0,Kt.cloneArr)(this.path.occurrenceStack).reverse(),this.ruleStack.pop(),this.occurrenceStack.pop(),this.updateExpectedNext(),this.walk(this.topProd),this.possibleTokTypes},e.prototype.walk=function(t,i){i===void 0&&(i=[]),this.found||r.prototype.walk.call(this,t,i)},e.prototype.walkProdRef=function(t,i,n){if(t.referencedRule.name===this.nextProductionName&&t.idx===this.nextProductionOccurrence){var s=i.concat(n);this.updateExpectedNext(),this.walk(t.referencedRule,s)}},e.prototype.updateExpectedNext=function(){(0,Kt.isEmpty)(this.ruleStack)?(this.nextProductionName=\"\",this.nextProductionOccurrence=0,this.isAtEndOfPath=!0):(this.nextProductionName=this.ruleStack.pop(),this.nextProductionOccurrence=this.occurrenceStack.pop())},e}(Xj.RestWalker);Nr.AbstractNextPossibleTokensWalker=Zj;var SIe=function(r){mc(e,r);function e(t,i){var n=r.call(this,t,i)||this;return n.path=i,n.nextTerminalName=\"\",n.nextTerminalOccurrence=0,n.nextTerminalName=n.path.lastTok.name,n.nextTerminalOccurrence=n.path.lastTokOccurrence,n}return e.prototype.walkTerminal=function(t,i,n){if(this.isAtEndOfPath&&t.terminalType.name===this.nextTerminalName&&t.idx===this.nextTerminalOccurrence&&!this.found){var s=i.concat(n),o=new kt.Alternative({definition:s});this.possibleTokTypes=(0,QIe.first)(o),this.found=!0}},e}(Zj);Nr.NextAfterTokenWalker=SIe;var Pd=function(r){mc(e,r);function e(t,i){var n=r.call(this)||this;return n.topRule=t,n.occurrence=i,n.result={token:void 0,occurrence:void 0,isEndOfRule:void 0},n}return e.prototype.startWalking=function(){return this.walk(this.topRule),this.result},e}(Xj.RestWalker);Nr.AbstractNextTerminalAfterProductionWalker=Pd;var vIe=function(r){mc(e,r);function e(){return r!==null&&r.apply(this,arguments)||this}return e.prototype.walkMany=function(t,i,n){if(t.idx===this.occurrence){var s=(0,Kt.first)(i.concat(n));this.result.isEndOfRule=s===void 0,s instanceof kt.Terminal&&(this.result.token=s.terminalType,this.result.occurrence=s.idx)}else r.prototype.walkMany.call(this,t,i,n)},e}(Pd);Nr.NextTerminalAfterManyWalker=vIe;var xIe=function(r){mc(e,r);function e(){return r!==null&&r.apply(this,arguments)||this}return e.prototype.walkManySep=function(t,i,n){if(t.idx===this.occurrence){var s=(0,Kt.first)(i.concat(n));this.result.isEndOfRule=s===void 0,s instanceof kt.Terminal&&(this.result.token=s.terminalType,this.result.occurrence=s.idx)}else r.prototype.walkManySep.call(this,t,i,n)},e}(Pd);Nr.NextTerminalAfterManySepWalker=xIe;var PIe=function(r){mc(e,r);function e(){return r!==null&&r.apply(this,arguments)||this}return e.prototype.walkAtLeastOne=function(t,i,n){if(t.idx===this.occurrence){var s=(0,Kt.first)(i.concat(n));this.result.isEndOfRule=s===void 0,s instanceof kt.Terminal&&(this.result.token=s.terminalType,this.result.occurrence=s.idx)}else r.prototype.walkAtLeastOne.call(this,t,i,n)},e}(Pd);Nr.NextTerminalAfterAtLeastOneWalker=PIe;var DIe=function(r){mc(e,r);function e(){return r!==null&&r.apply(this,arguments)||this}return e.prototype.walkAtLeastOneSep=function(t,i,n){if(t.idx===this.occurrence){var s=(0,Kt.first)(i.concat(n));this.result.isEndOfRule=s===void 0,s instanceof kt.Terminal&&(this.result.token=s.terminalType,this.result.occurrence=s.idx)}else r.prototype.walkAtLeastOneSep.call(this,t,i,n)},e}(Pd);Nr.NextTerminalAfterAtLeastOneSepWalker=DIe;function _j(r,e,t){t===void 0&&(t=[]),t=(0,Kt.cloneArr)(t);var i=[],n=0;function s(c){return c.concat((0,Kt.drop)(r,n+1))}function o(c){var u=_j(s(c),e,t);return i.concat(u)}for(;t.length=0;ge--){var re=B.definition[ge],O={idx:p,def:re.definition.concat((0,Kt.drop)(h)),ruleStack:C,occurrenceStack:y};g.push(O),g.push(o)}else if(B instanceof kt.Alternative)g.push({idx:p,def:B.definition.concat((0,Kt.drop)(h)),ruleStack:C,occurrenceStack:y});else if(B instanceof kt.Rule)g.push(RIe(B,p,C,y));else throw Error(\"non exhaustive match\")}}return u}Nr.nextPossibleTokensAfter=kIe;function RIe(r,e,t,i){var n=(0,Kt.cloneArr)(t);n.push(r.name);var s=(0,Kt.cloneArr)(i);return s.push(1),{idx:e,def:r.definition,ruleStack:n,occurrenceStack:s}}});var kd=w(Zt=>{\"use strict\";var tq=Zt&&Zt.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(Zt,\"__esModule\",{value:!0});Zt.areTokenCategoriesNotUsed=Zt.isStrictPrefixOfPath=Zt.containsPath=Zt.getLookaheadPathsForOptionalProd=Zt.getLookaheadPathsForOr=Zt.lookAheadSequenceFromAlternatives=Zt.buildSingleAlternativeLookaheadFunction=Zt.buildAlternativesLookAheadFunc=Zt.buildLookaheadFuncForOptionalProd=Zt.buildLookaheadFuncForOr=Zt.getProdType=Zt.PROD_TYPE=void 0;var sr=Gt(),$j=Dd(),FIe=Ay(),hy=_g(),OA=mn(),NIe=$g(),oi;(function(r){r[r.OPTION=0]=\"OPTION\",r[r.REPETITION=1]=\"REPETITION\",r[r.REPETITION_MANDATORY=2]=\"REPETITION_MANDATORY\",r[r.REPETITION_MANDATORY_WITH_SEPARATOR=3]=\"REPETITION_MANDATORY_WITH_SEPARATOR\",r[r.REPETITION_WITH_SEPARATOR=4]=\"REPETITION_WITH_SEPARATOR\",r[r.ALTERNATION=5]=\"ALTERNATION\"})(oi=Zt.PROD_TYPE||(Zt.PROD_TYPE={}));function TIe(r){if(r instanceof OA.Option)return oi.OPTION;if(r instanceof OA.Repetition)return oi.REPETITION;if(r instanceof OA.RepetitionMandatory)return oi.REPETITION_MANDATORY;if(r instanceof OA.RepetitionMandatoryWithSeparator)return oi.REPETITION_MANDATORY_WITH_SEPARATOR;if(r instanceof OA.RepetitionWithSeparator)return oi.REPETITION_WITH_SEPARATOR;if(r instanceof OA.Alternation)return oi.ALTERNATION;throw Error(\"non exhaustive match\")}Zt.getProdType=TIe;function LIe(r,e,t,i,n,s){var o=iq(r,e,t),a=Xv(o)?hy.tokenStructuredMatcherNoCategories:hy.tokenStructuredMatcher;return s(o,i,a,n)}Zt.buildLookaheadFuncForOr=LIe;function OIe(r,e,t,i,n,s){var o=nq(r,e,n,t),a=Xv(o)?hy.tokenStructuredMatcherNoCategories:hy.tokenStructuredMatcher;return s(o[0],a,i)}Zt.buildLookaheadFuncForOptionalProd=OIe;function MIe(r,e,t,i){var n=r.length,s=(0,sr.every)(r,function(l){return(0,sr.every)(l,function(c){return c.length===1})});if(e)return function(l){for(var c=(0,sr.map)(l,function(D){return D.GATE}),u=0;u{\"use strict\";var Zv=Vt&&Vt.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(Vt,\"__esModule\",{value:!0});Vt.checkPrefixAlternativesAmbiguities=Vt.validateSomeNonEmptyLookaheadPath=Vt.validateTooManyAlts=Vt.RepetionCollector=Vt.validateAmbiguousAlternationAlternatives=Vt.validateEmptyOrAlternative=Vt.getFirstNoneTerminal=Vt.validateNoLeftRecursion=Vt.validateRuleIsOverridden=Vt.validateRuleDoesNotAlreadyExist=Vt.OccurrenceValidationCollector=Vt.identifyProductionForDuplicates=Vt.validateGrammar=void 0;var er=Gt(),Qr=Gt(),To=jn(),_v=vd(),tf=kd(),YIe=Dd(),to=mn(),$v=$g();function jIe(r,e,t,i,n){var s=er.map(r,function(h){return qIe(h,i)}),o=er.map(r,function(h){return ex(h,h,i)}),a=[],l=[],c=[];(0,Qr.every)(o,Qr.isEmpty)&&(a=(0,Qr.map)(r,function(h){return cq(h,i)}),l=(0,Qr.map)(r,function(h){return uq(h,e,i)}),c=hq(r,e,i));var u=zIe(r,t,i),g=(0,Qr.map)(r,function(h){return fq(h,i)}),f=(0,Qr.map)(r,function(h){return lq(h,r,n,i)});return er.flatten(s.concat(c,o,a,l,u,g,f))}Vt.validateGrammar=jIe;function qIe(r,e){var t=new Aq;r.accept(t);var i=t.allProductions,n=er.groupBy(i,oq),s=er.pick(n,function(a){return a.length>1}),o=er.map(er.values(s),function(a){var l=er.first(a),c=e.buildDuplicateFoundError(r,a),u=(0,_v.getProductionDslName)(l),g={message:c,type:To.ParserDefinitionErrorType.DUPLICATE_PRODUCTIONS,ruleName:r.name,dslName:u,occurrence:l.idx},f=aq(l);return f&&(g.parameter=f),g});return o}function oq(r){return(0,_v.getProductionDslName)(r)+\"_#_\"+r.idx+\"_#_\"+aq(r)}Vt.identifyProductionForDuplicates=oq;function aq(r){return r instanceof to.Terminal?r.terminalType.name:r instanceof to.NonTerminal?r.nonTerminalName:\"\"}var Aq=function(r){Zv(e,r);function e(){var t=r!==null&&r.apply(this,arguments)||this;return t.allProductions=[],t}return e.prototype.visitNonTerminal=function(t){this.allProductions.push(t)},e.prototype.visitOption=function(t){this.allProductions.push(t)},e.prototype.visitRepetitionWithSeparator=function(t){this.allProductions.push(t)},e.prototype.visitRepetitionMandatory=function(t){this.allProductions.push(t)},e.prototype.visitRepetitionMandatoryWithSeparator=function(t){this.allProductions.push(t)},e.prototype.visitRepetition=function(t){this.allProductions.push(t)},e.prototype.visitAlternation=function(t){this.allProductions.push(t)},e.prototype.visitTerminal=function(t){this.allProductions.push(t)},e}($v.GAstVisitor);Vt.OccurrenceValidationCollector=Aq;function lq(r,e,t,i){var n=[],s=(0,Qr.reduce)(e,function(a,l){return l.name===r.name?a+1:a},0);if(s>1){var o=i.buildDuplicateRuleNameError({topLevelRule:r,grammarName:t});n.push({message:o,type:To.ParserDefinitionErrorType.DUPLICATE_RULE_NAME,ruleName:r.name})}return n}Vt.validateRuleDoesNotAlreadyExist=lq;function JIe(r,e,t){var i=[],n;return er.contains(e,r)||(n=\"Invalid rule override, rule: ->\"+r+\"<- cannot be overridden in the grammar: ->\"+t+\"<-as it is not defined in any of the super grammars \",i.push({message:n,type:To.ParserDefinitionErrorType.INVALID_RULE_OVERRIDE,ruleName:r})),i}Vt.validateRuleIsOverridden=JIe;function ex(r,e,t,i){i===void 0&&(i=[]);var n=[],s=Rd(e.definition);if(er.isEmpty(s))return[];var o=r.name,a=er.contains(s,r);a&&n.push({message:t.buildLeftRecursionError({topLevelRule:r,leftRecursionPath:i}),type:To.ParserDefinitionErrorType.LEFT_RECURSION,ruleName:o});var l=er.difference(s,i.concat([r])),c=er.map(l,function(u){var g=er.cloneArr(i);return g.push(u),ex(r,u,t,g)});return n.concat(er.flatten(c))}Vt.validateNoLeftRecursion=ex;function Rd(r){var e=[];if(er.isEmpty(r))return e;var t=er.first(r);if(t instanceof to.NonTerminal)e.push(t.referencedRule);else if(t instanceof to.Alternative||t instanceof to.Option||t instanceof to.RepetitionMandatory||t instanceof to.RepetitionMandatoryWithSeparator||t instanceof to.RepetitionWithSeparator||t instanceof to.Repetition)e=e.concat(Rd(t.definition));else if(t instanceof to.Alternation)e=er.flatten(er.map(t.definition,function(o){return Rd(o.definition)}));else if(!(t instanceof to.Terminal))throw Error(\"non exhaustive match\");var i=(0,_v.isOptionalProd)(t),n=r.length>1;if(i&&n){var s=er.drop(r);return e.concat(Rd(s))}else return e}Vt.getFirstNoneTerminal=Rd;var tx=function(r){Zv(e,r);function e(){var t=r!==null&&r.apply(this,arguments)||this;return t.alternations=[],t}return e.prototype.visitAlternation=function(t){this.alternations.push(t)},e}($v.GAstVisitor);function cq(r,e){var t=new tx;r.accept(t);var i=t.alternations,n=er.reduce(i,function(s,o){var a=er.dropRight(o.definition),l=er.map(a,function(c,u){var g=(0,YIe.nextPossibleTokensAfter)([c],[],null,1);return er.isEmpty(g)?{message:e.buildEmptyAlternationError({topLevelRule:r,alternation:o,emptyChoiceIdx:u}),type:To.ParserDefinitionErrorType.NONE_LAST_EMPTY_ALT,ruleName:r.name,occurrence:o.idx,alternative:u+1}:null});return s.concat(er.compact(l))},[]);return n}Vt.validateEmptyOrAlternative=cq;function uq(r,e,t){var i=new tx;r.accept(i);var n=i.alternations;n=(0,Qr.reject)(n,function(o){return o.ignoreAmbiguities===!0});var s=er.reduce(n,function(o,a){var l=a.idx,c=a.maxLookahead||e,u=(0,tf.getLookaheadPathsForOr)(l,r,c,a),g=WIe(u,a,r,t),f=pq(u,a,r,t);return o.concat(g,f)},[]);return s}Vt.validateAmbiguousAlternationAlternatives=uq;var gq=function(r){Zv(e,r);function e(){var t=r!==null&&r.apply(this,arguments)||this;return t.allProductions=[],t}return e.prototype.visitRepetitionWithSeparator=function(t){this.allProductions.push(t)},e.prototype.visitRepetitionMandatory=function(t){this.allProductions.push(t)},e.prototype.visitRepetitionMandatoryWithSeparator=function(t){this.allProductions.push(t)},e.prototype.visitRepetition=function(t){this.allProductions.push(t)},e}($v.GAstVisitor);Vt.RepetionCollector=gq;function fq(r,e){var t=new tx;r.accept(t);var i=t.alternations,n=er.reduce(i,function(s,o){return o.definition.length>255&&s.push({message:e.buildTooManyAlternativesError({topLevelRule:r,alternation:o}),type:To.ParserDefinitionErrorType.TOO_MANY_ALTS,ruleName:r.name,occurrence:o.idx}),s},[]);return n}Vt.validateTooManyAlts=fq;function hq(r,e,t){var i=[];return(0,Qr.forEach)(r,function(n){var s=new gq;n.accept(s);var o=s.allProductions;(0,Qr.forEach)(o,function(a){var l=(0,tf.getProdType)(a),c=a.maxLookahead||e,u=a.idx,g=(0,tf.getLookaheadPathsForOptionalProd)(u,n,l,c),f=g[0];if((0,Qr.isEmpty)((0,Qr.flatten)(f))){var h=t.buildEmptyRepetitionError({topLevelRule:n,repetition:a});i.push({message:h,type:To.ParserDefinitionErrorType.NO_NON_EMPTY_LOOKAHEAD,ruleName:n.name})}})}),i}Vt.validateSomeNonEmptyLookaheadPath=hq;function WIe(r,e,t,i){var n=[],s=(0,Qr.reduce)(r,function(a,l,c){return e.definition[c].ignoreAmbiguities===!0||(0,Qr.forEach)(l,function(u){var g=[c];(0,Qr.forEach)(r,function(f,h){c!==h&&(0,tf.containsPath)(f,u)&&e.definition[h].ignoreAmbiguities!==!0&&g.push(h)}),g.length>1&&!(0,tf.containsPath)(n,u)&&(n.push(u),a.push({alts:g,path:u}))}),a},[]),o=er.map(s,function(a){var l=(0,Qr.map)(a.alts,function(u){return u+1}),c=i.buildAlternationAmbiguityError({topLevelRule:t,alternation:e,ambiguityIndices:l,prefixPath:a.path});return{message:c,type:To.ParserDefinitionErrorType.AMBIGUOUS_ALTS,ruleName:t.name,occurrence:e.idx,alternatives:[a.alts]}});return o}function pq(r,e,t,i){var n=[],s=(0,Qr.reduce)(r,function(o,a,l){var c=(0,Qr.map)(a,function(u){return{idx:l,path:u}});return o.concat(c)},[]);return(0,Qr.forEach)(s,function(o){var a=e.definition[o.idx];if(a.ignoreAmbiguities!==!0){var l=o.idx,c=o.path,u=(0,Qr.findAll)(s,function(f){return e.definition[f.idx].ignoreAmbiguities!==!0&&f.idx{\"use strict\";Object.defineProperty(rf,\"__esModule\",{value:!0});rf.validateGrammar=rf.resolveGrammar=void 0;var ix=Gt(),VIe=Vj(),XIe=rx(),dq=xd();function ZIe(r){r=(0,ix.defaults)(r,{errMsgProvider:dq.defaultGrammarResolverErrorProvider});var e={};return(0,ix.forEach)(r.rules,function(t){e[t.name]=t}),(0,VIe.resolveGrammar)(e,r.errMsgProvider)}rf.resolveGrammar=ZIe;function _Ie(r){return r=(0,ix.defaults)(r,{errMsgProvider:dq.defaultGrammarValidatorErrorProvider}),(0,XIe.validateGrammar)(r.rules,r.maxLookahead,r.tokenTypes,r.errMsgProvider,r.grammarName)}rf.validateGrammar=_Ie});var nf=w(In=>{\"use strict\";var Fd=In&&In.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(In,\"__esModule\",{value:!0});In.EarlyExitException=In.NotAllInputParsedException=In.NoViableAltException=In.MismatchedTokenException=In.isRecognitionException=void 0;var $Ie=Gt(),mq=\"MismatchedTokenException\",Eq=\"NoViableAltException\",Iq=\"EarlyExitException\",yq=\"NotAllInputParsedException\",wq=[mq,Eq,Iq,yq];Object.freeze(wq);function eye(r){return(0,$Ie.contains)(wq,r.name)}In.isRecognitionException=eye;var py=function(r){Fd(e,r);function e(t,i){var n=this.constructor,s=r.call(this,t)||this;return s.token=i,s.resyncedTokens=[],Object.setPrototypeOf(s,n.prototype),Error.captureStackTrace&&Error.captureStackTrace(s,s.constructor),s}return e}(Error),tye=function(r){Fd(e,r);function e(t,i,n){var s=r.call(this,t,i)||this;return s.previousToken=n,s.name=mq,s}return e}(py);In.MismatchedTokenException=tye;var rye=function(r){Fd(e,r);function e(t,i,n){var s=r.call(this,t,i)||this;return s.previousToken=n,s.name=Eq,s}return e}(py);In.NoViableAltException=rye;var iye=function(r){Fd(e,r);function e(t,i){var n=r.call(this,t,i)||this;return n.name=yq,n}return e}(py);In.NotAllInputParsedException=iye;var nye=function(r){Fd(e,r);function e(t,i,n){var s=r.call(this,t,i)||this;return s.previousToken=n,s.name=Iq,s}return e}(py);In.EarlyExitException=nye});var sx=w(Ki=>{\"use strict\";Object.defineProperty(Ki,\"__esModule\",{value:!0});Ki.attemptInRepetitionRecovery=Ki.Recoverable=Ki.InRuleRecoveryException=Ki.IN_RULE_RECOVERY_EXCEPTION=Ki.EOF_FOLLOW_KEY=void 0;var dy=TA(),hs=Gt(),sye=nf(),oye=Jv(),aye=jn();Ki.EOF_FOLLOW_KEY={};Ki.IN_RULE_RECOVERY_EXCEPTION=\"InRuleRecoveryException\";function nx(r){this.name=Ki.IN_RULE_RECOVERY_EXCEPTION,this.message=r}Ki.InRuleRecoveryException=nx;nx.prototype=Error.prototype;var Aye=function(){function r(){}return r.prototype.initRecoverable=function(e){this.firstAfterRepMap={},this.resyncFollows={},this.recoveryEnabled=(0,hs.has)(e,\"recoveryEnabled\")?e.recoveryEnabled:aye.DEFAULT_PARSER_CONFIG.recoveryEnabled,this.recoveryEnabled&&(this.attemptInRepetitionRecovery=Bq)},r.prototype.getTokenToInsert=function(e){var t=(0,dy.createTokenInstance)(e,\"\",NaN,NaN,NaN,NaN,NaN,NaN);return t.isInsertedInRecovery=!0,t},r.prototype.canTokenTypeBeInsertedInRecovery=function(e){return!0},r.prototype.tryInRepetitionRecovery=function(e,t,i,n){for(var s=this,o=this.findReSyncTokenType(),a=this.exportLexerState(),l=[],c=!1,u=this.LA(1),g=this.LA(1),f=function(){var h=s.LA(0),p=s.errorMessageProvider.buildMismatchTokenMessage({expected:n,actual:u,previous:h,ruleName:s.getCurrRuleFullName()}),C=new sye.MismatchedTokenException(p,u,s.LA(0));C.resyncedTokens=(0,hs.dropRight)(l),s.SAVE_ERROR(C)};!c;)if(this.tokenMatcher(g,n)){f();return}else if(i.call(this)){f(),e.apply(this,t);return}else this.tokenMatcher(g,o)?c=!0:(g=this.SKIP_TOKEN(),this.addToResyncTokens(g,l));this.importLexerState(a)},r.prototype.shouldInRepetitionRecoveryBeTried=function(e,t,i){return!(i===!1||e===void 0||t===void 0||this.tokenMatcher(this.LA(1),e)||this.isBackTracking()||this.canPerformInRuleRecovery(e,this.getFollowsForInRuleRecovery(e,t)))},r.prototype.getFollowsForInRuleRecovery=function(e,t){var i=this.getCurrentGrammarPath(e,t),n=this.getNextPossibleTokenTypes(i);return n},r.prototype.tryInRuleRecovery=function(e,t){if(this.canRecoverWithSingleTokenInsertion(e,t)){var i=this.getTokenToInsert(e);return i}if(this.canRecoverWithSingleTokenDeletion(e)){var n=this.SKIP_TOKEN();return this.consumeToken(),n}throw new nx(\"sad sad panda\")},r.prototype.canPerformInRuleRecovery=function(e,t){return this.canRecoverWithSingleTokenInsertion(e,t)||this.canRecoverWithSingleTokenDeletion(e)},r.prototype.canRecoverWithSingleTokenInsertion=function(e,t){var i=this;if(!this.canTokenTypeBeInsertedInRecovery(e)||(0,hs.isEmpty)(t))return!1;var n=this.LA(1),s=(0,hs.find)(t,function(o){return i.tokenMatcher(n,o)})!==void 0;return s},r.prototype.canRecoverWithSingleTokenDeletion=function(e){var t=this.tokenMatcher(this.LA(2),e);return t},r.prototype.isInCurrentRuleReSyncSet=function(e){var t=this.getCurrFollowKey(),i=this.getFollowSetFromFollowKey(t);return(0,hs.contains)(i,e)},r.prototype.findReSyncTokenType=function(){for(var e=this.flattenFollowSet(),t=this.LA(1),i=2;;){var n=t.tokenType;if((0,hs.contains)(e,n))return n;t=this.LA(i),i++}},r.prototype.getCurrFollowKey=function(){if(this.RULE_STACK.length===1)return Ki.EOF_FOLLOW_KEY;var e=this.getLastExplicitRuleShortName(),t=this.getLastExplicitRuleOccurrenceIndex(),i=this.getPreviousExplicitRuleShortName();return{ruleName:this.shortRuleNameToFullName(e),idxInCallingRule:t,inRule:this.shortRuleNameToFullName(i)}},r.prototype.buildFullFollowKeyStack=function(){var e=this,t=this.RULE_STACK,i=this.RULE_OCCURRENCE_STACK;return(0,hs.map)(t,function(n,s){return s===0?Ki.EOF_FOLLOW_KEY:{ruleName:e.shortRuleNameToFullName(n),idxInCallingRule:i[s],inRule:e.shortRuleNameToFullName(t[s-1])}})},r.prototype.flattenFollowSet=function(){var e=this,t=(0,hs.map)(this.buildFullFollowKeyStack(),function(i){return e.getFollowSetFromFollowKey(i)});return(0,hs.flatten)(t)},r.prototype.getFollowSetFromFollowKey=function(e){if(e===Ki.EOF_FOLLOW_KEY)return[dy.EOF];var t=e.ruleName+e.idxInCallingRule+oye.IN+e.inRule;return this.resyncFollows[t]},r.prototype.addToResyncTokens=function(e,t){return this.tokenMatcher(e,dy.EOF)||t.push(e),t},r.prototype.reSyncTo=function(e){for(var t=[],i=this.LA(1);this.tokenMatcher(i,e)===!1;)i=this.SKIP_TOKEN(),this.addToResyncTokens(i,t);return(0,hs.dropRight)(t)},r.prototype.attemptInRepetitionRecovery=function(e,t,i,n,s,o,a){},r.prototype.getCurrentGrammarPath=function(e,t){var i=this.getHumanReadableRuleStack(),n=(0,hs.cloneArr)(this.RULE_OCCURRENCE_STACK),s={ruleStack:i,occurrenceStack:n,lastTok:e,lastTokOccurrence:t};return s},r.prototype.getHumanReadableRuleStack=function(){var e=this;return(0,hs.map)(this.RULE_STACK,function(t){return e.shortRuleNameToFullName(t)})},r}();Ki.Recoverable=Aye;function Bq(r,e,t,i,n,s,o){var a=this.getKeyForAutomaticLookahead(i,n),l=this.firstAfterRepMap[a];if(l===void 0){var c=this.getCurrRuleFullName(),u=this.getGAstProductions()[c],g=new s(u,n);l=g.startWalking(),this.firstAfterRepMap[a]=l}var f=l.token,h=l.occurrence,p=l.isEndOfRule;this.RULE_STACK.length===1&&p&&f===void 0&&(f=dy.EOF,h=1),this.shouldInRepetitionRecoveryBeTried(f,h,o)&&this.tryInRepetitionRecovery(r,e,t,f)}Ki.attemptInRepetitionRecovery=Bq});var Cy=w(Jt=>{\"use strict\";Object.defineProperty(Jt,\"__esModule\",{value:!0});Jt.getKeyForAutomaticLookahead=Jt.AT_LEAST_ONE_SEP_IDX=Jt.MANY_SEP_IDX=Jt.AT_LEAST_ONE_IDX=Jt.MANY_IDX=Jt.OPTION_IDX=Jt.OR_IDX=Jt.BITS_FOR_ALT_IDX=Jt.BITS_FOR_RULE_IDX=Jt.BITS_FOR_OCCURRENCE_IDX=Jt.BITS_FOR_METHOD_TYPE=void 0;Jt.BITS_FOR_METHOD_TYPE=4;Jt.BITS_FOR_OCCURRENCE_IDX=8;Jt.BITS_FOR_RULE_IDX=12;Jt.BITS_FOR_ALT_IDX=8;Jt.OR_IDX=1<{\"use strict\";Object.defineProperty(my,\"__esModule\",{value:!0});my.LooksAhead=void 0;var ka=kd(),ro=Gt(),bq=jn(),Ra=Cy(),Ec=vd(),cye=function(){function r(){}return r.prototype.initLooksAhead=function(e){this.dynamicTokensEnabled=(0,ro.has)(e,\"dynamicTokensEnabled\")?e.dynamicTokensEnabled:bq.DEFAULT_PARSER_CONFIG.dynamicTokensEnabled,this.maxLookahead=(0,ro.has)(e,\"maxLookahead\")?e.maxLookahead:bq.DEFAULT_PARSER_CONFIG.maxLookahead,this.lookAheadFuncsCache=(0,ro.isES2015MapSupported)()?new Map:[],(0,ro.isES2015MapSupported)()?(this.getLaFuncFromCache=this.getLaFuncFromMap,this.setLaFuncCache=this.setLaFuncCacheUsingMap):(this.getLaFuncFromCache=this.getLaFuncFromObj,this.setLaFuncCache=this.setLaFuncUsingObj)},r.prototype.preComputeLookaheadFunctions=function(e){var t=this;(0,ro.forEach)(e,function(i){t.TRACE_INIT(i.name+\" Rule Lookahead\",function(){var n=(0,Ec.collectMethods)(i),s=n.alternation,o=n.repetition,a=n.option,l=n.repetitionMandatory,c=n.repetitionMandatoryWithSeparator,u=n.repetitionWithSeparator;(0,ro.forEach)(s,function(g){var f=g.idx===0?\"\":g.idx;t.TRACE_INIT(\"\"+(0,Ec.getProductionDslName)(g)+f,function(){var h=(0,ka.buildLookaheadFuncForOr)(g.idx,i,g.maxLookahead||t.maxLookahead,g.hasPredicates,t.dynamicTokensEnabled,t.lookAheadBuilderForAlternatives),p=(0,Ra.getKeyForAutomaticLookahead)(t.fullRuleNameToShort[i.name],Ra.OR_IDX,g.idx);t.setLaFuncCache(p,h)})}),(0,ro.forEach)(o,function(g){t.computeLookaheadFunc(i,g.idx,Ra.MANY_IDX,ka.PROD_TYPE.REPETITION,g.maxLookahead,(0,Ec.getProductionDslName)(g))}),(0,ro.forEach)(a,function(g){t.computeLookaheadFunc(i,g.idx,Ra.OPTION_IDX,ka.PROD_TYPE.OPTION,g.maxLookahead,(0,Ec.getProductionDslName)(g))}),(0,ro.forEach)(l,function(g){t.computeLookaheadFunc(i,g.idx,Ra.AT_LEAST_ONE_IDX,ka.PROD_TYPE.REPETITION_MANDATORY,g.maxLookahead,(0,Ec.getProductionDslName)(g))}),(0,ro.forEach)(c,function(g){t.computeLookaheadFunc(i,g.idx,Ra.AT_LEAST_ONE_SEP_IDX,ka.PROD_TYPE.REPETITION_MANDATORY_WITH_SEPARATOR,g.maxLookahead,(0,Ec.getProductionDslName)(g))}),(0,ro.forEach)(u,function(g){t.computeLookaheadFunc(i,g.idx,Ra.MANY_SEP_IDX,ka.PROD_TYPE.REPETITION_WITH_SEPARATOR,g.maxLookahead,(0,Ec.getProductionDslName)(g))})})})},r.prototype.computeLookaheadFunc=function(e,t,i,n,s,o){var a=this;this.TRACE_INIT(\"\"+o+(t===0?\"\":t),function(){var l=(0,ka.buildLookaheadFuncForOptionalProd)(t,e,s||a.maxLookahead,a.dynamicTokensEnabled,n,a.lookAheadBuilderForOptional),c=(0,Ra.getKeyForAutomaticLookahead)(a.fullRuleNameToShort[e.name],i,t);a.setLaFuncCache(c,l)})},r.prototype.lookAheadBuilderForOptional=function(e,t,i){return(0,ka.buildSingleAlternativeLookaheadFunction)(e,t,i)},r.prototype.lookAheadBuilderForAlternatives=function(e,t,i,n){return(0,ka.buildAlternativesLookAheadFunc)(e,t,i,n)},r.prototype.getKeyForAutomaticLookahead=function(e,t){var i=this.getLastExplicitRuleShortName();return(0,Ra.getKeyForAutomaticLookahead)(i,e,t)},r.prototype.getLaFuncFromCache=function(e){},r.prototype.getLaFuncFromMap=function(e){return this.lookAheadFuncsCache.get(e)},r.prototype.getLaFuncFromObj=function(e){return this.lookAheadFuncsCache[e]},r.prototype.setLaFuncCache=function(e,t){},r.prototype.setLaFuncCacheUsingMap=function(e,t){this.lookAheadFuncsCache.set(e,t)},r.prototype.setLaFuncUsingObj=function(e,t){this.lookAheadFuncsCache[e]=t},r}();my.LooksAhead=cye});var Sq=w(Lo=>{\"use strict\";Object.defineProperty(Lo,\"__esModule\",{value:!0});Lo.addNoneTerminalToCst=Lo.addTerminalToCst=Lo.setNodeLocationFull=Lo.setNodeLocationOnlyOffset=void 0;function uye(r,e){isNaN(r.startOffset)===!0?(r.startOffset=e.startOffset,r.endOffset=e.endOffset):r.endOffset{\"use strict\";Object.defineProperty(MA,\"__esModule\",{value:!0});MA.defineNameProp=MA.functionName=MA.classNameFromInstance=void 0;var pye=Gt();function dye(r){return xq(r.constructor)}MA.classNameFromInstance=dye;var vq=\"name\";function xq(r){var e=r.name;return e||\"anonymous\"}MA.functionName=xq;function Cye(r,e){var t=Object.getOwnPropertyDescriptor(r,vq);return(0,pye.isUndefined)(t)||t.configurable?(Object.defineProperty(r,vq,{enumerable:!1,configurable:!0,writable:!1,value:e}),!0):!1}MA.defineNameProp=Cye});var Fq=w(Si=>{\"use strict\";Object.defineProperty(Si,\"__esModule\",{value:!0});Si.validateRedundantMethods=Si.validateMissingCstMethods=Si.validateVisitor=Si.CstVisitorDefinitionError=Si.createBaseVisitorConstructorWithDefaults=Si.createBaseSemanticVisitorConstructor=Si.defaultVisit=void 0;var ps=Gt(),Nd=ox();function Pq(r,e){for(var t=(0,ps.keys)(r),i=t.length,n=0;n:\n\t`+(\"\"+s.join(`\n\n`).replace(/\\n/g,`\n\t`)))}}};return t.prototype=i,t.prototype.constructor=t,t._RULE_NAMES=e,t}Si.createBaseSemanticVisitorConstructor=mye;function Eye(r,e,t){var i=function(){};(0,Nd.defineNameProp)(i,r+\"BaseSemanticsWithDefaults\");var n=Object.create(t.prototype);return(0,ps.forEach)(e,function(s){n[s]=Pq}),i.prototype=n,i.prototype.constructor=i,i}Si.createBaseVisitorConstructorWithDefaults=Eye;var ax;(function(r){r[r.REDUNDANT_METHOD=0]=\"REDUNDANT_METHOD\",r[r.MISSING_METHOD=1]=\"MISSING_METHOD\"})(ax=Si.CstVisitorDefinitionError||(Si.CstVisitorDefinitionError={}));function Dq(r,e){var t=kq(r,e),i=Rq(r,e);return t.concat(i)}Si.validateVisitor=Dq;function kq(r,e){var t=(0,ps.map)(e,function(i){if(!(0,ps.isFunction)(r[i]))return{msg:\"Missing visitor method: <\"+i+\"> on \"+(0,Nd.functionName)(r.constructor)+\" CST Visitor.\",type:ax.MISSING_METHOD,methodName:i}});return(0,ps.compact)(t)}Si.validateMissingCstMethods=kq;var Iye=[\"constructor\",\"visit\",\"validateVisitor\"];function Rq(r,e){var t=[];for(var i in r)(0,ps.isFunction)(r[i])&&!(0,ps.contains)(Iye,i)&&!(0,ps.contains)(e,i)&&t.push({msg:\"Redundant visitor method: <\"+i+\"> on \"+(0,Nd.functionName)(r.constructor)+` CST Visitor\nThere is no Grammar Rule corresponding to this method's name.\n`,type:ax.REDUNDANT_METHOD,methodName:i});return t}Si.validateRedundantMethods=Rq});var Tq=w(Ey=>{\"use strict\";Object.defineProperty(Ey,\"__esModule\",{value:!0});Ey.TreeBuilder=void 0;var sf=Sq(),_r=Gt(),Nq=Fq(),yye=jn(),wye=function(){function r(){}return r.prototype.initTreeBuilder=function(e){if(this.CST_STACK=[],this.outputCst=e.outputCst,this.nodeLocationTracking=(0,_r.has)(e,\"nodeLocationTracking\")?e.nodeLocationTracking:yye.DEFAULT_PARSER_CONFIG.nodeLocationTracking,!this.outputCst)this.cstInvocationStateUpdate=_r.NOOP,this.cstFinallyStateUpdate=_r.NOOP,this.cstPostTerminal=_r.NOOP,this.cstPostNonTerminal=_r.NOOP,this.cstPostRule=_r.NOOP;else if(/full/i.test(this.nodeLocationTracking))this.recoveryEnabled?(this.setNodeLocationFromToken=sf.setNodeLocationFull,this.setNodeLocationFromNode=sf.setNodeLocationFull,this.cstPostRule=_r.NOOP,this.setInitialNodeLocation=this.setInitialNodeLocationFullRecovery):(this.setNodeLocationFromToken=_r.NOOP,this.setNodeLocationFromNode=_r.NOOP,this.cstPostRule=this.cstPostRuleFull,this.setInitialNodeLocation=this.setInitialNodeLocationFullRegular);else if(/onlyOffset/i.test(this.nodeLocationTracking))this.recoveryEnabled?(this.setNodeLocationFromToken=sf.setNodeLocationOnlyOffset,this.setNodeLocationFromNode=sf.setNodeLocationOnlyOffset,this.cstPostRule=_r.NOOP,this.setInitialNodeLocation=this.setInitialNodeLocationOnlyOffsetRecovery):(this.setNodeLocationFromToken=_r.NOOP,this.setNodeLocationFromNode=_r.NOOP,this.cstPostRule=this.cstPostRuleOnlyOffset,this.setInitialNodeLocation=this.setInitialNodeLocationOnlyOffsetRegular);else if(/none/i.test(this.nodeLocationTracking))this.setNodeLocationFromToken=_r.NOOP,this.setNodeLocationFromNode=_r.NOOP,this.cstPostRule=_r.NOOP,this.setInitialNodeLocation=_r.NOOP;else throw Error('Invalid config option: \"'+e.nodeLocationTracking+'\"')},r.prototype.setInitialNodeLocationOnlyOffsetRecovery=function(e){e.location={startOffset:NaN,endOffset:NaN}},r.prototype.setInitialNodeLocationOnlyOffsetRegular=function(e){e.location={startOffset:this.LA(1).startOffset,endOffset:NaN}},r.prototype.setInitialNodeLocationFullRecovery=function(e){e.location={startOffset:NaN,startLine:NaN,startColumn:NaN,endOffset:NaN,endLine:NaN,endColumn:NaN}},r.prototype.setInitialNodeLocationFullRegular=function(e){var t=this.LA(1);e.location={startOffset:t.startOffset,startLine:t.startLine,startColumn:t.startColumn,endOffset:NaN,endLine:NaN,endColumn:NaN}},r.prototype.cstInvocationStateUpdate=function(e,t){var i={name:e,children:{}};this.setInitialNodeLocation(i),this.CST_STACK.push(i)},r.prototype.cstFinallyStateUpdate=function(){this.CST_STACK.pop()},r.prototype.cstPostRuleFull=function(e){var t=this.LA(0),i=e.location;i.startOffset<=t.startOffset?(i.endOffset=t.endOffset,i.endLine=t.endLine,i.endColumn=t.endColumn):(i.startOffset=NaN,i.startLine=NaN,i.startColumn=NaN)},r.prototype.cstPostRuleOnlyOffset=function(e){var t=this.LA(0),i=e.location;i.startOffset<=t.startOffset?i.endOffset=t.endOffset:i.startOffset=NaN},r.prototype.cstPostTerminal=function(e,t){var i=this.CST_STACK[this.CST_STACK.length-1];(0,sf.addTerminalToCst)(i,t,e),this.setNodeLocationFromToken(i.location,t)},r.prototype.cstPostNonTerminal=function(e,t){var i=this.CST_STACK[this.CST_STACK.length-1];(0,sf.addNoneTerminalToCst)(i,t,e),this.setNodeLocationFromNode(i.location,e.location)},r.prototype.getBaseCstVisitorConstructor=function(){if((0,_r.isUndefined)(this.baseCstVisitorConstructor)){var e=(0,Nq.createBaseSemanticVisitorConstructor)(this.className,(0,_r.keys)(this.gastProductionsCache));return this.baseCstVisitorConstructor=e,e}return this.baseCstVisitorConstructor},r.prototype.getBaseCstVisitorConstructorWithDefaults=function(){if((0,_r.isUndefined)(this.baseCstVisitorWithDefaultsConstructor)){var e=(0,Nq.createBaseVisitorConstructorWithDefaults)(this.className,(0,_r.keys)(this.gastProductionsCache),this.getBaseCstVisitorConstructor());return this.baseCstVisitorWithDefaultsConstructor=e,e}return this.baseCstVisitorWithDefaultsConstructor},r.prototype.getLastExplicitRuleShortName=function(){var e=this.RULE_STACK;return e[e.length-1]},r.prototype.getPreviousExplicitRuleShortName=function(){var e=this.RULE_STACK;return e[e.length-2]},r.prototype.getLastExplicitRuleOccurrenceIndex=function(){var e=this.RULE_OCCURRENCE_STACK;return e[e.length-1]},r}();Ey.TreeBuilder=wye});var Oq=w(Iy=>{\"use strict\";Object.defineProperty(Iy,\"__esModule\",{value:!0});Iy.LexerAdapter=void 0;var Lq=jn(),Bye=function(){function r(){}return r.prototype.initLexerAdapter=function(){this.tokVector=[],this.tokVectorLength=0,this.currIdx=-1},Object.defineProperty(r.prototype,\"input\",{get:function(){return this.tokVector},set:function(e){if(this.selfAnalysisDone!==!0)throw Error(\"Missing invocation at the end of the Parser's constructor.\");this.reset(),this.tokVector=e,this.tokVectorLength=e.length},enumerable:!1,configurable:!0}),r.prototype.SKIP_TOKEN=function(){return this.currIdx<=this.tokVector.length-2?(this.consumeToken(),this.LA(1)):Lq.END_OF_FILE},r.prototype.LA=function(e){var t=this.currIdx+e;return t<0||this.tokVectorLength<=t?Lq.END_OF_FILE:this.tokVector[t]},r.prototype.consumeToken=function(){this.currIdx++},r.prototype.exportLexerState=function(){return this.currIdx},r.prototype.importLexerState=function(e){this.currIdx=e},r.prototype.resetLexerState=function(){this.currIdx=-1},r.prototype.moveToTerminatedState=function(){this.currIdx=this.tokVector.length-1},r.prototype.getLexerPosition=function(){return this.exportLexerState()},r}();Iy.LexerAdapter=Bye});var Kq=w(yy=>{\"use strict\";Object.defineProperty(yy,\"__esModule\",{value:!0});yy.RecognizerApi=void 0;var Mq=Gt(),bye=nf(),Ax=jn(),Qye=xd(),Sye=rx(),vye=mn(),xye=function(){function r(){}return r.prototype.ACTION=function(e){return e.call(this)},r.prototype.consume=function(e,t,i){return this.consumeInternal(t,e,i)},r.prototype.subrule=function(e,t,i){return this.subruleInternal(t,e,i)},r.prototype.option=function(e,t){return this.optionInternal(t,e)},r.prototype.or=function(e,t){return this.orInternal(t,e)},r.prototype.many=function(e,t){return this.manyInternal(e,t)},r.prototype.atLeastOne=function(e,t){return this.atLeastOneInternal(e,t)},r.prototype.CONSUME=function(e,t){return this.consumeInternal(e,0,t)},r.prototype.CONSUME1=function(e,t){return this.consumeInternal(e,1,t)},r.prototype.CONSUME2=function(e,t){return this.consumeInternal(e,2,t)},r.prototype.CONSUME3=function(e,t){return this.consumeInternal(e,3,t)},r.prototype.CONSUME4=function(e,t){return this.consumeInternal(e,4,t)},r.prototype.CONSUME5=function(e,t){return this.consumeInternal(e,5,t)},r.prototype.CONSUME6=function(e,t){return this.consumeInternal(e,6,t)},r.prototype.CONSUME7=function(e,t){return this.consumeInternal(e,7,t)},r.prototype.CONSUME8=function(e,t){return this.consumeInternal(e,8,t)},r.prototype.CONSUME9=function(e,t){return this.consumeInternal(e,9,t)},r.prototype.SUBRULE=function(e,t){return this.subruleInternal(e,0,t)},r.prototype.SUBRULE1=function(e,t){return this.subruleInternal(e,1,t)},r.prototype.SUBRULE2=function(e,t){return this.subruleInternal(e,2,t)},r.prototype.SUBRULE3=function(e,t){return this.subruleInternal(e,3,t)},r.prototype.SUBRULE4=function(e,t){return this.subruleInternal(e,4,t)},r.prototype.SUBRULE5=function(e,t){return this.subruleInternal(e,5,t)},r.prototype.SUBRULE6=function(e,t){return this.subruleInternal(e,6,t)},r.prototype.SUBRULE7=function(e,t){return this.subruleInternal(e,7,t)},r.prototype.SUBRULE8=function(e,t){return this.subruleInternal(e,8,t)},r.prototype.SUBRULE9=function(e,t){return this.subruleInternal(e,9,t)},r.prototype.OPTION=function(e){return this.optionInternal(e,0)},r.prototype.OPTION1=function(e){return this.optionInternal(e,1)},r.prototype.OPTION2=function(e){return this.optionInternal(e,2)},r.prototype.OPTION3=function(e){return this.optionInternal(e,3)},r.prototype.OPTION4=function(e){return this.optionInternal(e,4)},r.prototype.OPTION5=function(e){return this.optionInternal(e,5)},r.prototype.OPTION6=function(e){return this.optionInternal(e,6)},r.prototype.OPTION7=function(e){return this.optionInternal(e,7)},r.prototype.OPTION8=function(e){return this.optionInternal(e,8)},r.prototype.OPTION9=function(e){return this.optionInternal(e,9)},r.prototype.OR=function(e){return this.orInternal(e,0)},r.prototype.OR1=function(e){return this.orInternal(e,1)},r.prototype.OR2=function(e){return this.orInternal(e,2)},r.prototype.OR3=function(e){return this.orInternal(e,3)},r.prototype.OR4=function(e){return this.orInternal(e,4)},r.prototype.OR5=function(e){return this.orInternal(e,5)},r.prototype.OR6=function(e){return this.orInternal(e,6)},r.prototype.OR7=function(e){return this.orInternal(e,7)},r.prototype.OR8=function(e){return this.orInternal(e,8)},r.prototype.OR9=function(e){return this.orInternal(e,9)},r.prototype.MANY=function(e){this.manyInternal(0,e)},r.prototype.MANY1=function(e){this.manyInternal(1,e)},r.prototype.MANY2=function(e){this.manyInternal(2,e)},r.prototype.MANY3=function(e){this.manyInternal(3,e)},r.prototype.MANY4=function(e){this.manyInternal(4,e)},r.prototype.MANY5=function(e){this.manyInternal(5,e)},r.prototype.MANY6=function(e){this.manyInternal(6,e)},r.prototype.MANY7=function(e){this.manyInternal(7,e)},r.prototype.MANY8=function(e){this.manyInternal(8,e)},r.prototype.MANY9=function(e){this.manyInternal(9,e)},r.prototype.MANY_SEP=function(e){this.manySepFirstInternal(0,e)},r.prototype.MANY_SEP1=function(e){this.manySepFirstInternal(1,e)},r.prototype.MANY_SEP2=function(e){this.manySepFirstInternal(2,e)},r.prototype.MANY_SEP3=function(e){this.manySepFirstInternal(3,e)},r.prototype.MANY_SEP4=function(e){this.manySepFirstInternal(4,e)},r.prototype.MANY_SEP5=function(e){this.manySepFirstInternal(5,e)},r.prototype.MANY_SEP6=function(e){this.manySepFirstInternal(6,e)},r.prototype.MANY_SEP7=function(e){this.manySepFirstInternal(7,e)},r.prototype.MANY_SEP8=function(e){this.manySepFirstInternal(8,e)},r.prototype.MANY_SEP9=function(e){this.manySepFirstInternal(9,e)},r.prototype.AT_LEAST_ONE=function(e){this.atLeastOneInternal(0,e)},r.prototype.AT_LEAST_ONE1=function(e){return this.atLeastOneInternal(1,e)},r.prototype.AT_LEAST_ONE2=function(e){this.atLeastOneInternal(2,e)},r.prototype.AT_LEAST_ONE3=function(e){this.atLeastOneInternal(3,e)},r.prototype.AT_LEAST_ONE4=function(e){this.atLeastOneInternal(4,e)},r.prototype.AT_LEAST_ONE5=function(e){this.atLeastOneInternal(5,e)},r.prototype.AT_LEAST_ONE6=function(e){this.atLeastOneInternal(6,e)},r.prototype.AT_LEAST_ONE7=function(e){this.atLeastOneInternal(7,e)},r.prototype.AT_LEAST_ONE8=function(e){this.atLeastOneInternal(8,e)},r.prototype.AT_LEAST_ONE9=function(e){this.atLeastOneInternal(9,e)},r.prototype.AT_LEAST_ONE_SEP=function(e){this.atLeastOneSepFirstInternal(0,e)},r.prototype.AT_LEAST_ONE_SEP1=function(e){this.atLeastOneSepFirstInternal(1,e)},r.prototype.AT_LEAST_ONE_SEP2=function(e){this.atLeastOneSepFirstInternal(2,e)},r.prototype.AT_LEAST_ONE_SEP3=function(e){this.atLeastOneSepFirstInternal(3,e)},r.prototype.AT_LEAST_ONE_SEP4=function(e){this.atLeastOneSepFirstInternal(4,e)},r.prototype.AT_LEAST_ONE_SEP5=function(e){this.atLeastOneSepFirstInternal(5,e)},r.prototype.AT_LEAST_ONE_SEP6=function(e){this.atLeastOneSepFirstInternal(6,e)},r.prototype.AT_LEAST_ONE_SEP7=function(e){this.atLeastOneSepFirstInternal(7,e)},r.prototype.AT_LEAST_ONE_SEP8=function(e){this.atLeastOneSepFirstInternal(8,e)},r.prototype.AT_LEAST_ONE_SEP9=function(e){this.atLeastOneSepFirstInternal(9,e)},r.prototype.RULE=function(e,t,i){if(i===void 0&&(i=Ax.DEFAULT_RULE_CONFIG),(0,Mq.contains)(this.definedRulesNames,e)){var n=Qye.defaultGrammarValidatorErrorProvider.buildDuplicateRuleNameError({topLevelRule:e,grammarName:this.className}),s={message:n,type:Ax.ParserDefinitionErrorType.DUPLICATE_RULE_NAME,ruleName:e};this.definitionErrors.push(s)}this.definedRulesNames.push(e);var o=this.defineRule(e,t,i);return this[e]=o,o},r.prototype.OVERRIDE_RULE=function(e,t,i){i===void 0&&(i=Ax.DEFAULT_RULE_CONFIG);var n=[];n=n.concat((0,Sye.validateRuleIsOverridden)(e,this.definedRulesNames,this.className)),this.definitionErrors=this.definitionErrors.concat(n);var s=this.defineRule(e,t,i);return this[e]=s,s},r.prototype.BACKTRACK=function(e,t){return function(){this.isBackTrackingStack.push(1);var i=this.saveRecogState();try{return e.apply(this,t),!0}catch(n){if((0,bye.isRecognitionException)(n))return!1;throw n}finally{this.reloadRecogState(i),this.isBackTrackingStack.pop()}}},r.prototype.getGAstProductions=function(){return this.gastProductionsCache},r.prototype.getSerializedGastProductions=function(){return(0,vye.serializeGrammar)((0,Mq.values)(this.gastProductionsCache))},r}();yy.RecognizerApi=xye});var Yq=w(By=>{\"use strict\";Object.defineProperty(By,\"__esModule\",{value:!0});By.RecognizerEngine=void 0;var Pr=Gt(),qn=Cy(),wy=nf(),Uq=kd(),of=Dd(),Hq=jn(),Pye=sx(),Gq=TA(),Td=_g(),Dye=ox(),kye=function(){function r(){}return r.prototype.initRecognizerEngine=function(e,t){if(this.className=(0,Dye.classNameFromInstance)(this),this.shortRuleNameToFull={},this.fullRuleNameToShort={},this.ruleShortNameIdx=256,this.tokenMatcher=Td.tokenStructuredMatcherNoCategories,this.definedRulesNames=[],this.tokensMap={},this.isBackTrackingStack=[],this.RULE_STACK=[],this.RULE_OCCURRENCE_STACK=[],this.gastProductionsCache={},(0,Pr.has)(t,\"serializedGrammar\"))throw Error(`The Parser's configuration can no longer contain a property.\n\tSee: https://chevrotain.io/docs/changes/BREAKING_CHANGES.html#_6-0-0\n\tFor Further details.`);if((0,Pr.isArray)(e)){if((0,Pr.isEmpty)(e))throw Error(`A Token Vocabulary cannot be empty.\n\tNote that the first argument for the parser constructor\n\tis no longer a Token vector (since v4.0).`);if(typeof e[0].startOffset==\"number\")throw Error(`The Parser constructor no longer accepts a token vector as the first argument.\n\tSee: https://chevrotain.io/docs/changes/BREAKING_CHANGES.html#_4-0-0\n\tFor Further details.`)}if((0,Pr.isArray)(e))this.tokensMap=(0,Pr.reduce)(e,function(o,a){return o[a.name]=a,o},{});else if((0,Pr.has)(e,\"modes\")&&(0,Pr.every)((0,Pr.flatten)((0,Pr.values)(e.modes)),Td.isTokenType)){var i=(0,Pr.flatten)((0,Pr.values)(e.modes)),n=(0,Pr.uniq)(i);this.tokensMap=(0,Pr.reduce)(n,function(o,a){return o[a.name]=a,o},{})}else if((0,Pr.isObject)(e))this.tokensMap=(0,Pr.cloneObj)(e);else throw new Error(\" argument must be An Array of Token constructors, A dictionary of Token constructors or an IMultiModeLexerDefinition\");this.tokensMap.EOF=Gq.EOF;var s=(0,Pr.every)((0,Pr.values)(e),function(o){return(0,Pr.isEmpty)(o.categoryMatches)});this.tokenMatcher=s?Td.tokenStructuredMatcherNoCategories:Td.tokenStructuredMatcher,(0,Td.augmentTokenTypes)((0,Pr.values)(this.tokensMap))},r.prototype.defineRule=function(e,t,i){if(this.selfAnalysisDone)throw Error(\"Grammar rule <\"+e+`> may not be defined after the 'performSelfAnalysis' method has been called'\nMake sure that all grammar rule definitions are done before 'performSelfAnalysis' is called.`);var n=(0,Pr.has)(i,\"resyncEnabled\")?i.resyncEnabled:Hq.DEFAULT_RULE_CONFIG.resyncEnabled,s=(0,Pr.has)(i,\"recoveryValueFunc\")?i.recoveryValueFunc:Hq.DEFAULT_RULE_CONFIG.recoveryValueFunc,o=this.ruleShortNameIdx<t},r.prototype.orInternal=function(e,t){var i=this.getKeyForAutomaticLookahead(qn.OR_IDX,t),n=(0,Pr.isArray)(e)?e:e.DEF,s=this.getLaFuncFromCache(i),o=s.call(this,n);if(o!==void 0){var a=n[o];return a.ALT.call(this)}this.raiseNoAltException(t,e.ERR_MSG)},r.prototype.ruleFinallyStateUpdate=function(){if(this.RULE_STACK.pop(),this.RULE_OCCURRENCE_STACK.pop(),this.cstFinallyStateUpdate(),this.RULE_STACK.length===0&&this.isAtEndOfInput()===!1){var e=this.LA(1),t=this.errorMessageProvider.buildNotAllInputParsedMessage({firstRedundant:e,ruleName:this.getCurrRuleFullName()});this.SAVE_ERROR(new wy.NotAllInputParsedException(t,e))}},r.prototype.subruleInternal=function(e,t,i){var n;try{var s=i!==void 0?i.ARGS:void 0;return n=e.call(this,t,s),this.cstPostNonTerminal(n,i!==void 0&&i.LABEL!==void 0?i.LABEL:e.ruleName),n}catch(o){this.subruleInternalError(o,i,e.ruleName)}},r.prototype.subruleInternalError=function(e,t,i){throw(0,wy.isRecognitionException)(e)&&e.partialCstResult!==void 0&&(this.cstPostNonTerminal(e.partialCstResult,t!==void 0&&t.LABEL!==void 0?t.LABEL:i),delete e.partialCstResult),e},r.prototype.consumeInternal=function(e,t,i){var n;try{var s=this.LA(1);this.tokenMatcher(s,e)===!0?(this.consumeToken(),n=s):this.consumeInternalError(e,s,i)}catch(o){n=this.consumeInternalRecovery(e,t,o)}return this.cstPostTerminal(i!==void 0&&i.LABEL!==void 0?i.LABEL:e.name,n),n},r.prototype.consumeInternalError=function(e,t,i){var n,s=this.LA(0);throw i!==void 0&&i.ERR_MSG?n=i.ERR_MSG:n=this.errorMessageProvider.buildMismatchTokenMessage({expected:e,actual:t,previous:s,ruleName:this.getCurrRuleFullName()}),this.SAVE_ERROR(new wy.MismatchedTokenException(n,t,s))},r.prototype.consumeInternalRecovery=function(e,t,i){if(this.recoveryEnabled&&i.name===\"MismatchedTokenException\"&&!this.isBackTracking()){var n=this.getFollowsForInRuleRecovery(e,t);try{return this.tryInRuleRecovery(e,n)}catch(s){throw s.name===Pye.IN_RULE_RECOVERY_EXCEPTION?i:s}}else throw i},r.prototype.saveRecogState=function(){var e=this.errors,t=(0,Pr.cloneArr)(this.RULE_STACK);return{errors:e,lexerState:this.exportLexerState(),RULE_STACK:t,CST_STACK:this.CST_STACK}},r.prototype.reloadRecogState=function(e){this.errors=e.errors,this.importLexerState(e.lexerState),this.RULE_STACK=e.RULE_STACK},r.prototype.ruleInvocationStateUpdate=function(e,t,i){this.RULE_OCCURRENCE_STACK.push(i),this.RULE_STACK.push(e),this.cstInvocationStateUpdate(t,e)},r.prototype.isBackTracking=function(){return this.isBackTrackingStack.length!==0},r.prototype.getCurrRuleFullName=function(){var e=this.getLastExplicitRuleShortName();return this.shortRuleNameToFull[e]},r.prototype.shortRuleNameToFullName=function(e){return this.shortRuleNameToFull[e]},r.prototype.isAtEndOfInput=function(){return this.tokenMatcher(this.LA(1),Gq.EOF)},r.prototype.reset=function(){this.resetLexerState(),this.isBackTrackingStack=[],this.errors=[],this.RULE_STACK=[],this.CST_STACK=[],this.RULE_OCCURRENCE_STACK=[]},r}();By.RecognizerEngine=kye});var qq=w(by=>{\"use strict\";Object.defineProperty(by,\"__esModule\",{value:!0});by.ErrorHandler=void 0;var lx=nf(),cx=Gt(),jq=kd(),Rye=jn(),Fye=function(){function r(){}return r.prototype.initErrorHandler=function(e){this._errors=[],this.errorMessageProvider=(0,cx.has)(e,\"errorMessageProvider\")?e.errorMessageProvider:Rye.DEFAULT_PARSER_CONFIG.errorMessageProvider},r.prototype.SAVE_ERROR=function(e){if((0,lx.isRecognitionException)(e))return e.context={ruleStack:this.getHumanReadableRuleStack(),ruleOccurrenceStack:(0,cx.cloneArr)(this.RULE_OCCURRENCE_STACK)},this._errors.push(e),e;throw Error(\"Trying to save an Error which is not a RecognitionException\")},Object.defineProperty(r.prototype,\"errors\",{get:function(){return(0,cx.cloneArr)(this._errors)},set:function(e){this._errors=e},enumerable:!1,configurable:!0}),r.prototype.raiseEarlyExitException=function(e,t,i){for(var n=this.getCurrRuleFullName(),s=this.getGAstProductions()[n],o=(0,jq.getLookaheadPathsForOptionalProd)(e,s,t,this.maxLookahead),a=o[0],l=[],c=1;c<=this.maxLookahead;c++)l.push(this.LA(c));var u=this.errorMessageProvider.buildEarlyExitMessage({expectedIterationPaths:a,actual:l,previous:this.LA(0),customUserDescription:i,ruleName:n});throw this.SAVE_ERROR(new lx.EarlyExitException(u,this.LA(1),this.LA(0)))},r.prototype.raiseNoAltException=function(e,t){for(var i=this.getCurrRuleFullName(),n=this.getGAstProductions()[i],s=(0,jq.getLookaheadPathsForOr)(e,n,this.maxLookahead),o=[],a=1;a<=this.maxLookahead;a++)o.push(this.LA(a));var l=this.LA(0),c=this.errorMessageProvider.buildNoViableAltMessage({expectedPathsPerAlt:s,actual:o,previous:l,customUserDescription:t,ruleName:this.getCurrRuleFullName()});throw this.SAVE_ERROR(new lx.NoViableAltException(c,this.LA(1),l))},r}();by.ErrorHandler=Fye});var zq=w(Qy=>{\"use strict\";Object.defineProperty(Qy,\"__esModule\",{value:!0});Qy.ContentAssist=void 0;var Jq=Dd(),Wq=Gt(),Nye=function(){function r(){}return r.prototype.initContentAssist=function(){},r.prototype.computeContentAssist=function(e,t){var i=this.gastProductionsCache[e];if((0,Wq.isUndefined)(i))throw Error(\"Rule ->\"+e+\"<- does not exist in this grammar.\");return(0,Jq.nextPossibleTokensAfter)([i],t,this.tokenMatcher,this.maxLookahead)},r.prototype.getNextPossibleTokenTypes=function(e){var t=(0,Wq.first)(e.ruleStack),i=this.getGAstProductions(),n=i[t],s=new Jq.NextAfterTokenWalker(n,e).startWalking();return s},r}();Qy.ContentAssist=Nye});var rJ=w(xy=>{\"use strict\";Object.defineProperty(xy,\"__esModule\",{value:!0});xy.GastRecorder=void 0;var yn=Gt(),Oo=mn(),Tye=Bd(),_q=_g(),$q=TA(),Lye=jn(),Oye=Cy(),vy={description:\"This Object indicates the Parser is during Recording Phase\"};Object.freeze(vy);var Vq=!0,Xq=Math.pow(2,Oye.BITS_FOR_OCCURRENCE_IDX)-1,eJ=(0,$q.createToken)({name:\"RECORDING_PHASE_TOKEN\",pattern:Tye.Lexer.NA});(0,_q.augmentTokenTypes)([eJ]);var tJ=(0,$q.createTokenInstance)(eJ,`This IToken indicates the Parser is in Recording Phase\n\tSee: https://chevrotain.io/docs/guide/internals.html#grammar-recording for details`,-1,-1,-1,-1,-1,-1);Object.freeze(tJ);var Mye={name:`This CSTNode indicates the Parser is in Recording Phase\n\tSee: https://chevrotain.io/docs/guide/internals.html#grammar-recording for details`,children:{}},Kye=function(){function r(){}return r.prototype.initGastRecorder=function(e){this.recordingProdStack=[],this.RECORDING_PHASE=!1},r.prototype.enableRecording=function(){var e=this;this.RECORDING_PHASE=!0,this.TRACE_INIT(\"Enable Recording\",function(){for(var t=function(n){var s=n>0?n:\"\";e[\"CONSUME\"+s]=function(o,a){return this.consumeInternalRecord(o,n,a)},e[\"SUBRULE\"+s]=function(o,a){return this.subruleInternalRecord(o,n,a)},e[\"OPTION\"+s]=function(o){return this.optionInternalRecord(o,n)},e[\"OR\"+s]=function(o){return this.orInternalRecord(o,n)},e[\"MANY\"+s]=function(o){this.manyInternalRecord(n,o)},e[\"MANY_SEP\"+s]=function(o){this.manySepFirstInternalRecord(n,o)},e[\"AT_LEAST_ONE\"+s]=function(o){this.atLeastOneInternalRecord(n,o)},e[\"AT_LEAST_ONE_SEP\"+s]=function(o){this.atLeastOneSepFirstInternalRecord(n,o)}},i=0;i<10;i++)t(i);e.consume=function(n,s,o){return this.consumeInternalRecord(s,n,o)},e.subrule=function(n,s,o){return this.subruleInternalRecord(s,n,o)},e.option=function(n,s){return this.optionInternalRecord(s,n)},e.or=function(n,s){return this.orInternalRecord(s,n)},e.many=function(n,s){this.manyInternalRecord(n,s)},e.atLeastOne=function(n,s){this.atLeastOneInternalRecord(n,s)},e.ACTION=e.ACTION_RECORD,e.BACKTRACK=e.BACKTRACK_RECORD,e.LA=e.LA_RECORD})},r.prototype.disableRecording=function(){var e=this;this.RECORDING_PHASE=!1,this.TRACE_INIT(\"Deleting Recording methods\",function(){for(var t=0;t<10;t++){var i=t>0?t:\"\";delete e[\"CONSUME\"+i],delete e[\"SUBRULE\"+i],delete e[\"OPTION\"+i],delete e[\"OR\"+i],delete e[\"MANY\"+i],delete e[\"MANY_SEP\"+i],delete e[\"AT_LEAST_ONE\"+i],delete e[\"AT_LEAST_ONE_SEP\"+i]}delete e.consume,delete e.subrule,delete e.option,delete e.or,delete e.many,delete e.atLeastOne,delete e.ACTION,delete e.BACKTRACK,delete e.LA})},r.prototype.ACTION_RECORD=function(e){},r.prototype.BACKTRACK_RECORD=function(e,t){return function(){return!0}},r.prototype.LA_RECORD=function(e){return Lye.END_OF_FILE},r.prototype.topLevelRuleRecord=function(e,t){try{var i=new Oo.Rule({definition:[],name:e});return i.name=e,this.recordingProdStack.push(i),t.call(this),this.recordingProdStack.pop(),i}catch(n){if(n.KNOWN_RECORDER_ERROR!==!0)try{n.message=n.message+`\n\t This error was thrown during the \"grammar recording phase\" For more info see:\n\thttps://chevrotain.io/docs/guide/internals.html#grammar-recording`}catch{throw n}throw n}},r.prototype.optionInternalRecord=function(e,t){return Ld.call(this,Oo.Option,e,t)},r.prototype.atLeastOneInternalRecord=function(e,t){Ld.call(this,Oo.RepetitionMandatory,t,e)},r.prototype.atLeastOneSepFirstInternalRecord=function(e,t){Ld.call(this,Oo.RepetitionMandatoryWithSeparator,t,e,Vq)},r.prototype.manyInternalRecord=function(e,t){Ld.call(this,Oo.Repetition,t,e)},r.prototype.manySepFirstInternalRecord=function(e,t){Ld.call(this,Oo.RepetitionWithSeparator,t,e,Vq)},r.prototype.orInternalRecord=function(e,t){return Uye.call(this,e,t)},r.prototype.subruleInternalRecord=function(e,t,i){if(Sy(t),!e||(0,yn.has)(e,\"ruleName\")===!1){var n=new Error(\" argument is invalid\"+(\" expecting a Parser method reference but got: <\"+JSON.stringify(e)+\">\")+(`\n inside top level rule: <`+this.recordingProdStack[0].name+\">\"));throw n.KNOWN_RECORDER_ERROR=!0,n}var s=(0,yn.peek)(this.recordingProdStack),o=e.ruleName,a=new Oo.NonTerminal({idx:t,nonTerminalName:o,label:i==null?void 0:i.LABEL,referencedRule:void 0});return s.definition.push(a),this.outputCst?Mye:vy},r.prototype.consumeInternalRecord=function(e,t,i){if(Sy(t),!(0,_q.hasShortKeyProperty)(e)){var n=new Error(\" argument is invalid\"+(\" expecting a TokenType reference but got: <\"+JSON.stringify(e)+\">\")+(`\n inside top level rule: <`+this.recordingProdStack[0].name+\">\"));throw n.KNOWN_RECORDER_ERROR=!0,n}var s=(0,yn.peek)(this.recordingProdStack),o=new Oo.Terminal({idx:t,terminalType:e,label:i==null?void 0:i.LABEL});return s.definition.push(o),tJ},r}();xy.GastRecorder=Kye;function Ld(r,e,t,i){i===void 0&&(i=!1),Sy(t);var n=(0,yn.peek)(this.recordingProdStack),s=(0,yn.isFunction)(e)?e:e.DEF,o=new r({definition:[],idx:t});return i&&(o.separator=e.SEP),(0,yn.has)(e,\"MAX_LOOKAHEAD\")&&(o.maxLookahead=e.MAX_LOOKAHEAD),this.recordingProdStack.push(o),s.call(this),n.definition.push(o),this.recordingProdStack.pop(),vy}function Uye(r,e){var t=this;Sy(e);var i=(0,yn.peek)(this.recordingProdStack),n=(0,yn.isArray)(r)===!1,s=n===!1?r:r.DEF,o=new Oo.Alternation({definition:[],idx:e,ignoreAmbiguities:n&&r.IGNORE_AMBIGUITIES===!0});(0,yn.has)(r,\"MAX_LOOKAHEAD\")&&(o.maxLookahead=r.MAX_LOOKAHEAD);var a=(0,yn.some)(s,function(l){return(0,yn.isFunction)(l.GATE)});return o.hasPredicates=a,i.definition.push(o),(0,yn.forEach)(s,function(l){var c=new Oo.Alternative({definition:[]});o.definition.push(c),(0,yn.has)(l,\"IGNORE_AMBIGUITIES\")?c.ignoreAmbiguities=l.IGNORE_AMBIGUITIES:(0,yn.has)(l,\"GATE\")&&(c.ignoreAmbiguities=!0),t.recordingProdStack.push(c),l.ALT.call(t),t.recordingProdStack.pop()}),vy}function Zq(r){return r===0?\"\":\"\"+r}function Sy(r){if(r<0||r>Xq){var e=new Error(\"Invalid DSL Method idx value: <\"+r+`>\n\t`+(\"Idx value must be a none negative value smaller than \"+(Xq+1)));throw e.KNOWN_RECORDER_ERROR=!0,e}}});var nJ=w(Py=>{\"use strict\";Object.defineProperty(Py,\"__esModule\",{value:!0});Py.PerformanceTracer=void 0;var iJ=Gt(),Hye=jn(),Gye=function(){function r(){}return r.prototype.initPerformanceTracer=function(e){if((0,iJ.has)(e,\"traceInitPerf\")){var t=e.traceInitPerf,i=typeof t==\"number\";this.traceInitMaxIdent=i?t:1/0,this.traceInitPerf=i?t>0:t}else this.traceInitMaxIdent=0,this.traceInitPerf=Hye.DEFAULT_PARSER_CONFIG.traceInitPerf;this.traceInitIndent=-1},r.prototype.TRACE_INIT=function(e,t){if(this.traceInitPerf===!0){this.traceInitIndent++;var i=new Array(this.traceInitIndent+1).join(\"\t\");this.traceInitIndent <\"+e+\">\");var n=(0,iJ.timer)(t),s=n.time,o=n.value,a=s>10?console.warn:console.log;return this.traceInitIndent time: \"+s+\"ms\"),this.traceInitIndent--,o}else return t()},r}();Py.PerformanceTracer=Gye});var sJ=w(Dy=>{\"use strict\";Object.defineProperty(Dy,\"__esModule\",{value:!0});Dy.applyMixins=void 0;function Yye(r,e){e.forEach(function(t){var i=t.prototype;Object.getOwnPropertyNames(i).forEach(function(n){if(n!==\"constructor\"){var s=Object.getOwnPropertyDescriptor(i,n);s&&(s.get||s.set)?Object.defineProperty(r.prototype,n,s):r.prototype[n]=t.prototype[n]}})})}Dy.applyMixins=Yye});var jn=w(dr=>{\"use strict\";var AJ=dr&&dr.__extends||function(){var r=function(e,t){return r=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(i,n){i.__proto__=n}||function(i,n){for(var s in n)Object.prototype.hasOwnProperty.call(n,s)&&(i[s]=n[s])},r(e,t)};return function(e,t){if(typeof t!=\"function\"&&t!==null)throw new TypeError(\"Class extends value \"+String(t)+\" is not a constructor or null\");r(e,t);function i(){this.constructor=e}e.prototype=t===null?Object.create(t):(i.prototype=t.prototype,new i)}}();Object.defineProperty(dr,\"__esModule\",{value:!0});dr.EmbeddedActionsParser=dr.CstParser=dr.Parser=dr.EMPTY_ALT=dr.ParserDefinitionErrorType=dr.DEFAULT_RULE_CONFIG=dr.DEFAULT_PARSER_CONFIG=dr.END_OF_FILE=void 0;var en=Gt(),jye=qj(),oJ=TA(),lJ=xd(),aJ=Cq(),qye=sx(),Jye=Qq(),Wye=Tq(),zye=Oq(),Vye=Kq(),Xye=Yq(),Zye=qq(),_ye=zq(),$ye=rJ(),ewe=nJ(),twe=sJ();dr.END_OF_FILE=(0,oJ.createTokenInstance)(oJ.EOF,\"\",NaN,NaN,NaN,NaN,NaN,NaN);Object.freeze(dr.END_OF_FILE);dr.DEFAULT_PARSER_CONFIG=Object.freeze({recoveryEnabled:!1,maxLookahead:3,dynamicTokensEnabled:!1,outputCst:!0,errorMessageProvider:lJ.defaultParserErrorProvider,nodeLocationTracking:\"none\",traceInitPerf:!1,skipValidations:!1});dr.DEFAULT_RULE_CONFIG=Object.freeze({recoveryValueFunc:function(){},resyncEnabled:!0});var rwe;(function(r){r[r.INVALID_RULE_NAME=0]=\"INVALID_RULE_NAME\",r[r.DUPLICATE_RULE_NAME=1]=\"DUPLICATE_RULE_NAME\",r[r.INVALID_RULE_OVERRIDE=2]=\"INVALID_RULE_OVERRIDE\",r[r.DUPLICATE_PRODUCTIONS=3]=\"DUPLICATE_PRODUCTIONS\",r[r.UNRESOLVED_SUBRULE_REF=4]=\"UNRESOLVED_SUBRULE_REF\",r[r.LEFT_RECURSION=5]=\"LEFT_RECURSION\",r[r.NONE_LAST_EMPTY_ALT=6]=\"NONE_LAST_EMPTY_ALT\",r[r.AMBIGUOUS_ALTS=7]=\"AMBIGUOUS_ALTS\",r[r.CONFLICT_TOKENS_RULES_NAMESPACE=8]=\"CONFLICT_TOKENS_RULES_NAMESPACE\",r[r.INVALID_TOKEN_NAME=9]=\"INVALID_TOKEN_NAME\",r[r.NO_NON_EMPTY_LOOKAHEAD=10]=\"NO_NON_EMPTY_LOOKAHEAD\",r[r.AMBIGUOUS_PREFIX_ALTS=11]=\"AMBIGUOUS_PREFIX_ALTS\",r[r.TOO_MANY_ALTS=12]=\"TOO_MANY_ALTS\"})(rwe=dr.ParserDefinitionErrorType||(dr.ParserDefinitionErrorType={}));function iwe(r){return r===void 0&&(r=void 0),function(){return r}}dr.EMPTY_ALT=iwe;var ky=function(){function r(e,t){this.definitionErrors=[],this.selfAnalysisDone=!1;var i=this;if(i.initErrorHandler(t),i.initLexerAdapter(),i.initLooksAhead(t),i.initRecognizerEngine(e,t),i.initRecoverable(t),i.initTreeBuilder(t),i.initContentAssist(),i.initGastRecorder(t),i.initPerformanceTracer(t),(0,en.has)(t,\"ignoredIssues\"))throw new Error(`The IParserConfig property has been deprecated.\n\tPlease use the flag on the relevant DSL method instead.\n\tSee: https://chevrotain.io/docs/guide/resolving_grammar_errors.html#IGNORING_AMBIGUITIES\n\tFor further details.`);this.skipValidations=(0,en.has)(t,\"skipValidations\")?t.skipValidations:dr.DEFAULT_PARSER_CONFIG.skipValidations}return r.performSelfAnalysis=function(e){throw Error(\"The **static** `performSelfAnalysis` method has been deprecated.\t\\nUse the **instance** method with the same name instead.\")},r.prototype.performSelfAnalysis=function(){var e=this;this.TRACE_INIT(\"performSelfAnalysis\",function(){var t;e.selfAnalysisDone=!0;var i=e.className;e.TRACE_INIT(\"toFastProps\",function(){(0,en.toFastProperties)(e)}),e.TRACE_INIT(\"Grammar Recording\",function(){try{e.enableRecording(),(0,en.forEach)(e.definedRulesNames,function(s){var o=e[s],a=o.originalGrammarAction,l=void 0;e.TRACE_INIT(s+\" Rule\",function(){l=e.topLevelRuleRecord(s,a)}),e.gastProductionsCache[s]=l})}finally{e.disableRecording()}});var n=[];if(e.TRACE_INIT(\"Grammar Resolving\",function(){n=(0,aJ.resolveGrammar)({rules:(0,en.values)(e.gastProductionsCache)}),e.definitionErrors=e.definitionErrors.concat(n)}),e.TRACE_INIT(\"Grammar Validations\",function(){if((0,en.isEmpty)(n)&&e.skipValidations===!1){var s=(0,aJ.validateGrammar)({rules:(0,en.values)(e.gastProductionsCache),maxLookahead:e.maxLookahead,tokenTypes:(0,en.values)(e.tokensMap),errMsgProvider:lJ.defaultGrammarValidatorErrorProvider,grammarName:i});e.definitionErrors=e.definitionErrors.concat(s)}}),(0,en.isEmpty)(e.definitionErrors)&&(e.recoveryEnabled&&e.TRACE_INIT(\"computeAllProdsFollows\",function(){var s=(0,jye.computeAllProdsFollows)((0,en.values)(e.gastProductionsCache));e.resyncFollows=s}),e.TRACE_INIT(\"ComputeLookaheadFunctions\",function(){e.preComputeLookaheadFunctions((0,en.values)(e.gastProductionsCache))})),!r.DEFER_DEFINITION_ERRORS_HANDLING&&!(0,en.isEmpty)(e.definitionErrors))throw t=(0,en.map)(e.definitionErrors,function(s){return s.message}),new Error(`Parser Definition Errors detected:\n `+t.join(`\n-------------------------------\n`))})},r.DEFER_DEFINITION_ERRORS_HANDLING=!1,r}();dr.Parser=ky;(0,twe.applyMixins)(ky,[qye.Recoverable,Jye.LooksAhead,Wye.TreeBuilder,zye.LexerAdapter,Xye.RecognizerEngine,Vye.RecognizerApi,Zye.ErrorHandler,_ye.ContentAssist,$ye.GastRecorder,ewe.PerformanceTracer]);var nwe=function(r){AJ(e,r);function e(t,i){i===void 0&&(i=dr.DEFAULT_PARSER_CONFIG);var n=this,s=(0,en.cloneObj)(i);return s.outputCst=!0,n=r.call(this,t,s)||this,n}return e}(ky);dr.CstParser=nwe;var swe=function(r){AJ(e,r);function e(t,i){i===void 0&&(i=dr.DEFAULT_PARSER_CONFIG);var n=this,s=(0,en.cloneObj)(i);return s.outputCst=!1,n=r.call(this,t,s)||this,n}return e}(ky);dr.EmbeddedActionsParser=swe});var uJ=w(Ry=>{\"use strict\";Object.defineProperty(Ry,\"__esModule\",{value:!0});Ry.createSyntaxDiagramsCode=void 0;var cJ=Dv();function owe(r,e){var t=e===void 0?{}:e,i=t.resourceBase,n=i===void 0?\"https://unpkg.com/chevrotain@\"+cJ.VERSION+\"/diagrams/\":i,s=t.css,o=s===void 0?\"https://unpkg.com/chevrotain@\"+cJ.VERSION+\"/diagrams/diagrams.css\":s,a=`\n\n\n\n\n\n`,l=`\n\n`,c=`\n