xv-webcomponents 0.1.17 → 0.1.19

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 crossvertise
-
-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.
+MIT License
+
+Copyright (c) 2025 crossvertise
+
+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/README.md

@@ -1,129 +1,129 @@
-# @xv/webcomponents
-
-**Reusable Web Components for XV Applications**  
-This repository contains Web Components built with Stencil.js to provide a modular and reusable UI across multiple applications.
-
----
-
-## Features
-
-**Reusable Web Components** – Designed for multiple XV applications  
-**Stencil.js Powered** – Built using modern Web Component standards  
-**Shadow DOM Support** – Encapsulated styles and functionality  
-**Brand-Specific Theming** – Automatically detects and applies brand styles  
-**Framework Agnostic** – Works with Angular, React, Vue, and plain HTML  
-
----
-
-## Folder Structure
-
-```
-xv-webcomponents/
-│── src/
-│   ├── components/       # Web Component source files
-│   │   ├── button/
-│   │   │   ├── xv-button.tsx
-│   │   │   ├── xv-button.css
-│   │   │   ├── xv-button.e2e.ts
-│   │   │   ├── xv-button.spec.ts
-│   │   ├── checkbox/
-│   │   │   ├── xv-checkbox.tsx
-│   │   │   ├── xv-checkbox.css
-│   │   │   ├── xv-checkbox.e2e.ts
-│   │   │   ├── xv-checkbox.spec.ts
-│   ├── utils/            # Utility functions for components
-│── dist/                 # Compiled distribution files
-│── loader/               # Loader scripts for consuming Web Components
-│── package.json
-│── README.md
-│── stencil.config.ts     # Stencil.js configuration
-```
-
----
-
-## Installation
-
-To install the package from npm:
-```bash
-npm install xv-webcomponents
-```
-
----
-
-## Usage
-
-### **Using in an HTML Page**
-Simply include the Web Component in your HTML:
-```html
-<script type="module" src="https://cdn.yourcompany.com/xv-webcomponents/xv-webcomponents.esm.js"></script>
-<xv-button-v2 label="Click Me" variant="accent"></xv-button-v2>
-```
-
-### **Using in an Angular Project**
-First, import `CUSTOM_ELEMENTS_SCHEMA` in your module:
-```typescript
-import { NgModule, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
-import { BrowserModule } from '@angular/platform-browser';
-
-@NgModule({
-  declarations: [],
-  imports: [BrowserModule],
-  schemas: [CUSTOM_ELEMENTS_SCHEMA]
-})
-export class AppModule {}
-```
-Now, use the Web Component in your Angular templates:
-```html
-<xv-button-v2 label="Click Me" variant="primary"></xv-button-v2>
-```
-
-### **Using in a C# Razor Page (MVC)**
-```html
-<xv-button-v2 label="Submit" variant="secondary"></xv-button-v2>
-```
-
-### **Using in Sitefinity CMS**
-Embed the Web Component inside a content block:
-```html
-<xv-button-v2 label="Learn More" variant="ghost"></xv-button-v2>
-```
-
----
-
-## 🛠 Development & Building
-
-### **1️⃣ Build the Components**
-To build all components:
-```bash
-npm run build
-```
-This generates compiled components inside the `dist/` folder.
-
-### **2️⃣ Run Local Development Server**
-To test components locally:
-```bash
-npm start
-```
-This starts a development server and watches for changes.
-
-### **3️⃣ Publish to npm**
-To publish a new version of the package:
-```bash
-npm version patch
-npm publish --access public
-```
-
----
-
-## Contributing
-
-### **Adding a New Component**
-1. Generate a new component:
-   ```bash
-   npm run generate component xv-new-component
-   ```
-2. Implement logic and styles inside `src/components/xv-new-component/`.
-3. Test the component using Jest (`.spec.ts`) and e2e tests.
-4. Run `npm run build` to generate the compiled version.
-5. Commit changes and submit a pull request.
-
+# @xv/webcomponents
+
+**Reusable Web Components for XV Applications**  
+This repository contains Web Components built with Stencil.js to provide a modular and reusable UI across multiple applications.
+
+---
+
+## Features
+
+**Reusable Web Components** – Designed for multiple XV applications  
+**Stencil.js Powered** – Built using modern Web Component standards  
+**Shadow DOM Support** – Encapsulated styles and functionality  
+**Brand-Specific Theming** – Automatically detects and applies brand styles  
+**Framework Agnostic** – Works with Angular, React, Vue, and plain HTML  
+
+---
+
+## Folder Structure
+
+```
+xv-webcomponents/
+│── src/
+│   ├── components/       # Web Component source files
+│   │   ├── button/
+│   │   │   ├── xv-button.tsx
+│   │   │   ├── xv-button.css
+│   │   │   ├── xv-button.e2e.ts
+│   │   │   ├── xv-button.spec.ts
+│   │   ├── checkbox/
+│   │   │   ├── xv-checkbox.tsx
+│   │   │   ├── xv-checkbox.css
+│   │   │   ├── xv-checkbox.e2e.ts
+│   │   │   ├── xv-checkbox.spec.ts
+│   ├── utils/            # Utility functions for components
+│── dist/                 # Compiled distribution files
+│── loader/               # Loader scripts for consuming Web Components
+│── package.json
+│── README.md
+│── stencil.config.ts     # Stencil.js configuration
+```
+
+---
+
+## Installation
+
+To install the package from npm:
+```bash
+npm install xv-webcomponents
+```
+
+---
+
+## Usage
+
+### **Using in an HTML Page**
+Simply include the Web Component in your HTML:
+```html
+<script type="module" src="https://cdn.yourcompany.com/xv-webcomponents/xv-webcomponents.esm.js"></script>
+<xv-button-v2 label="Click Me" variant="accent"></xv-button-v2>
+```
+
+### **Using in an Angular Project**
+First, import `CUSTOM_ELEMENTS_SCHEMA` in your module:
+```typescript
+import { NgModule, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+
+@NgModule({
+  declarations: [],
+  imports: [BrowserModule],
+  schemas: [CUSTOM_ELEMENTS_SCHEMA]
+})
+export class AppModule {}
+```
+Now, use the Web Component in your Angular templates:
+```html
+<xv-button-v2 label="Click Me" variant="primary"></xv-button-v2>
+```
+
+### **Using in a C# Razor Page (MVC)**
+```html
+<xv-button-v2 label="Submit" variant="secondary"></xv-button-v2>
+```
+
+### **Using in Sitefinity CMS**
+Embed the Web Component inside a content block:
+```html
+<xv-button-v2 label="Learn More" variant="ghost"></xv-button-v2>
+```
+
+---
+
+## 🛠 Development & Building
+
+### **1️⃣ Build the Components**
+To build all components:
+```bash
+npm run build
+```
+This generates compiled components inside the `dist/` folder.
+
+### **2️⃣ Run Local Development Server**
+To test components locally:
+```bash
+npm start
+```
+This starts a development server and watches for changes.
+
+### **3️⃣ Publish to npm**
+To publish a new version of the package:
+```bash
+npm version patch
+npm publish --access public
+```
+
+---
+
+## Contributing
+
+### **Adding a New Component**
+1. Generate a new component:
+   ```bash
+   npm run generate component xv-new-component
+   ```
+2. Implement logic and styles inside `src/components/xv-new-component/`.
+3. Test the component using Jest (`.spec.ts`) and e2e tests.
+4. Run `npm run build` to generate the compiled version.
+5. Commit changes and submit a pull request.
+

