@abgov/nx-adsp 13.28.0 → 13.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abgov/nx-adsp",
-  "version": "13.28.0",
+  "version": "13.29.0",
   "license": "Apache-2.0",
   "main": "src/index.js",
   "description": "Government of Alberta - Nx plugin for ADSP apps.",

package/src/generators/vue-admin-crud/vue-admin-crud.js

@@ -5,6 +5,7 @@ const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
 const path = require("path");
 const vue_router_1 = require("../../utils/vue-router");
+const vue_side_menu_1 = require("../../utils/vue-side-menu");
 const vue_components_1 = require("../vue-components/vue-components");
 // Nx's own CLI option coercion (coerceTypesInOptions in nx/src/utils/params)
 // only knows how to split an array-typed option on commas -- it has no JSON
@@ -51,6 +52,11 @@ function default_1(host, options) {
             requiresAuth: normalizedOptions.requiresAuth,
             layout: 'wide',
         });
+        // The list is the nav destination; the edit form is reached from it.
+        (0, vue_side_menu_1.insertSideMenuItem)(host, normalizedOptions.projectRoot, {
+            label: normalizedOptions.heading,
+            to: normalizedOptions.route,
+        });
         yield (0, devkit_1.formatFiles)(host);
     });
 }

package/src/generators/vue-admin-crud/vue-admin-crud.js.map

