refactor: improve TypeScript configuration and build system

- Update Nx Cloud ID for workspace integration
- Add CSS module type definitions for theme package
- Fix theme package test imports and TypeScript config
- Add composite project setup with proper references
- Remove outdated scaffold template configuration
- Add typecheck targets to all standard sites
- Standardize tsconfig.json across all projects
- Configure separate TypeScript declaration generation
- Fix workspace-level declaration file output structure

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

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

Author: jonphipps

nx.json

@@ -148,7 +148,7 @@
       }
     }
   ],
-  "nxCloudId": "686155f6ee99673f43464d29",
+  "nxCloudId": "6857fccbb755d4191ce6fbe4",
   "defaultBase": "dev",
   "affected": {
     "defaultBase": "dev"

packages/theme/project.json

@@ -8,15 +8,20 @@
     "build": {
       "executor": "nx:run-commands",
       "options": {
-        "command": "pnpm exec tsup",
-        "cwd": "packages/theme"
+        "commands": [
+          "pnpm exec tsup",
+          "tsc --project tsconfig.build.json"
+        ],
+        "cwd": "packages/theme",
+        "parallel": false
       },
       "outputs": ["{projectRoot}/dist"],
       "cache": true,
       "inputs": [
         "production",
         "{projectRoot}/src/**/*",
         "{projectRoot}/tsup.config.ts",
+        "{projectRoot}/tsconfig.build.json",
         "{projectRoot}/package.json"
       ]
     },

packages/theme/src/global.d.ts

@@ -0,0 +1,4 @@
+declare module '*.css' {
+  const content: Record<string, string>;
+  export default content;
+}

packages/theme/src/tests/fixtures/siteConfigs.ts

@@ -1,5 +1,5 @@
 // Standard site configuration fixtures for testing
-import type { SiteConfig } from '@ifla/theme/config/siteConfig';
+import type { SiteConfig } from '../../config/siteConfig';
 
 export const mockSiteConfig: Partial<SiteConfig> = {
   title: 'Test Site',

packages/theme/tsconfig.build.json

@@ -0,0 +1,22 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "declaration": true,
+    "declarationMap": true,
+    "emitDeclarationOnly": true,
+    "outDir": "../../dist",
+    "rootDir": "../../",
+    "composite": true,
+    "noEmit": false
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "**/*.test.ts",
+    "**/*.test.tsx", 
+    "**/*.spec.ts",
+    "**/*.spec.tsx",
+    "src/tests/**/*"
+  ]
+}

packages/theme/tsconfig.build.tsbuildinfo

@@ -1,11 +1,12 @@
 {
   "extends": "../../tsconfig.json",
   "compilerOptions": {
-    "rootDir": "../../",
-    "baseUrl": "../../",
+    "baseUrl": ".",
+    "composite": true,
+    "noEmit": false // Ensure this is not set to true
   },
   "include": [
-    "src/**/*",
+    "src/**/*"
   ],
   "exclude": [
     "node_modules",

packages/theme/tsconfig.json

@@ -1,5 +1,6 @@
 import { defineConfig } from 'tsup';
 import { sassPlugin, postcssModules } from 'esbuild-sass-plugin';
+import type { Plugin } from 'esbuild';
 
 export default defineConfig({
   entry: {
@@ -12,7 +13,8 @@ export default defineConfig({
     'config/siteConfig': 'src/config/siteConfig.ts',
   },
   format: ['esm', 'cjs'],
-  dts: true,
+  // Disable built-in DTS generation due to TypeScript project conflicts
+  dts: false,
   splitting: false, // Disable code splitting to avoid bundling issues
   sourcemap: true,
   clean: true, // Clean output directory before build
@@ -32,7 +34,7 @@ export default defineConfig({
     'prism-react-renderer',
   ],
   esbuildPlugins: [
-    // Type assertion to work around version mismatch between tsup and esbuild
-    sassPlugin({ transform: postcssModules({}) }) as any,
+    // Properly type the sass plugin
+    sassPlugin({ transform: postcssModules({}) }) as Plugin,
   ],
 });

packages/theme/tsup.config.ts

@@ -2,6 +2,8 @@
   "extends": "../tsconfig.json",
   "compilerOptions": {
     "baseUrl": ".",
+    "composite": true,
+    "tsBuildInfoFile": "./build/.tsbuildinfo",
     "paths": {
       "@ifla/theme": ["../packages/theme/src/index.ts"],
       "@ifla/theme/*": ["../packages/theme/src/*"],
@@ -19,5 +21,8 @@
     "docusaurus.config.ts",
     "sidebars.ts",
     "navbar.ts"
+  ],
+  "references": [
+    { "path": "../packages/theme" }
   ]
 }