feat: implement environment-based configuration refactor

- Created shared-config library with factory functions for Docusaurus configuration
- Implemented environment-based configuration using .env files for different deployment targets
- Updated portal to use new environment configuration system with legacy compatibility
- Replaced hardcoded site configurations with dynamic environment loading
- Added proper workspace dependencies and module resolution
- Updated unit tests to use new shared-config system with mock environment configurations
- Ensured Nx caching compatibility with pure functions
- Added TypeScript path mappings and vite config aliases for proper module resolution
- Maintained backward compatibility with existing regression tests

All tests passing with complete coverage of URL generation and cross-site navigation functionality.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: jonphipps

.prettierrc

@@ -0,0 +1,3 @@
+{
+  "singleQuote": true
+}

libs/shared-config/.swcrc

@@ -0,0 +1,22 @@
+{
+  "jsc": {
+    "parser": {
+      "syntax": "typescript",
+      "tsx": false,
+      "decorators": false,
+      "dynamicImport": true
+    },
+    "target": "es2020",
+    "loose": false,
+    "externalHelpers": false
+  },
+  "module": {
+    "type": "commonjs"
+  },
+  "exclude": [
+    "jest.config.ts",
+    ".*\\.spec.tsx?$",
+    ".*\\.test.tsx?$",
+    "./src/jest-setup.ts$"
+  ]
+}

libs/shared-config/README.md

@@ -0,0 +1,11 @@
+# shared-config
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build shared-config` to build the library.
+
+## Running unit tests
+
+Run `nx test shared-config` to execute the unit tests via [Vitest](https://vitest.dev/).

libs/shared-config/eslint.config.mjs

@@ -0,0 +1,22 @@
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: [
+            '{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}',
+            '{projectRoot}/vite.config.{js,ts,mjs,mts}',
+          ],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

libs/shared-config/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@ifla/shared-config",
+  "version": "0.0.1",
+  "private": true,
+  "type": "commonjs",
+  "main": "./dist/index.cjs.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.cjs.js",
+      "import": "./dist/index.esm.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

libs/shared-config/project.json

@@ -0,0 +1,29 @@
+{
+  "name": "shared-config",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/shared-config/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/rollup:rollup",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "libs/shared-config/dist",
+        "main": "libs/shared-config/src/index.ts",
+        "tsConfig": "libs/shared-config/tsconfig.lib.json",
+        "project": "libs/shared-config/package.json",
+        "compiler": "tsc",
+        "format": ["cjs", "esm"],
+        "generateExportsField": false,
+        "assets": [
+          {
+            "input": "libs/shared-config/src/lib",
+            "glob": "defaults.json",
+            "output": "lib"
+          }
+        ]
+      }
+    }
+  }
+}

libs/shared-config/src/index.ts

@@ -0,0 +1,9 @@
+// Main exports for shared-config library
+export * from './lib/createBaseConfig';
+export * from './lib/createThemeConfig';
+export * from './lib/createPluginConfig';
+export * from './lib/createFooterConfig';
+export * from './lib/utils/loadEnvConfig';
+export * from './lib/utils/getSiteUrl';
+export * from './lib/types';
+export { default as defaults } from './lib/defaults.json';

libs/shared-config/src/lib/createBaseConfig.ts

@@ -0,0 +1,31 @@
+import type { BaseConfigOptions } from './types';
+import defaults from './defaults.json';
+
+/**
+ * Factory function to create base Docusaurus configuration
+ * This is a pure function that returns a consistent configuration object
+ */
+export function createBaseConfig(options: BaseConfigOptions) {
+  return {
+    title: options.title,
+    tagline: options.tagline,
+    url: options.url,
+    baseUrl: options.baseUrl,
+    projectName: options.projectName,
+    
+    // Static values from defaults
+    organizationName: defaults.organizationName,
+    favicon: defaults.favicon,
+    trailingSlash: defaults.trailingSlash,
+    onBrokenLinks: defaults.onBrokenLinks as 'warn',
+    onBrokenMarkdownLinks: defaults.onBrokenMarkdownLinks as 'warn',
+    onBrokenAnchors: defaults.onBrokenAnchors as 'warn',
+    onDuplicateRoutes: defaults.onDuplicateRoutes as 'warn',
+    
+    // Future flags for Docusaurus v4
+    future: defaults.future,
+    
+    // i18n configuration
+    i18n: defaults.i18n,
+  };
+}

libs/shared-config/src/lib/createFooterConfig.ts

@@ -0,0 +1,15 @@
+import type { FooterConfigOptions } from './types';
+
+/**
+ * Factory function to create footer configuration
+ * This is a pure function that returns a consistent footer configuration
+ */
+export function createFooterConfig(options: FooterConfigOptions) {
+  const { links = [], copyright } = options;
+  
+  return {
+    style: 'dark',
+    links,
+    copyright: copyright || `Copyright © ${new Date().getFullYear()} International Federation of Library Associations and Institutions (IFLA)`,
+  };
+}

libs/shared-config/src/lib/createPluginConfig.ts

@@ -0,0 +1,25 @@
+import type { PluginConfigOptions } from './types';
+
+/**
+ * Factory function to create plugin configuration
+ * This is a pure function that returns a consistent plugin configuration
+ */
+export function createPluginConfig(options: PluginConfigOptions) {
+  const { docsPath = './docs', editUrl, showReadingTime = true, customCss = './src/css/custom.css' } = options;
+  
+  return {
+    docs: {
+      path: docsPath,
+      sidebarPath: './sidebars.ts',
+      editUrl,
+      remarkPlugins: [],
+    },
+    blog: showReadingTime ? {
+      showReadingTime: true,
+      editUrl,
+    } : false,
+    theme: {
+      customCss,
+    },
+  };
+}