package/dist/types/components/xv-checkbox/xv-checkbox.d.ts

@@ -1,6 +1,70 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { SIZE_VAR } from '../../types/enum';
 export declare class XvCheckbox {
+    private inputEl;
+    private internals;
     el: HTMLElement;
-    private applyGlobalStyles;
-    componentWillLoad(): void;
+    /**
+     * Default checked status
+     */
+    checked: boolean;
+    /**
+     * Using for forms
+     */
+    indeterminate: boolean;
+    /**
+     * Disabled status
+     */
+    disabled: boolean;
+    /**
+     * Input name
+     */
+    name: string;
+    /**
+     * Input value
+     */
+    value: string;
+    /**
+     * The same like default checkbox prop
+     */
+    required: boolean;
+    /**
+     * Change checkmark icon to minus
+     */
+    partial: boolean;
+    /**
+     * Can be used like property or like slot
+     */
+    label: string;
+    size?: SIZE_VAR;
+    error?: string | boolean;
+    hasFocus: boolean;
+    /**
+     * event 'onEventChange'
+     */
+    changeEvent: EventEmitter<boolean>;
+    /**
+     * event 'onEventInput'
+     */
+    inputEvent: EventEmitter<boolean>;
+    /**
+     * event 'onEventFocus'
+     */
+    focusEvent: EventEmitter<void>;
+    /**
+     * event 'onEventBlur'
+     */
+    blurEvent: EventEmitter<void>;
+    constructor();
+    connectedCallback(): void;
+    onCheckedChange(newValue: boolean): void;
+    private onInput;
+    private onChange;
+    private onFocus;
+    private onBlur;
     render(): any;
+    componentDidLoad(): void;
+    componentDidUpdate(): void;
+    formResetCallback(): void;
+    formStateRestoreCallback(state: string): void;
 }

