@nucleus-suite-pe/core 1.0.0 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nucleus-suite-pe/core",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Capa compartida de la suite Nucleus: sesión única, permisos, tema y marco de aplicación para Angular.",
   "keywords": [
     "angular",
@@ -26,11 +26,17 @@
     "@primeuix/themes": "^3.0.0",
     "@angular/router": "^21.2.0",
     "@angular/forms": "^21.2.0",
-    "primeicons": "^8.0.0"
+    "primeicons": "^8.0.0",
+    "chart.js": "^4.4.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"
   },
+  "peerDependenciesMeta": {
+    "chart.js": {
+      "optional": true
+    }
+  },
   "module": "fesm2022/nucleus-suite-pe-core.mjs",
   "typings": "types/nucleus-suite-pe-core.d.ts",
   "exports": {
@@ -40,6 +46,10 @@
     ".": {
       "types": "./types/nucleus-suite-pe-core.d.ts",
       "default": "./fesm2022/nucleus-suite-pe-core.mjs"
+    },
+    "./charts": {
+      "types": "./types/nucleus-suite-pe-core-charts.d.ts",
+      "default": "./fesm2022/nucleus-suite-pe-core-charts.mjs"
     }
   },
   "type": "module"

package/styles/tokens.css

@@ -33,7 +33,7 @@
   --ns-form-gap-y: calc(18px * var(--ns-density));
   --ns-control-y: calc(0.55rem * var(--ns-density));
 
-  --ac-font: 'Space Grotesk', sans-serif;
+  --ac-font: 'IBM Plex Sans', 'Segoe UI', system-ui, sans-serif;
   --ac-radius-pill: 999px;
   --ac-radius-box: 4px;
 }
