useCountdown Hook

.github/workflows/codeql.yml

@@ -1,24 +1,12 @@
-# For most projects, this workflow file will not need changing; you simply need
-# to commit it to your repository.
-#
-# You may wish to alter this file to override the set of languages analyzed,
-# or to provide custom queries or build logic.
-#
-# ******** NOTE ********
-# We have attempted to detect the languages in your repository. Please check
-# the `language` matrix defined below to confirm you have the correct set of
-# supported CodeQL languages.
-#
 name: "CodeQL"
 
 on:
   push:
-    branches: [ master ]
+    branches: [master]
   pull_request:
-    # The branches below must be a subset of the branches above
-    branches: [ master ]
+    branches: [master]
   schedule:
-    - cron: '39 1 * * 5'
+    - cron: "39 1 * * 5"
 
 jobs:
   analyze:
@@ -32,40 +20,16 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        language: [ 'javascript' ]
-        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ]
-        # Learn more:
-        # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed
+        language: ["javascript-typescript"]
 
     steps:
-    - name: Checkout repository
-      uses: actions/checkout@v3
+      - name: Checkout repository
+        uses: actions/checkout@v5
 
-    # Initializes the CodeQL tools for scanning.
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
-      with:
-        languages: ${{ matrix.language }}
-        # If you wish to specify custom queries, you can do so here or in a config file.
-        # By default, queries listed here will override any specified in a config file.
-        # Prefix the list here with "+" to use these queries and those in the config file.
-        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: ${{ matrix.language }}
 
-    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
-    # If this step fails, then you should remove it and run the build manually (see below)
-    - name: Autobuild
-      uses: github/codeql-action/autobuild@v2
-
-    # ℹ️ Command-line programs to run using the OS shell.
-    # 📚 https://git.io/JvXDl
-
-    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
-    #    and modify them (or add more) to build your code if your project
-    #    uses a compiled language
-
-    #- run: |
-    #   make bootstrap
-    #   make release
-
-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v2
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3

.github/workflows/main.yml

@@ -4,76 +4,93 @@ on:
   push:
     branches: [master]
   pull_request:
-    branches: ['*']
+    branches: ["*"]
 
 jobs:
   lint:
     name: Lint
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
-      - name: Use Node.js 20.x
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-
-      - name: Get yarn cache directory path
-        id: yarn-cache-dir-path
-        run: echo "dir=$(yarn cache dir)" >> $GITHUB_OUTPUT
+      - uses: pnpm/action-setup@v5
 
-      - uses: actions/cache@v4
-        id: yarn-cache
+      - name: Use Node.js 24.x
+        uses: actions/setup-node@v5
         with:
-          path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
-          key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-yarn-
+          node-version: 24
+          cache: "pnpm"
 
       - name: Install
-        run: yarn install
+        run: pnpm install --frozen-lockfile
 
-      - name: 'Lint: Prettier'
-        run: yarn lint:prettier
+      - name: "Lint: oxlint"
+        run: pnpm lint:oxlint
 
-      - name: 'Lint: TypeScript'
-        run: yarn lint:tslint && yarn lint:tsc
+      - name: "Lint: oxfmt"
+        run: pnpm lint:oxfmt
+
+      - name: "Lint: TypeScript"
+        run: pnpm lint:tsc
 
   test:
-    name: Test
+    name: Test (React ${{ matrix.react }})
     runs-on: ubuntu-latest
 
-    steps:
-      - uses: actions/checkout@v4
+    strategy:
+      fail-fast: false
+      matrix:
+        react: ["18", "19"]
 
-      - name: Use Node.js 20.x
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
+    steps:
+      - uses: actions/checkout@v5
 
-      - name: Get yarn cache directory path
-        id: yarn-cache-dir-path
-        run: echo "dir=$(yarn cache dir)" >> $GITHUB_OUTPUT
+      - uses: pnpm/action-setup@v5
 
-      - uses: actions/cache@v4
-        id: yarn-cache
+      - name: Use Node.js 24.x
+        uses: actions/setup-node@v5
         with:
-          path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
-          key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-yarn-
+          node-version: 24
+          cache: "pnpm"
 
       - name: Install
