@unopsitg/ux 21.0.2

package/README.md

@@ -0,0 +1,56 @@
+# @unopsitg/ux
+
+Angular 21 library: UNOPS brand theme (PrimeNG / PrimeUIX), application layout shell, and shared demo types.
+
+## Install
+
+```bash
+npm install @unopsitg/ux
+```
+
+## Bootstrap
+
+```typescript
+// app.config.ts
+import { ApplicationConfig } from '@angular/core';
+import { providePrimeNG } from 'primeng/config';
+import { BrandSoft, MENU_MODEL, LayoutService } from '@unopsitg/ux';
+import { createDemoAppMenu } from './app/config/app-menu';
+import { environment } from './environments/environment';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    providePrimeNG({ theme: { preset: BrandSoft, options: { darkModeSelector: '.app-dark' } } }),
+    {
+      provide: MENU_MODEL,
+      useFactory: (layoutService: LayoutService) =>
+        createDemoAppMenu(layoutService, environment.storybookBaseUrl),
+      deps: [LayoutService]
+    }
+  ]
+};
+```
+
+## Styles and assets
+
+Reference library SCSS/Tailwind and copy bundled logos into your app output:
+
+```json
+// angular.json — styles (library bundles layout SCSS via `assets/styles.scss`)
+"styles": [
+  "node_modules/@unopsitg/ux/assets/styles.scss",
+  "node_modules/@unopsitg/ux/assets/tailwind.css",
+  "src/styles.scss"
+],
+"assets": [
+  { "glob": "**/*", "input": "node_modules/@unopsitg/ux/assets/opp", "output": "assets/opp" }
+]
+```
+
+When developing **inside this monorepo**, use paths under `projects/unops-ux/src/assets/` instead of `node_modules`.
+
+## Tokens
+
+- `MENU_MODEL` — injectable menu tree (`MenuItem[]`).
+- `SIDEBAR_LOGO` — expanded/compact logo URLs and `alt` text (defaults match UNOPS assets).
+- `TOPBAR_MOBILE_LOGO` — light/dark mobile header logos.

package/assets/_animations.scss

@@ -0,0 +1,47 @@
+@use './_sass_variables' as *;
+
+router-outlet + * {
+    display: block;
+    animation: fade-in-up 0.35s ease-out both;
+}
+
+.card {
+    transition: box-shadow 0.25s ease;
+
+    &:hover {
+        box-shadow: $sidebarShadow;
+    }
+}
+
+/* ── Expand / collapse (grid-row technique) ── */
+.expand-body {
+    display: grid;
+    grid-template-rows: 0fr;
+    opacity: 0;
+    transition:
+        grid-template-rows 0.3s ease-in,
+        opacity 0.3s ease-in;
+
+    &--open {
+        grid-template-rows: 1fr;
+        opacity: 1;
+        transition:
+            grid-template-rows 0.3s ease-out,
+            opacity 0.3s ease-out;
+    }
+
+    &__inner {
+        overflow: hidden;
+        min-height: 0;
+    }
+}
+
+@media (prefers-reduced-motion: reduce) {
+    *,
+    *::before,
+    *::after {
+        animation-duration: 0.01ms !important;
+        animation-iteration-count: 1 !important;
+        transition-duration: 0.01ms !important;
+    }
+}

package/assets/_breadcrumb.scss

@@ -0,0 +1,71 @@
+.layout-breadcrumb {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    min-width: 0;
+    overflow: hidden;
+
+    @media screen and (min-width: 768px) {
+        gap: 1rem;
+    }
+
+    ol {
+        display: flex;
+        align-items: center;
+        margin: 0;
+        padding: 0;
+        list-style: none;
+        gap: 0.5rem;
+
+        li {
+            white-space: nowrap;
+            line-height: 1.5;
+            overflow: hidden;
+            text-overflow: ellipsis;
+            max-width: 10rem;
+
+            @media screen and (min-width: 768px) {
+                max-width: none;
+            }
+
+            a {
+                color: var(--p-text-color);
+                position: relative;
+                text-decoration: none;
+                z-index: 0;
+                cursor: pointer;
+
+                &::before {
+                    background: var(--p-primary-200);
+                    content: '';
+                    inset: 0;
+                    position: absolute;
+                    transform: scaleX(0);
+                    transform-origin: right;
+                    transition: transform 0.3s ease-in-out;
+                    z-index: -1;
+
+                    .app-dark & {
+                        background: var(--p-primary-800);
+                    }
+                }
+
+                &:hover::before {
+                    transform: scaleX(1);
+                    transform-origin: left;
+                }
+
+                @media (prefers-reduced-motion: reduce) {
+                    &::before {
+                        transition: none;
+                    }
+                }
+            }
+        }
+    }
+}
+
+.content-breadcrumb {
+    margin-bottom: 2rem;
+    padding: 0 .5rem;
+}

