chore: shorten verbose block comments across SaaS branch

frontend/editor/src/core/constants/app.ts

@@ -39,10 +39,7 @@ export const absoluteWithBasePath = (path: string): string => {
   return `${window.location.origin}${BASE_PATH}${clean}`;
 };
 
-/**
- * Remove the BASE_PATH prefix from a pathname so comparisons against
- * bare app routes ("/login", "/files", …) work under any subpath deploy.
- */
+/** Strip BASE_PATH prefix so route comparisons work under any subpath deploy. */
 export const stripBasePath = (pathname: string): string => {
   if (!BASE_PATH) return pathname;
   if (pathname === BASE_PATH) return "/";

frontend/editor/src/core/services/apiClientSetup.ts

@@ -13,11 +13,7 @@ export function setupApiInterceptors(client: AxiosInstance): void {
   );
 }
 
-/**
- * Auth headers for raw fetch() calls (SSE streams, etc.).
- * Proprietary overrides with stored JWT + XSRF; SaaS overrides with the live
- * Supabase access token. Async because SaaS has to consult the auth client.
- */
+/** Auth headers for raw fetch() calls — empty in core; proprietary/SaaS override. */
 export async function getAuthHeaders(): Promise<Record<string, string>> {
   return {};
 }

frontend/editor/src/core/utils/settingsNavigation.ts

@@ -1,53 +1,21 @@
 import { NavKey } from "@app/components/shared/config/types";
 import { stripBasePath, withBasePath } from "@app/constants/app";
 
-/**
- * Navigate to a specific settings section
- *
- * @param section - The settings section key to navigate to
- *
- * @example
- * // Navigate to People section
- * navigateToSettings('people');
- *
- * // Navigate to Admin Premium section
- * navigateToSettings('adminPremium');
- */
+/** Push the URL for a settings section and notify listeners. */
 export function navigateToSettings(section: NavKey) {
   const newPath = withBasePath(`/settings/${section}`);
   window.history.pushState({}, "", newPath);
-
-  // Trigger a popstate event to notify components
   window.dispatchEvent(new PopStateEvent("popstate"));
 }
 
-/**
- * Get the URL path for a settings section
- * Useful for creating links
- *
- * @param section - The settings section key
- * @returns The URL path for the settings section
- *
- * @example
- * <a href={getSettingsUrl('people')}>Go to People Settings</a>
- * // Returns: "/settings/people" (or "/bpp/settings/people" under subpath)
- */
+/** URL for a settings section (subpath-aware). */
 export function getSettingsUrl(section: NavKey): string {
   return withBasePath(`/settings/${section}`);
 }
 
-/**
- * Check if currently viewing a settings section
- *
- * @param section - Optional section key to check for specific section
- * @returns True if in settings (and matching specific section if provided)
- */
+/** Whether the current URL is in /settings (optionally a specific section). */
 export function isInSettings(section?: NavKey): boolean {
   const pathname = stripBasePath(window.location.pathname);
-
-  if (!section) {
-    return pathname.startsWith("/settings");
-  }
-
+  if (!section) return pathname.startsWith("/settings");
   return pathname === `/settings/${section}`;
 }

frontend/editor/src/core/workers/pixelCompareWorker.ts

@@ -390,12 +390,7 @@ self.addEventListener(
     let compDoc: PDFDocumentProxy | null = null;
 
     try {
-      // `CanvasFactory`/`FilterFactory` are supported at runtime but not declared on legacy types.
-      // pdfjs-dist 5.x renamed the option to `CanvasFactory` (capital C); without a FilterFactory
-      // the default DOMFilterFactory crashes in a worker calling document.createElementNS.
-      // Resolve CMap/standard-font URLs against the worker's own origin. Vite copies these
-      // directories from pdfjs-dist at build time via viteStaticCopy (see vite.config.ts).
-      // import.meta.env.BASE_URL ends with a slash and includes any subpath prefix.
+      // Resolve pdfjs CMap/standard-font URLs against the worker's origin + subpath.
       const assetsBase = new URL(
         `${import.meta.env.BASE_URL}pdfjs/`,
         self.location.origin,