Production Release - June 26 / 2026

.gitattributes

@@ -0,0 +1,5 @@
+# Generated docs files: collapse by default in GitHub PR diffs (linguist-generated).
+# Deterministic build outputs (see docs/ARCHITECTURE.md). They stay fully diffable,
+# searchable, and in history; this only hides them by default in the Files Changed tab.
+docs/generated/** linguist-generated=true
+docs/public/search-index.json linguist-generated=true

.github/workflows/dev-release.yml

@@ -0,0 +1,126 @@
+name: Dev Release & Preview
+
+on:
+  push:
+    branches: [dev]
+  workflow_dispatch:
+
+concurrency:
+  group: dev-release
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+  id-token: write # Required for OIDC
+
+jobs:
+  dev-release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: "npm"
+          cache-dependency-path: |
+            package-lock.json
+            docs/package-lock.json
+
+      - name: Install npm 11
+        run: npm install -g npm@11
+
+      - name: Install dependencies
+        run: |
+          npm ci
+          cd docs && npm ci --legacy-peer-deps
+
+      # ---- Release libs to npm (dev prerelease channel) ----
+      - name: Get last successful commit
+        uses: nrwl/nx-set-shas@v4
+        id: last_successful_commit
+        with:
+          main-branch-name: ${{ github.ref_name }}
+
+      - name: Build libs
+        run: npm run build:prod
+
+      - name: Fix web-component lib README
+        run: cp libs/web-components/README.md dist/libs/web-components
+
+      - name: Release libs
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx nx affected --target release --parallel=false --base=${{ steps.last_successful_commit.outputs.base }}
+
+      # ---- Build + deploy docs & playground previews to Pages ----
+      - name: Build docs
+        env:
+          PREVIEW_SITE: https://govalta.github.io
+          PREVIEW_BASE: /ui-components/dev/
+        run: npx nx run docs:build
+
+      - name: Build React playground
+        env:
+          PREVIEW_BASE_REACT: /ui-components/dev-react/
+        run: npx nx run react-prs:build:production
+
+      - name: Build Angular playground
+        env:
+          PREVIEW_BASE_ANGULAR: /ui-components/dev-angular/
+        run: npx nx run angular-prs:build:production --base-href=$PREVIEW_BASE_ANGULAR
+
+      # force: false => rebase onto the latest gh-pages instead of force-pushing,
+      # so a concurrent PR-preview deploy to a different folder is not clobbered.
+      # clean-exclude protects the sibling folders as a safety net.
+      - name: Deploy docs
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: ./dist/docs
+          target-folder: dev
+          force: false
+          attempt-limit: 5
+          clean: true
+          clean-exclude: |
+            pr-preview
+            pr-preview-react
+            pr-preview-angular
+            dev-react
+            dev-angular
+
+      - name: Deploy React playground
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: ./dist/apps/prs/react
+          target-folder: dev-react
+          force: false
+          attempt-limit: 5
+          clean: true
+          clean-exclude: |
+            pr-preview
+            pr-preview-react
+            pr-preview-angular
+            dev
+            dev-angular
+
+      - name: Deploy Angular playground
+        uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          branch: gh-pages
+          folder: ./dist/apps/prs/angular/browser
+          target-folder: dev-angular
+          force: false
+          attempt-limit: 5
+          clean: true
+          clean-exclude: |
+            pr-preview
+            pr-preview-react
+            pr-preview-angular
+            dev
+            dev-react

.github/workflows/release-ci.yml → .github/workflows/main-release.yml

@@ -1,11 +1,9 @@
-name: Release CI
+name: Main Release
 
 on:
   push:
     branches:
       - main
-      - next
-      - dev
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
@@ -48,17 +46,14 @@ jobs:
 
       - name: Release libs
         env:
-          GITHUB_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: npx nx affected --target release --parallel=false --base=${{ steps.last_successful_commit.outputs.base }}
 
   release-docs:
     runs-on: ubuntu-latest
     needs: build
 
-    # this will get changed to main in the future
-    if: github.ref == 'refs/heads/dev'
-
     steps:
       - uses: actions/checkout@v5
         with:

.github/workflows/pull-request.yml

@@ -7,7 +7,6 @@ on:
   pull_request:
     branches:
       - main
-      - next
       - dev
 
 jobs:

.releaserc.json

@@ -3,10 +3,6 @@
   "branches": [
     "+([0-9])?(.{+([0-9]),x}).x",
     "main",
-    {
-      "name": "next",
-      "prerelease": true
-    },
     {
       "name": "dev",
       "prerelease": true

apps/prs/angular/src/app/app.component.html

@@ -1,78 +1,102 @@
 @if (!isFullPage) {
-  <div style="min-height: 100vh; display: flex; flex-direction: column">
-    <section slot="header" id="top" class="width" role="header" style="flex: 0 0 auto">
-      <goab-microsite-header type="alpha" version="UAT" />
-      <goab-app-header heading="Testing Playground" [url]="baseHref"></goab-app-header>
-    </section>
+  <ng-template #sideMenuTpl>
+    <goab-work-side-menu
+      heading="Testing Playground"
+      [url]="baseHref"
+      [open]="true"
+      (onNavigate)="handleNavigate($event)"
+      [primaryContent]="primaryTemplate"
+      [secondaryContent]="tokenToggleTemplate"
+    />
+  </ng-template>
+  <ng-template #tokenToggleTemplate>
+    <goab-work-side-menu-item
+      [label]="'Switch to ' + (tokenMode === 'v1' ? 'V2' : 'V1') + ' tokens'"
+      icon="swap-horizontal"
+      [url]="tokenToggleUrl"
+    />
+    <goab-work-side-menu-item
+      [icon]="theme.mode() === 'dark' ? 'sunny' : 'moon'"
+      [label]="theme.mode() === 'dark' ? 'Light mode' : 'Dark mode'"
+      url="#toggle-theme"
+    />
+  </ng-template>
 
-    <div
-      style="display: flex; flex: 1 1 auto; min-height: calc(100vh - 10.1875rem)"
-      [style.--goa-work-side-menu-height]="workSideMenuHeight"
-    >
-      <goab-work-side-menu
-        heading="Testing Playground"
-        [url]="baseHref"
-        [open]="true"
-        (onNavigate)="handleNavigate($event)"
-        [primaryContent]="primaryTemplate"
-        [secondaryContent]="secondaryTemplate"
-      >
-      </goab-work-side-menu>
 
-      <ng-template #secondaryTemplate>
+  <ng-template #primaryTemplate>
+    <goab-work-side-menu-item
+      label="All Components"
+      [url]="baseHref + 'everything'"
+      icon="list"
+    />
+    <goab-work-side-menu-group icon="alert-circle" heading="Bugs">
+      @for (route of bugRouteDefinitions; track route.path) {
         <goab-work-side-menu-item
-          [label]="'Switch to ' + (tokenMode === 'v1' ? 'V2' : 'V1') + ' tokens'"
-          icon="swap-horizontal"
-          [url]="tokenToggleUrl"
-        ></goab-work-side-menu-item>
+          [label]="route.id + ' - ' + route.title"
+          [url]="baseHref + route.path"
+        />
+      }
+    </goab-work-side-menu-group>
+    <goab-work-side-menu-group icon="book" heading="Docs">
+      @for (route of docsRouteDefinitions; track route.path) {
+        <goab-work-side-menu-item [label]="route.title" [url]="baseHref + route.path" />
+      }
+    </goab-work-side-menu-group>
+    <goab-work-side-menu-group icon="star" heading="Features">
+      @for (route of featureRouteDefinitions; track route.path) {
         <goab-work-side-menu-item
-          [icon]="theme.mode() === 'dark' ? 'sunny' : 'moon'"
-          [label]="theme.mode() === 'dark' ? 'Light mode' : 'Dark mode'"
-          url="#toggle-theme"
-        ></goab-work-side-menu-item>
-      </ng-template>
+          [label]="route.id + ' - ' + route.title"
+          [url]="baseHref + route.path"
+        />
+      }
+    </goab-work-side-menu-group>
+  </ng-template>
 
-      <ng-template #primaryTemplate>
-        <goab-work-side-menu-item
-          label="All Components"
-          [url]="baseHref + 'everything'"
-          icon="list"
-        ></goab-work-side-menu-item>
-        <goab-work-side-menu-group icon="alert-circle" heading="Bugs">
-          @for (route of bugRouteDefinitions; track route.path) {
-            <goab-work-side-menu-item
-              [label]="route.id + ' - ' + route.title"
-              [url]="baseHref + route.path"
-            ></goab-work-side-menu-item>
-          }
-        </goab-work-side-menu-group>
-        <goab-work-side-menu-group icon="book" heading="Docs">
-          @for (route of docsRouteDefinitions; track route.path) {
-            <goab-work-side-menu-item
-              [label]="route.title"
-              [url]="baseHref + route.path"
-            ></goab-work-side-menu-item>
-          }
-        </goab-work-side-menu-group>
-        <goab-work-side-menu-group icon="star" heading="Features">
-          @for (route of featureRouteDefinitions; track route.path) {
-            <goab-work-side-menu-item
-              [label]="route.id + ' - ' + route.title"
-              [url]="baseHref + route.path"
-            ></goab-work-side-menu-item>
-          }
-        </goab-work-side-menu-group>
-      </ng-template>
-      <section style="padding: 30px; width: 100%" role="main">
-        <router-outlet></router-outlet>
-      </section>
+  <ng-template #pageHeaderTpl>
+    <goab-app-header heading="Testing Playground" [url]="baseHref" />
+  </ng-template>
+  <ng-template #pageFooterTpl>
+    <goab-app-footer maxContentWidth="100%" />
+  </ng-template>
+
+  <ng-template #pushActionsTpl>
+    <goab-button-group alignment="end">
+      <goab-button type="secondary" (onClick)="closePushDrawer()">Cancel</goab-button>
+      <goab-button type="primary" (onClick)="closePushDrawer()">Save</goab-button>
+    </goab-button-group>
+  </ng-template>
+
+  <ng-template #pushDrawerTpl>
+    <goab-push-drawer
+      testId="push-drawer-v2"
+      heading="Push Drawer V2 test"
+      [open]="pushDrawerOpen()"
+      width="492px"
+      [actions]="pushActionsTpl"
+      (onClose)="closePushDrawer()"
+    >
+      @for (n of pushDrawerParagraphs; track n) {
+        <p>
+          Paragraph {{ n }} — Push Drawer V2 now uses goa-scroll-panel internally. Verify
+          header sticky + actions sticky + content scrolls + outer chrome morphs
+          (margins/radius/height) as scroll state changes between top / middle / bottom.
+        </p>
+      }
+    </goab-push-drawer>
+  </ng-template>
+
+  <goab-workspace-layout
+    [sideMenu]="sideMenuTpl"
+    [pageHeader]="pageHeaderTpl"
+    [pageFooter]="pageFooterTpl"
+    [pushDrawer]="isPushDrawerRoute ? pushDrawerTpl : undefined"
+  >
+    <div style="padding: 30px">
+      <router-outlet />
     </div>
-    <section slot="footer" role="footer" style="flex: 0 0 auto">
-      <goab-app-footer maxContentWidth="100%" />
-    </section>
-  </div>
+  </goab-workspace-layout>
 }
 
 @if (isFullPage) {
-  <router-outlet></router-outlet>
+  <router-outlet />
 }