minahil 0.1.10 → 0.1.11

package/README.md

@@ -1,4 +1,4 @@
-# @brickclay-org/ui
+# Minahil - Angular UI Component Library
 
 A comprehensive Angular UI component library featuring a rich collection of customizable, accessible components. Built with modern Angular standards, this library provides everything you need to build beautiful and functional user interfaces.
 
@@ -6,11 +6,12 @@ A comprehensive Angular UI component library featuring a rich collection of cust
 
 - 📦 **Comprehensive Component Library** - Rich set of UI components for common use cases
 - ♿ **Accessible by Default** - WCAG compliant components with keyboard navigation and screen reader support
-- 🚀 **Angular 20+ Ready** - Built with latest Angular features and standalone components
+- 🚀 **Angular 17-21 Support** - Built with modern Angular features and standalone components
 - 📱 **Responsive Design** - Mobile-first components that work on all screen sizes
 - 🎯 **Type-Safe** - Full TypeScript support with comprehensive type definitions
 - ⚡ **Lightweight** - Tree-shakeable and optimized for performance
 - 🎛️ **Highly Customizable** - Extensive configuration options for every component
+- 🔧 **Easy Setup** - One-command installation with automatic dependency management
 
 ## 📚 Available Components
 
@@ -32,20 +33,49 @@ A fully accessible radio button component with Angular forms integration. Featur
 
 _More components coming soon..._
 
-## Installation
+## 🚀 Quick Start
+
+### Automatic Installation (Recommended)
+
+The easiest way to install Minahil is using Angular CLI's `ng add` command. This automatically installs the library along with matching versions of Angular CDK and other dependencies:
 
 ```bash
-npm i @brickclay-org/ui@0.0.6
+ng add minahil
 ```
 
-### Peer Dependencies
+This will:
+
+- ✅ Detect your Angular version (17, 18, 19, 20, or 21)
+- ✅ Install Minahil library
+- ✅ Install matching @angular/cdk version
+- ✅ Install moment.js dependency
+- ✅ Configure everything automatically
+
+### Manual Installation
+
+If you prefer manual installation:
+
+```bash
+npm install minahil
+```
 
-This library requires Angular 20.3.0 or higher:
+**Important:** You must also install peer dependencies that match your Angular version:
 
 ```bash
-npm install @angular/common@^20.3.0 @angular/core@^20.3.0 moment
+# For Angular 19 projects
+npm install @angular/cdk@^19.0.0 moment@^2.29.0
+
+# For Angular 17 projects
+npm install @angular/cdk@^17.0.0 moment@^2.29.0
+
+# For Angular 21 projects
+npm install @angular/cdk@^21.0.0 moment@^2.29.0
 ```
 
+### Supported Angular Versions
+
+Minahil supports Angular versions **17 through 21**. The library will automatically work with any Angular version in this range.
+
 ### Asset Configuration (Required)
 
 After installing the library, you need to configure your `angular.json` to include the library's assets (icons, etc.). Add the following to your project's `assets` array in the `build` options:

package/package.json

@@ -1,12 +1,25 @@
 {
   "name": "minahil",
-  "version": "0.1.10",
+  "version": "0.1.11",
+  "description": "A comprehensive Angular UI component library with calendar, checkbox, radio, and toggle components",
+  "schematics": "./schematics/collection.json",
+  "ng-add": {
+    "save": "dependencies"
+  },
   "peerDependencies": {
     "@angular/cdk": ">=17.0.0 <22.0.0",
     "@angular/common": ">=17.0.0 <22.0.0",
     "@angular/core": ">=17.0.0 <22.0.0",
     "moment": "^2.29.0"
   },
+  "peerDependenciesMeta": {
+    "@angular/cdk": {
+      "optional": true
+    },
+    "moment": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "tslib": "^2.3.0"
   },
@@ -21,10 +34,5 @@
       "types": "./index.d.ts",
       "default": "./fesm2022/minahil.mjs"
     }