package/dist/types/components/xv-table/defs.d.ts

@@ -0,0 +1,16 @@
+export declare enum TABLE_COLOR_SCHEMA {
+    DEF = "",
+    ZEBRA = "zebra"
+}
+export declare enum TABLE_SIZE {
+    EXTRA_SMALL = "xs",
+    SMALL = "sm",
+    MEDIUM = "md",
+    LARGE = "lg",
+    EXTRA_LARGE = "xl"
+}
+export type TableSelectionEvent = CustomEvent<{
+    name: string;
+    checked: boolean;
+    value?: string;
+}>;

package/dist/types/components/xv-table/xv-table-col/xv-table-col.d.ts

@@ -0,0 +1,3 @@
+export declare class XvTableCol {
+    render(): any;
+}

package/dist/types/components/xv-table/xv-table-header-row/xv-table-header-row.d.ts

@@ -0,0 +1,25 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+export declare class XvTableHeaderRow {
+    el: HTMLElement;
+    /**
+     * Checkbox row name
+     */
+    selectionName?: string;
+    /**
+     * Checkbox row selected partially
+     */
+    partial?: boolean;
+    /**
+     * Checkbox row checked
+     */
+    checked?: boolean;
+    cols: number;
+    checkedChange: EventEmitter<{
+        name: string;
+        value?: string;
+        checked: boolean;
+    }>;
+    private slotChangeHandle;
+    private checkboxChange;
+    render(): any;
+}

package/dist/types/components/xv-table/xv-table-row/xv-table-row.d.ts

@@ -0,0 +1,59 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+export declare class XvTableRow {
+    el: HTMLElement;
+    /**
+     * Is row will be expandable
+     * If it's true then the next row will be collapsed
+     */
+    expandable: boolean;
+    /**
+     * Default state of expandable
+     */
+    expanded: boolean;
+    /**
+     * Checkbox row name
+     */
+    selectionName?: string;
+    /**
+     * Checkbox row value
+     */
+    value?: string;
+    /**
+     * Checkbox row status
+     */
+    checked?: boolean;
+    prevRowExpanded: boolean;
+    expandId?: string;
+    id?: string;
+    cols: number;
+    checkedChange: EventEmitter<{
+        name: string;
+        value?: string;
+        checked: boolean;
+    }>;
+    /**
+     * Called from outside (From expandable row)
+     */
+    setExpandRelation(id?: string, expanded?: boolean): Promise<boolean>;
+    /**
+     * Called from outside (From expandable row)
+     * to change then expand or collapse
+     */
+    toggleExpand(id?: string, expanded?: boolean): Promise<void>;
+    /**
+     * Watch for expandable
+     * When it's false needs to remove unnecessary properties
+     */
+    setExpandableRelationHandle(): Promise<any>;
+    /**
+     * When user press on the expand button
+     */
+    private changeExpandHandle;
+    /**
+     * Highlight the expanded row on hover
+     */
+    private hoverHandle;
+    private checkboxChange;
+    componentWillLoad(): Promise<void>;
+    render(): any;
+}

package/dist/types/components/xv-table/xv-table.d.ts

@@ -0,0 +1,40 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { TABLE_COLOR_SCHEMA, TABLE_SIZE } from './defs';
+export declare class XvTable {
+    el: HTMLElement;
+    /**
+     * Table caption description
+     */
+    description: string;
+    /**
+     * Set current color schema type of enum TABLE_COLOR_SCHEMA
+     * Possible options 'zebra'
+     */
+    colorSchema: TABLE_COLOR_SCHEMA;
+    /**
+     * If table is expandable fields
+     */
+    expandable: boolean;
+    /**
+     * Table size
+     * enum TABLE_SIZE
+     */
+    size: TABLE_SIZE;
+    /**
+     * Add checkbox selection to the table
+     */
+    selectable: boolean;
+    selectedRows: Map<string, {
+        name: string;
+        value?: string;
+    }>;
+    changeSelection: EventEmitter<{
+        name: string;
+        value?: any;
+    }[]>;
+    setRowPropsHandler(): void;
+    private handleCheckedChange;
+    render(): any;
+    componentWillLoad(): void;
+    disconnectedCallback(): void;
+}