@cute-widgets/base 20.0.1

package/CHANGELOG.md

@@ -0,0 +1 @@
+## Initial version 20.0.0

package/LICENSE.md

@@ -0,0 +1,191 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+**1. Definitions.**
+
+   ***License*** shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   ***Licensor*** shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   ***Legal Entity*** shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   ***You*** (or ***Your***) shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   ***Source*** form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   ***Object*** form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   ***Work*** shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   ***Derivative Works*** shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   ***Contribution*** shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   ***Contributor*** shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+**2. Grant of Copyright License.** Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+**3. Grant of Patent License.** Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+**4. Redistribution.** You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+   Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+   stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+   that You distribute, all copyright, patent, trademark, and
+   attribution notices from the Source form of the Work,
+   excluding those notices that do not pertain to any part of
+   the Derivative Works; and
+
+   (d) If the Work includes a NOTICE text file as part of its
+   distribution, then any Derivative Works that You distribute must
+   include a readable copy of the attribution notices contained
+   within such NOTICE file, excluding those notices that do not
+   pertain to any part of the Derivative Works, in at least one
+   of the following places: within a NOTICE text file distributed
+   as part of the Derivative Works; within the Source form or
+   documentation, if provided along with the Derivative Works; or,
+   within a display generated by the Derivative Works, if and
+   wherever such third-party notices normally appear. The contents
+   of the NOTICE file are for informational purposes only and
+   do not modify the License. You may add Your own attribution
+   notices within Derivative Works that You distribute, alongside
+   or as an addendum to the NOTICE text from the Work, provided
+   that such additional attribution notices cannot be construed
+   as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+**5. Submission of Contributions.** Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+**6. Trademarks.** This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+**7. Disclaimer of Warranty.** Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an **AS IS** BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+**8. Limitation of Liability.** In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+**9. Accepting Warranty or Additional Liability.** While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+---
+© 2025 CuteWidgets Team. All rights reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,190 @@
+# CuteWidgets
+
+**[@cute-widgets/base](https://github.com/cute-widgets/base)** is an open-source UI component library for Angular applications.
+All components are implemented as native directives and styled using the design and utility
+classes of the [Bootstrap 5+](https://getbootstrap.com/) framework. At the same time, the internal implementation and external API of 
+core **Cute Widgets** are based on the source code of the popular MIT-licensed [Angular Material](https://material.angular.dev/) 
+library. In a sense, **[@cute-widgets/base](https://github.com/cute-widgets/base)** is a complete reincarnation of the latter.
+
+### Architecture and Design Principles
+
+Components adopt structural and behavioral patterns from **Angular Material**, including:
+
+- Consistent input/output naming (`[disabled]`, `(change)`)
+- Form control integration via `ControlValueAccessor`
+- Content projection using well-defined slots
+- Focus management and keyboard navigation
+- Accessibility attributes (ARIA roles, labels, states)
+- Responsive behavior out of the box
+- Seamless integration with **Bootstrap** classes and layout
+
+
+### Highlights
+
+- **35+ free components**
+
+The full set of [Angular Material](https://material.angular.dev/) 20+ components is 
+available in the open-source `@cute-widgets/base` package.
+
+- **Looks like Bootstrap** 
+
+Visual styling adheres to [Bootstrap 5+](https://getbootstrap.com/) CSS classes.
+Components apply standard class names such as `.btn`, `.form-control`, `.table`, and `.card`,
+ensuring compatibility with existing Bootstrap projects.
+
+- **Themes out of the box**
+
+Supports Bootstrap CSS variables, dark mode, embedded and custom color themes. The Bootstrap icon font is set by default.
+
+- **Powered by Angular Material**
+
+Fully redesigned code of the popular library with almost full 
+program interface compatibility, full `a11y`, keyboard navigation, internationalization, and enterprise-grade 
+stability.
+
+- **Ready for teams**
+
+Standalone components, signals, SSR, and lazy loading — all Angular’s latest features.
+No more custom CSS hacks and design compromises. Just a seamless, production-ready UI library for Angular 20+ applications.
+
+- **PRO components**
+
+Advanced featured components (Carousel, ChartJs, EditMask, Dropdown, etc.) 
+are available in `@cute-widgets/pro` library and need the Commercial license.
+ 
+### Get Started
+
+1. Install the open-source library
+```bash
+npm install @cute-widgets/base
+```
+or with yarn
+```bash
+yarn add @cute-widgets/base
+```
+
+2. Copy and paste the following excerpt in your _src/styles.scss_ file to include the minimum required compiled and minified CSS bundles:
+
+```scss
+@use "bootstrap/dist/css/bootstrap.min.css";
+//@use "bootstrap/dist/css/bootstrap.rtl.min.css";
+@use "bootstrap-icons/font/bootstrap-icons";
+@use '@angular/cdk/overlay-prebuilt.css';
+```
+
+> **Note**   
+You don't need to include **Bootstrap**'s compiled and minified JavaScript plugins and use `data-bs-*` attributes in your components. All the necessary behavior is implemented within the Cute Widgets themselves.
+
+3. Import components
+
+Just import the desired component module and start using it.
+
+```typescript
+// app.component.ts
+import {CuteButtonModule} from '@cute-widgets/base/button';
+import {CuteCardModule} from '@cute-widgets/base/card';
+
+@Component({
+    selector: 'app-root',
+    template: `
+        <cute-card>
+            <cute-card-header> My header </cite-card-header>
+            <cute-card-body> My body </cute-card-body>
+            <cute-card-footer>    
+                <button cute-button color="primary">Click me</button>
+            </cute-card-footer>    
+        </cute-card>
+    `,
+    imports: [CuteButtonModule, CuteCardModule],
+})
+export class AppComponent {}
+```
+
+
+### Why @cute-widgets/base?
+
+###### ✅ Simpler than Angular Material
+
+Angular Material is powerful but often too heavy for simple projects.
+`@cute-widgets/base` offers:
+
+- Smaller bundle size
+- Fewer dependencies
+- More intuitive APIs
+- No mandatory theming engine
+
+###### ✅ Better than raw Bootstrap
+
+Bootstrap is great, but lacks true Angular integration.
+Our components:
+
+- Are native Angular directives
+- Support reactive forms
+- Have proper change detection
+- Emit events, not just DOM events
+
+###### ✅ Designed for Real Projects
+
+We focus on what developers actually need:
+
+- Clean, readable code
+- Predictable behavior
+- Easy customization
+- Supporting i18n and RTL
+- Great developer experience
+
+###### ✅ All components:
+
+- Use standard Bootstrap classes (e.g., `.btn`, `.form-control`)
+- Are fully accessible (ARIA, keyboard support)
+- Work with Bootstrap’s grid and utilities
+- Support dark mode via Bootstrap’s `.bg-dark`, `.text-white`, etc.
+
+### What's the next
+
+Now you have a full set of open-source components available in the **Angular Material** library since **20.x** version, but with the `cute` prefix and styled with **Bootstrap 5+**. In fact, you have much more.
+
+> **Note**  
+> The developers of **CuteWidgets** have tried to ensure maximum compatibility in terms of 
+> selector names and input/output program interfaces with the parent library, changing only its 
+> visual representation. However, 100% compatibility of the internal API of components and 
+> services is not guaranteed and may change in the future.
+
+To simplify the process of getting started with **@cute-widgets/base** components the small `projects/showcase` application was created.
+All you need to do is run the `ng serve` command in the terminal window and navigate to http://localhost:4200 in the browser, or press 
+`o+Enter` in the development server's console window. For a detailed description of using a specific component, see the according **.md** file in the component's folder.
+
+Here is another example of using base components similar to **Bootstrap**, but with **Angular Material** power. As you can see we just replace the **mat*** prefixes with **cute*** in a component's template:
+
+```html
+<!-- @angular/material -->
+<button matButton="outlined" color="primary" 
+        (click)="onSaveButtonClick()">
+    <mat-icon> save </mat-icon>
+    Save changes
+</button> 
+```
+
+```html
+<!-- @cute-widgets/base -->
+<button cuteButton="outlined" color="primary" 
+        (click)="onSaveButtonClick()">
+  <cute-icon> bi-floppy </cute-icon>
+  Save changes
+</button> 
+```
+
+
+### Contributing
+
+For bug reports or feature requests, please use [GitHub Issues](https://github.com/cute-widgets/base/issues).
+To contribute to the project, `fork` the **CuteWidgets** project and create a `Pull Request` in a separate branch.
+
+### License
+Apache-2.0
+
+---
+© 2025 CuteWidgets Team. All rights reserved. 🌐
+
+
+