LIBRARY INDEX

Documentation for Developers

📚 NX Library Navigation Index

Quick reference for finding library files in the monorepo.

🎯 Core Libraries

Alias	Path	Type	Status
`@core`	`libs/core-models/src/index.ts`	Angular	✅ Active
`@core-types`	`libs/core-models/src/index.ts`	TypeScript	✅ Active
`@auth`	`libs/auth/src/index.ts`	Angular	✅ Active

🎨 UI & UX Libraries

Alias	Path	Type	Status
`@ux-portal`	`libs/ux-portal/src/index.ts`	Angular	✅ Active
`@ux-ui-extended`	`libs/ux-ui-extended/src/index.ts`	Angular	✅ Active
`@ux-ui-core`	`libs/ux-ui-core/src/index.ts`	Angular	✅ Active
`@ux-ui-forms`	`libs/ux-ui-forms/src/index.ts`	Angular	✅ Active
`@ux-ui-feedback`	`libs/ux-ui-feedback/src/index.ts`	Angular	✅ Active
`@ux-loading`	`libs/ux-loading/src/index.ts`	Angular	✅ Active
`@ux-icons`	`libs/ux-icons/src/index.ts`	Angular	✅ Active
`@ux-menu`	`libs/ux-menu/src/index.ts`	Angular	✅ Active
`@ux-panel`	`libs/ux-panel/src/index.ts`	Angular	✅ Active
`@ux-space`	`libs/ux-space/src/index.ts`	Angular	✅ Active
`@ux-context-menu`	`libs/ux-context-menu/src/index.ts`	Angular	✅ Active
`@ux-icon-finder`	`libs/ux-icon-finder/src/index.ts`	Angular	✅ Active

🎨 Editor Libraries

Alias	Path	Type	Status
`@ui-editor`	`libs/editor-ui/src/index.ts`	Angular	✅ Active
`@editor/catalyst-ui-kit`	`libs/catalyst-ui-kit/src/index.ts`	React	✅ Active
`@editor/mock-api`	`libs/mock-api/src/index.ts`	TypeScript	✅ Active
`@editor/theme-runtime`	`libs/theme-system/theme-runtime/src/index.ts`	Angular	✅ Active
`@editor/theme-styles`	`libs/theme-system/theme-styles/src/index.ts`	SCSS	✅ Active
`@editor/theme-dev-tools`	`libs/theme-system/theme-dev-tools/src/index.ts`	Angular	✅ Active

🗄️ Storage Libraries

Alias	Path	Type	Status
`@storage-system`	`libs/storage-system/src/index.ts`	Angular	✅ Active

🤖 AI & Features

Alias	Path	Type	Status
`@gograb-ai`	`libs/gograb-ai/src/index.ts`	Angular	✅ Active
`@ai-data-connector`	`libs/ai-data-connector/src/index.ts`	TypeScript	✅ Active
`@prompt-system`	`libs/prompt-system/src/index.ts`	Angular	✅ Active

🎨 Shared & Utilities

Alias	Path	Type	Status
`@shared-ui`	`libs/shared-ui/src/index.ts`	Angular	✅ Active
`@cosmic-backgrounds`	`libs/cosmic-backgrounds/src/index.ts`	Angular	✅ Active
`@unified-nav`	`libs/unified-nav/src/index.ts`	Angular	✅ Active
`@unified-dashboard`	`libs/unified-dashboard/src/index.ts`	Angular	❌ Removed
`@widgets`	`libs/widgets/src/index.ts`	Angular	✅ Active
`@landing-page-ui`	`libs/landing-page-ui/src/index.ts`	Angular	✅ Active
`@component-library`	`libs/component-library/src/index.ts`	Angular	✅ Active

🚀 Quick Navigation Commands

# Navigate to specific library
node scripts/navigate-to-lib.js gograb-ai

# VS Code Quick Open
Cmd+P → type: gograb-ai/src/index.ts

# Find all exports in a library
grep -r "export" libs/gograb-ai/src/

🔍 Debugging Import Issues

Check if file exists: Use the navigation script above
Verify exports: Check the index.ts file
Test import: Try importing in a test file
Check build: Run nx build <library-name>

⚠️ Known Issues: Nested Libraries

Libraries in Nested Folders (e.g., `libs/theme-system`)

Issue: ng-packagr may fail to resolve cross-library imports in nested structures.

Symptoms:

Cannot find module '@ux-portal' or its corresponding type declarations.

Solution:

Use custom build script in project.json:

{
  "build": {
    "executor": "nx:run-commands",
    "options": {
      "command": "node tools/scripts/build-angular-library.js theme-system"
    }
  }
}

⚠️ Important: Pass the full nested path: theme-system

Use direct imports in your code:

// ✅ Works reliably
import { UxPortalService } from 'libs/ux-portal/src/index';

// ❌ May fail with ng-packagr
import { UxPortalService } from '@libs-ux/ux-portal';

Affected Libraries

✅ Fixed: libs/theme-system (now uses custom build)
✅ Works: libs/theme-system/* (simple dependencies, uses ng-packagr)
⚠️ Watch: Any new nested libraries with cross-Angular imports

Reference: See @imports-exports.md for complete documentation

This index is automatically maintained. Update when adding new libraries.