bways-report 0.2.0 → 0.2.2

package/lib/core/config/bways-report-config.d.ts

@@ -105,6 +105,9 @@ export interface BwaysReportConfig {
      * a plain object, a factory function, an Observable, or a Signal.
      *
      * @example
+     * Browser login storage is never inspected automatically. Omitted page sessions inherit
+     * explicitly configured application sessions; use session: {} to isolate a page.
+     *
      * session: PlaygroundSessionService
      * session: () => inject(AuthService).session()
      * session: { branchId: 1, companyId: 10 }

package/lib/core/models/report-grid.model.d.ts

@@ -92,7 +92,7 @@ export interface GridOptionsDefinition {
     pageSize?: number;
     /** Whether pagination is enabled. */
     pagination?: boolean;
-    /** Whether row selection is enabled. */
+    /** Whether row selection is enabled. Defaults to true; set false to disable. */
     selectable?: boolean;
     /** Selection mode when selectable is true. Defaults to 'multiple'. */
     selectionMode?: 'single' | 'multiple';

package/lib/core/services/report-overlay.service.d.ts

@@ -0,0 +1,14 @@
+import { ScrollStrategy } from '@angular/cdk/overlay';
+import * as i0 from "@angular/core";
+export declare class ReportOverlayService {
+    private readonly document;
+    private readonly nonce;
+    private readonly overlay;
+    private readonly scrollDispatcher;
+    private readonly zone;
+    ensureStyles(): void;
+    /** Retain CDK's scroll strategy; cover native, unregistered host ancestors too. */
+    scrollStrategy(origin: () => HTMLElement): ScrollStrategy;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportOverlayService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ReportOverlayService>;
+}

package/lib/core/services/report-session-context.service.d.ts

@@ -74,11 +74,6 @@ export declare class ReportSessionContextService implements OnDestroy {
      * Always pulls the latest runtime state. Never throws or crashes the thread.
      */
     getCurrentSessionContext(): SessionContextMap;
-    /**
-     * Safely detects session parameters from host project browser storage
-     * (sessionStorage: user_Info, currentUser; localStorage: currentUser, CompanyData, user_Info).
-     */
-    private detectBrowserSession;
     /**
      * Normalizes a parameter or session key into a lowercase alphanumeric string
      * for reliable, case-insensitive, and symbol-insensitive matching.

package/lib/core/utils/report-parameter.util.d.ts

@@ -1,6 +1,16 @@
 import { ReportDefinition } from '../models/report-definition.model';
 import { ReportDataSourceDefinition } from '../models/report-datasource.model';
 export type ParameterMappings = Record<string, string | number | boolean>;
+/** Supported wire formats for date-bound procedure/API parameters. */
+export declare const PARAMETER_DATE_FORMATS: readonly ["yyyy-MM-dd", "yyyyMMdd", "dd/MM/yyyy", "MM/dd/yyyy", "dd-MM-yyyy"];
+export type ParameterDateFormat = typeof PARAMETER_DATE_FORMATS[number];
+/** The optional date pipe is persisted in existing string mappings. */
+export declare function parseParameterToken(raw: string): {
+    field: string;
+    dateFormat?: ParameterDateFormat;
+} | null;
+/** Format calendar parts directly, avoiding UTC/time-zone shifts and locale parsing. */
+export declare function formatParameterDate(value: unknown, format: ParameterDateFormat): string;
 /** Resolves `{{context.xxx}}` presets such as today / startOfMonth. */
 export declare function resolveContextPreset(key: string): string;
 /**
@@ -34,7 +44,11 @@ export declare function parseSqlExecStatement(sql: string): ParsedSqlExec | null
  * - anything else           -> sanitized literal value (fixed value)
  */
 export declare function resolveParameterValue(raw: unknown, session: Record<string, unknown>, formValues: Record<string, unknown>): unknown;
-/** Resolves every mapping into concrete values (de-duplicating `@name` / `name`). */
+/** Replace a single mapping and remove all stale aliases for the same argument. */
+export declare function setParameterMapping(mappings: ParameterMappings | undefined, name: string, value: string | number | boolean): ParameterMappings;
+/** Canonical SQL argument names. Equal aliases collapse; conflicting values fail explicitly. */
+export declare function normalizeParameterNames(parameters: Record<string, unknown>): Record<string, unknown>;
+/** Resolves mappings into one concrete value per parameter, without @ aliases. */
 export declare function resolveParameterMappings(mappings: ParameterMappings | undefined, session: Record<string, unknown>, formValues: Record<string, unknown>): Record<string, unknown>;
 /**
  * Returns canvas field keys referenced by mappings that currently have no value.

package/lib/features/designer/components/property-editor/parameter-binding-editor.component.d.ts

@@ -1,9 +1,11 @@
 import { ProcedureParameterMetadata } from '../../../../data-access/contracts/schema-discovery.contract';
 import { ReportComponentDefinition } from '../../../../core/models/report-component.model';
+import { ParameterDateFormat } from '../../../../core/utils/report-parameter.util';
 import * as i0 from "@angular/core";
 export type ParameterBindingMode = 'session' | 'control' | 'fixed' | 'context' | 'custom';
 export declare class ParameterBindingEditorComponent {
     private readonly sessionService;
+    private readonly reportingConfig;
     readonly param: import("@angular/core").InputSignal<ProcedureParameterMetadata>;
     readonly currentValue: import("@angular/core").InputSignal<string | number | boolean>;
     readonly allComponents: import("@angular/core").InputSignal<ReportComponentDefinition[]>;
@@ -17,6 +19,7 @@ export declare class ParameterBindingEditorComponent {
     }>;
     readonly internalMode: import("@angular/core").WritableSignal<ParameterBindingMode | null>;
     readonly sessionMatch: import("@angular/core").Signal<import("../../../../core/services/report-session-context.service").SessionParamMatch | null>;
+    readonly unavailableSessionBinding: import("@angular/core").Signal<boolean | undefined>;
     readonly friendlyLabel: import("@angular/core").Signal<string>;
     readonly displayType: import("@angular/core").Signal<"Date" | "Text" | "Number" | "Yes / No">;
     readonly isCurrentValue: (val: string | number) => boolean;
@@ -25,6 +28,15 @@ export declare class ParameterBindingEditorComponent {
         value: string | number;
     }[]>;
     readonly compatibleControls: import("@angular/core").Signal<ReportComponentDefinition[]>;
+    readonly selectedDropdownField: import("@angular/core").Signal<ReportComponentDefinition | undefined>;
+    readonly dropdownExample: import("@angular/core").Signal<{
+        label: string;
+        value: string;
+    } | null>;
+    readonly dateFormats: readonly ["yyyy-MM-dd", "yyyyMMdd", "dd/MM/yyyy", "MM/dd/yyyy", "dd-MM-yyyy"];
+    readonly selectedDateField: import("@angular/core").Signal<ReportComponentDefinition | undefined>;
+    readonly selectedDateFormat: import("@angular/core").Signal<"dd/MM/yyyy" | "yyyy-MM-dd" | "yyyyMMdd" | "MM/dd/yyyy" | "dd-MM-yyyy">;
+    onDateFormatSelected(format: ParameterDateFormat): void;
     readonly hasValue: import("@angular/core").Signal<boolean>;
     readonly activeMode: import("@angular/core").Signal<ParameterBindingMode>;
     readonly isAutoSessionDerived: import("@angular/core").Signal<boolean>;

package/lib/features/designer/components/property-editor/property-editor-datasource.component.d.ts

@@ -12,6 +12,7 @@ export declare class PropertyEditorDatasourceComponent implements OnDestroy {
     private entitiesSub?;
     private readonly discoveryAdapter;
     private readonly sessionService;
+    private readonly reportingConfig;
     private readonly designerState;
     private readonly dataDiscovery;
     private readonly endpoints;

package/lib/features/designer/designer.component.d.ts

@@ -22,6 +22,7 @@ export declare class DesignerComponent implements OnInit {
     private readonly sessionService;
     private readonly executionService;
     private readonly dialog;
+    private readonly overlaySupport;
     private readonly router;
     private readonly reportingConfig;
     /** Optional reportId to load from persistence adapter */

package/lib/features/runtime/report-grid-bridge.component.d.ts

@@ -80,6 +80,7 @@ export declare class ReportGridBridgeComponent {
     readonly gridInstanceKey: import("@angular/core").Signal<string>;
     readonly gridStateKey: import("@angular/core").Signal<string>;
     readonly gridConfig: import("@angular/core").Signal<{
+        selectable: boolean;
         rowSelection: "single" | "multiple";
         selectionMode: "single" | "multiple";
         checkboxSelection: boolean;
@@ -87,7 +88,6 @@ export declare class ReportGridBridgeComponent {
         stateKey: string;
         pageSize?: number;
         pagination?: boolean;
-        selectable?: boolean;
         showRowNumbers?: boolean;
         allowColumnReorder?: boolean;
         allowExport?: boolean;
@@ -155,6 +155,7 @@ export declare class ReportGridBridgeComponent {
         }[];
         rowData: unknown[];
         config: {
+            selectable: boolean;
             rowSelection: "single" | "multiple";
             selectionMode: "single" | "multiple";
             checkboxSelection: boolean;
@@ -162,7 +163,6 @@ export declare class ReportGridBridgeComponent {
             stateKey: string;
             pageSize?: number;
             pagination?: boolean;
-            selectable?: boolean;
             showRowNumbers?: boolean;
             allowColumnReorder?: boolean;
             allowExport?: boolean;

package/lib/primitives/components/dropdown/rpt-dropdown.component.d.ts

@@ -13,7 +13,6 @@ export declare class RptDropdownComponent implements OnDestroy {
     private readonly sessionService;
     private readonly elementRef;
     private readonly reportingConfig;
-    private readonly overlay;
     readonly scrollStrategy: ScrollStrategy;
     readonly triggerWidth: import("@angular/core").WritableSignal<string | number>;
     readonly overlayPositions: ConnectedPosition[];
@@ -66,7 +65,7 @@ export declare class RptDropdownComponent implements OnDestroy {
     readonly hasExcessOptions: import("@angular/core").Signal<boolean>;
     readonly excessOptionsCount: import("@angular/core").Signal<number>;
     readonly waitingLabel: import("@angular/core").Signal<string>;
-    readonly statusKind: import("@angular/core").Signal<"error" | "idle" | "loading" | "ok" | "waiting" | "empty">;
+    readonly statusKind: import("@angular/core").Signal<"error" | "waiting" | "idle" | "loading" | "ok" | "empty">;
     readonly statusText: import("@angular/core").Signal<string>;
     readonly isInvalid: import("@angular/core").Signal<boolean>;
     readonly errorMessage: import("@angular/core").Signal<string>;

package/lib/primitives/components/searchable-select/rpt-searchable-select.component.d.ts

@@ -13,7 +13,6 @@ export interface SearchableSelectOption<T = any> {
 }
 export declare class RptSearchableSelectComponent implements ControlValueAccessor {
     private readonly elementRef;
-    private readonly overlay;
     readonly panelId: string;
     readonly scrollStrategy: ScrollStrategy;
     readonly triggerWidth: import("@angular/core").WritableSignal<string | number>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bways-report",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Enterprise-grade, metadata-driven reporting engine and visual page builder for Angular 18+ ERP applications.",
   "keywords": [
     "angular",
@@ -40,10 +40,11 @@
     "tslib": "^2.3.0"
   },
   "schematics": "./schematics/collection.json",
-  "sideEffects": false,
-  "module": "fesm2022/bways-report.mjs",
-  "typings": "index.d.ts",
+  "sideEffects": [
+    "**/*.css"
+  ],
   "exports": {
+    "./styles/theme.css": "./styles/theme.css",
     "./package.json": {
       "default": "./package.json"
     },
@@ -53,5 +54,7 @@
       "esm": "./esm2022/bways-report.mjs",
       "default": "./fesm2022/bways-report.mjs"
     }
-  }
+  },
+  "module": "fesm2022/bways-report.mjs",
+  "typings": "index.d.ts"
 }

package/styles/theme.css

@@ -0,0 +1,181 @@
+/**
+ * BWays-Report Default CSS Theme Variables & Design Tokens
+ *
+ * Designed according to Enterprise Precision & Data-Dense Dashboard standards.
+ * Host ERP applications can easily override any of these variables
+ * in their global styles or container elements to match their design system.
+ */
+:root {
+  /* Typography */
+  --rpt-font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Inter', Helvetica, Arial, sans-serif;
+  --rpt-font-family-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Fira Code', monospace;
+  --rpt-font-size-xs: 11px; /* 11px */
+  --rpt-font-size-sm: 12px;   /* 12px */
+  --rpt-font-size-base: 14px; /* 14px */
+  --rpt-font-size-md: 16px;       /* 16px */
+  --rpt-font-size-lg: 18px;   /* 18px */
+  --rpt-font-size-xl: 22px;   /* 22px */
+  --rpt-font-size-2xl: 28px;   /* 28px */
+  --rpt-font-weight-normal: 400;
+  --rpt-font-weight-medium: 500;
+  --rpt-font-weight-semibold: 600;
+  --rpt-font-weight-bold: 700;
+
+  /* Spacing Scale (4/8px Rhythm) */
+  --rpt-space-xs: 4px;
+  --rpt-space-sm: 8px;
+  --rpt-space-md: 12px;
+  --rpt-space-lg: 16px;
+  --rpt-space-xl: 24px;
+  --rpt-space-2xl: 32px;
+
+  /* Brand / Primary Color Scale */
+  --rpt-color-primary: #2563eb;
+  --rpt-color-primary-hover: #1d4ed8;
+  --rpt-color-primary-active: #1e40af;
+  --rpt-color-primary-light: #eff6ff;
+  --rpt-color-primary-focus: rgba(37, 99, 235, 0.25);
+  --rpt-color-primary-gradient: linear-gradient(135deg, #2563eb 0%, #4f46e5 100%);
+
+  /* Neutral Backgrounds & Surfaces */
+  --rpt-color-bg: #f8fafc;
+  --rpt-color-surface: #ffffff;
+  --rpt-color-surface-hover: #f1f5f9;
+  --rpt-color-surface-active: #e2e8f0;
+  --rpt-color-surface-elevated: #ffffff;
+
+  /* Text & Foreground */
+  --rpt-color-text: #0f172a;
+  --rpt-color-text-secondary: #334155;
+  --rpt-color-text-muted: #64748b;
+  --rpt-color-text-inverse: #ffffff;
+
+  /* Borders & Dividers */
+  --rpt-color-border: #cbd5e1;
+  --rpt-color-border-subtle: #e2e8f0;
+  --rpt-color-border-hover: #94a3b8;
+  --rpt-color-border-focus: #2563eb;
+
+  /* Status Colors */
+  --rpt-color-danger: #ef4444;
+  --rpt-color-danger-hover: #dc2626;
+  --rpt-color-danger-bg: #fef2f2;
+  --rpt-color-danger-border: #fecaca;
+  --rpt-color-success: #10b981;
+  --rpt-color-success-bg: #ecfdf5;
+  --rpt-color-success-border: #a7f3d0;
+  --rpt-color-warning: #f59e0b;
+  --rpt-color-warning-bg: #fffbeb;
+  --rpt-color-warning-border: #fde68a;
+  --rpt-color-info: #0284c7;
+  --rpt-color-info-bg: #f0f9ff;
+  --rpt-color-info-border: #bae6fd;
+
+  /* Border Radii */
+  --rpt-border-radius-xs: 3px;
+  --rpt-border-radius-sm: 4px;
+  --rpt-border-radius: 6px;
+  --rpt-border-radius-lg: 8px;
+  --rpt-border-radius-xl: 12px;
+  --rpt-border-radius-full: 9999px;
+
+  /* Transitions & Animation Speeds */
+  --rpt-transition-speed-fast: 100ms;
+  --rpt-transition-speed: 150ms;
+  --rpt-transition-speed-smooth: 250ms;
+  --rpt-transition-ease: cubic-bezier(0.16, 1, 0.3, 1);
+
+  /* Elevation Shadows */
+  --rpt-box-shadow-xs: 0 1px 2px 0 rgba(0, 0, 0, 0.04);
+  --rpt-box-shadow: 0 1px 3px 0 rgba(0, 0, 0, 0.08), 0 1px 2px -1px rgba(0, 0, 0, 0.04);
+  --rpt-box-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.07), 0 2px 4px -2px rgba(0, 0, 0, 0.05);
+  --rpt-box-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.08), 0 4px 6px -4px rgba(0, 0, 0, 0.04);
+  --rpt-box-shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.04);
+  --rpt-box-shadow-focus: 0 0 0 3px var(--rpt-color-primary-focus);
+
+  /* Glassmorphism */
+  --rpt-glass-bg: rgba(255, 255, 255, 0.85);
+  --rpt-glass-border: rgba(255, 255, 255, 0.4);
+  --rpt-glass-blur: blur(10px);
+}
+
+/* ==========================================================================
+   Global Helper & Accessibility Utilities
+   ========================================================================== */
+.rpt-tabular-nums {
+  font-variant-numeric: tabular-nums;
+}
+
+/* Library typography only: do not reset the host application controls. */
+:where(rpt-designer, rpt-report-designer, rpt-runtime, rpt-report, rpt-report-saved-dialog) :is(button, input, select, textarea) {
+  font-family: inherit;
+}
+
+/* Remove increment / decrement stepper arrows from all number inputs */
+input[type=number]::-webkit-inner-spin-button,
+input[type=number]::-webkit-outer-spin-button {
+  -webkit-appearance: none;
+  margin: 0;
+}
+
+input[type=number] {
+  -moz-appearance: textfield;
+  appearance: textfield;
+}
+
+/* Accessible focus ring */
+:focus-visible {
+  outline: 2px solid var(--rpt-color-primary);
+  outline-offset: 2px;
+}
+
+/* Respect reduced motion */
+@media (prefers-reduced-motion: reduce) {
+  *, ::before, ::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}
+
+/* CDK Drag and Drop Global Styles */
+.cdk-drag-preview {
+  box-sizing: border-box;
+  border-radius: var(--rpt-border-radius-lg, 8px);
+  box-shadow: 0 16px 32px -4px rgba(0, 0, 0, 0.28), 0 4px 12px rgba(0, 0, 0, 0.15);
+  opacity: 0.96;
+  background: var(--rpt-color-surface, #ffffff);
+  border: 1px solid var(--rpt-color-primary, #2563eb);
+  z-index: 10000 !important;
+  font-family: var(--rpt-font-family, system-ui, sans-serif) !important;
+}
+
+.cdk-drag-preview * {
+  font-family: inherit !important;
+}
+
+.cdk-drag-placeholder {
+  opacity: 0.25 !important;
+  border: 2px dashed var(--rpt-color-primary, #2563eb) !important;
+  border-radius: var(--rpt-border-radius-lg, 8px) !important;
+  background: var(--rpt-color-primary-light, rgba(37, 99, 235, 0.05)) !important;
+}
+
+.cdk-drag-animating {
+  transition: transform 220ms var(--rpt-transition-ease, cubic-bezier(0.16, 1, 0.3, 1));
+}
+
+.canvas-grid.cdk-drop-list-dragging .canvas-component-card:not(.cdk-drag-placeholder) {
+  transition: transform 220ms var(--rpt-transition-ease, cubic-bezier(0.16, 1, 0.3, 1));
+}
+
+/* Optional library dialog appearance. Structural positioning is installed by the library. */
+.rpt-dialog-panel {
+  max-width: 95vw;
+  max-height: 95vh;
+}
+.rpt-dialog-backdrop {
+  background-color: rgba(15, 23, 42, 0.48);
+  backdrop-filter: blur(3px);
+}

package/third-party-notices/angular-cdk-LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2024 Google LLC.
+
+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.