@@ -1 +1 @@
-{"version":3,"file":"vue-admin-crud.js","sourceRoot":"","sources":["../../../../../../packages/nx-adsp/src/generators/vue-admin-crud/vue-admin-crud.ts"],"names":[],"mappings":";;AAkDA,4BAmCC;;AArFD,uCAMoB;AACpB,6BAA6B;AAC7B,uDAAwD;AACxD,qEAE0C;AAG1C,6EAA6E;AAC7E,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,iEAAiE;AACjE,SAAS,WAAW,CAAC,MAAwB;IAC3C,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAU,EAAE,OAAe;;IACnD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAA,iCAAwB,EAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E,MAAM,SAAS,GAAG,IAAA,cAAK,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;IAChD,0EAA0E;IAC1E,+BAA+B;IAC/B,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,OAAO,mCAAI,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,uCACK,OAAO,KACV,WAAW,EACX,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EACnC,gBAAgB,EAAE,GAAG,SAAS,UAAU,EACxC,gBAAgB,EAAE,GAAG,SAAS,UAAU,EACxC,OAAO,EACP,aAAa,EAAE,MAAA,OAAO,CAAC,aAAa,mCAAI,OAAO,EAC/C,YAAY,EAAE,MAAA,OAAO,CAAC,YAAY,mCAAI,IAAI,IAC1C;AACJ,CAAC;AAED,mBAA+B,IAAU,EAAE,OAAe;;QACxD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE1D,2EAA2E;QAC3E,oCAAoC;QACpC,MAAM,IAAA,wBAAsB,EAAC,IAAI,CAAC,CAAC;QAEnC,IAAA,sBAAa,EACX,IAAI,EACJ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAC7B,iBAAiB,CAAC,WAAW,kCAExB,iBAAiB,KACpB,aAAa,EAAE,IAAA,wCAAuB,EAAC,IAAI,CAAC,EAC5C,IAAI,EAAE,EAAE,IAEX,CAAC;QAEF,yEAAyE;QACzE,sEAAsE;QACtE,uEAAuE;QACvE,IAAA,2BAAc,EAAC,IAAI,EAAE,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,CAAC,OAAO,EAAE;YAC7E,IAAI,EAAE,GAAG,iBAAiB,CAAC,KAAK,MAAM;YACtC,mBAAmB,EAAE,YAAY,iBAAiB,CAAC,gBAAgB,MAAM;YACzE,YAAY,EAAE,iBAAiB,CAAC,YAAY;YAC5C,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,IAAA,2BAAc,EAAC,IAAI,EAAE,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,CAAC,OAAO,EAAE;YAC7E,IAAI,EAAE,iBAAiB,CAAC,KAAK;YAC7B,mBAAmB,EAAE,YAAY,iBAAiB,CAAC,gBAAgB,MAAM;YACzE,YAAY,EAAE,iBAAiB,CAAC,YAAY;YAC5C,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA"}
+{"version":3,"file":"vue-admin-crud.js","sourceRoot":"","sources":["../../../../../../packages/nx-adsp/src/generators/vue-admin-crud/vue-admin-crud.ts"],"names":[],"mappings":";;AAmDA,4BAyCC;;AA5FD,uCAMoB;AACpB,6BAA6B;AAC7B,uDAAwD;AACxD,6DAA+D;AAC/D,qEAE0C;AAG1C,6EAA6E;AAC7E,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,iEAAiE;AACjE,SAAS,WAAW,CAAC,MAAwB;IAC3C,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAU,EAAE,OAAe;;IACnD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAA,iCAAwB,EAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E,MAAM,SAAS,GAAG,IAAA,cAAK,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;IAChD,0EAA0E;IAC1E,+BAA+B;IAC/B,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,OAAO,mCAAI,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,uCACK,OAAO,KACV,WAAW,EACX,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EACnC,gBAAgB,EAAE,GAAG,SAAS,UAAU,EACxC,gBAAgB,EAAE,GAAG,SAAS,UAAU,EACxC,OAAO,EACP,aAAa,EAAE,MAAA,OAAO,CAAC,aAAa,mCAAI,OAAO,EAC/C,YAAY,EAAE,MAAA,OAAO,CAAC,YAAY,mCAAI,IAAI,IAC1C;AACJ,CAAC;AAED,mBAA+B,IAAU,EAAE,OAAe;;QACxD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE1D,2EAA2E;QAC3E,oCAAoC;QACpC,MAAM,IAAA,wBAAsB,EAAC,IAAI,CAAC,CAAC;QAEnC,IAAA,sBAAa,EACX,IAAI,EACJ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAC7B,iBAAiB,CAAC,WAAW,kCAExB,iBAAiB,KACpB,aAAa,EAAE,IAAA,wCAAuB,EAAC,IAAI,CAAC,EAC5C,IAAI,EAAE,EAAE,IAEX,CAAC;QAEF,yEAAyE;QACzE,sEAAsE;QACtE,uEAAuE;QACvE,IAAA,2BAAc,EAAC,IAAI,EAAE,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,CAAC,OAAO,EAAE;YAC7E,IAAI,EAAE,GAAG,iBAAiB,CAAC,KAAK,MAAM;YACtC,mBAAmB,EAAE,YAAY,iBAAiB,CAAC,gBAAgB,MAAM;YACzE,YAAY,EAAE,iBAAiB,CAAC,YAAY;YAC5C,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,IAAA,2BAAc,EAAC,IAAI,EAAE,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,CAAC,OAAO,EAAE;YAC7E,IAAI,EAAE,iBAAiB,CAAC,KAAK;YAC7B,mBAAmB,EAAE,YAAY,iBAAiB,CAAC,gBAAgB,MAAM;YACzE,YAAY,EAAE,iBAAiB,CAAC,YAAY;YAC5C,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,qEAAqE;QACrE,IAAA,kCAAkB,EAAC,IAAI,EAAE,iBAAiB,CAAC,WAAW,EAAE;YACtD,KAAK,EAAE,iBAAiB,CAAC,OAAO;YAChC,EAAE,EAAE,iBAAiB,CAAC,KAAK;SAC5B,CAAC,CAAC;QAEH,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA"}

package/src/generators/vue-app/files/AGENTS.md__tmpl__

