@gsa-tts/graymatter-ui 0.4.1 → 0.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gsa-tts/graymatter-ui",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -62,8 +62,8 @@
     "vite": "^6.3.5",
     "vitest": "^3.0.7",
     "@gsa-tts/graymatter-eslint": "0.0.2",
-    "@gsa-tts/graymatter-vitest-config": "0.0.1",
-    "@gsa-tts/graymatter-typescript-config": "0.0.2"
+    "@gsa-tts/graymatter-typescript-config": "0.0.2",
+    "@gsa-tts/graymatter-vitest-config": "0.0.1"
   },
   "dependencies": {
     "@fontsource-variable/archivo": "^5.2.6",

package/src/utils/index.ts

@@ -2,7 +2,6 @@
 // These are Astro-specific utilities that should only be imported directly by their specific paths.
 // Exporting them would cause bundling issues for Svelte/SvelteKit apps that import from this barrel export.
 
-export * from './getAppUrls.js';
 export * from './navigationControl.js';
 export * from './copyButtonScript.js';
 export * from './generateApiNavData.js';

package/src/utils/setupMocks.ts

@@ -28,18 +28,15 @@ export function setupCommonMocks() {
     };
   });
 
-  vi.mock('../utils/getAppUrls', () => ({
-    getAppUrls: () => ({
-      discover: '/fake-discover',
-      chat: '/fake-chat',
-      console: '/fake-console',
-      api: '/fake-api',
-    }),
-  }));
-
-  vi.mock('slugify', () => ({
-    default: (x: string) => x.toLowerCase().replace(/ /g, '-'),
-  }));
+  vi.mock('slugify', () => {
+    const mockSlugify = (x: string) => x.toLowerCase().replace(/ /g, '-');
+    return {
+      __esModule: true,
+      default: mockSlugify,
+      // Support both named and default exports
+      slugify: mockSlugify,
+    };
+  });
 
   vi.stubGlobal(
     'window',

package/src/utils/apiDocumentationConfig.ts

@@ -1,35 +0,0 @@
-import { glob } from 'astro/loaders';
-
-/**
- * Creates the API documentation collection for Astro apps.
- *
- * @example
- * ```typescript
- * import { defineCollection, z } from 'astro:content';
- * import { createApiDocumentationCollection } from '@gsa-tts/graymatter-ui/utils/apiDocumentationConfig.js';
- *
- * export const collections = {
- *   apiDocumentation: createApiDocumentationCollection({ defineCollection, z }),
- * };
- * ```
- */
-export function createApiDocumentationCollection({
-  defineCollection,
-  z,
-}: {
-  defineCollection: typeof import('astro:content').defineCollection;
-  z: typeof import('astro:content').z;
-}) {
-  return defineCollection({
-    loader: glob({
-      base: './node_modules/@gsa-tts/graymatter-ui/src/content/api',
-      pattern: '**/*.{md,mdx}',
-    }),
-    schema: () =>
-      z.object({
-        title: z.string(),
-        description: z.string(),
-        sortOrder: z.number(),
-      }),
-  });
-}

package/src/utils/getAppUrls.ts

@@ -1,153 +0,0 @@
-import { getUrlFromBase } from '@gsa-tts/graymatter-ui/helpers/url.js';
-
-/**
- * Logs a warning message when an environment variable is missing.
- *
- * @param name - The name of the missing environment variable
- * @param value - The value of the environment variable (should be undefined)
- */
-function warnIfMissing(name: string, value: string | undefined) {
-  if (!value) {
-    console.warn(`[getAppUrls] Environment variable for ${name} is missing!`);
-  }
-}
-
-/**
- * Checks if a URL is absolute (starts with protocol like http:// or https://).
- *
- * @param url - The URL string to check
- * @returns True if the URL is absolute, false otherwise
- */
-function isAbsoluteUrl(url: string): boolean {
-  try {
-    new URL(url);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Processes a URL string, handling both absolute and relative URLs.
- *
- * If the URL is undefined, returns the fallback. If it's absolute (starts with protocol),
- * returns it as-is. If it's relative, processes it through `getUrlFromBase()` to create
- * a full URL.
- *
- * @param url - The URL string to process (can be undefined)
- * @param fallback - The fallback URL to use if the input URL is undefined
- * @returns The processed URL string (can be absolute URL or relative path)
- *
- * @example
- * ```typescript
- * processUrl('https://example.com', '/fallback'); // "https://example.com"
- * processUrl('/api/docs', '/fallback'); // "/api/docs" (processed by getUrlFromBase)
- * processUrl(undefined, '/fallback'); // "/fallback"
- * ```
- */
-function processUrl(url: string | undefined, fallback: string): string {
-  if (!url) {
-    return fallback;
-  }
-
-  if (isAbsoluteUrl(url)) {
-    return url;
-  }
-
-  return getUrlFromBase(url);
-}
-
-/**
- * Retrieves application URLs/paths from environment variables with fallback support.
- *
- * This utility function processes environment variables to provide URLs or paths for different
- * application sections (chat, console, API, discover). It supports both absolute URLs
- * and relative paths, with intelligent fallback handling.
- *
- * @param envArg - Optional environment object to use instead of `import.meta.env`.
- *                 Useful for testing or when you want to override environment variables.
- *                 If not provided, uses `process.env` (server) or `import.meta.env` (client).
- *
- * @returns An object containing processed URLs/paths for each application section:
- *   - `chat`: Chat application URL or path
- *   - `console`: Console application URL or path
- *   - `api`: API documentation URL or path
- *   - `discover`: Discover page URL or path
- *
- * @example
- * ```typescript
- * // Using default environment variables
- * const urls = getAppUrls();
- * console.log(urls.chat); // "#" (fallback) or "https://chat.example.com" (URL)
- *
- * // Using custom environment object (useful for testing)
- * const urls = getAppUrls({
- *   PUBLIC_CHAT_URL: 'https://chat.dev/',
- *   PUBLIC_CONSOLE_URL: 'https://console.dev/',
- *   PUBLIC_API_URL: 'https://api.dev/docs',
- *   PUBLIC_DISCOVER_URL: 'https://discover.dev/'
- * });
- * ```
- *
- * @example
- * ```typescript
- * // Environment variables (.env file)
- * PUBLIC_CHAT_URL=https://chat.example.com
- * PUBLIC_CONSOLE_URL=https://console.example.com
- * PUBLIC_API_URL=/api/documentation
- * PUBLIC_DISCOVER_URL=https://discover.example.com
- *
- * // Usage in code
- * const { chat, console, api, discover } = getAppUrls();
- * ```
- *
- * @remarks
- * - Uses `process.env` in server context, `import.meta.env` in client context
- * - Supports both `CHAT_URL` and `PUBLIC_CHAT_URL` naming conventions
- * - URLs are processed through `processUrl()` which handles both absolute and relative URLs
- * - Missing environment variables result in fallback values (`#` for most, `/api/documentation` for API)
- * - Warnings are logged in development when environment variables are missing
- * - The function is designed to work with both Vite's `import.meta.env` and Node.js `process.env`
- * - Note: Astro layouts (like GlobalAppLayout.astro) use `getSecret()` directly for better performance
- *
- * @see {@link processUrl} - URL processing logic
- * @see {@link getUrlFromBase} - Base URL resolution
- */
-export function getAppUrls(envArg?: Record<string, string | undefined>) {
-  // If envArg is provided, use it directly (for testing)
-  if (envArg) {
-    const chatUrl = envArg.CHAT_URL || envArg.PUBLIC_CHAT_URL;
-    const consoleUrl = envArg.CONSOLE_URL || envArg.PUBLIC_CONSOLE_URL;
-    const apiUrl = envArg.API_URL || envArg.PUBLIC_API_URL;
-    const discoverUrl = envArg.DISCOVER_URL || envArg.PUBLIC_DISCOVER_URL;
-
-    warnIfMissing('chat', chatUrl);
-    warnIfMissing('console', consoleUrl);
-    warnIfMissing('api', apiUrl);
-
-    return {
-      chat: processUrl(chatUrl, '#'),
-      console: processUrl(consoleUrl, '#'),
-      api: processUrl(apiUrl, getUrlFromBase('/api/documentation')),
-      discover: processUrl(discoverUrl, '#'),
-    };
-  }
-
-  // Use process.env in server context, import.meta.env in client context
-  const env = typeof window === 'undefined' ? process.env : import.meta.env;
-  const chatUrl = env.CHAT_URL || env.PUBLIC_CHAT_URL;
-  const consoleUrl = env.CONSOLE_URL || env.PUBLIC_CONSOLE_URL;
-  const apiUrl = env.API_URL || env.PUBLIC_API_URL;
-  const discoverUrl = env.DISCOVER_URL || env.PUBLIC_DISCOVER_URL;
-
-  warnIfMissing('chat', chatUrl);
-  warnIfMissing('console', consoleUrl);
-  warnIfMissing('api', apiUrl);
-
-  return {
-    chat: processUrl(chatUrl, '#'),
-    console: processUrl(consoleUrl, '#'),
-    api: processUrl(apiUrl, getUrlFromBase('/api/documentation')),
-    discover: processUrl(discoverUrl, '#'),
-  };
-}