package/assets/_card.scss

@@ -0,0 +1,11 @@
+.card {
+    margin-bottom: 0;
+}
+
+.layout-card-filled .card{
+    background: var(--surface-card);
+}
+
+.layout-card-transparent .card{
+    background: transparent;
+}

package/assets/_config.scss

@@ -0,0 +1,95 @@
+.layout-config-button {
+    display: block;
+    position: fixed;
+    width: 3rem;
+    height: 3rem;
+    line-height: 3rem;
+    background: var(--primary-color);
+    color: var(--primary-contrast-color);
+    text-align: center;
+    top: 50%;
+    right: 0;
+    margin-top: -1.5rem;
+    border-top-left-radius: var(--border-radius);
+    border-bottom-left-radius: var(--border-radius);
+    border-top-right-radius: 0;
+    border-bottom-right-radius: 0;
+    transition: background-color var(--transition-duration);
+    overflow: hidden;
+    cursor: pointer;
+    z-index: 999;
+    box-shadow: -0.25rem 0 1rem rgba(0, 0, 0, 0.15);
+
+    &.config-link {
+        font-size: 1rem;
+        font-family: 'Noto Sans', sans-serif;
+        border: none;
+    }
+
+    .config-link:focus {
+        outline: 0 none;
+        outline-offset: 0;
+        box-shadow: 0 0 0 1px var(--focus-ring-shadow);
+    }
+
+    i {
+        font-size: 2rem;
+        line-height: inherit;
+        transform: rotate(0deg);
+        transition: transform 1s;
+    }
+
+    &:hover {
+        background: var(--p-primary-400);
+    }
+}
+
+.app-config-button {
+    border: 1px solid var(--border-color);
+    background-color: var(--card-background);
+    position: relative;
+    z-index: 0;
+    border-radius: 0px;
+    width: 2.5rem;
+    height: 2.5rem;
+    line-height: 2.5rem;
+    text-align: center;
+    cursor: pointer;
+
+    i {
+        line-height: inherit;
+        font-size: 1.125rem;
+    }
+    &::before,
+    &::after {
+        content: '';
+        position: absolute;
+        inset: 0;
+        border: 1px solid var(--p-primary-color);
+        transition: all 0.5s;
+        animation: clippath 3s infinite linear;
+        border-radius: 4px;
+        opacity: 1;
+    }
+
+    &::after {
+        animation: clippath 3s infinite -1.5s linear;
+    }
+}
+
+@keyframes clippath {
+    0%,
+    100% {
+        clip-path: inset(0 0 90% 0);
+    }
+
+    25% {
+        clip-path: inset(0 90% 0 0);
+    }
+    50% {
+        clip-path: inset(90% 0 0 0);
+    }
+    75% {
+        clip-path: inset(0 0 0 90%);
+    }
+}

package/assets/_content.scss

@@ -0,0 +1,55 @@
+@use '_sass_variables' as *;
+
+.layout-wrapper {
+    height: 100vh;
+    display: flex;
+    flex-direction: column;
+
+    > app-configurator,
+    > [app-search],
+    > [app-rightmenu] {
+        flex: none;
+        width: 0;
+        overflow: visible;
+    }
+
+}
+
+.layout-body {
+    flex: 1;
+    min-height: 0;
+    display: flex;
+    position: relative;
+    overflow: hidden;
+}
+
+.layout-content-wrapper {
+    flex: 1;
+    min-width: 0;
+    min-height: 0;
+    overflow-y: auto;
+    overflow-x: hidden;
+    z-index: 9;
+}
+.layout-content-wrapper-inside {
+    width: 100%;
+    max-width: 1540px;
+    margin-inline: auto;
+    min-height: 100%;
+    display: flex;
+    flex-direction: column;
+    
+}
+.layout-content {
+    padding: 2rem;
+    flex: 1 1 auto;
+    position: relative;
+
+    @media screen and (min-width: 576px) {
+        padding: 1.5rem;
+    }
+
+    @media screen and (min-width: 992px) {
+        padding: 1.5rem;
+    }
+}

