@nucleus-suite-pe/core 0.3.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nucleus-suite-pe/core",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Capa compartida de la suite Nucleus: sesión única, permisos, tema y marco de aplicación para Angular.",
   "keywords": [
     "angular",

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

@@ -1,9 +1,10 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, EnvironmentProviders, Signal } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, Signal, TemplateRef } from '@angular/core';
 import { HttpContextToken, HttpInterceptorFn } from '@angular/common/http';
 import * as _primeuix_themes from '@primeuix/themes';
 import * as _primeuix_themes_types_base from '@primeuix/themes/types/base';
 import * as _nucleus_suite_pe_core from '@nucleus-suite-pe/core';
+import { MenuItem } from 'primeng/api';
 
 interface NucleusConfig {
     readonly appId: string;
@@ -183,6 +184,17 @@ interface AppSummary {
 }
 type LauncherApp = AppSummary;
 
+interface MenuPermissions {
+    readonly canView: boolean;
+    readonly canInsert: boolean;
+    readonly canEdit: boolean;
+    readonly canDelete: boolean;
+    readonly canExport: boolean;
+}
+declare const NO_PERMISSIONS: MenuPermissions;
+declare function findMenuByRoute(nodes: readonly MenuNode[], route: string): MenuNode | null;
+declare function permissionsOf(node: MenuNode | null): MenuPermissions;
+
 declare class SessionService {
     private readonly http;
     private readonly auth;
@@ -217,6 +229,7 @@ declare class SessionService {
     readonly companyId: _angular_core.Signal<string | null>;
     readonly companyName: _angular_core.Signal<string | null>;
     load(language: string, force?: boolean): Promise<void>;
+    permissionsFor(route: string): MenuPermissions;
     reload(language: string): Promise<void>;
     sites(companyId: string): Promise<Site[]>;
     accessibleSites(companyId: string): Promise<Site[]>;
@@ -283,6 +296,155 @@ declare const NucleusPreset: _primeuix_themes.Preset<_primeuix_themes_types_base
 declare const NUCLEUS_DARK_SELECTOR = ".ns-dark";
 declare function provideNucleusTheme(): EnvironmentProviders;
 
+declare function loadLordicon(): Promise<void>;
+declare const NUCLEUS_ICONS: {
+    readonly trash: "https://cdn.lordicon.com/wpyrrmcq.json";
+    readonly check: "https://cdn.lordicon.com/lomfljuq.json";
+    readonly warning: "https://cdn.lordicon.com/vihyezfv.json";
+    readonly power: "https://cdn.lordicon.com/gwvmctbb.json";
+    readonly user: "https://cdn.lordicon.com/hrjifpbq.json";
+    readonly key: "https://cdn.lordicon.com/ossgtprr.json";
+};
+declare class NucleusLordicon {
+    private readonly themes;
+    readonly src: _angular_core.InputSignal<string>;
+    readonly trigger: _angular_core.InputSignal<string>;
+    readonly state: _angular_core.InputSignal<string | null>;
+    readonly size: _angular_core.InputSignal<number>;
+    readonly tone: _angular_core.InputSignal<"accent" | "danger">;
+    protected readonly colors: _angular_core.Signal<string>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusLordicon, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusLordicon, "nucleus-lordicon", never, { "src": { "alias": "src"; "required": true; "isSignal": true; }; "trigger": { "alias": "trigger"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+interface Crumb {
+    readonly label: string;
+    readonly route?: readonly unknown[];
+}
+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;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusPage, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NucleusPage>;
+}
+
+interface ConfirmRequest {
+    readonly header: string;
+    readonly message: string;
+    readonly accept: string;
+    readonly reject: string;
+    readonly icon?: string;
+    readonly tone?: 'accent' | 'danger';
+}
+declare function provideNucleusFeedback(): EnvironmentProviders;
+declare class NucleusFeedback {
+    private readonly confirmation;
+    private readonly messages;
+    ask(request: ConfirmRequest): Promise<boolean>;
+    done(summary: string, detail?: string): void;
+    failed(summary: string, detail?: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusFeedback, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NucleusFeedback>;
+}
+
+type FieldKind = 'text' | 'email' | 'password' | 'number' | 'textarea' | 'select' | 'checkbox' | 'switch';
+type FieldSpan = 1 | 2 | 3 | 4 | 'full';
+interface FieldOption {
+    readonly label: string;
+    readonly value: unknown;
+}
+interface FormField {
+    readonly key: string;
+    readonly label: string;
+    readonly kind?: FieldKind;
+    readonly span?: FieldSpan;
+    readonly hint?: string;
+    readonly placeholder?: string;
+    readonly maxlength?: number;
+    readonly rows?: number;
+    readonly options?: readonly FieldOption[];
+    readonly disabled?: boolean;
+    readonly clearable?: boolean;
+}
+type FormValue = Record<string, unknown>;
+
+declare class NucleusForm {
+    readonly fields: _angular_core.InputSignal<readonly FormField[]>;
+    readonly value: _angular_core.InputSignal<FormValue>;
+    readonly readonly: _angular_core.InputSignal<boolean>;
+    readonly dense: _angular_core.InputSignal<boolean>;
+    readonly valueChange: _angular_core.OutputEmitterRef<FormValue>;
+    protected read(field: FormField): unknown;
+    protected text(field: FormField): string;
+    protected checked(field: FormField): boolean;
+    protected write(field: FormField, next: unknown): void;
+    protected isDisabled(field: FormField): boolean;
+    protected spanClass(field: FormField): string;
+    protected optionsOf(field: FormField): FieldOption[];
+    protected kindOf(field: FormField): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusForm, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NucleusForm, "nucleus-form", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "dense": { "alias": "dense"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}
+
+type ListAlign = 'left' | 'center' | 'right';
+interface ListTag {
+    readonly label: string;
+    readonly severity?: 'success' | 'info' | 'warn' | 'danger' | 'secondary';
+}
+interface ListColumn<T = Record<string, unknown>> {
+    readonly key: string;
+    readonly header: string;
+    readonly align?: ListAlign;
+    readonly strong?: boolean;
+    readonly width?: string;
+    readonly value?: (row: T) => string;
+    readonly tag?: (row: T) => ListTag | null;
+}
+interface ListAction<T = Record<string, unknown>> {
+    readonly id: string;
+    readonly icon: string;
+    readonly label: string;
+    readonly tone?: 'default' | 'danger';
+    readonly visible?: (row: T) => boolean;
+}
+interface ListActionEvent<T = Record<string, unknown>> {
+    readonly id: string;
+    readonly row: T;
+}
+
+declare class NucleusCell {
+    readonly nucleusCell: _angular_core.InputSignal<string>;
+    readonly template: TemplateRef<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NucleusCell, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NucleusCell, "[nucleusCell]", never, { "nucleusCell": { "alias": "nucleusCell"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class NucleusList<T extends object = Record<string, unknown>> {
+    readonly rows: _angular_core.InputSignal<T[]>;
+    readonly columns: _angular_core.InputSignal<readonly ListColumn<T>[]>;
+    readonly actions: _angular_core.InputSignal<readonly ListAction<T>[]>;
+    readonly empty: _angular_core.InputSignal<string>;
+    readonly loading: _angular_core.InputSignal<boolean>;
+    readonly minWidth: _angular_core.InputSignal<string>;
+    readonly rowClass: _angular_core.InputSignal<(row: T) => string>;
+    readonly action: _angular_core.OutputEmitterRef<ListActionEvent<T>>;
+    private readonly cells;
+    protected readonly tableStyle: _angular_core.Signal<{
+        'min-width': string;
+    }>;
+    protected readonly showEmpty: _angular_core.Signal<boolean>;
+    protected cellTemplate(key: string): TemplateRef<unknown> | null;
+    protected text(column: ListColumn<T>, row: T): string;
+    protected tagOf(column: ListColumn<T>, row: T): ListTag | null;
+    protected visibleActions(row: T): readonly ListAction<T>[];
+    protected run(entry: ListAction<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; }; "rowClass": { "alias": "rowClass"; "required": false; "isSignal": true; }; }, { "action": "action"; }, ["cells"], ["[nucleusListTitle]", "[nucleusListActions]"], true, never>;
+}
+
 declare class NucleusMark {
     readonly accent: _angular_core.InputSignal<string>;
     readonly size: _angular_core.InputSignal<number>;
@@ -369,6 +531,7 @@ declare class NucleusShell {
     private readonly sessionAuth;
     private readonly themes;
     private readonly language;
+    private readonly page;
     private readonly config;
     private readonly injector;
     private readonly router;
@@ -381,6 +544,18 @@ declare class NucleusShell {
     readonly navSelect: _angular_core.OutputEmitterRef<string>;
     readonly menuSelect: _angular_core.OutputEmitterRef<MenuNode>;
     protected readonly lang: _angular_core.Signal<NucleusLang>;
+    protected readonly icons: {
+        readonly trash: "https://cdn.lordicon.com/wpyrrmcq.json";
+        readonly check: "https://cdn.lordicon.com/lomfljuq.json";
+        readonly warning: "https://cdn.lordicon.com/vihyezfv.json";
+        readonly power: "https://cdn.lordicon.com/gwvmctbb.json";
+        readonly user: "https://cdn.lordicon.com/hrjifpbq.json";
+        readonly key: "https://cdn.lordicon.com/ossgtprr.json";
+    };
+    protected readonly title: _angular_core.Signal<string>;
+    protected readonly subtitle: _angular_core.Signal<string>;
+    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>;
     protected readonly starfield: _angular_core.Signal<boolean>;
     protected readonly themePreference: _angular_core.Signal<ThemePreference>;
@@ -427,5 +602,5 @@ declare class NucleusShell {
     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>;
 }
 
-export { DEFAULT_THEME, NUCLEUS_CONFIG, NUCLEUS_DARK_SELECTOR, NUCLEUS_FORCE_BEARER, NUCLEUS_LANGS, NUCLEUS_LOGOUT_PARAM, NUCLEUS_SKIP_AUTH, NucleusAuth, NucleusLanguage, NucleusMark, NucleusPreset, NucleusSessionAuth, NucleusShell, NucleusStarfield, SHELL_COPY, SessionService, THEMES, THEME_LABELS, ThemeService, UserSyncService, consumeNucleusLogout, isNucleusConfigured, isThemePreference, loadNucleusConfig, nucleusAuthInterceptor, nucleusLogoutUrl, ownsUrl, provideNucleus, provideNucleusTheme, themeById };
-export type { AccessScope, AppSummary, AppUser, AuthSyncRequest, CompanyOption, CompanyRelation, CompanySummary, LauncherApp, MeResponse, MenuNode, NucleusConfig, NucleusIdentity, NucleusLang, SessionTicket, ShellCopy, ShellNavItem, Site, SiteAccess, Subscription, Theme, ThemeId, ThemePreference, ThemeTokens, UserProfile };
+export { DEFAULT_THEME, NO_PERMISSIONS, NUCLEUS_CONFIG, NUCLEUS_DARK_SELECTOR, NUCLEUS_FORCE_BEARER, NUCLEUS_ICONS, NUCLEUS_LANGS, NUCLEUS_LOGOUT_PARAM, NUCLEUS_SKIP_AUTH, NucleusAuth, NucleusCell, NucleusFeedback, NucleusForm, NucleusLanguage, NucleusList, NucleusLordicon, NucleusMark, NucleusPage, NucleusPreset, NucleusSessionAuth, NucleusShell, NucleusStarfield, SHELL_COPY, SessionService, THEMES, THEME_LABELS, ThemeService, UserSyncService, consumeNucleusLogout, findMenuByRoute, isNucleusConfigured, isThemePreference, loadLordicon, loadNucleusConfig, nucleusAuthInterceptor, nucleusLogoutUrl, ownsUrl, permissionsOf, provideNucleus, provideNucleusFeedback, provideNucleusTheme, themeById };
+export type { AccessScope, AppSummary, AppUser, AuthSyncRequest, CompanyOption, CompanyRelation, CompanySummary, ConfirmRequest, Crumb, FieldKind, FieldOption, FieldSpan, FormField, FormValue, LauncherApp, ListAction, ListActionEvent, ListAlign, ListColumn, ListTag, MeResponse, MenuNode, MenuPermissions, NucleusConfig, NucleusIdentity, NucleusLang, SessionTicket, ShellCopy, ShellNavItem, Site, SiteAccess, Subscription, Theme, ThemeId, ThemePreference, ThemeTokens, UserProfile };