Merge branch 'main' into feat/478-view-only-links

# Conflicts:
#	src/app/features/project/contributors/components/create-view-link-dialog/create-view-link-dialog.component.html
#	src/app/features/project/contributors/contributors.component.html
#	src/app/features/project/overview/components/overview-toolbar/overview-toolbar.component.html
#	src/app/features/project/overview/mappers/project-overview.mapper.ts
#	src/app/features/project/overview/models/project-overview.models.ts
#	src/app/features/project/settings/settings.component.html
#	src/app/shared/components/resource-metadata/resource-metadata.component.html

Author: rnastyuk

.fantasticonrc.js

@@ -3,10 +3,10 @@ npx lint-staged || {
   exit 1
 }
 
-npm run docs:coverage || {
-  printf "\n\nERROR: Documentation Coverage thresholds are not met."
-  printf "\n\nIn the future this will block your ability to commit locally until it is resolved."
-  printf "\n\nThe same pipeline runs via GitHub actions."
-  printf "\n\nYou are seeing this error because code was added without documentation."
+# npm run docs:coverage || {
+#   printf "\n\nERROR: Documentation Coverage thresholds are not met."
+#   printf "\n\nIn the future this will block your ability to commit locally until it is resolved."
+#   printf "\n\nThe same pipeline runs via GitHub actions."
+#   printf "\n\nYou are seeing this error because code was added without documentation."
   # exit 1
-}
+# }

.husky/pre-commit

@@ -14,14 +14,17 @@ take up to 60 seconds once the docker build finishes.
 
 ## Index
 
+### First steps
+
+- Install git commit template: [Commit Template](docs/commit.template.md).
+- Volta: [Volta](#volta)
+
 ### Recommended
 
 - Compodoc: [Compodoc Conventions](docs/compodoc.md).
 - Docker Commands: [Docker Commands](docs/docker.md).
 - Git Conventions: [Git Conventions](docs/git-convention.md).
-- Install git commit template: [Commit Template](docs/commit.template.md).
-- Volta: [Volta](#volta)
-- Redux DevTools: [Redux DevTools](#redux-devtools)
+- NGXS: [NGXS Conventions](docs/ngxs.md).
 
 ### Optional
 
@@ -53,8 +56,3 @@ npm run test:check-coverage-thresholds
 
 OSF uses volta to manage node and npm versions inside of the repository
 Install Volta from [volta](https://volta.sh/) and it will automatically pin Node/npm per the repo toolchain.
-
-## Redux DevTools
-
-OSF Angular uses [NGXS](https://github.com/ngxs) for state management. It is highly recommended to install
-the `Redux DevTools` extension from the Chrome web store.

README.md

@@ -44,7 +44,6 @@
             ],
             "styles": [
               "src/assets/styles/styles.scss",
-              "src/assets/icons/dist/icons.css",
               "node_modules/primeflex/primeflex.css",
               "node_modules/@fortawesome/fontawesome-free/css/all.min.css",
               "node_modules/ngx-markdown-editor/assets/highlight.js/agate.min.css"

angular.json

@@ -0,0 +1,65 @@
+# NGXS State Management Overview
+
+The OSF Angular project uses [NGXS](https://www.ngxs.io/) as the state management library for Angular applications. NGXS provides a simple, powerful, and TypeScript-friendly framework for managing state across components and services.
+
+---
+
+## Purpose
+
+The goal of using NGXS is to centralize and streamline the handling of application state, reduce boilerplate, and maintain a predictable flow of data and events throughout the OSF Angular app.
+
+---
+
+## Core Concepts
+
+- **State**: Defines a slice of the application state and how it is modified in response to actions.
+- **Actions**: Dispatched to signal state changes or trigger effects (e.g., API calls).
+- **Selectors**: Functions that extract and transform data from the store.
+- **Store**: Centralized container that holds the application state.
+- **Effects** (via `@ngxs-labs/effects` or `@ngxs/store`): Side-effect handling such as HTTP requests, logging, etc.
+
+### Diagram
+
+[![OSF NGRX Diagram](./assets/osf-ngxs-diagram.png)](./assets/osf-ngxs-diagram.png)
+
+---
+
+## Directory Structure
+
+Typical NGXS-related files are organized as follows:
+
+```
+src/app/shared/stores/
+  └── addons/
+      ├── addons.actions.ts       # All action definitions
+      ├── addons.models.ts        # Interfaces & data models
+      ├── addons.state.ts         # State implementation
+      ├── addons.selectors.ts     # Reusable selectors
+```
+
+```
+src/app/shared/services/
+  └── addons/
+      ├── addons.service.ts       # External API calls
+```
+
+---
+
+## Tooling and Extensions
+
+- [Redux DevTools](https://github.com/zalmoxisus/redux-devtools-extension) is supported. Enable it in development via `NgxsReduxDevtoolsPluginModule`.
+- [NGXS Logger Plugin](https://www.ngxs.io/plugins/logger) can be used for debugging dispatched actions and state changes.
+- [NGXS Storage Plugin](https://www.ngxs.io/plugins/storage) allows selective persistence of state across reloads.
+
+---
+
+## Testing
+
+- Mock `Store` using `jest.fn()` or test-specific modules for unit testing components and services.
+
+---
+
+## Documentation
+
+Refer to the official NGXS documentation for full API details and advanced usage:
+[https://www.ngxs.io/docs](https://www.ngxs.io/docs)

docs/assets/osf-ngxs-diagram.png

@@ -2,7 +2,7 @@ module.exports = {
   preset: 'jest-preset-angular',
   setupFilesAfterEnv: ['<rootDir>/setup-jest.ts'],
   globalSetup: '<rootDir>/jest.global-setup.ts',
-  collectCoverage: true,
+  collectCoverage: false,
   coverageReporters: ['json-summary', 'lcov', 'clover'],
   moduleNameMapper: {
     '^@osf/(.*)$': '<rootDir>/src/app/$1',
@@ -45,10 +45,10 @@ module.exports = {
   extensionsToTreatAsEsm: ['.ts'],
   coverageThreshold: {
     global: {
-      branches: 14.15,
-      functions: 14.83,
-      lines: 41.15,
-      statements: 41.63,
+      branches: 14.27,
+      functions: 15.55,
+      lines: 42.6,
+      statements: 43.2,
     },
   },
   watchPathIgnorePatterns: [
@@ -74,6 +74,10 @@ module.exports = {
     '<rootDir>/src/app/features/project/addons/components/configure-configure-addon/',
     '<rootDir>/src/app/features/project/addons/components/connect-configured-addon/',
     '<rootDir>/src/app/features/project/addons/components/disconnect-addon-modal/',
+    '<rootDir>/src/app/features/project/addons/components/confirm-account-connection-modal/',
+    '<rootDir>/src/app/features/files/',
+    '<rootDir>/src/app/features/my-projects/',
+    '<rootDir>/src/app/features/preprints/',
     '<rootDir>/src/app/features/project/analytics/',
     '<rootDir>/src/app/features/project/contributors/',
     '<rootDir>/src/app/features/project/files/',