package/assets/_fonts.scss

@@ -0,0 +1 @@
+/* Noto Sans is loaded via Google Fonts CDN in index.html */

package/assets/_footer.scss

@@ -0,0 +1,17 @@
+.layout-footer {
+    height: 4rem;
+    padding: 1rem;
+    display: flex;
+    align-items: center;
+    justify-content: flex-end;
+    text-align: right;
+
+    @media screen and (min-width: 992px) {
+        padding: 2rem;
+    }
+
+    .footer-copyright {
+        font-size: var(--font-size-sm);
+        color: var(--text-muted-color);
+    }
+}

package/assets/_main.scss

@@ -0,0 +1,38 @@
+@use '_sass_variables' as *;
+
+html {
+    height: 100%;
+    font-size: 16px;
+    line-height: 1.5;
+}
+
+body {
+    font-family: 'Noto Sans', sans-serif;
+    font-weight: 400;
+    color: var(--text-color);
+    background-color: var(--surface-ground);
+    padding: 0;
+    margin: 0;
+    min-height: 100%;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+}
+
+@media screen and (min-width: $breakpoint) {
+    :root:not(.app-dark) body {
+        background: linear-gradient(355deg, var(--p-primary-100) 5%, var(--p-surface-100) 50%, var(--p-surface-50) 80%);
+    }
+
+    .app-dark body {
+        background: linear-gradient(355deg, var(--p-primary-800) 5%, var(--p-surface-900) 60%, var(--p-surface-950) 86%);
+    }
+}
+
+a {
+    text-decoration: none;
+}
+
+img {
+    max-width: 100%;
+    height: auto;
+}

package/assets/_mask.scss

@@ -0,0 +1,7 @@
+.layout-mask {
+    display: none;
+    position: absolute;
+    inset: 0;
+    background-color: var(--p-mask-background);
+    z-index: 998;
+}

package/assets/_paginator.scss

@@ -0,0 +1,16 @@
+// PrimeUIX paginator defaults to flex-wrap: wrap, which splits << < 1 2 3 … > >> across
+// lines in narrow cards. Keep one row; scroll horizontally only if still too tight.
+.p-paginator.p-component {
+  flex-wrap: nowrap !important;
+  max-width: 100%;
+  min-width: 0;
+  overflow-x: auto;
+  overflow-y: hidden;
+  overscroll-behavior-x: contain;
+  scrollbar-width: thin;
+}
+
+.p-paginator-content {
+  flex-wrap: nowrap !important;
+  min-width: 0;
+}

package/assets/_responsive.scss