@@ -234,34 +234,31 @@ mark what's meant to be edited.
    { path: '/queue', component: () => import('../views/QueueView.vue'), meta: { layout: 'wide' } }
    { path: '/apply', component: () => import('../views/ApplyView.vue'), meta: { layout: 'form' } }
    ```
-3. **For the `internal` layout: add a nav link to `src/App.vue`.** The generated shell only
-   populates `accountItems`; primary navigation lives in `primaryItems` (or `secondaryItems`).
-   `AppSideMenu` emits one `itemClick` for all slots — the generated `onItemClick` already
-   dispatches by `item.to`: items with a `to` route, items without sign in/out. Add only
-   `primaryItems`:
+3. **For the `internal` layout: check the side-menu nav.** `src/App.vue` has a plain
+   `primaryItems` array — the app's own navigation list, seeded with Home. Each `vue-*-view`
+   generator that adds a staff screen appends its entry automatically, so a generated route is
+   navigable without you doing anything.
+
+   It is a literal array, not derived from the router, on purpose: nav order, grouping and
+   labels are decisions this app owns. Reorder, relabel, group into `secondaryItems`, or prune
+   freely — the generators only ever append, and never touch an entry that already exists for
+   that route.
 
    ```typescript
-   // In <script setup> — route, router, and onItemClick are already in the generated App.vue:
-   // Icon names from the GoA icon set: design.alberta.ca/components/icons
-   const primaryItems = computed(() => [
-     { label: 'Home',       to: '/',           icon: 'home', current: route.path === '/' },
-     { label: 'My Feature', to: '/my-feature', icon: 'list', current: route.path.startsWith('/my-feature') },
-   ])
+   const primaryItems = [
+     { label: 'Home', to: '/', icon: 'home' },
+     { label: 'Review queue', to: '/queue' },   // added by vue-workspace-view
+   ];
    ```
 
-   ```html
-   <!-- In <template>, add :primary-items to <AppSideMenu>
-        (@item-click="onItemClick" is already wired in the generated shell): -->
-   <AppSideMenu
-     heading="..."
-     :primary-items="primaryItems"
-     :account-items="accountItems"
-     @item-click="onItemClick"
-   >
-   ```
+   Two things worth adding by hand: **`icon`** is effectively required —
+   `goa-work-side-menu-item` renders a blank item without one, and the generators can't guess it
+   (icon names: [design.alberta.ca/components/icons](https://design.alberta.ca/components/icons)).
+   And **`current`** for active highlighting, e.g. `current: route.path.startsWith('/queue')`,
+   which needs the `route` already in scope.
 
-   The `header` layout has no side menu — add route-level breadcrumbs or a secondary nav
-   directly inside the view component instead.
+   The `header` layout has no side menu, so it has no `primaryItems` array and the generators
+   skip the step silently — use route-level breadcrumbs or a nav inside the view instead.
 
 ## Backend API calls (proxy setup)
 

package/src/generators/vue-app/files/src/App.vue__tmpl__

@@ -32,6 +32,14 @@ function signInAgain() {
 }
 <% if (layout === 'internal') { %>
 
+// The app's main navigation. Every `vue-*-view` generator that adds a staff
+// screen appends an entry here, and it is yours to reorder, relabel, group or
+// prune -- a generated app is a starting point, not a fixed shell. Items are
+// `{ label, to }`; add `icon` for a leading icon or `badge` for a count.
+const primaryItems = [
+  { label: 'Home', to: '/' },
+];
+
 // AppSideMenu's items are presentational — it doesn't know about Keycloak or
 // routing; it just renders whatever's passed and emits itemClick on click.
 const accountItems = computed(() => [
@@ -56,6 +64,7 @@ function onItemClick(item: { to?: string }) {
 <% if (layout === 'internal') { %>
   <AppSideMenu
     heading="<%= projectName %>"
+    :primary-items="primaryItems"
     :account-items="accountItems"
     @item-click="onItemClick"
   >

package/src/generators/vue-app/vue-app.spec.ts

@@ -193,6 +193,12 @@ describe('Vue App Generator', () => {
     expect(app).toContain('<AppFooter />');
   }, 30000);
 
+  it('the header layout has no side-menu nav array (there is no side menu)', async () => {
+    await generator(host, options);
+    const app = host.read('apps/test/src/App.vue').toString();
+    expect(app).not.toContain('primaryItems');
+  });
+
   it('--layout=internal generates an AppSideMenu shell instead of AppHeader/AppFooter', async () => {
     await generator(host, { ...options, layout: 'internal' });
 
@@ -206,6 +212,12 @@ describe('Vue App Generator', () => {
     expect(app).toContain('<AppSideMenu');
     expect(app).toContain('heading="test"');
     expect(app).toContain(':account-items="accountItems"');
+    // A plain, editable nav array -- the app's own list, seeded with Home and
+    // appended to by each staff view generator. Not derived from the router:
+    // nav order, grouping and labels are the owning team's decisions.
+    expect(app).toContain(':primary-items="primaryItems"');
+    expect(app).toContain('const primaryItems = [');
+    expect(app).toContain("{ label: 'Home', to: '/' },");
     expect(app).toContain('@item-click="onItemClick"');
     // The content gutter is shared regardless of shell choice.
     expect(app).toContain('<AppLayout');

package/src/generators/vue-components/files/src/lib/patterns/AppSideMenu.vue__tmpl__

@@ -86,10 +86,26 @@ const emit = defineEmits<{ itemClick: [item: AppSideMenuItem] }>();
 
 <style scoped>
 .app-side-menu {
-  min-height: 100vh;
+  /* Bounded height, so .app-side-menu-content's overflow-y below actually
+     engages. With min-height the flex container grows past the viewport, the
+     content pane never overflows within it, and the DOCUMENT scrolls instead --
+     carrying the side menu off the top, which is the one thing a persistent
+     nav must not do. The overflow-y rule below was always intended to be the
+     scroll container; it was simply inert.
+     dvh tracks mobile browser chrome; vh is the fallback for older engines. */
+  height: 100vh;
+  height: 100dvh;
+  overflow: hidden;
   display: flex;
 }
 
+.app-side-menu > goa-work-side-menu {
+  /* A nav longer than the viewport scrolls within its own column rather than
+     being clipped by the container's overflow: hidden. */
+  overflow-y: auto;
+  flex: 0 0 auto;
+}
+
 .app-side-menu-content {
   flex: 1;
   min-width: 0;

package/src/generators/vue-components/vue-components.spec.ts

@@ -93,6 +93,16 @@ describe('Vue Components Generator', () => {
     const formattersSrc = host
       .read('libs/vue-components/src/lib/formatters.ts')
       .toString();
+    // The staff shell must scroll its content, not the document -- otherwise
+    // the persistent side menu scrolls off the top. Verified in a real browser;
+    // this pins the rule so it can't regress to min-height.
+    const sideMenu = host
+      .read('libs/vue-components/src/lib/patterns/AppSideMenu.vue')
+      .toString();
+    expect(sideMenu).toContain('height: 100dvh');
+    expect(sideMenu).toContain('overflow: hidden');
+    expect(sideMenu).not.toContain('min-height: 100vh');
+
     // goa-form-stepper's `step` prop drives the progress bar; without it every
     // page of a wizard renders step one as current.
     const stepper = host

package/src/generators/vue-workspace-view/vue-workspace-view.js

@@ -5,6 +5,7 @@ const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
 const path = require("path");
 const vue_router_1 = require("../../utils/vue-router");
+const vue_side_menu_1 = require("../../utils/vue-side-menu");
 const vue_components_1 = require("../vue-components/vue-components");
 // Nx's own CLI option coercion (coerceTypesInOptions in nx/src/utils/params)
 // only knows how to split an array-typed option on commas -- it has no JSON
@@ -62,6 +63,11 @@ function default_1(host, options) {
             // A multi-column table at the 1000px default wraps every cell.
             layout: 'wide',
         });
+        // No-op on a header-layout app, which has no side menu.
+        (0, vue_side_menu_1.insertSideMenuItem)(host, normalizedOptions.projectRoot, {
+            label: normalizedOptions.heading,
+            to: normalizedOptions.route,
+        });
         yield (0, devkit_1.formatFiles)(host);
     });
 }

package/src/generators/vue-workspace-view/vue-workspace-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"vue-workspace-view.js","sourceRoot":"","sources":["../../../../../../packages/nx-adsp/src/generators/vue-workspace-view/vue-workspace-view.ts"],"names":[],"mappings":";;AA8EA,4BA2BC;;AAzGD,uCAMoB;AACpB,6BAA6B;AAC7B,uDAAwD;AACxD,qEAE0C;AAQ1C,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,8EAA8E;AAC9E,iEAAiE;AACjE,SAAS,YAAY,CAAC,OAA0B;IAC9C,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+DAA+D;AAC/D,SAAS,YAAY,CAAC,OAA0B;IAC9C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,MAAM,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,uDAAuD,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,GAAG,IAAI,CAC3F,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAU,EAAE,OAAe;;IACnD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAA,iCAAwB,EAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E,MAAM,SAAS,GAAG,IAAA,cAAK,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;IAChD,uCACK,OAAO,KACV,WAAW,EACX,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EACtC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EACtC,YAAY,EAAE,GAAG,SAAS,UAAU;QACpC,sEAAsE;QACtE,6CAA6C;QAC7C,OAAO,EAAE,MAAA,OAAO,CAAC,OAAO,mCAAI,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,EACvE,QAAQ,EAAE,MAAA,OAAO,CAAC,QAAQ,mCAAI,EAAE,EAChC,UAAU,EAAE,MAAA,OAAO,CAAC,UAAU,mCAAI,IAAI,EACtC,YAAY,EAAE,MAAA,OAAO,CAAC,YAAY,mCAAI,IAAI;QAC1C,6EAA6E;QAC7E,2EAA2E;QAC3E,4EAA4E;QAC5E,WAAW,EAAE,MAAA,OAAO,CAAC,WAAW,mCAAI,IAAI,IACxC;AACJ,CAAC;AAED,mBAA+B,IAAU,EAAE,OAAe;;QACxD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE1D,2EAA2E;QAC3E,oCAAoC;QACpC,MAAM,IAAA,wBAAsB,EAAC,IAAI,CAAC,CAAC;QAEnC,IAAA,sBAAa,EACX,IAAI,EACJ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAC7B,iBAAiB,CAAC,WAAW,kCAExB,iBAAiB,KACpB,aAAa,EAAE,IAAA,wCAAuB,EAAC,IAAI,CAAC,EAC5C,IAAI,EAAE,EAAE,IAEX,CAAC;QAEF,IAAA,2BAAc,EAAC,IAAI,EAAE,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,CAAC,OAAO,EAAE;YAC7E,IAAI,EAAE,iBAAiB,CAAC,KAAK;YAC7B,mBAAmB,EAAE,YAAY,iBAAiB,CAAC,YAAY,MAAM;YACrE,YAAY,EAAE,iBAAiB,CAAC,YAAY;YAC5C,+DAA+D;YAC/D,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA"}
+{"version":3,"file":"vue-workspace-view.js","sourceRoot":"","sources":["../../../../../../packages/nx-adsp/src/generators/vue-workspace-view/vue-workspace-view.ts"],"names":[],"mappings":"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"}

package/src/generators/vue-workspace-view/vue-workspace-view.spec.ts

@@ -9,6 +9,13 @@ import { Schema } from './schema';
 
 // Mirrors the shape vue-app's own template generates -- vue-workspace-view
 // retrofits into this file, so the fixture must match what it actually looks for.
+const APP_VUE_INTERNAL_FIXTURE = `<script setup lang="ts">
+const primaryItems = [
+  { label: 'Home', to: '/' },
+];
+</script>
+`;
+
 const ROUTER_FIXTURE = `import { createRouter, createWebHistory } from 'vue-router';
 import HomeView from '../views/HomeView.vue';
 