-        run: yarn install
+        run: pnpm install --frozen-lockfile
+
+      # The lockfile pins React 19; override it to validate the matrix's other
+      # major against the actual runtime. Type-checking stays pinned to the
+      # lockfile in the lint job, since the @types/react 18/19 ref-variance
+      # differences are a DefinitelyTyped concern, not the library's.
+      - name: "Override React ${{ matrix.react }}"
+        if: matrix.react != '19'
+        run: pnpm add -D react@^${{ matrix.react }} react-dom@^${{ matrix.react }} @types/react@^${{ matrix.react }} @types/react-dom@^${{ matrix.react }}
+
+      - name: "Tests: Unit"
+        run: pnpm test:coverage
+
+      # pnpm's side-effects cache (restored via setup-node's pnpm cache) makes
+      # `pnpm install` skip Cypress's postinstall, but the binary it downloads
+      # lives in ~/.cache/Cypress, outside the pnpm store. Cache that path and
+      # install explicitly so the binary is present even when postinstall is
+      # skipped. See https://on.cypress.io/not-installed-ci-error
+      - name: Cache Cypress binary
+        if: matrix.react == '19'
+        uses: actions/cache@v5
+        with:
+          path: ~/.cache/Cypress
+          key: cypress-${{ runner.os }}-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: cypress-${{ runner.os }}-
 
-      - name: 'Tests: Unit'
-        run: yarn test:coverage
+      - name: "Install: Cypress binary"
+        if: matrix.react == '19'
+        run: pnpm exec cypress install
 
-      - name: 'Tests: E2E'
-        run: yarn test:e2e
+      - name: "Tests: E2E"
+        if: matrix.react == '19'
+        run: pnpm test:e2e
 
       - name: Coveralls
+        if: matrix.react == '19'
         uses: coverallsapp/github-action@master
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
@@ -84,69 +101,43 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
-      - name: Use Node.js 20.x
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-
-      - name: Get yarn cache directory path
-        id: yarn-cache-dir-path
-        run: echo "dir=$(yarn cache dir)" >> $GITHUB_OUTPUT
+      - uses: pnpm/action-setup@v5
 
-      - uses: actions/cache@v4
-        id: yarn-cache
+      - name: Use Node.js 24.x
+        uses: actions/setup-node@v5
         with:
-          path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
-          key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-yarn-
+          node-version: 24
+          cache: "pnpm"
 
       - name: Install
-        run: yarn install
+        run: pnpm install --frozen-lockfile
 
       - name: Build
-        run: yarn build
+        run: pnpm build
 
   examples:
     name: Build examples
     needs: build
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
-
-      - name: Use Node.js 20.x
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-
-      - name: Get yarn cache directory path
-        id: yarn-cache-dir-path
-        run: echo "dir=$(yarn cache dir)" >> $GITHUB_OUTPUT
+      - uses: actions/checkout@v5
 
-      - uses: actions/cache@v4
-        id: yarn-cache
-        with:
-          path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
-          key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-yarn-
+      - uses: pnpm/action-setup@v5
 
-      - uses: actions/cache@v4
-        id: yarn-cache-examples
+      - name: Use Node.js 24.x
+        uses: actions/setup-node@v5
         with:
-          path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
-          key: ${{ runner.os }}-yarn-examples-${{ hashFiles('examples/**/yarn.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-yarn-examples-
+          node-version: 24
+          cache: "pnpm"
 
       - name: Install master
-        run: yarn install
+        run: pnpm install --frozen-lockfile
 
       - name: Install
-        run: cd examples && yarn
+        run: cd examples && pnpm install --frozen-lockfile
 
       - name: Build
-        run: yarn build
+        run: cd examples && pnpm build

.gitignore

@@ -2,6 +2,7 @@ dist/
 node_modules/
 coverage/
 .cache/
+.parcel-cache/
 *.DS_Store
 *.log
 *.idea

.oxfmtrc.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "printWidth": 100,
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "sortPackageJson": false,
+  "ignorePatterns": []
+}

.oxlintrc.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["react", "typescript", "jest", "import", "jsx-a11y"],
+  "env": {
+    "browser": true,
+    "node": true,
+    "es2021": true,
+    "jest": true
+  },
+  "categories": {
+    "correctness": "error"
+  },
+  "rules": {
+    "no-unused-expressions": ["error", { "allowShortCircuit": true }],
+    "typescript/no-non-null-assertion": "off"
+  }
+}