@softheon/armature 19.23.1 → 19.23.3

package/lib/base-components/sof-badge/sof-badge.component.d.ts

@@ -12,6 +12,8 @@ export declare class SofBadgeComponent {
     badgeColor: 'info' | 'success' | 'warn' | 'error' | 'theme' | 'neutral' | 'metal-tier';
     /** Whether or not to use default icons */
     useIcon: boolean;
+    /** Whether or not to use default icons */
+    isNotificationType: boolean;
     /** The icon class- this should be a Phosphor Icons class, type bold */
     iconClass: string;
     /** The badge aria label */
@@ -38,7 +40,7 @@ export declare class SofBadgeComponent {
     /** Sets the icon based on badge type */
     private setIcon;
     static ɵfac: i0.ɵɵFactoryDeclaration<SofBadgeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SofBadgeComponent, "sof-badge", never, { "bold": { "alias": "bold"; "required": false; }; "badgeText": { "alias": "badgeText"; "required": false; }; "badgeColor": { "alias": "badgeColor"; "required": false; }; "useIcon": { "alias": "useIcon"; "required": false; }; "iconClass": { "alias": "iconClass"; "required": false; }; "badgeAria": { "alias": "badgeAria"; "required": false; }; "iconAria": { "alias": "iconAria"; "required": false; }; "tooltipData": { "alias": "tooltipData"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SofBadgeComponent, "sof-badge", never, { "bold": { "alias": "bold"; "required": false; }; "badgeText": { "alias": "badgeText"; "required": false; }; "badgeColor": { "alias": "badgeColor"; "required": false; }; "useIcon": { "alias": "useIcon"; "required": false; }; "isNotificationType": { "alias": "isNotificationType"; "required": false; }; "iconClass": { "alias": "iconClass"; "required": false; }; "badgeAria": { "alias": "badgeAria"; "required": false; }; "iconAria": { "alias": "iconAria"; "required": false; }; "tooltipData": { "alias": "tooltipData"; "required": false; }; }, {}, never, never, false, never>;
 }
 export declare enum STATUS {
     INFO = "info",

package/lib/navigation/components/sof-navigation-panel/models/nav-panel-nodes.d.ts

@@ -46,6 +46,10 @@ export interface NavPanelNode {
      * Node route url
     */
     route?: string;
+    /**
+     * Badge config
+    */
+    badgeConfig?: NavNodeBadgeConfig;
     /**
      * Subnodes array
      * @description If sub nodes are present,
@@ -95,5 +99,36 @@ interface NavPanelSubnode {
      * Subnode route url
     */
     route?: string;
+    /**
+     * Badge config
+    */
+    badgeConfig?: NavNodeBadgeConfig;
+}
+/**
+ * Navigation node badge configuration
+*/
+export interface NavNodeBadgeConfig {
+    /** Badge type - 'notification' for red badges, 'status' for primary badges */
+    type: 'notification' | 'status';
+}
+/**
+ * Available badge data
+ * @note the nav-panel returns this as @Output() event
+*/
+export interface NavNodeAvailableBadge {
+    /** node index */
+    nodeIndex: number;
+    /** node sub index */
+    subnodeIndex?: number;
+    /** the nodes label */
+    nodeLabel: string;
+    /** the nodes badge type - 'notification' for red badges, 'status' for primary badges */
+    badgeType: 'notification' | 'status';
+}
+/** Interface for badge update events */
+export interface NavBadgeUpdate {
+    nodeIndex: number;
+    value: string;
+    subIndex?: number;
 }
 export {};

package/lib/navigation/components/sof-navigation-panel/sof-nav-panel.component.d.ts

@@ -1,19 +1,19 @@
-import { EventEmitter, OnInit, Signal } from '@angular/core';
+import { EventEmitter, OnChanges, OnInit, Signal, SimpleChanges, WritableSignal } from '@angular/core';
 import { BreakpointState } from '@angular/cdk/layout';
 import { MatSidenavContent } from '@angular/material/sidenav';
-import { NavPanelNode } from './models/nav-panel-nodes';
+import { NavNodeAvailableBadge, NavPanelNode } from './models/nav-panel-nodes';
 import { NavPanelSettings } from './models/nav-panel-settings';
 import { NavPanelLogo } from './models/nav-panel-logo';
 import * as i0 from "@angular/core";
 /**
  * The Navigation Panel Component
  * @description Main navigation panel for Portals, part of the new Portal UI-shell.
- * @note Designed to be used with the 'SofHeaderPortalComponent' component as its child.
+ * @note Designed to be used with the 'SofHeaderComponent' component as its child.
  * @see [Figma/portal-ui-shell]({@link https://www.figma.com/design/W5HVNCcN9HafDRvc5N7Z28/%5BWIP%5D-Softheon-Unified-Design-System-v1.0?node-id=14089-118395&t=G5IKDvYHpwU0vOFq-0})
  *
  * @todo `mobile styling` - awaiting design, minor adjustments have been made - 1/2/25 ...
 */
-export declare class SofNavPanelComponent implements OnInit {
+export declare class SofNavPanelComponent implements OnInit, OnChanges {
     /**
      * Component Input (required) - Navigation node data
      * @see {@link NavPanelNode}
@@ -49,7 +49,7 @@ export declare class SofNavPanelComponent implements OnInit {
      * @note this is the element which has the apps 'main' scrollbar.
     */
     sidenavContent: MatSidenavContent;
-    /** This is the navpanel element */
+    /** This is the navPanel element */
     private navPanel;
     /** Utility for checking the matching state of media queries.*/
     private breakpointObserver;
@@ -60,11 +60,23 @@ export declare class SofNavPanelComponent implements OnInit {
     /** The previous break point state */
     private previousBreakpointState;
     /**
-     * Constructor.
+     * Badge values signal
+     * @description Map of node index to badge value string
+     * @example { 0: '5', 2: '12' } - node at index 0 shows '5', node at index 2 shows '12'
      */
+    badgeValues: WritableSignal<Record<number, string>>;
+    /** The nodes with badge configs */
+    nodeBadges: WritableSignal<Array<NavNodeAvailableBadge>>;
+    /** Emits the nodes with badge configs */
+    availableNodeBadges: EventEmitter<Array<NavNodeAvailableBadge>>;
+    /**
+     * Constructor.
+    */
     constructor();
     /** On Init - Initialize the settings */
     ngOnInit(): void;
+    /** On Changes - find node badges and emit the results */
+    ngOnChanges(changes: SimpleChanges): void;
     /**
      * Initializes the nav panel settings, defaults will be set if `null` or `undefined`
      * @note The 'nullish coalescing assignment operator' `??=` assigns defaults for `boolean` and `number` types,
@@ -82,6 +94,37 @@ export declare class SofNavPanelComponent implements OnInit {
      * Configuring `scrollPositionRestoration` in the router module will not work either.
     */
     scrollToTop(): void;
+    /**
+     * Gets the badge value for a specific node index
+     * @param index The flattened node index (accounts for subnodes)
+     * @returns The badge value string or empty string if not found
+     */
+    getBadgeValue(index: number): string;
+    /**
+     * Updates the badge value for a specific node or subnode
+     * @param nodeIndex The parent node index
+     * @param value The badge value to set
+     * @param subIndex The subnode index (optional, for subnodes only)
+     * @example
+     * // Update a regular node badge
+     * updateBadgeValue(0, '5');
+     *
+     * // Update a subnode badge
+     * updateBadgeValue(6, '12', 0); // 6th node, 1st subnode
+     */
+    updateBadgeValue(nodeIndex: number, value: string, subIndex?: number): void;
+    /**
+     * Calculates the flattened index for a node or subnode
+     * @param nodeIndex The parent node index
+     * @param subIndex The subnode index (optional)
+     * @returns The flattened index accounting for all previous nodes and subnodes
+     */
+    getFlatIndex(nodeIndex: number, subIndex?: number): number;
+    /**
+     * Finds all nodes with badge configurations
+     * @returns Array of badge information objects
+     */
+    private findBadges;
     static ɵfac: i0.ɵɵFactoryDeclaration<SofNavPanelComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SofNavPanelComponent, "sof-nav-panel", never, { "nodes": { "alias": "nodes"; "required": true; }; "settings": { "alias": "settings"; "required": false; }; "scrollToTopOnNavigationEndEvent": { "alias": "scrollToTopOnNavigationEndEvent"; "required": false; }; "brandLogo": { "alias": "brandLogo"; "required": false; }; "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "isAutoShrink": { "alias": "isAutoShrink"; "required": false; }; }, { "isNavPanelOpenedEvent": "isNavPanelOpenedEvent"; }, never, ["[sof-nav-panel-main-content]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SofNavPanelComponent, "sof-nav-panel", never, { "nodes": { "alias": "nodes"; "required": true; }; "settings": { "alias": "settings"; "required": false; }; "scrollToTopOnNavigationEndEvent": { "alias": "scrollToTopOnNavigationEndEvent"; "required": false; }; "brandLogo": { "alias": "brandLogo"; "required": false; }; "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "isAutoShrink": { "alias": "isAutoShrink"; "required": false; }; }, { "isNavPanelOpenedEvent": "isNavPanelOpenedEvent"; "availableNodeBadges": "availableNodeBadges"; }, never, ["[sof-nav-panel-main-content]"], true, never>;
 }

package/lib/snackbar/sof-snackbar/sof-snackbar.component.d.ts

@@ -7,6 +7,12 @@ export declare class SofSnackbarComponent {
     private _snackbarService;
     /** Snackbars array signal */
     snackbars: Signal<Array<_SnackbarInternal>>;
+    /** Position from top for the snackbar container */
+    positionTop: string | undefined;
+    /** Position from right for the snackbar container (default: 24px) */
+    positionRight: string;
+    /** Position from bottom for the snackbar container (default: 24px) */
+    positionBottom: string;
     /** Live announcer for screen reader wcag */
     private _liveAnnouncerService;
     /** Translation service */
@@ -35,5 +41,5 @@ export declare class SofSnackbarComponent {
     */
     handleAction(snackbar: _SnackbarInternal): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SofSnackbarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SofSnackbarComponent, "sof-snackbar", never, {}, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SofSnackbarComponent, "sof-snackbar", never, { "positionTop": { "alias": "positionTop"; "required": false; }; "positionRight": { "alias": "positionRight"; "required": false; }; "positionBottom": { "alias": "positionBottom"; "required": false; }; }, {}, never, never, true, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softheon/armature",
-  "version": "19.23.1",
+  "version": "19.23.3",
   "dependencies": {
     "tslib": "^2.5.0"
   },