@@ -231,7 +231,7 @@ input {
 }
 
 .ns-crumbs.p-breadcrumb {
-  margin-bottom: 14px;
+  margin: 0;
   padding: 0;
   border: 0;
   background: transparent;
@@ -452,3 +452,12 @@ input {
   flex: none;
   width: 18px;
 }
+
+/* Cifras tabulares donde los numeros se leen en columna: una tabla de montos
+   con cifras proporcionales no alinea las unidades y obliga a leer dos veces. */
+.ns-list td,
+.ns-list th,
+nucleus-metric .value,
+nucleus-chart {
+  font-variant-numeric: tabular-nums;
+}

package/types/nucleus-suite-pe-core-charts.d.ts

@@ -0,0 +1,129 @@
+import * as _angular_core from '@angular/core';
+
+type ChartKind = 'line' | 'area' | 'bar' | 'stackedBar' | 'doughnut';
+type ChartValueKind = 'number' | 'bytes' | 'currency';
+interface ChartSeries {
+    readonly key: string;
+    readonly label: string;
+    readonly values: readonly (number | null)[];
+    readonly color?: string;
+}
+interface ChartPalette {
+    readonly series: readonly string[];
+    readonly ink: string;
+    readonly muted: string;
+    readonly line: string;
+    readonly accent: string;
+}
+
+declare function chartPalette(host: Element, dark: boolean, accent: string): ChartPalette;
+
+declare class NucleusChart {
+    private readonly host;
+    private readonly theme;
+    private readonly language;
+    readonly kind: _angular_core.InputSignal<ChartKind>;
+    readonly series: _angular_core.InputSignal<readonly ChartSeries[]>;
+    readonly labels: _angular_core.InputSignal<readonly string[]>;
+    readonly height: _angular_core.InputSignal<number>;
+    readonly valueKind: _angular_core.InputSignal<ChartValueKind>;
+    readonly currency: _angular_core.InputSignal<string>;
+    readonly empty: _angular_core.InputSignal<string>;
+    readonly caption: _angular_core.InputSignal<string>;
+    readonly axisLabel: _angular_core.InputSignal<string>;
+    readonly beginAtZero: _angular_core.InputSignal<boolean>;
+    protected readonly heightPx: _angular_core.Signal<string>;
+    protected readonly hasData: _angular_core.Signal<boolean>;
+    protected readonly primeType: _angular_core.Signal<"line" | "bar" | "doughnut">;
+    private readonly palette;
+    protected readonly data: _angular_core.Signal<{
+        labels: string[];
+        datasets: {
+            data: (number | null)[];
+            backgroundColor: string[];
+            borderWidth: number;
+        }[];
+    } | {
+        labels: string[];
+        datasets: {
+            label: string;
+            data: (number | null)[];
+            borderColor: string;
+            backgroundColor: string;
+            fill: boolean;
+            tension: number;
+            borderWidth: number;
+            pointRadius: number;
+            pointHoverRadius: number;
+            borderRadius: number;
+        }[];
+    }>;
+    protected readonly options: _angular_core.Signal<{
+        maintainAspectRatio: boolean;
+        animation: {
+            duration: number;
+        };
+        interaction: {
+            mode: string;
+            intersect: boolean;
+        };
+        plugins: {
+            legend: {
+                display: boolean;
+                position: string;
+                labels: {
+                    color: string;
+                    usePointStyle: boolean;
+                    boxWidth: number;
+                };
+            };
+            tooltip: {
+                callbacks: {
+                    label(context: {
+                        dataset: {
+                            label?: string;
+                        };
+                        parsed: {
+                            y?: number;
+                        } | number;
+                    }): string;
+                };
+            };
+        };
+        scales: {
+            x?: undefined;
+            y?: undefined;
+        } | {
+            x: {
+                stacked: boolean;
+                ticks: {
+                    color: string;
+                    maxRotation: number;
+                    autoSkipPadding: number;
+                };
+                grid: {
+                    display: boolean;
+                };
+            };
+            y: {
+                stacked: boolean;
+                beginAtZero: boolean;
+                ticks: {
+                    color: string;
+                    callback: (value: number) => string;
+                };
+                grid: {
+                    color: string;
+                    drawBorder: boolean;
+                };
+            };
+        };
+    }>;
+    protected format(value: number | null | undefined): string;
+    private bytes;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusChart, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusChart, "nucleus-chart", never, { "kind": { "alias": "kind"; "required": false; "isSignal": true; }; "series": { "alias": "series"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "valueKind": { "alias": "valueKind"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "empty": { "alias": "empty"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "axisLabel": { "alias": "axisLabel"; "required": false; "isSignal": true; }; "beginAtZero": { "alias": "beginAtZero"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { NucleusChart, chartPalette };
+export type { ChartKind, ChartPalette, ChartSeries, ChartValueKind };

package/types/nucleus-suite-pe-core.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, EnvironmentProviders, Signal, ElementRef, TemplateRef } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, Signal, TemplateRef, OnDestroy, ElementRef } from '@angular/core';
 import { HttpContextToken, HttpInterceptorFn } from '@angular/common/http';
 import * as _nucleus_suite_pe_core from '@nucleus-suite-pe/core';
 import * as _primeuix_themes from '@primeuix/themes';
@@ -53,10 +53,13 @@ declare class NucleusSessionAuth {
     private readonly injector;
     private readonly _ticket;
     private readonly _failed;
+    private readonly _usable;
     private pending;
     readonly ticket: _angular_core.Signal<SessionTicket | null>;
     readonly failed: _angular_core.Signal<boolean>;
     readonly established: _angular_core.Signal<boolean>;
+    readonly usable: _angular_core.Signal<boolean>;
+    disable(): void;
     establish(force?: boolean): Promise<boolean>;
     clear(): Promise<void>;
     private request;
@@ -687,13 +690,22 @@ interface Crumb {
 }
 declare class NucleusPage {
     readonly heading: _angular_core.WritableSignal<string>;
-    readonly lead: _angular_core.WritableSignal<string>;
     readonly crumbs: _angular_core.WritableSignal<readonly Crumb[]>;
-    set(heading: string, lead?: string, crumbs?: readonly Crumb[]): void;
+    readonly actions: _angular_core.WritableSignal<TemplateRef<unknown> | null>;
+    set(heading: string, crumbs?: readonly Crumb[]): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusPage, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<NucleusPage>;
 }
 
+declare class NucleusPageActions implements OnDestroy {
+    private readonly page;
+    private readonly template;
+    constructor();
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusPageActions, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NucleusPageActions, "[nucleusPageActions]", never, {}, {}, never, never, true, never>;
+}
+
 interface ConfirmRequest {
     readonly header: string;
     readonly message: string;
@@ -864,9 +876,12 @@ declare class NucleusList<T extends object = Record<string, unknown>> {
     readonly minWidth: _angular_core.InputSignal<string>;
     readonly skeletonRows: _angular_core.InputSignal<number>;
     readonly rowClass: _angular_core.InputSignal<(row: T) => string>;
+    readonly pageSize: _angular_core.InputSignal<number>;
+    readonly pageSizes: _angular_core.InputSignal<number[]>;
     readonly action: _angular_core.OutputEmitterRef<ListActionEvent<T>>;
     readonly toggle: _angular_core.OutputEmitterRef<ListToggleEvent<T>>;
     private readonly cells;
+    protected readonly paginate: _angular_core.Signal<boolean>;
     protected readonly tableStyle: _angular_core.Signal<{
         'min-width': string;
     }>;
@@ -885,7 +900,7 @@ declare class NucleusList<T extends object = Record<string, unknown>> {
     protected hintOf(column: ListColumn<T>, row: T): string;
     protected flip(column: ListColumn<T>, row: T): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusList<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusList<any>, "nucleus-list", never, { "rows": { "alias": "rows"; "required": true; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "empty": { "alias": "empty"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "rowClass": { "alias": "rowClass"; "required": false; "isSignal": true; }; }, { "action": "action"; "toggle": "toggle"; }, ["cells"], ["[nucleusListTitle]", "[nucleusListActions]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusList<any>, "nucleus-list", never, { "rows": { "alias": "rows"; "required": true; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "empty": { "alias": "empty"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "rowClass": { "alias": "rowClass"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "pageSizes": { "alias": "pageSizes"; "required": false; "isSignal": true; }; }, { "action": "action"; "toggle": "toggle"; }, ["cells"], ["[nucleusListTitle]", "[nucleusListActions]"], true, never>;
 }
 
 interface TreeRow {
@@ -1100,7 +1115,6 @@ declare class NucleusShell {
     private readonly router;
     readonly brand: _angular_core.InputSignal<string>;
     readonly heading: _angular_core.InputSignal<string>;
-    readonly lead: _angular_core.InputSignal<string>;
     readonly navItems: _angular_core.InputSignal<readonly ShellNavItem[]>;
     readonly activeNavId: _angular_core.InputSignal<string | null>;
     readonly selectedMenuId: _angular_core.InputSignal<string | null>;
@@ -1117,7 +1131,7 @@ declare class NucleusShell {
     };
     protected readonly menuPlaceholders: string[];
     protected readonly title: _angular_core.Signal<string>;
-    protected readonly subtitle: _angular_core.Signal<string>;
+    protected readonly pageActions: _angular_core.WritableSignal<_angular_core.TemplateRef<unknown> | null>;
     protected readonly home: _angular_core.Signal<MenuItem>;
     protected readonly crumbs: _angular_core.Signal<MenuItem[]>;
     protected readonly copy: _angular_core.Signal<_nucleus_suite_pe_core.ShellCopy>;
@@ -1177,8 +1191,8 @@ declare class NucleusShell {
     protected signOut(): Promise<void>;
     private loadSites;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusShell, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusShell, "nucleus-shell", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "lead": { "alias": "lead"; "required": false; "isSignal": true; }; "navItems": { "alias": "navItems"; "required": false; "isSignal": true; }; "activeNavId": { "alias": "activeNavId"; "required": false; "isSignal": true; }; "selectedMenuId": { "alias": "selectedMenuId"; "required": false; "isSignal": true; }; }, { "navSelect": "navSelect"; "menuSelect": "menuSelect"; }, never, ["[nucleusTop]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusShell, "nucleus-shell", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "navItems": { "alias": "navItems"; "required": false; "isSignal": true; }; "activeNavId": { "alias": "activeNavId"; "required": false; "isSignal": true; }; "selectedMenuId": { "alias": "selectedMenuId"; "required": false; "isSignal": true; }; }, { "navSelect": "navSelect"; "menuSelect": "menuSelect"; }, never, ["[nucleusTop]", "*"], true, never>;
 }
 
-export { ACCENTS, CANVASES, COMMON_COPY, CONTROL_CONTRAST, DEFAULT_APPEARANCE, DENSITIES, EMPTY_GEO_VALUE, FIELD_TARGETS, FRAMES, GEO_COPY, LEGACY_THEMES, NO_PERMISSIONS, NUCLEUS_ACCENTS, NUCLEUS_CONFIG, NUCLEUS_DARK_SELECTOR, NUCLEUS_FORCE_BEARER, NUCLEUS_ICONS, NUCLEUS_ICON_CATALOG, NUCLEUS_LANGS, NUCLEUS_LOGOUT_PARAM, NUCLEUS_SKIP_AUTH, NucleusAppearance, NucleusAuth, NucleusCache, NucleusCard, NucleusCell, NucleusColorPicker, NucleusEnterAdvance, NucleusFeedback, NucleusForm, NucleusGeo, NucleusGeoSelect, NucleusIconPicker, NucleusLanguage, NucleusList, NucleusLordicon, NucleusMark, NucleusMenu, NucleusMetric, NucleusMetrics, NucleusPage, NucleusPreset, NucleusRecentApps, NucleusSessionAuth, NucleusShell, NucleusShortcut, NucleusShortcuts, NucleusStarfield, NucleusTabs, SHELL_COPY, SessionService, TEXT_CONTRAST, THEME_COPY, ThemeService, UserSyncService, accentById, accentLabelOf, accentOn, ariaKeysOf, auditAppearance, canvasById, clock, comboOf, commonCopyOf, consumeNucleusLogout, contrastIssue, contrastRatio, day, densityById, endOfDayUtc, fieldsIn, findMenuByRoute, flagOf, foldText, frameById, geoCopyOf, hasChildren, hasModifier, iconClassOf, iconNameOf, integer, isAccentPreference, isApplePlatform, isBeforeToday, isCanvasPreference, isDarkCanvas, isDensityId, isFieldSearchable, isFrameId, isNucleusConfigured, isOnOrBeforeToday, isReachable, isToday, isTypingTarget, isoDay, levelLabel, loadLordicon, loadNucleusConfig, matchesRow, meetsContrast, menuGlyph, menuTile, minutesAsClock, mixHex, money, moveTo, normalizeKeys, nucleusAuthInterceptor, nucleusErrorMessage, nucleusLang, nucleusLogoutUrl, nucleusParseDate, ownsUrl, percent, permissionsOf, provideNucleus, provideNucleusFeedback, provideNucleusTheme, qty, readableOn, relativeLuminance, resolveAccent, resolveFieldSize, searchIcons, selectableRows, shiftDay, shortcutHint, signedMoney, stamp, startOfDayUtc, themeCopyOf, toNumber, toggleCollapsed, visibleTreeRows };
+export { ACCENTS, CANVASES, COMMON_COPY, CONTROL_CONTRAST, DEFAULT_APPEARANCE, DENSITIES, EMPTY_GEO_VALUE, FIELD_TARGETS, FRAMES, GEO_COPY, LEGACY_THEMES, NO_PERMISSIONS, NUCLEUS_ACCENTS, NUCLEUS_CONFIG, NUCLEUS_DARK_SELECTOR, NUCLEUS_FORCE_BEARER, NUCLEUS_ICONS, NUCLEUS_ICON_CATALOG, NUCLEUS_LANGS, NUCLEUS_LOGOUT_PARAM, NUCLEUS_SKIP_AUTH, NucleusAppearance, NucleusAuth, NucleusCache, NucleusCard, NucleusCell, NucleusColorPicker, NucleusEnterAdvance, NucleusFeedback, NucleusForm, NucleusGeo, NucleusGeoSelect, NucleusIconPicker, NucleusLanguage, NucleusList, NucleusLordicon, NucleusMark, NucleusMenu, NucleusMetric, NucleusMetrics, NucleusPage, NucleusPageActions, NucleusPreset, NucleusRecentApps, NucleusSessionAuth, NucleusShell, NucleusShortcut, NucleusShortcuts, NucleusStarfield, NucleusTabs, SHELL_COPY, SessionService, TEXT_CONTRAST, THEME_COPY, ThemeService, UserSyncService, accentById, accentLabelOf, accentOn, ariaKeysOf, auditAppearance, canvasById, clock, comboOf, commonCopyOf, consumeNucleusLogout, contrastIssue, contrastRatio, day, densityById, endOfDayUtc, fieldsIn, findMenuByRoute, flagOf, foldText, frameById, geoCopyOf, hasChildren, hasModifier, iconClassOf, iconNameOf, integer, isAccentPreference, isApplePlatform, isBeforeToday, isCanvasPreference, isDarkCanvas, isDensityId, isFieldSearchable, isFrameId, isNucleusConfigured, isOnOrBeforeToday, isReachable, isToday, isTypingTarget, isoDay, levelLabel, loadLordicon, loadNucleusConfig, matchesRow, meetsContrast, menuGlyph, menuTile, minutesAsClock, mixHex, money, moveTo, normalizeKeys, nucleusAuthInterceptor, nucleusErrorMessage, nucleusLang, nucleusLogoutUrl, nucleusParseDate, ownsUrl, percent, permissionsOf, provideNucleus, provideNucleusFeedback, provideNucleusTheme, qty, readableOn, relativeLuminance, resolveAccent, resolveFieldSize, searchIcons, selectableRows, shiftDay, shortcutHint, signedMoney, stamp, startOfDayUtc, themeCopyOf, toNumber, toggleCollapsed, visibleTreeRows };
 export type { Accent, AccentId, AccentOption, AccentPreference, AccessScope, AppSummary, AppUser, Appearance, AuthSyncRequest, Canvas, CanvasEffects, CanvasId, CanvasPreference, CanvasTokens, CardSize, CommonCopy, CommonCopySet, CompanyOption, CompanyRelation, CompanySummary, ConfirmRequest, ContrastIssue, Crumb, Density, DensityId, FieldKind, FieldOption, FieldSize, FieldSpan, FormField, FormValue, Frame, FrameId, FrameTokens, GeoCopy, GeoCopySet, GeoCountry, GeoDivision, GeoLevel, GeoPlace, GeoValue, GlobalAccess, LauncherApp, ListAction, ListActionEvent, ListAlign, ListColumn, ListColumnKind, ListTag, ListToggleEvent, MeResponse, MenuNode, MenuPermissions, MenuRow, MenuSection, MenuTile, MetricTone, NucleusConfig, NucleusIdentity, NucleusLang, SessionTicket, ShellCopy, ShellNavItem, ShortcutBinding, Site, SiteAccess, Subscription, TabItem, ThemeCopy, TreeRow, UserProfile };