chore: prepare 1.0.0 trusted npm release

Author: angular-bootstrap

.github/workflows/ci.yml

@@ -1,15 +1,16 @@
-name: CI (non-main)
+name: CI
 
 on:
   push:
-    branches-ignore:
+    branches:
       - main
   pull_request:
-    branches:
-      - '**'
+
+permissions:
+  contents: read
 
 jobs:
-  build-test:
+  library:
     runs-on: ubuntu-latest
 
     steps:
@@ -19,14 +20,28 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
+          node-version: 22.x
+
+      - name: Enable Corepack
+        run: corepack enable
 
       - name: Install dependencies
-        run: npm install
+        run: pnpm install --frozen-lockfile
+
+      - name: Lint
+        run: pnpm lint
 
       - name: Run tests
-        run: npm test
+        run: pnpm test:ci
 
       - name: Build library
-        run: npm run build
+        run: pnpm build
+
+      - name: Verify release package
+        run: pnpm release:verify
+
+      - name: Inspect npm package contents
+        run: pnpm pack:dry-run
+
+      - name: Audit production dependencies
+        run: pnpm security:audit

.github/workflows/release.yml

@@ -1,59 +1,75 @@
+name: Release @angular-bootstrap/ngbootstrap
+
 on:
+  release:
+    types:
+      - published
   push:
-    branches:
-      - main
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: read
+  id-token: write
 
 jobs:
-  build-test-release:
+  publish:
+    name: Publish to npm
     runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      id-token: write # CRITICAL: This enables OIDC authentication
-      packages: write
+    environment: npm-production
 
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-          always-auth: true
-          scope: '@angular-bootstrap'
+          node-version: 22.x
+          registry-url: https://registry.npmjs.org
 
-      - name: Clean dist
-        run: rm -rf dist
+      - name: Enable Corepack
+        run: corepack enable
 
       - name: Install dependencies
-        run: npm install
+        run: pnpm install --frozen-lockfile
+
+      - name: Lint
+        run: pnpm lint
 
       - name: Run tests
-        run: npm test
+        run: pnpm test:ci
 
       - name: Build library
-        run: npm run build
+        run: pnpm build
 
-      - name: Publish to npm
-        working-directory: dist/ngbootstrap
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: npm publish --provenance --access public
+      - name: Validate package metadata
+        run: pnpm release:verify
 
-      - name: Read version
-        id: pkg
+      - name: Validate release tag
         run: |
-          VERSION=$(node -p "require('./package.json').version")
-          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          set -euo pipefail
+          VERSION="$(node -p "require('./package.json').version")"
+          TAG="${GITHUB_REF_NAME}"
+          if [ "$TAG" != "v$VERSION" ]; then
+            echo "Release tag $TAG must match package version v$VERSION."
+            exit 1
+          fi
 
-      - name: Create GitHub Release
-        uses: actions/create-release@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          tag_name: v${{ steps.pkg.outputs.version }}
-          release_name: v${{ steps.pkg.outputs.version }}
-          generate_release_notes: true
+      - name: Verify version is unpublished
+        run: |
+          set -euo pipefail
+          VERSION="$(node -p "require('./package.json').version")"
+          if npm view "@angular-bootstrap/ngbootstrap@$VERSION" version >/dev/null 2>&1; then
+            echo "@angular-bootstrap/ngbootstrap@$VERSION is already published."
+            exit 1
+          fi
+
+      - name: Inspect npm package contents
+        run: pnpm pack:dry-run
+
+      - name: Audit production dependencies
+        run: pnpm security:audit
+
+      - name: Publish to npm
+        run: npm publish ./dist/ngbootstrap --access public --provenance

AGENTS.md

@@ -0,0 +1,18 @@
+# AGENTS.md
+
+## Scope
+
+This folder is the source for the `@angular-bootstrap/ngbootstrap` Angular library.
+
+## Rules
+
+- Treat `src/**` public exports, components, directives, services, inputs, outputs, and types as the source of truth.
+- Keep code Angular 21/22 compatible and prefer built-in control flow (`@if`, `@for`, `@switch`) in templates.
+- Keep Angular packages as peer dependencies. Mark optional integrations as optional peers.
+- Add or update focused specs for behavior changes.
+- Validate with the relevant Jest test and `pnpm build` before handing off.
+
+## Commands
+
+- `pnpm test -- <spec> --runInBand`
+- `pnpm build`

README.md

@@ -1,93 +1,80 @@
 # @angular-bootstrap/ngbootstrap
 
-Angular UI library providing Datagrid, Drag‑and‑drop, Pagination, Stepper, Splitter, Tree, Typeahead, and Chips components with Bootstrap‑friendly styling.
+Standalone Angular UI components with Bootstrap-friendly styling.
 
-## Features
+## What Is Included
 
