fix(excludeStaticFile): check period in last segment only, not entire path (#197)

* fix(excludeStaticFile): check period in last segment only, not entire path

The previous implementation excluded any path containing a period anywhere,
which incorrectly filtered out legitimate API routes like /my.workspace/action
or /api.v2/users.

Changes:
- Check only the final path segment for periods to identify static files
- Rename isStaticFileExcluded to shouldIncludePath for clarity
- Add inline comments explaining each condition in the logic
- Update JSDoc to clarify the detection mechanism

This correctly distinguishes between static files (/style.css) and API routes
with periods in earlier segments (/my.workspace/action).

* docs: clarify comment to describe exclusion condition rather than result

---------

Co-authored-by: Braden Wong <git@bradenwong.com>

Author: braden-w

src/types.ts

@@ -44,7 +44,7 @@ export type GenerateSpecOptions = {
   includeEmptyPaths: boolean;
 
   /**
-   * Determine if Swagger should exclude static files.
+   * Determine if Swagger should exclude static files (by checking if the last path segment contains a period).
    *
    * @default true
    */

src/utils.ts

@@ -213,15 +213,15 @@ export function removeExcludedPaths(
       return x.test(key);
     });
 
-    // If excludeStaticFile is true, we want to exclude static files
-    const isStaticFileExcluded = excludeStaticFile
-      ? !key.includes(".") || key.includes("{")
-      : true;
+    const shouldIncludePath =
+      !excludeStaticFile || // Include all paths when static file filtering is disabled
+      key.includes("{") || // Always include paths with parameters (e.g., /users/{id}.json)
+      !key.split("/").pop()?.includes("."); // Exclude if last segment has a period (e.g., /style.css)
 
     if (
       isPathExcluded &&
       !(key.includes("*") && !key.includes("{")) &&
-      isStaticFileExcluded &&
+      shouldIncludePath &&
       value != null
     ) {
       for (const method of Object.keys(value)) {