osi-cards-lib 1.0.0

package/lib/services/section-utils.service.d.ts

@@ -0,0 +1,46 @@
+import * as i0 from "@angular/core";
+/**
+ * Status values that can be used in sections
+ */
+export type StatusValue = 'active' | 'completed' | 'success' | 'pending' | 'warning' | 'in-progress' | 'inactive' | 'error' | 'cancelled' | 'blocked' | 'delayed' | string;
+/**
+ * Priority values that can be used in sections
+ */
+export type PriorityValue = 'high' | 'medium' | 'low' | string;
+/**
+ * Trend values for analytics
+ */
+export type TrendValue = 'up' | 'down' | 'stable' | 'neutral';
+/**
+ * Utility service for section components
+ * Provides consistent status, trend, and icon handling across all sections
+ */
+export declare class SectionUtilsService {
+    /**
+     * Get CSS classes for status badges/tags
+     * Returns consistent classes across all section types
+     */
+    getStatusClasses(status?: StatusValue): string;
+    /**
+     * Get CSS classes for priority badges/tags
+     */
+    getPriorityClasses(priority?: PriorityValue): string;
+    /**
+     * Get icon name for trend indicators
+     */
+    getTrendIcon(trend?: TrendValue | string): string;
+    /**
+     * Get CSS classes for trend indicators
+     */
+    getTrendClass(trend?: TrendValue | string | number): string;
+    /**
+     * Calculate trend from change value
+     */
+    calculateTrend(change?: number): TrendValue;
+    /**
+     * Format change value with sign
+     */
+    formatChange(change?: number): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SectionUtilsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SectionUtilsService>;
+}

package/lib/utils/card-diff.util.d.ts

@@ -0,0 +1,52 @@
+import { AICardConfig } from '../models';
+export type CardChangeType = 'content' | 'structural';
+export interface CardDiffResult {
+    card: AICardConfig;
+    changeType: CardChangeType;
+}
+/**
+ * Deep comparison utility for card objects
+ * Uses content hashing instead of JSON.stringify for better performance
+ */
+export declare class CardDiffUtil {
+    /**
+     * Creates an updated card with only changed sections/fields updated
+     * Preserves references to unchanged sections for optimal performance
+     */
+    static mergeCardUpdates(oldCard: AICardConfig, newCard: AICardConfig): CardDiffResult;
+    private static didStructureChange;
+    /**
+     * Merges sections array, preserving references to unchanged sections
+     */
+    private static mergeSections;
+    /**
+     * Merges a single section, preserving references to unchanged fields/items
+     */
+    private static mergeSection;
+    /**
+     * Merges fields array, preserving references to unchanged fields
+     * Uses content hashing instead of JSON.stringify for better performance
+     */
+    private static mergeFields;
+    /**
+     * Merges items array, preserving references to unchanged items
+     * Uses content hashing instead of JSON.stringify for better performance
+     */
+    private static mergeItems;
+    /**
+     * Fast equality check for cards
+     */
+    private static areCardsEqual;
+    /**
+     * Fast equality check for sections arrays
+     */
+    private static areSectionsEqual;
+    /**
+     * Fast equality check for fields arrays
+     */
+    private static areFieldsEqual;
+    /**
+     * Fast equality check for items arrays
+     */
+    private static areItemsEqual;
+}

package/lib/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './card-diff.util';
+export * from './responsive.util';

package/lib/utils/responsive.util.d.ts

@@ -0,0 +1,2 @@
+export type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+export declare function getBreakpointFromWidth(width: number): Breakpoint;

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "osi-cards-lib",
+  "version": "1.0.0",
+  "description": "Standalone OSI Cards library for Angular applications",
+  "keywords": [
+    "angular",
+    "cards",
+    "ui",
+    "components"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Inutilepat83/OSI-Cards.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Inutilepat83/OSI-Cards/issues"
+  },
+  "homepage": "https://github.com/Inutilepat83/OSI-Cards#readme",
+  "peerDependencies": {
+    "@angular/core": "^20.0.0",
+    "@angular/common": "^20.0.0",
+    "@angular/forms": "^20.0.0",
+    "@angular/router": "^20.0.0",
+    "@angular/platform-browser": "^20.0.0",
+    "@ngrx/store": "^18.0.0",
+    "@ngrx/effects": "^18.0.0",
+    "@ngrx/entity": "^18.0.0",
+    "rxjs": "~7.8.0",
+    "zone.js": "~0.15.0"
+  },
+  "dependencies": {
+    "lucide-angular": "^0.548.0",
+    "lucide": "^0.548.0",
+    "tslib": "^2.3.0"
+  },
+  "optionalDependencies": {
+    "chart.js": "^4.4.0",
+    "leaflet": "^1.9.4"
+  },
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "esm2022": "./esm2022/osi-cards-lib.mjs",
+      "esm": "./esm2022/osi-cards-lib.mjs",
+      "default": "./fesm2022/osi-cards-lib.mjs"
+    },
+    "./styles/_styles": {
+      "default": "./styles/_styles.scss"
+    },
+    "./styles/_styles.scss": {
+      "default": "./styles/_styles.scss"
+    }
+  },
+  "main": "./fesm2022/osi-cards-lib.mjs",
+  "module": "./fesm2022/osi-cards-lib.mjs",
+  "typings": "./index.d.ts",
+  "sideEffects": false
+}

