b2b-tools 0.1.1 → 0.1.3

package/types/b2b-tools.d.ts

@@ -0,0 +1,578 @@
+import * as b2b_tools from 'b2b-tools';
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+
+type AdvancedTone = 'primary' | 'success' | 'warning' | 'danger' | 'neutral';
+interface AdvancedBadge {
+    label: string;
+    tone?: AdvancedTone;
+}
+interface AdvancedHighlight {
+    label: string;
+    value: string;
+    hint?: string;
+}
+interface AdvancedAction {
+    id: string;
+    label: string;
+    tone?: 'primary' | 'secondary' | 'danger';
+    disabled?: boolean;
+}
+type AdvancedTabKind = 'template' | 'text' | 'empty';
+type AdvancedDensity = 'compact' | 'comfortable';
+type AdvancedSize = 'sm' | 'md' | 'lg';
+interface AdvancedCardTab {
+    id: string;
+    label: string;
+    kind: AdvancedTabKind;
+    /** kind=text */
+    text?: string;
+    /** kind=template */
+    templateId?: string;
+    /** toolbar por tab */
+    actions?: AdvancedTabAction[];
+    /** badge pequeño opcional en tab */
+    pill?: {
+        label: string;
+        tone?: AdvancedTone;
+    };
+}
+interface AdvancedCardConfig {
+    id: string;
+    title: string;
+    subtitle?: string;
+    badge?: AdvancedBadge;
+    highlights?: AdvancedHighlight[];
+    summaryBlocks?: AdvancedSummaryBlock[];
+    primaryCta?: {
+        label: string;
+    };
+    actions?: AdvancedAction[];
+    tabs?: AdvancedCardTab[];
+    defaultTabId?: string;
+    expandMode?: AdvancedExpandMode;
+    closeOnBackdrop?: boolean;
+    density?: AdvancedDensity;
+    size?: AdvancedSize;
+    data?: any;
+}
+interface AdvancedSummaryBlock {
+    title: string;
+    rows: {
+        label: string;
+        value: string;
+    }[];
+}
+interface AdvancedTabAction {
+    id: string;
+    label: string;
+    tone?: 'primary' | 'secondary' | 'danger';
+    disabled?: boolean;
+}
+type AdvancedExpandMode = 'inline' | 'drawer' | 'modal';
+type AdvancedCardTemplateCtx = {
+    /** The current card identifier (config.id) */
+    cardId: string;
+    /** The current active tab identifier (tab.id) */
+    tabId: string;
+};
+type AdvancedCardContentVm = {
+    cardId: string;
+    summaryBlocks?: AdvancedSummaryBlock[];
+    tabs: AdvancedCardTab[];
+    activeTabId: string | null;
+    activeTab: AdvancedCardTab | null;
+    templateRef: TemplateRef<AdvancedCardTemplateCtx> | null;
+};
+
+declare class AdvancedCardTemplateDirective {
+    readonly templateRef: TemplateRef<any>;
+    templateId: _angular_core.InputSignal<string>;
+    constructor(templateRef: TemplateRef<any>);
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdvancedCardTemplateDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AdvancedCardTemplateDirective, "[advancedCardTemplate]", never, { "templateId": { "alias": "advancedCardTemplate"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare class AdvancedCard {
+    config: _angular_core.InputSignal<AdvancedCardConfig>;
+    fullWidthOnExpand: _angular_core.InputSignal<boolean>;
+    stickyHeader: _angular_core.InputSignal<boolean>;
+    closeOnEsc: _angular_core.InputSignal<boolean>;
+    expandedChange: _angular_core.OutputEmitterRef<boolean>;
+    action: _angular_core.OutputEmitterRef<{
+        actionId: string;
+        cardId: string;
+    }>;
+    tabChanged: _angular_core.OutputEmitterRef<{
+        tabId: string;
+        cardId: string;
+    }>;
+    tabAction: _angular_core.OutputEmitterRef<{
+        tabId: string;
+        actionId: string;
+        cardId: string;
+    }>;
+    private projectedTemplates;
+    readonly expanded: _angular_core.WritableSignal<boolean>;
+    readonly activeTabId: _angular_core.WritableSignal<string | null>;
+    readonly cardId: _angular_core.Signal<string>;
+    readonly expandMode: _angular_core.Signal<b2b_tools.AdvancedExpandMode>;
+    readonly closeOnBackdrop: _angular_core.Signal<boolean>;
+    readonly isInline: _angular_core.Signal<boolean>;
+    readonly isDrawer: _angular_core.Signal<boolean>;
+    readonly isModal: _angular_core.Signal<boolean>;
+    readonly hasHighlights: _angular_core.Signal<boolean>;
+    readonly hasSummaryBlocks: _angular_core.Signal<boolean>;
+    readonly tabs: _angular_core.Signal<AdvancedCardTab[]>;
+    readonly activeTab: _angular_core.Signal<AdvancedCardTab | null>;
+    readonly templateMap: _angular_core.Signal<Map<string, AdvancedCardTemplateDirective>>;
+    readonly density: _angular_core.Signal<b2b_tools.AdvancedDensity>;
+    readonly size: _angular_core.Signal<b2b_tools.AdvancedSize>;
+    readonly hostClass: _angular_core.Signal<string>;
+    readonly activeTemplateRef: _angular_core.Signal<any>;
+    readonly contentVm: _angular_core.Signal<AdvancedCardContentVm>;
+    notifyExpandenChangesEffect: _angular_core.EffectRef;
+    initiActiveTabEffect: _angular_core.EffectRef;
+    toggleExpand(): void;
+    expand(): void;
+    collapse(): void;
+    onActionClick(a: AdvancedAction): void;
+    selectTab(tabId: string): void;
+    onTabActionClick(tab: AdvancedCardTab, a: AdvancedTabAction): void;
+    getActiveTemplate(): AdvancedCardTemplateDirective | null;
+    badgeClass(tone: AdvancedTone | undefined): string;
+    onKeydown(ev: KeyboardEvent): void;
+    onBackdropClick(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdvancedCard, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AdvancedCard, "advanced-card", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "fullWidthOnExpand": { "alias": "fullWidthOnExpand"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "closeOnEsc": { "alias": "closeOnEsc"; "required": false; "isSignal": true; }; }, { "expandedChange": "expandedChange"; "action": "action"; "tabChanged": "tabChanged"; "tabAction": "tabAction"; }, ["projectedTemplates"], ["*", "*", "ng-template[advancedCardTemplate]"], true, never>;
+}
+
+type CellDataType = 'string' | 'integer' | 'decimal' | 'currency' | 'date' | 'datetime' | 'boolean' | 'image' | 'status' | 'link' | 'custom' | 'actions';
+type CellSize = 'XS' | 'SM' | 'MD' | 'LG' | 'XL' | 'AUTO';
+type TextAlign = 'left' | 'center' | 'right';
+type RowId = string | number;
+type PagerItem = number | '…';
+type Icon = 'edit' | 'delete' | 'view' | 'copy';
+interface TableColumn<T = unknown> {
+    key: string;
+    label: string;
+    type: CellDataType;
+    size?: CellSize;
+    align?: TextAlign;
+    sortable?: boolean;
+    filterable?: boolean;
+    hidden?: boolean;
+    valueGetter?: (row: T) => unknown;
+    formatter?: (value: unknown, row: T) => string;
+    actions?: TableAction<T>[];
+    options?: {
+        currency?: 'MXN';
+        dateFormat?: 'short' | 'medium' | 'long';
+        dateTimeFormat?: 'short' | 'medium' | 'long';
+        image?: {
+            hidden?: boolean;
+            openInModal?: boolean;
+            showFull?: boolean;
+            alt?: (row: T) => string;
+        };
+        status?: {
+            classMap?: Record<string, string>;
+        };
+        link?: {
+            hrefGetter?: (row: T) => string;
+            labelGetter?: (row: T) => string;
+            target?: '_blank' | '_self';
+        };
+    };
+}
+interface TableConfig {
+    globalSearch?: boolean;
+    columnFilters?: boolean;
+    selectable?: boolean;
+    selectionMode?: 'single' | 'multiple';
+    pagination?: {
+        enabled: boolean;
+        pageSize: number;
+        pageSizeOptions?: number[];
+    };
+    scroll?: {
+        mode: 'none' | 'infinite';
+        heightPx?: number;
+        batchSize?: number;
+    };
+    fixedRowCount?: number;
+    emptyText?: string;
+    rowIdKey?: string;
+    rowIdGetter?: (row: any) => string | number;
+    globalSearchVisibleOnly?: boolean;
+}
+interface TableSortState {
+    key: string;
+    dir: 'asc' | 'desc';
+}
+type ActionVariant = 'default' | 'danger';
+type ActionRender = 'icon' | 'text';
+interface TableAction<T> {
+    id: string;
+    label: string;
+    icon?: Icon | string;
+    tooltip?: string;
+    variant?: ActionVariant;
+    render?: ActionRender;
+    visible?: (row: T) => boolean;
+    disabled?: (row: T) => boolean;
+    confirm?: {
+        title?: string;
+        message: string;
+    };
+}
+interface TableActionEvent<T> {
+    actionId: string;
+    row: T;
+}
+declare const SVG_ICONS: Record<string, string>;
+
+declare class AdvancedTable<T extends Record<string, any>> {
+    readonly columns: _angular_core.InputSignal<TableColumn<T>[]>;
+    readonly data: _angular_core.InputSignal<T[]>;
+    readonly config: _angular_core.InputSignal<TableConfig>;
+    readonly rowClick: _angular_core.OutputEmitterRef<T>;
+    readonly selectionChange: _angular_core.OutputEmitterRef<RowId[]>;
+    readonly actionClick: _angular_core.OutputEmitterRef<TableActionEvent<T>>;
+    readonly globalQuery: _angular_core.WritableSignal<string>;
+    readonly columnQueries: _angular_core.WritableSignal<Record<string, string>>;
+    readonly sortState: _angular_core.WritableSignal<TableSortState | null>;
+    readonly page: _angular_core.WritableSignal<number>;
+    readonly visibleCount: _angular_core.WritableSignal<number>;
+    readonly modalOpen: _angular_core.WritableSignal<boolean>;
+    readonly modalImageSrc: _angular_core.WritableSignal<string>;
+    readonly modalImageAlt: _angular_core.WritableSignal<string>;
+    readonly selectedIdsSet: _angular_core.WritableSignal<Set<RowId>>;
+    readonly pageSize: _angular_core.WritableSignal<number>;
+    readonly selectedIds: _angular_core.Signal<RowId[]>;
+    readonly visibleColumns: _angular_core.Signal<TableColumn<T>[]>;
+    readonly showSelectionColumn: _angular_core.Signal<boolean>;
+    readonly gridTemplateColumns: _angular_core.Signal<string>;
+    readonly filteredData: _angular_core.Signal<T[]>;
+    readonly sortedData: _angular_core.Signal<T[]>;
+    readonly pagedData: _angular_core.Signal<T[]>;
+    readonly pagerItems: _angular_core.Signal<PagerItem[]>;
+    readonly totalCount: _angular_core.Signal<number>;
+    readonly pageCount: _angular_core.Signal<number>;
+    readonly isAllSelectedOnPage: _angular_core.Signal<boolean>;
+    infiniteScrollEffect: _angular_core.EffectRef;
+    selectionDataEffect: _angular_core.EffectRef;
+    pagesCountEffect: _angular_core.EffectRef;
+    onHeaderClickSort(col: TableColumn<T>): void;
+    onBodyScroll(event: Event): void;
+    onPageSizeChange(size: number): void;
+    getCellValue(row: T, col: TableColumn<T>): unknown;
+    getRowId(row: T): RowId;
+    setGlobalQuery(query: string): void;
+    setColumnQuery(key: string, query: string): void;
+    clearFilters(): void;
+    onRowClick(row: T): void;
+    toggleRowSelection(row: T): void;
+    toggleSelectAllOnPage(): void;
+    prevPage(): void;
+    nextPage(): void;
+    goToPage(p: number): void;
+    openImageModal(src: string, alt: string): void;
+    closeModal(): void;
+    private resetInfiniteIfNeeded;
+    private sizeToCss;
+    private toNumber;
+    private toDate;
+    private compareValues;
+    private valueToSearchableText;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdvancedTable<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AdvancedTable<any>, "advanced-table", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; }, { "rowClick": "rowClick"; "selectionChange": "selectionChange"; "actionClick": "actionClick"; }, never, never, true, never>;
+}
+
+/**
+ * Base information for a time zone associated with a country or region.
+ * Intended for catalogs, dropdowns, and Intl-based formatting.
+ */
+interface TimeZoneInfo {
+    /**
+     * Official IANA time zone identifier.
+     * Used by Intl.DateTimeFormat and backend time handling.
+     * Example: 'America/Mexico_City', 'Europe/Madrid'.
+     */
+    timeZone: string;
+    /**
+     * Country or region name.
+     * Intended for user-friendly display in UI components.
+     * Example: 'Mexico', 'United States (Eastern)'.
+     */
+    name: string;
+    /**
+     * ISO 4217 currency code used in the country or region.
+     * Required for monetary formatting with Intl.NumberFormat.
+     * Example: 'MXN', 'USD', 'EUR'.
+     */
+    currency: string;
+    /**
+     * Locale identifier following the BCP-47 standard.
+     * Determines language, number formatting, and date conventions.
+     * Example: 'es-MX', 'en-US', 'fr-FR'.
+     */
+    locale: string;
+    /**
+     * UTC offset of the time zone expressed in hours.
+     * This value represents the standard offset and does not account for DST.
+     * Example: -6, -5, +1, +5.5.
+     */
+    utcOffset: number;
+    /**
+     * City name.
+     * Used as a human-readable label in dropdowns or selectors.
+     * Example: 'Mexico City', 'New York', 'London'.
+     */
+    city: string;
+}
+declare const TIME_ZONES: {
+    CAIRO: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    CASABLANCA: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    JOHANNESBURG: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    BUENOS_AIRES: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    SAO_PAULO: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    TORONTO: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    VANCOUVER: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    BOGOTA: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    CANCUN: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    MEXICO_CITY: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    TIJUANA: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    LIMA: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    SANTIAGO: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    CHICAGO: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    DENVER: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    LOS_ANGELES: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    NEW_YORK: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    SHANGHAI: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    KOLKATA: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    TOKYO: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    SEOUL: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    DUBAI: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    BERLIN: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    PARIS: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    ROME: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    MADRID: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    ZURICH: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    LONDON: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    SYDNEY: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+    AUCKLAND: {
+        city: string;
+        timeZone: string;
+        name: string;
+        currency: string;
+        locale: string;
+        utcOffset: number;
+    };
+};
+
+export { AdvancedCard, AdvancedCardTemplateDirective, AdvancedTable, SVG_ICONS, TIME_ZONES };
+export type { ActionRender, ActionVariant, AdvancedAction, AdvancedBadge, AdvancedCardConfig, AdvancedCardContentVm, AdvancedCardTab, AdvancedCardTemplateCtx, AdvancedDensity, AdvancedExpandMode, AdvancedHighlight, AdvancedSize, AdvancedSummaryBlock, AdvancedTabAction, AdvancedTabKind, AdvancedTone, CellDataType, CellSize, Icon, PagerItem, RowId, TableAction, TableActionEvent, TableColumn, TableConfig, TableSortState, TextAlign, TimeZoneInfo };

package/LICENCE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Luis Emiliano Cortes
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/ng-package.json

@@ -1,7 +0,0 @@
-{
-  "$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
-  "dest": "../../dist/b2b-tools",
-  "lib": {
-    "entryFile": "src/public-api.ts"
-  }
-}

package/src/lib/b2b-tools.spec.ts

@@ -1,23 +0,0 @@
-import { ComponentFixture, TestBed } from '@angular/core/testing';
-
-import { B2bTools } from './b2b-tools';
-
-describe('B2bTools', () => {
-  let component: B2bTools;
-  let fixture: ComponentFixture<B2bTools>;
-
-  beforeEach(async () => {
-    await TestBed.configureTestingModule({
-      imports: [B2bTools]
-    })
-    .compileComponents();
-
-    fixture = TestBed.createComponent(B2bTools);
-    component = fixture.componentInstance;
-    await fixture.whenStable();
-  });
-
-  it('should create', () => {
-    expect(component).toBeTruthy();
-  });
-});

package/src/lib/b2b-tools.ts

@@ -1,15 +0,0 @@
-import { Component } from '@angular/core';
-
-@Component({
-  selector: 'lib-b2b-tools',
-  imports: [],
-  template: `
-    <p>
-      b2b-tools works!
-    </p>
-  `,
-  styles: ``,
-})
-export class B2bTools {
-
-}