Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 6 additions & 7 deletions .github/instructions/build-scripts.instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,6 @@ Node.js automation scripts for building and packaging the Angular SDK.
| `copy-npm-assets-to-components.js` | `build-angular-sdk-components` | Copies SECURITY.md, LICENSE, doc/ to `dist/angular-sdk-components/` |
| `copy-npm-assets-to-overrides.js` | `postbuild-overrides` | Copies SECURITY.md, LICENSE to `packages/angular-sdk-overrides/` |
| `copy-file.js` | — | Generic file copy utility used by other scripts |
| `extra-webpack.config.js` | Angular CLI build (via `@angular-builders/custom-webpack`) | Copies OAuth `auth.html` and `authDone.js` from `@pega/auth` into `dist/` |
| `update-dependencies.js` | `create_and_install_sdk_packages` | Builds both packages, creates `.tgz` files, and installs them into the `angular-sdk` consumer repo |
| `playwright-message.js` | `pretest` (before E2E) | Prints "Running in headless mode" info message |

Expand Down Expand Up @@ -120,20 +119,20 @@ The component library uses **ng-packagr** (not Webpack) for building:
- Config: `packages/angular-sdk-components/ng-package.json`
- Entry point: `src/public-api.ts` — all public exports must be listed here
- Output: `dist/angular-sdk-components/` (FESM bundles + typings)
- Builder: `@angular-devkit/build-angular:ng-packagr` (configured in `angular.json`)
- Builder: `@angular/build:ng-packagr` (configured in `angular.json`)

### Angular CLI (App builds)
The test app uses Angular CLI with `@angular-builders/custom-webpack`:
- Extends standard Angular build with `extra-webpack.config.js`
- The custom webpack config only adds `CopyWebpackPlugin` for OAuth auth files
- Dev server: `ng serve --port 3500`
The test app uses the Angular CLI esbuild-based `@angular/build:application` builder (no custom webpack):
- Output goes directly to `dist/` (`outputPath.browser` is `""`)
- OAuth `auth.html` and `authDone.js` are copied from `node_modules/@pega/auth/lib/oauth-client/` via the `assets` array in `angular.json`
- Dev server: `@angular/build:dev-server` (`ng serve --port 3500`)
- Two Angular projects in workspace: `angular-sdk-components` (library) and `angular-test-app` (application)

### Key differences from the React build
| Concern | React | Angular |
|---------|-------|---------|
| Library bundler | TypeScript compiler (`tsc`) | ng-packagr (FESM bundles) |
| App bundler | Webpack | Angular CLI (esbuild/webpack) |
| App bundler | Webpack | Angular CLI (esbuild) |
| Export generation | `build-exports.js` auto-generates | Manual — `public-api.ts` must be edited |
| Component map transform | `edit-pega-components-map-in-lib.js` | Not needed (ng-packagr handles re-exports) |

Expand Down
50 changes: 50 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,61 @@
# [26.1.11](https://github.com/pegasystems/angular-sdk/tree/release/26.1.11)

## Breaking changes