-  },
-  "schematics": "./schematics/collection.json",
-  "description": "A comprehensive Angular UI component library with calendar, checkbox, radio, and toggle components",
-  "ng-add": {
-    "save": "dependencies"
   }
 }

package/schematics/ng-add/index.js

@@ -1,74 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = default_1;
-const tasks_1 = require("@angular-devkit/schematics/tasks");
-const dependencies_1 = require("@schematics/angular/utility/dependencies");
-function default_1(options) {
-    return (tree, context) => {
-        context.logger.info('🚀 Setting up Minahil library...');
-        // 1. Read user's Angular version from package.json
-        const angularCore = (0, dependencies_1.getPackageJsonDependency)(tree, '@angular/core');
-        if (!angularCore) {
-            throw new Error('❌ Cannot find @angular/core in package.json. Make sure this is an Angular project.');
-        }
-        // 2. Extract major version (e.g., "^19.0.0" -> "19" or "~18.2.0" -> "18")
-        const angularVersion = angularCore.version;
-        const majorVersionMatch = angularVersion.match(/(\d+)/);
-        if (!majorVersionMatch) {
-            throw new Error(`❌ Could not determine Angular version from ${angularVersion}`);
-        }
-        const majorVersion = parseInt(majorVersionMatch[0], 10);
-        // 3. Validate Angular version is in supported range (17-21)
-        if (majorVersion < 17 || majorVersion > 21) {
-            throw new Error(`❌ Minahil library supports Angular versions 17-21, but found Angular ${majorVersion}.\n` +
-                `Please upgrade or downgrade your Angular version.`);
-        }
-        context.logger.info(`✅ Detected Angular version: ${majorVersion}`);
-        // 4. Check if user already has CDK installed
-        const existingCdk = (0, dependencies_1.getPackageJsonDependency)(tree, '@angular/cdk');
-        if (existingCdk) {
-            const existingCdkMajor = existingCdk.version.match(/(\d+)/)?.[0];
-            // Check if existing CDK version matches Angular version
-            if (existingCdkMajor && parseInt(existingCdkMajor) === majorVersion) {
-                context.logger.info(`✅ Using existing @angular/cdk@${existingCdk.version}`);
-            }
-            else {
-                context.logger.warn(`⚠️  Found @angular/cdk@${existingCdk.version} but you have Angular ${majorVersion}.\n` +
-                    `   Consider updating CDK to match your Angular version: npm install @angular/cdk@^${majorVersion}.0.0`);
-            }
-        }
-        else {
-            // Install matching CDK version
-            const cdkVersion = `^${majorVersion}.0.0`;
-            (0, dependencies_1.addPackageJsonDependency)(tree, {
-                type: dependencies_1.NodeDependencyType.Default,
-                name: '@angular/cdk',
-                version: cdkVersion,
-            });
-            context.logger.info(`✅ Installing @angular/cdk@${cdkVersion} to match Angular ${majorVersion}`);
-        }
-        // 5. Check if moment is installed (it's a peer dependency)
-        const existingMoment = (0, dependencies_1.getPackageJsonDependency)(tree, 'moment');
-        if (!existingMoment) {
-            (0, dependencies_1.addPackageJsonDependency)(tree, {
-                type: dependencies_1.NodeDependencyType.Default,
-                name: 'moment',
-                version: '^2.29.0',
-            });
-            context.logger.info('✅ Installing moment@^2.29.0');
-        }
-        else {
-            context.logger.info(`✅ Using existing moment@${existingMoment.version}`);
-        }
-        // 6. Schedule npm install
-        context.addTask(new tasks_1.NodePackageInstallTask());
-        context.logger.info('');
-        context.logger.info('🎉 Minahil library has been successfully configured!');
-        context.logger.info('');
-        context.logger.info('📚 Next steps:');
-        context.logger.info('  1. Import components from "minahil" in your modules or standalone components');
-        context.logger.info('  2. Check the documentation for available components');
-        context.logger.info('');
-        return tree;
-    };
-}