feat: add macOS CI and update POD known limitations

.github/workflows/testsuite.yml

@@ -1,4 +1,4 @@
-name: linux
+name: testsuite
 
 on:
   push:
@@ -31,6 +31,22 @@ jobs:
       - run: make
       - run: make test
 
+  macos:
+    runs-on: macos-latest
+
+    env:
+      PERL_USE_UNSAFE_INC: 0
+
+    steps:
+      - uses: actions/checkout@v6
+      - run: perl -V
+      - name: Install Dependencies
+        run: |
+          curl -fsSL --compressed https://raw.githubusercontent.com/skaji/cpm/main/cpm | perl - install -g --show-build-log-on-failure
+      - run: perl Makefile.PL
+      - run: make
+      - run: make test
+
   perl-versions:
     runs-on: ubuntu-latest
     name: List Perl versions

lib/Overload/FileCheck.pm

@@ -1123,15 +1123,13 @@ view stat_as_directory and L</"Using stat_as_* helpers"> for some sample usages
 Create a stat array ref for a named pipe (FIFO)
 view stat_as_directory and L</"Using stat_as_* helpers"> for some sample usages
 
-=head1 Notice
-
-This is a very early development stage and some behavior might change before the release of a more stable build.
-
 =head1 Known Limitations
 
-=head2 This is design for Unit Test purpose
+=head2 Designed for unit testing
 
-This code was mainly designed to be used during unit tests. It's far from being optimized at this time.
+This module is designed for use in test suites.  While it works reliably, runtime
+performance is not optimized — the Perl↔XS callback round-trip adds overhead
+that is negligible in tests but would matter in hot loops.
 
 =head2 Mock as soon as possible