* Upgraded the `Angular` version to 22, the `Angular Material` version to 22, and the `TypeScript` version to 6.
* Github: [PR-659](https://github.com/pegasystems/angular-sdk-components/pull/659)
* Upgraded `@pega/auth` to version 0.3.x.
* Github: [PR-659](https://github.com/pegasystems/angular-sdk-components/pull/659)

## Non Breaking changes

### **Bug fixes**
* **Fixed Dropdown labels not displaying the selected value after a lookup data page call.**
* Github: [PR-623](https://github.com/pegasystems/angular-sdk-components/pull/623)

* **Fixed `TextInput`, `Email`, `URL`, and `TextArea` fields showing an empty value after being hidden and shown again by a visibility condition.**
* Github: [PR-656](https://github.com/pegasystems/angular-sdk-components/pull/656)
---

### **Dependencies & Infrastructure**

* The **@angular-builders/custom-webpack**, **@angular-devkit/build-angular**, **copy-webpack-plugin**, and **webpack** packages have been removed. The builds now use `@angular/build`.
* Github: [PR-659](https://github.com/pegasystems/angular-sdk-components/pull/659)
* The **@angular-eslint/eslint-plugin**, **@angular-eslint/eslint-plugin-template**, and **@angular-eslint/template-parser** packages have been replaced with **angular-eslint**.
* Github: [PR-659](https://github.com/pegasystems/angular-sdk-components/pull/659)
* The following table lists the packages that have been added:

| Package | Added version |
| :--- | :--- |
| **@angular/build** | 22.2.6 |
| **angular-eslint** | 22.6.0 |

* The following table lists the packages whose versions have been updated:

| Package | Updated version |
| :--- | :--- |
| **@angular/animations** | 22.2.5 |
| **@angular/cdk** | 22.2.6 |
| **@angular/cli** | 22.2.6 |
| **@angular/common** | 22.2.5 |
| **@angular/compiler** | 22.2.5 |
| **@angular/compiler-cli** | 22.2.5 |
| **@angular/core** | 22.2.5 |
| **@angular/forms** | 22.2.5 |
| **@angular/google-maps** | 22.2.6 |
| **@angular/language-service** | 22.2.5 |
| **@angular/material** | 22.2.6 |
| **@angular/material-experimental** | 22.2.6 |
| **@angular/material-moment-adapter** | 22.2.6 |
| **@angular/platform-browser** | 22.2.5 |
| **@angular/platform-browser-dynamic** | 22.2.5 |
| **@angular/router** | 22.2.5 |
| **@angular-devkit/core** | 22.2.6 |
| **@danielmoncada/angular-datetime-picker** | 22.0.0 |
| **@pega/auth** | 0.3.3 |
| **ng-packagr** | 22.2.6 |
| **typescript** | 6.0.3 |
| **typescript-eslint** | 8.72.2 |

# [26.1.10](https://github.com/pegasystems/angular-sdk/tree/release/26.1.10)

Expand Down
31 changes: 17 additions & 14 deletions angular.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
"prefix": "lib",
"architect": {
"build": {
"builder": "@angular-devkit/build-angular:ng-packagr",
"builder": "@angular/build:ng-packagr",
"options": {
"project": "packages/angular-sdk-components/ng-package.json"
},
Expand All @@ -28,7 +28,7 @@
"defaultConfiguration": "production"
},
"test": {
"builder": "@angular-devkit/build-angular:karma",
"builder": "@angular/build:karma",
"options": {
"tsConfig": "packages/angular-sdk-components/tsconfig.spec.json",
"polyfills": []
Expand All @@ -48,11 +48,13 @@
"prefix": "app",
"architect": {
"build": {
"builder": "@angular-builders/custom-webpack:browser",
"builder": "@angular/build:application",
"options": {
"outputPath": "dist",
"outputPath": {
"base": "dist",
"browser": ""
},
"index": "projects/angular-test-app/src/index.html",
"main": "projects/angular-test-app/src/main.ts",
"polyfills": [],
"tsConfig": "projects/angular-test-app/tsconfig.app.json",
"inlineStyleLanguage": "scss",
Expand All @@ -62,6 +64,11 @@
"input": "./",
"output": "./"
},
{
"glob": "{auth.html,authDone.js}",
"input": "./node_modules/@pega/auth/lib/oauth-client/",
"output": "./"
},
{
"glob": "bootstrap-shell.*",
"input": "./node_modules/@pega/constellationjs/dist/",
Expand Down Expand Up @@ -107,10 +114,8 @@
],
"styles": ["projects/angular-test-app/src/styles.scss"],
"scripts": [],
"customWebpackConfig": {
"path": "./scripts/extra-webpack.config.js"
},
"allowedCommonJsDependencies": ["lodash.clonedeep", "lodash.debounce", "downloadjs", "dayjs", "fast-deep-equal", "moment"]
"allowedCommonJsDependencies": ["lodash.clonedeep", "lodash.debounce", "downloadjs", "dayjs", "fast-deep-equal", "moment"],
"browser": "projects/angular-test-app/src/main.ts"
},
"configurations": {
"production": {
Expand All @@ -129,9 +134,7 @@
"outputHashing": "all"
},
"development": {
"buildOptimizer": false,
"optimization": false,
"vendorChunk": true,
"extractLicenses": false,
"sourceMap": true,
"namedChunks": true
Expand All @@ -140,7 +143,7 @@
"defaultConfiguration": "production"
},
"serve": {
"builder": "@angular-builders/custom-webpack:dev-server",
"builder": "@angular/build:dev-server",
"options": {
"buildTarget": "angular-test-app:build:development",
"port": 3500
Expand All @@ -156,13 +159,13 @@
"defaultConfiguration": "development"
},
"extract-i18n": {
"builder": "@angular-devkit/build-angular:extract-i18n",
"builder": "@angular/build:extract-i18n",
"options": {
"buildTarget": "angular-test-app:build"
}
},
"test": {
"builder": "@angular-devkit/build-angular:karma",
"builder": "@angular/build:karma",
"options": {
"polyfills": [],
"tsConfig": "projects/angular-test-app/tsconfig.spec.json",
Expand Down
19 changes: 8 additions & 11 deletions eslint.config.mjs
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
import { globalIgnores } from 'eslint/config';
import eslint from '@eslint/js';
import tseslint from 'typescript-eslint';
import angular from '@angular-eslint/eslint-plugin';
import angularTemplate from '@angular-eslint/eslint-plugin-template';
import angularTemplateParser from '@angular-eslint/template-parser';
import angular from 'angular-eslint';
import sonarjs from 'eslint-plugin-sonarjs';
import { defineConfig } from 'eslint/config';

Expand Down Expand Up @@ -37,8 +35,8 @@ export default defineConfig([
},

plugins: {
'@angular-eslint': angular,
'@angular-eslint/template': angularTemplate,
'@angular-eslint': angular.tsPlugin,
'@angular-eslint/template': angular.templatePlugin,
sonarjs
},
rules: {
Expand All @@ -58,12 +56,13 @@ export default defineConfig([
},
{
files: ['**/*.ts'],
extends: [eslint.configs.recommended, tseslint.configs.recommended, tseslint.configs.stylistic],
processor: angularTemplate.processors['extract-inline-html'],
extends: [eslint.configs.recommended, tseslint.configs.recommended, tseslint.configs.stylistic, angular.configs.tsRecommended],
processor: angular.processInlineTemplates,
rules: {
...angular.configs.recommended.rules,
'@angular-eslint/prefer-inject': 'off',
'@angular-eslint/prefer-standalone': 'off',
// Added to the recommended preset in angular-eslint 22; adopting OnPush is a behavioral change tracked separately
'@angular-eslint/prefer-on-push-component-change-detection': 'off',
'@angular-eslint/no-empty-lifecycle-method': 'off',
'@angular-eslint/directive-selector': ['error', { type: 'attribute', style: 'camelCase', prefix: ['app'] }],
'@angular-eslint/component-selector': ['error', { type: 'element', style: 'kebab-case', prefix: ['app', 'component', 'lib', 'wss'] }],
Expand All @@ -83,10 +82,8 @@ export default defineConfig([
},
{
files: ['**/*.html'],
languageOptions: { parser: angularTemplateParser },
extends: [angular.configs.templateRecommended, angular.configs.templateAccessibility],
rules: {
...angularTemplate.configs.recommended.rules,
...angularTemplate.configs.accessibility.rules,
'@angular-eslint/template/alt-text': 'off',
'@angular-eslint/template/label-has-associated-control': 'off',
'@angular-eslint/template/click-events-have-key-events': 'off',
Expand Down
Loading
Loading