feat: introduce file-based @analogjs/router library

[brandonroberts]

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://github.com/analogjs/analog/blob/main/CONTRIBUTING.md#-commit-message-guidelines
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

This PR:

• Adds a new @analogjs/router library that adds file-based routing on top of the Angular router.
• Routes are defined in the src/app/routes folder
• Example app has been updated to use the router

Sample route file

src/app/routes/about.ts

import { Component } from '@angular/core';
import { defineRouteMeta, injectRouter, injectActivatedRoute } from '@analogjs/router';

export const routeMeta = defineRouteMeta({
  title: 'About Analog',
  canActivate: [() => true],
  providers: [AboutService]
});

@Component({
  selector: 'app-about',
  standalone: true,
  template: `
    <h2>About Analog</h2>

    Analog is a meta-framework on top of Angular.
  `
})
export default class AboutPageComponent {
  route = injectActivatedRoute();
  router = injectRouter();
}

• Bugfix
• Feature
• Code style update (formatting, local variables)
• Refactoring (no functional changes, no api changes)
• Build related changes
• CI related changes
• Documentation content changes
• Other... Please describe:

Which package are you modifying?

• vite-angular-plugin
• astro-angular
• create-analog

What is the current behavior?

Issue Number: #1

What is the new behavior?

Does this PR introduce a breaking change?

• Yes
• No

Other information