@@ -41,6 +48,7 @@ describe('Vue Workspace View Generator', () => {
     host = createTreeWithEmptyWorkspace({ layout: 'apps-libs' });
     addProjectConfiguration(host, 'test', { root: 'apps/test' });
     host.write('apps/test/src/router/index.ts', ROUTER_FIXTURE);
+    host.write('apps/test/src/App.vue', APP_VUE_INTERNAL_FIXTURE);
   });
 
   it('throws when --project does not exist', async () => {
@@ -263,6 +271,13 @@ describe('Vue Workspace View Generator', () => {
     expect(view).toContain(':per-page-count="50"');
   }, 30000);
 
+  it('adds nothing to the side menu when the app has no App.vue', async () => {
+    host.delete('apps/test/src/App.vue');
+    // A header-layout app has no side menu; adding a staff view to one must not
+    // fail, it simply has no nav to join.
+    await expect(generator(host, baseOptions)).resolves.not.toThrow();
+  });
+
   it('inserts the route into router/index.ts, requiring auth by default', async () => {
     await generator(host, baseOptions);
 
@@ -274,6 +289,10 @@ describe('Vue Workspace View Generator', () => {
     expect(routerTs).toContain('requiresAuth: true');
     // A data table asks for the wide variant -- the generator knows it emitted one.
     expect(routerTs).toContain("layout: 'wide'");
+    // A staff queue is a nav destination, so the generator adds it to the
+    // app's side-menu list rather than leaving the route reachable only by URL.
+    const appVue = host.read('apps/test/src/App.vue').toString();
+    expect(appVue).toContain("to: '/applications'");
     expect(routerTs).toContain("{ path: '/', component: HomeView }");
   }, 30000);
 

package/src/utils/vue-side-menu.d.ts

@@ -0,0 +1,19 @@
+import { Tree } from '@nx/devkit';
+export interface SideMenuItemSpec {
+    /** Nav label shown in the side menu, e.g. 'Review queue'. */
+    label: string;
+    /** Route path the item navigates to, e.g. '/queue'. */
+    to: string;
+}
+/**
+ * Adds a nav item to a generated app's side menu.
+ *
+ * A no-op when the app has no `primaryItems` array. That is the signal the app
+ * was generated with `--layout=header` (a public app has no side menu at all),
+ * so adding a staff view to it should not fail or warn -- there is simply no nav
+ * to add to.
+ *
+ * Idempotent: re-running a generator, or two generators claiming the same path,
+ * leaves one entry.
+ */
+export declare function insertSideMenuItem(host: Tree, projectRoot: string, item: SideMenuItemSpec): void;

package/src/utils/vue-side-menu.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insertSideMenuItem = insertSideMenuItem;
+// Deterministic text insertion into vue-app's `primaryItems` array, mirroring
+// insertVueRoute's approach for the same reason: the template's shape is fixed,
+// so a targeted anchor beats pulling in an AST library for one array entry.
+//
+// The array is a plain literal in App.vue rather than something derived from the
+// router, deliberately: a generated app is an opinionated starting point, and
+// nav order, grouping and labels are decisions the owning team should be able to
+// read and change in one obvious place -- not behaviour resolved at runtime by
+// the shell that every app then has to work around.
+const ANCHOR = 'const primaryItems = [';
+/**
+ * Adds a nav item to a generated app's side menu.
+ *
+ * A no-op when the app has no `primaryItems` array. That is the signal the app
+ * was generated with `--layout=header` (a public app has no side menu at all),
+ * so adding a staff view to it should not fail or warn -- there is simply no nav
+ * to add to.
+ *
+ * Idempotent: re-running a generator, or two generators claiming the same path,
+ * leaves one entry.
+ */
+function insertSideMenuItem(host, projectRoot, item) {
+    var _a;
+    const appPath = `${projectRoot}/src/App.vue`;
+    const content = (_a = host.read(appPath)) === null || _a === void 0 ? void 0 : _a.toString();
+    if (content === undefined)
+        return;
+    const anchorIndex = content.indexOf(ANCHOR);
+    if (anchorIndex === -1)
+        return;
+    if (content.includes(`to: '${item.to}'`))
+        return;
+    const insertAt = anchorIndex + ANCHOR.length;
+    host.write(appPath, content.slice(0, insertAt) +
+        `\n  { label: '${item.label}', to: '${item.to}' },` +
+        content.slice(insertAt));
+}
+//# sourceMappingURL=vue-side-menu.js.map

package/src/utils/vue-side-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue-side-menu.js","sourceRoot":"","sources":["../../../../../packages/nx-adsp/src/utils/vue-side-menu.ts"],"names":[],"mappings":";;AA+BA,gDAqBC;AA3CD,8EAA8E;AAC9E,gFAAgF;AAChF,4EAA4E;AAC5E,EAAE;AACF,iFAAiF;AACjF,8EAA8E;AAC9E,iFAAiF;AACjF,+EAA+E;AAC/E,oDAAoD;AACpD,MAAM,MAAM,GAAG,wBAAwB,CAAC;AAExC;;;;;;;;;;GAUG;AACH,SAAgB,kBAAkB,CAChC,IAAU,EACV,WAAmB,EACnB,IAAsB;;IAEtB,MAAM,OAAO,GAAG,GAAG,WAAW,cAAc,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAA,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,0CAAE,QAAQ,EAAE,CAAC;IAC/C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO;IAElC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,WAAW,KAAK,CAAC,CAAC;QAAE,OAAO;IAE/B,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,EAAE,GAAG,CAAC;QAAE,OAAO;IAEjD,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,IAAI,CAAC,KAAK,CACR,OAAO,EACP,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;QACxB,iBAAiB,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,EAAE,MAAM;QACnD,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAC1B,CAAC;AACJ,CAAC"}

package/src/utils/vue-side-menu.spec.ts

@@ -0,0 +1,71 @@
+import { Tree } from '@nx/devkit';
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+import { insertSideMenuItem } from './vue-side-menu';
+
+const INTERNAL_APP = `<script setup lang="ts">
+const primaryItems = [
+  { label: 'Home', to: '/' },
+];
+</script>
+`;
+
+// A header-layout app has no side menu at all, so no array to insert into.
+const HEADER_APP = `<script setup lang="ts">
+const accountItems = computed(() => []);
+</script>
+`;
+
+describe('insertSideMenuItem', () => {
+  let host: Tree;
+
+  beforeEach(() => {
+    host = createTreeWithEmptyWorkspace({ layout: 'apps-libs' });
+  });
+
+  it('inserts an item into the app nav array', () => {
+    host.write('apps/staff/src/App.vue', INTERNAL_APP);
+    insertSideMenuItem(host, 'apps/staff', {
+      label: 'Review queue',
+      to: '/queue',
+    });
+    const app = host.read('apps/staff/src/App.vue').toString();
+    expect(app).toContain("{ label: 'Review queue', to: '/queue' },");
+    // The seeded Home entry survives.
+    expect(app).toContain("{ label: 'Home', to: '/' },");
+  });
+
+  it('is idempotent on the same route', () => {
+    host.write('apps/staff/src/App.vue', INTERNAL_APP);
+    const item = { label: 'Review queue', to: '/queue' };
+    insertSideMenuItem(host, 'apps/staff', item);
+    insertSideMenuItem(host, 'apps/staff', item);
+    const app = host.read('apps/staff/src/App.vue').toString();
+    expect(app.split("to: '/queue'").length - 1).toBe(1);
+  });
+
+  it('does not re-add a route already present under a different label', () => {
+    host.write('apps/staff/src/App.vue', INTERNAL_APP);
+    insertSideMenuItem(host, 'apps/staff', { label: 'Queue', to: '/queue' });
+    insertSideMenuItem(host, 'apps/staff', { label: 'Renamed', to: '/queue' });
+    const app = host.read('apps/staff/src/App.vue').toString();
+    expect(app).toContain("label: 'Queue'");
+    expect(app).not.toContain("label: 'Renamed'");
+  });
+
+  it('is a silent no-op on a header-layout app with no side menu', () => {
+    host.write('apps/public/src/App.vue', HEADER_APP);
+    expect(() =>
+      insertSideMenuItem(host, 'apps/public', {
+        label: 'Review queue',
+        to: '/queue',
+      }),
+    ).not.toThrow();
+    expect(host.read('apps/public/src/App.vue').toString()).toBe(HEADER_APP);
+  });
+
+  it('is a silent no-op when there is no App.vue at all', () => {
+    expect(() =>
+      insertSideMenuItem(host, 'apps/missing', { label: 'X', to: '/x' }),
+    ).not.toThrow();
+  });
+});