refactor: split Angular utilities into a dedicated package (#960)

fixed #956

Author: wangsijie

.changeset/cold-brooms-wait.md

@@ -0,0 +1,9 @@
+---
+"@logto/angular": major
+"@logto/angular-sample": major
+"@logto/js": major
+---
+
+extract Angular-specific utilities from JS package into standalone package
+
+Check the Angular sample app for usage, replace the existing import (`@logto/js`) with the new package (`@logto/angular`).

packages/angular-sample/package.json

@@ -21,7 +21,7 @@
     "@angular/platform-server": "^19.0.0",
     "@angular/router": "^19.0.0",
     "@angular/ssr": "^19.0.0",
-    "@logto/js": "link:../js",
+    "@logto/angular": "link:../angular",
     "angular-auth-oidc-client": "^19.0.0",
     "express": "^4.20.0",
     "rxjs": "~7.8.0",

packages/angular-sample/src/app/app.component.ts

@@ -2,7 +2,7 @@ import { Component, OnInit } from '@angular/core';
 import { RouterOutlet } from '@angular/router';
 import { CommonModule } from '@angular/common';
 import { OidcSecurityService } from 'angular-auth-oidc-client';
-import type { UserInfoResponse } from '@logto/js';
+import type { UserInfoResponse } from '@logto/angular';
 
 @Component({
   selector: 'app-root',

packages/angular-sample/src/app/app.config.ts

@@ -5,7 +5,7 @@ import { provideAuth } from 'angular-auth-oidc-client';
 import { routes } from './app.routes';
 import { provideClientHydration } from '@angular/platform-browser';
 import { provideHttpClient, withFetch } from '@angular/common/http';
-import { UserScope, buildAngularAuthConfig } from '@logto/js';
+import { UserScope, buildAngularAuthConfig } from '@logto/angular';
 
 export const appConfig: ApplicationConfig = {
   providers: [

packages/angular/README.md

@@ -0,0 +1,3 @@
+# Logto Angular helper
+
+This package provides a helper for Angular to use Logto.

packages/angular/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@logto/angular",
+  "version": "0.0.0",
+  "type": "module",
+  "module": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    "types": "./lib/index.d.ts",
+    "import": "./lib/index.js",
+    "default": "./lib/index.js"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/logto-io/js.git",
+    "directory": "packages/angular"
+  },
+  "scripts": {
+    "dev:tsc": "tsc -p tsconfig.build.json -w --preserveWatchOutput",
+    "precommit": "lint-staged",
+    "check": "tsc --noEmit",
+    "build": "rm -rf lib/ && tsc -p tsconfig.build.json --noEmit && rollup -c",
+    "lint": "eslint --ext .ts --ext .tsx src",
+    "prepack": "pnpm build && pnpm test"
+  },
+  "dependencies": {
+    "@logto/js": "workspace:^",
+    "@silverhand/essentials": "^2.9.2"
+  },
+  "devDependencies": {
+    "@silverhand/eslint-config": "^6.0.1",
+    "@silverhand/eslint-config-react": "^6.0.2",
+    "@silverhand/ts-config": "^6.0.0",
+    "@silverhand/ts-config-react": "^6.0.0",
+    "angular-auth-oidc-client": "^19.0.0",
+    "eslint": "^8.57.0",
+    "lint-staged": "^15.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^2.1.9"
+  },
+  "eslintConfig": {
+    "extends": "@silverhand"
+  },
+  "prettier": "@silverhand/eslint-config/.prettierrc",
+  "publishConfig": {
+    "access": "public"
+  }
+}

packages/angular/rollup.config.js

@@ -0,0 +1 @@
+export { default } from '../../rollup.config.js';

packages/js/src/utils/angular.ts renamed to packages/angular/src/index.ts

@@ -1,11 +1,7 @@
+import { Prompt, QueryKey, type SignInUriParameters, withReservedScopes } from '@logto/js';
 import { conditional } from '@silverhand/essentials';
 import { type OpenIdConfiguration } from 'angular-auth-oidc-client';
 
-import { Prompt, QueryKey } from '../consts/index.js';
-import { type SignInUriParameters } from '../index.js';
-
-import { withReservedScopes } from './scopes.js';
-
 /** The Logto configuration object for Angular apps. */
 export type LogtoAngularConfig = {
   /**
@@ -166,3 +162,6 @@ export const buildAngularAuthConfig = (logtoConfig: LogtoAngularConfig): OpenIdC
     },
   };
 };
+
+export type { UserInfoResponse } from '@logto/js';
+export { UserScope } from '@logto/js';

packages/angular/tsconfig.build.json

@@ -0,0 +1,6 @@
+{
+  "extends": "./tsconfig",
+  "include": [
+    "src",
+  ]
+}

packages/angular/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "@silverhand/ts-config-react/tsconfig.base",
+  "compilerOptions": {
+    "noEmit": false,
+    "outDir": "lib",
+    "types": ["vitest/globals"]
+  },
+  "include": [
+    "src",
+    "vitest.config.ts"
+  ]
+}