-- Datagrid – sortable, filterable, paginated, Sticky Header/Footer, Sticky Rows, Grid Styling, editable table with export (PDF/Excel) support and accessible templates.
-- Drag & drop – lightweight list and item directives with keyboard‑friendly a11y helpers.
-- Pagination – standalone Bootstrap‑styled pagination component.
-- Stepper – horizontal/vertical stepper with custom labels, error states, theming hooks, and keyboard support.
-- Splitter – resizable horizontal/vertical panes with collapsing, keyboard resizing, and ARIA semantics.
-- Tree – keyboard-accessible tree with optional checkboxes, JSON-style expanders, and expand/collapse helpers.
-- Typeahead – Bootstrap dropdown overlay with debouncing, virtualization, single/multi select, chips/tags mode, custom templates, and Reactive Forms support.
-- Chips – small reusable chips/tags component used by Typeahead (can also be used standalone).
-- Angular + Bootstrap first – built for modern Angular (v21) and works with plain Bootstrap CSS; Material/Tailwind can be layered via custom styles.
+- DataGrid
+- Pagination
+- Typeahead
+- Tree
+- Splitter
+- Stepper
+- Chips
+- Drag and drop
 
-## Installation
+## Requirements
 
-```bash
-npm install @angular-bootstrap/ngbootstrap
-```
-
-Make sure your app:
+- Angular `>=21.0.0 <23.0.0`
+- RxJS `^7.8.0`
+- Bootstrap CSS in the consuming app
+- Bootstrap Icons when icon-based examples are used
 
-- Uses Angular 21 (peer deps: `>=21 <22`).
-- Includes Bootstrap CSS + Bootstrap Icons (for example in `angular.json` or global styles):
+## Install
 
-```css
-@import 'bootstrap/dist/css/bootstrap.min.css';
-@import 'bootstrap-icons/font/bootstrap-icons.css';
+```bash
+npm install @angular-bootstrap/ngbootstrap bootstrap bootstrap-icons
 ```
 
-## Usage overview
-
-All components are standalone, so you import them directly into your feature components.
+Optional integrations are installed only when you use those features:
 
-Key datagrid capabilities:
-
-- Sorting (`enableSorting`, `sortChange`).
-- Column/global filtering (`enableFiltering`, `enableGlobalFilter`, `filtersChange`).
-- Pagination (`enablePagination`, `pageSize`, `pageChange`).
-- Inline add/edit/delete (`enableAdd`, `enableEdit`, `enableDelete`, `rowAdd`, `rowSave`, `rowDelete`).
-- Stable row identity via `trackBy` (defaults to index).
-- Pluggable editing logic via `editService` (implement `NgbDatagridEditService`).
-- Export to PDF/Excel via `exportOptions`.
-
-Export requires optional peer dependencies. Install only if you use export:
-
-```sh
-npm install jspdf jspdf-autotable xlsx
+```bash
+npm install chart.js jspdf jspdf-autotable xlsx
 ```
 
-Stepper highlights:
-
-- Horizontal/vertical variants via `orientation`.
-- Custom labels with the `ngbStepLabel` directive.
-- Label and content positioning (`labelPosition`, `contentPosition`).
-- Error states and messages (`errorMessage` on steps).
-- Controlled navigation (`allowRevisit`, `next()`, `prev()`, `reset()` and events).
-- Theming hooks via `theme` and CSS classes (`bootstrap`, `material`, `tailwind`).
-
-Refer to the source under `src/drag-drop` and `src/datagrid`/`src/stepper` for full API details until a dedicated docs site is added.
+## Use
+
+Import standalone components directly in your Angular component.
+
+```ts
+import { Component } from '@angular/core';
+import { NgbDatagridComponent, type ColumnDef } from '@angular-bootstrap/ngbootstrap';
+
+@Component({
+  selector: 'app-users-grid',
+  standalone: true,
+  imports: [NgbDatagridComponent],
+  template: `
+    <ngb-datagrid
+      [data]="users"
+      [columns]="columns"
+      [enableSorting]="true"
+      filterable="row"
+      [enablePagination]="true"
+      [pageSize]="10"
+    />
+  `,
+})
+export class UsersGridComponent {
+  users = [
+    { id: 1, name: 'Ava Patel', role: 'Admin' },
+    { id: 2, name: 'Noah Chen', role: 'Editor' },
+  ];
+
+  columns: ColumnDef[] = [
+    { field: 'id', header: 'ID', type: 'number', width: 90, sortable: true },
+    { field: 'name', header: 'Name', type: 'text', sortable: true, filterable: true },
+    { field: 'role', header: 'Role', type: 'text', filterable: true },
+  ];
+}
+```
 
 ## Development
 
-Local setup:
-
 ```bash
-npm install
-npm run lint
-npm test
-npm run build
+pnpm install
+pnpm test
+pnpm build
 ```
 
-- Build artefacts go to `dist/`.
-- Tests are powered by Jest + `jest-preset-angular`.
-
-## Releasing
-
-Releases are automated via GitHub Actions:
-
-- Non‑`main` branches:
-  - `.github/workflows/ci.yml` runs install, tests, build only.
-- `main` branch:
-  - `.github/workflows/release.yml` runs install, tests, build and publishes to npm using `NPM_TOKEN` from repository secrets.
-
-Recommended release flow:
-
-- On your local machine:
-  - Decide the new version (e.g. `1.1.0`).
-  - Run `npm version minor` or `npm version patch` to bump `package.json` and create the tag.
-  - Push the commit and tag: `git push origin main --tags`.
-- GitHub Actions will build and publish that tagged version to npm.
+Build output is written to `dist/`.