@ichicraft/widgets-widget-base 1.15.4 → 1.16.1

package/README.md

@@ -9,6 +9,14 @@ All notable changes to this project will be documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 1.16.1 - 2026-03-19
+
+-   Addition of `notificationBadgeCount` property to `CommandBarItemProps` to allow for a number to be displayed in the badge
+
+## 1.16.0 - 2026-03-09
+
+-   Addition of `cache` property to `instance`, `variant` and `manifest` level of `WidgetContext` to centralize cache handling and functionality
+
 ## 1.15.4 - 2026-01-07
 
 -   Override version of deep dependency 'validator' to get rid of potential vulnerability

package/lib/index.d.ts

@@ -1,2 +1,3 @@
 export { default as BaseWidget } from './BaseWidget';
 export * from './types';
+export type { CacheManager, SyncStore, AsyncStore, PutOptions } from '@ic/caching';

package/lib/types/index.d.ts

@@ -1,3 +1,4 @@
+import type { CacheManager } from '@ic/caching';
 import type { Client } from '@microsoft/microsoft-graph-client';
 import type { AadHttpClientFactory, AadTokenProviderFactory, SPHttpClient, SPHttpClientConfiguration } from '@microsoft/sp-http';
 import type { SPFI } from '@pnp/sp/presets/all';
@@ -386,6 +387,11 @@ export interface WidgetInstanceContext {
     raiseEvent?: (object: string, action: string, data?: {
         [key: string]: string;
     }) => void;
+    /**
+     * Cache manager scoped to this widget instance.
+     * Data stored here is specific to this instance only.
+     */
+    cache: CacheManager;
 }
 export interface WidgetBuddyContext {
     /**
@@ -429,6 +435,11 @@ export interface WidgetVariantContext {
      * The icon defined for this widget variant.
      */
     iconName?: string;
+    /**
+     * Cache manager scoped to this widget variant.
+     * Data stored here is shared across all instances of this variant, but isolated from other variants.
+     */
+    cache: CacheManager;
 }
 /**
  * Widget manifest context providing metadata and functions offered by the widget board. A widget manifest contains
@@ -442,6 +453,11 @@ export interface WidgetManifestContext {
      * widget can be installed in the widget board, the id of the definition is the same as the id of the manifest.
      */
     id: string;
+    /**
+     * Cache manager scoped to this widget type (manifest level).
+     * Data stored here is shared across all variants and instances of this widget type.
+     */
+    cache: CacheManager;
 }
 export interface WidgetDesignContext {
     /** Available options in the ColorPicker.*/
@@ -775,9 +791,15 @@ export interface CommandBarItemProps {
      */
     label?: string;
     /**
-     * Optionally display a red notification icon badge in the top-right corner of the button.
+     * Optionally display a badge in the top-right corner of the button.
+     * Optionally use in conjunction with notificationBadgeCount to display a number inside the badge.
      */
     showNotificationBadge?: boolean;
+    /**
+     * Optional count to display in the notification badge.
+     * Only applies when showNotificationBadge is true, and will be truncated to "99+" when the count exceeds 99.
+     */
+    notificationBadgeCount?: number;
     /**
      * Optional severity to specify how the item should render
      */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ichicraft/widgets-widget-base",
-    "version": "1.15.4",
+    "version": "1.16.1",
     "description": "Part of the Widget Development Kit for building widgets for Ichicraft Boards",
     "main": "lib/index.js",
     "types": "lib/index.d.ts",
@@ -24,6 +24,7 @@
         "z-schema@<5.0.5": "5.0.5"
     },
     "dependencies": {
+        "@ic/caching": "~0.0.2",
         "@microsoft/microsoft-graph-client": "3.0.2",
         "@microsoft/sp-http": "1.18.2",
         "@pnp/sp": "4.0.1"