package/public-api.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Public API Surface of OSI Cards Library
+ *
+ * This file exports all public APIs that can be imported by other Angular projects.
+ *
+ * @example
+ * ```typescript
+ * import { AICardRendererComponent, CardDataService } from '@osi/cards-lib';
+ * ```
+ */
+export * from './lib/models';
+export * from './lib/services';
+export * from './lib/services/section-utils.service';
+export * from './lib/utils';
+export * from './lib/icons';
+export * from './lib/components/ai-card-renderer/ai-card-renderer.component';
+export * from './lib/components/section-renderer/section-renderer.component';
+export * from './lib/components/masonry-grid/masonry-grid.component';
+export * from './lib/components/card-skeleton/card-skeleton.component';
+export * from './lib/components/card-preview/card-preview.component';
+export * from './lib/components/sections/base-section.component';
+export * from './lib/components/sections/analytics-section/analytics-section.component';
+export * from './lib/components/sections/brand-colors-section/brand-colors-section.component';
+export * from './lib/components/sections/chart-section/chart-section.component';
+export * from './lib/components/sections/contact-card-section/contact-card-section.component';
+export * from './lib/components/sections/event-section/event-section.component';
+export * from './lib/components/sections/fallback-section/fallback-section.component';
+export * from './lib/components/sections/financials-section/financials-section.component';
+export * from './lib/components/sections/info-section.component';
+export * from './lib/components/sections/list-section/list-section.component';
+export * from './lib/components/sections/map-section/map-section.component';
+export * from './lib/components/sections/network-card-section/network-card-section.component';
+export * from './lib/components/sections/news-section/news-section.component';
+export * from './lib/components/sections/overview-section/overview-section.component';
+export * from './lib/components/sections/product-section/product-section.component';
+export * from './lib/components/sections/quotation-section/quotation-section.component';
+export * from './lib/components/sections/social-media-section/social-media-section.component';
+export * from './lib/components/sections/solutions-section/solutions-section.component';
+export * from './lib/components/sections/text-reference-section/text-reference-section.component';
+/**
+ * Note: For full functionality including:
+ * - CardDataService and other core services
+ * - NgRx store (actions, selectors, reducers, effects)
+ * - Additional utilities and providers
+ *
+ * You may need to import from the main application source or
+ * extend the library exports. See integration documentation for details.
+ *
+ * Styles entry point: '@osi/cards-lib/styles/_styles.scss'
+ */

package/styles/_styles.scss

@@ -0,0 +1,95 @@
+// Core variables and mixins (must come first)
+@import 'core/variables';
+@import 'core/mixins';
+@import 'core/surface-layers';
+@import 'core/global';
+@import 'core/utilities';
+@import 'core/animations';
+
+// Layout styles
+@import 'layout/tilt';
+@import 'layout/masonry';
+
+// Component styles
+@import 'components/cards/ai-card';
+@import 'components/sections/design-system'; /* Master design system - must import first */
+@import 'components/sections/sections-base';
+@import 'components/sections/section-types';
+@import 'components/sections/section-shell';
+@import 'components/sections/overview';
+@import 'components/sections/analytics';
+@import 'components/sections/news';
+@import 'components/sections/social-media';
+@import 'components/sections/info';
+@import 'components/sections/map';
+@import 'components/sections/list';
+@import 'components/sections/contact';
+@import 'components/sections/network';
+@import 'components/sections/product';
+@import 'components/sections/chart';
+@import 'components/sections/event';
+@import 'components/sections/financials';
+@import 'components/sections/solutions';
+@import 'components/sections/quotation';
+@import 'components/sections/text-reference';
+@import 'components/sections/brand-colors';
+@import 'components/sections/fallback';
+@import 'components/sections/unified-cards'; /* Must be last to override all section-specific styles */
+@import 'components/sections/global-enforcement'; /* GLOBAL ENFORCEMENT - MUST BE ABSOLUTELY LAST to enforce all settings */
+@import 'components/ai-card-renderer';
+
+/* FINAL OVERRIDE - ABSOLUTELY NO BORDERS OR BORDER-LIKE EFFECTS */
+h1.ai-card-title,
+.ai-card-title,
+article.ai-card-surface h1,
+.ai-card-surface > h1,
+.ai-card-surface .ai-card-title {
+  border: 0 !important;
+  border-width: 0 !important;
+  border-style: none !important;
+  border-top-width: 0 !important;
+  border-right-width: 0 !important;
+  border-bottom-width: 0 !important;
+  border-left-width: 0 !important;
+  box-shadow: none !important;
+  outline: 0 !important;
+  outline-width: 0 !important;
+  text-decoration: none !important;
+  background-image: none !important;
+  
+  &::before,
+  &::after {
+    display: none !important;
+    content: none !important;
+    border: 0 !important;
+    box-shadow: none !important;
+    background: none !important;
+  }
+}
+
+/* Remove all styling from parent container */
+.relative.h-full,
+div[class*="relative"][class*="h-full"] {
+  position: static !important;
+  height: auto !important;
+  padding: 0 !important;
+  margin: 0 !important;
+  border: 0 !important;
+  background: none !important;
+  box-shadow: none !important;
+}
+
+/* Also ensure article itself has no borders */
+article.ai-card-surface,
+.ai-card-surface {
+  border: 0 !important;
+  border-width: 0 !important;
+  outline: 0 !important;
+}
+
+
+
+
+
+
+