@@ -0,0 +1,203 @@
+@use '_sass_variables' as *;
+
+@media screen and (min-width: $breakpoint) {
+    .layout-static-inactive {
+        .layout-sidebar {
+            margin-left: -14rem;
+        }
+        .layout-topbar {
+            .menu-button {
+                i:before {
+                    content: '\e901';
+                }
+            }
+        }
+    }
+
+    .layout-overlay {
+        .layout-topbar {
+            .menu-button {
+                i:before {
+                    content: '\e901';
+                }
+            }
+        }
+        .layout-sidebar {
+            position: absolute;
+            left: 0;
+            transform: translateX(-100%);
+            background-color: var(--d-sidebar-bg-color);
+            z-index: 99999;
+        }
+        &.layout-overlay-active {
+            .layout-sidebar {
+                border-right: var(--d-sidebar-border);
+                position: absolute;
+                transform: translateX(0);
+                box-shadow: $sidebarShadow;
+                background-color: var(--d-sidebar-bg-color);
+            }
+        }
+    }
+
+    .layout-mask {
+        display: none;
+    }
+}
+
+@media screen and (max-width: ($breakpoint - 1)) {
+    .blocked-scroll {
+        overflow: hidden;
+    }
+
+    .layout-body {
+        flex: 1;
+        min-height: 0;
+        position: relative;
+    }
+
+    [app-topbar] {
+        height: fit-content;
+    }
+
+    .layout-topbar {
+        display: flex;
+        flex-direction: row;
+        align-items: center;
+        justify-content: space-between;
+        position: relative;
+        width: 100%;
+        padding: 0.75rem 1rem;
+        height: fit-content;
+
+        .topbar-left {
+            display: none;
+        }
+
+        .topbar-right {
+            display: flex;
+            align-items: center;
+        }
+
+        .menu-button {
+            i:before {
+                content: '\e91d';
+            }
+        }
+
+        .mobile-logo {
+            display: block;
+            position: absolute;
+            left: 50%;
+            top: 50%;
+            transform: translate(-50%, -50%);
+
+            img {
+                width: auto;
+                height: clamp(1.25rem, 2rem + 1vw, 2.5rem);
+                object-fit: contain;
+            }
+        }
+
+        .mobile-menu-button {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            width: 2.75rem;
+            height: 2.75rem;
+            border-radius: 2rem;
+            border: none;
+            background: transparent;
+            padding: 0;
+            color: var(--p-primary-600);
+            cursor: pointer;
+            transition: background-color var(--transition-duration);
+
+            &:hover {
+                background: var(--surface-hover);
+            }
+
+            i {
+                font-size: 1rem;
+            }
+        }
+
+        .viewname {
+            font-size: 1rem;
+        }
+
+        .topbar-menu {
+            justify-content: flex-end;
+            gap: 0.25rem;
+            > li {
+                margin-left: 0;
+
+                &.right-sidebar-item {
+                    display: none;
+                }
+
+                &.profile-item {
+                    border-left: 0;
+                    border-right: 0;
+                    padding: 0;
+                    border-radius: 2rem;
+
+                    > a {
+                        padding: 0;
+                    }
+
+                    .profile-image {
+                        width: 2rem;
+                        height: 2rem;
+                        margin: 0;
+                    }
+
+                    .profile-name {
+                        display: none;
+                    }
+                }
+            }
+        }
+    }
+    .layout-sidebar {
+        position: absolute;
+        z-index: 999;
+        box-shadow: 0 0 1rem rgba(0, 0, 0, 0.15);
+        left: 0;
+        transform: translateX(-100%);
+
+        .layout-topbar {
+            display: none;
+        }
+    }
+
+    :root:not(.app-dark) .layout-sidebar {
+        background: var(--surface-ground);
+    }
+
+    .app-dark .layout-sidebar-dark .layout-sidebar,
+    .app-dark .layout-sidebar-light .layout-sidebar {
+        background: var(--d-sidebar-bg-color);
+    }
+
+    .layout-mobile-active {
+        .layout-sidebar {
+            transform: translateX(0);
+        }
+
+        .layout-mask {
+            display: block;
+            animation: fadein var(--layout-section-transition-duration);
+        }
+    }
+
+    .layout-search {
+        .search-container {
+            width: 90vw;
+
+            @media screen and (min-width: 576px) {
+                width: 75vw;
+            }
+        }
+    }
+}

package/assets/_sass_variables.scss

@@ -0,0 +1,2 @@
+$breakpoint: 992px !default;
+$sidebarShadow: 0px 1px 2px 0px rgba(18, 18, 23, 0.05) !default;

package/assets/_search.scss

@@ -0,0 +1,35 @@
+.search-container {
+    background: var(--surface-overlay);
+    display: flex;
+    align-items: center;
+    font-size: 1.5rem;
+    padding: 2rem;
+    border-radius: var(--border-radius);
+    position: relative;
+    box-shadow:
+        0px 11px 15px -7px rgba(0, 0, 0, 0.2),
+        0px 24px 38px 3px rgba(0, 0, 0, 0.14),
+        0px 9px 46px 8px rgba(0, 0, 0, 0.12);
+    border: var(--surface-border);
+    -webkit-backface-visibility: hidden;
+    backface-visibility: hidden;
+    pointer-events: all;
+
+    input {
+        appearance: none;
+        font-size: 1.5rem;
+        text-indent: 2.5rem;
+        padding: 0.5rem;
+        width: 100%;
+    }
+
+    i {
+        color: var(--text-muted-color);
+        width: 2rem;
+        font-size: 1.5rem;
+        position: absolute;
+        top: 50%;
+        margin-top: -0.75rem;
+        margin-left: 1rem;
+    }
+}