@vaadin/grid-pro 22.0.0-alpha7

package/LICENSE

@@ -0,0 +1,262 @@
+Commercial Vaadin Developer License version 4
+
+Terms and Conditions for Use, Reproduction and Distribution
+
+NOTICE TO USER: PLEASE READ THIS LICENSE AGREEMENT CAREFULLY.
+
+BY USING ALL OR ANY PART OF THE LICENSED SOFTWARE YOU ACCEPT ALL THE TERMS AND
+CONDITIONS OF THIS AGREEMENT, INCLUDING, IN PARTICULAR THE RESTRICTIONS ON: USE
+AND TRANSFERABILITY CONTAINED IN CLAUSE 2; WARRANTY IN CLAUSE 6; LIABILITY IN
+CLAUSE 7. YOU ACCEPT THAT THIS AGREEMENT IS ENFORCEABLE LIKE ANY WRITTEN
+NEGOTIATED AGREEMENT DULY SIGNED BY YOU. IF YOU DO NOT AGREE ON ALL THE TERMS
+AND CONDITIONS OF THIS AGREEMENT, STOP THE USE OF THE LICENSED SOFTWARE
+IMMEDIATELY.
+
+1. Definitions
+In this Agreement, unless the context requires otherwise, the following words
+and phrases shall have the following meanings:
+
+  * "Developer" shall mean a software developer, tester, designer or other
+    person developing a software application.
+  * "Vaadin Platform" shall mean the Vaadin web framework, components, themes,
+    tools and libraries that help Developers in building software applications.
+  * "Licensed Software" shall mean an add-on software component, extended
+    support version of Vaadin Platform, library, theme, tool or other software
+    or resource that is part of or adds functionality to Vaadin Platform or
+    helps Developers in developing applications. Licensed Software include, but
+    are not limited to, user interface components, integration components,
+    themes, libraries and development tools.
+  * "Use Licensed Software" shall mean either directly interacting with,
+    including without limitations using the user interface of, running or
+    installing, the Licensed Software during Project or editing Project source
+    code file that refers to or depends on Licensed Software either directly or
+    indirectly. Developer who edits source code that can not be compiled and/or
+    run without a copy of Licensed Software is considered to Use Licensed
+    Software. Interacting with a server that runs Licensed Software as a part
+    of an automated test suite or a design system is not considered as Use of
+    Licensed Software, but the maintainers of the mentioned test suite or
+    design system are considered to Use Licensed Software.
+  * "Agreement" shall mean this Commercial Vaadin Developer License version 4
+    agreement. Previous versions of the agreement were called Commercial Vaadin
+    Add-on License.
+  * "License" shall mean the right to Use Licensed Software according to
+    Agreement by one Developer.
+  * "Intellectual Property Rights" shall mean any and all patent, copyright,
+    trademark, design right, petty patent, service mark, domain name or any
+    other right or trade secret whether registered or not.
+  * "Licensee" shall mean the entity that has subscribed to a Subscription that
+     includes the right to Use Licensed Software.
+  * "Licensor" shall mean Vaadin Ltd. or a third party licensing Licensed
+     Software under the Agreement.
+  * "Parties/Party" shall mean Licensee and Licensor, or either of them.
+  * "Project" shall mean Licensee's software development project during which
+     the participating Developers Use Licensed Software and which aims to
+     produce Project Result.
+  * "Project Result" shall mean the outcome of the Project.
+  * “End User” shall mean a person using Project Result that does not involve
+     changing any source code.
+  * "Subscription" shall mean a subscription offered by Licensor in which
+    Licensor grants rights to Use Licensed Software according to the terms of
+    the subscription agreement and this Agreement.
+
+2. Grant of License
+2.1 Licensor grants to Licensee, against full payment of the Subscription fee, a
+worldwide, royalty-free, non-exclusive limited License to Use Licensed Software
+in Project(s) by a Developer.
+
+2.2 Licensee shall not, unless expressly provided in Agreement or in the
+applicable legislation
+
+2.2.1 rent, lease or loan Licensed Software or any copy of it;
+
+2.2.2 remove, obliterate, deface or in any way alter the notice of Licensor’s or
+a third party’s proprietary rights related to Licensed Software;
+
+2.2.3 grant sub-licenses to Licensed Software or assign its rights or
+obligations under this Agreement to a third party.
+
+2.3 Licensee may grant licenses, for free or against a payment, to the Project
+Result including Licensed Software whether regarded as derivative works or not.
+End Users are not required to have a valid License. If the Project Result is
+further developed or modified by changing its source code or the Project Results
+is used as a software component or framework in a software development project,
+all Developers who Use Licensed Software in such a context need to have a valid
+License. If the Project Result is a software development tool, component or
+environment that provides the functionality of the Licensed Software for use in
+software development projects, all Developers who Use Licensed Software need to
+have a valid License.
+
+3. Intellectual Property Rights
+3.1 All Intellectual Property Rights in and to Licensed Software are and shall
+at all times remain the sole and exclusive property of Licensor and its third
+party licensors, if any.
+
+3.2 Licensee will not at any time do or cause to be done any such act or thing
+which in any way impairs, or intends to impair, any right, title, interest or
+any Intellectual Property Right of Licensor or its third party licensors.
+Licensee shall not in any manner represent that it has any ownership of any kind
+in any of the above mentioned Intellectual Property Rights.
+
+4. Subscription fee and Subscription term
+4.1 In consideration for the Subscription based license granted herein, Licensor
+shall charge a recurring Subscription fee from the Licensee.
+
+4.2 Licensee must have a valid License for all Developers who Use Licensed
+Software in the Project. During the Subscription term, the License may be Used
+in many Projects simultaneously without additional payments. The Project Result
+may be copied an unlimited number of times and deployed to an unlimited number
+of computers without additional payments.
+
+4.3 Licensee's License will be valid starting from the beginning of the
+Subscription term and remain in force until the end of the Subscription term.
+The start date of the Subscription term and its possible renewal mechanism are
+set out in the Subscription agreement or the Licensor’s invoice to the Licensee.
+If no Subscription start date is specified in the Subscription agreement or the
+invoice, the start date shall be the date when the Licensor provides the
+Licensee access to the Licensed Software.
+
+4.4 If License is given without a fee, the License is valid for the time defined
+by the Licensor.
+
+5. Term and termination
+5.1 This Agreement is effective as of the effective date of the Subscription and
+expires on the day that the Subscription term for the Licensed Software has
+expired. Notwithstanding the aforesaid, in the event that the Licensee fails to
+comply with the terms set in this Agreement, the License granted herein shall
+not be valid and Licensee must at once cease the use of Licensed Software and
+any of its rights under Clause 2, and delete all copies of Licensed Software.
+
+5.2 Licensor has the right, in addition and without prejudice to any other
+rights or remedies, to terminate this Agreement immediately as follows:
+
+5.2.1 for any material breach of Agreement, that is not cured within seven (7)
+days of receipt by Licensee in default of a written notice specifying the breach
+and requiring its cure;
+
+5.2.2 upon receiving a written notice, if (a) all or a substantial portion of
+the assets of Licensee are transferred to an assignee for the benefit of
+creditors, or to a receiver or a trustee in bankruptcy, (b) a proceeding is
+commenced by or against Licensee for relief under bankruptcy or similar laws and
+such proceeding is not dismissed within sixty (60) days, or (c) Licensee is
+adjudged bankrupt.
+
+5.3 If and when this Agreement is terminated due to any reason or cause
+whatsoever, the Licensee shall cease to Use Licensed Software and any of its
+rights under Clause 2, and delete all copies of Licensed Software. For clarity,
+the termination of this Agreement shall not affect the validity of any licenses
+granted by the Licensee to End Users with respect to Project Results prior to
+the termination of this Agreement, but the Licensee shall not be entitled to
+Use Licensed Software after the termination of the Agreement.
+
+5.4 Provisions of the Agreement which, by their nature, are intended to survive
+its termination or expiration, shall survive its termination or expiration.
+
+6. Warranties
+THE LICENSED SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND EXPRESS
+OR IMPLIED, AND TO THE MAXIMUM EXTENT PERMITTED BY THE APPLICABLE LAW. EXCEPT AS
+EXPRESSLY PROVIDED IN THIS CLAUSE, NO WARRANTY, CONDITION, UNDERTAKING,
+LIABILITY OR TERM, EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, AS TO CONDITION,
+QUALITY, PERFORMANCE, FUNCTIONALITY, INFRINGEMENT, MERCHANTABILITY, DURABILITY
+OR FITNESS FOR PURPOSE, IS GIVEN OR ASSUMED BY VAADIN LTD., LICENSOR OR ITS
+LICENSORS AND ALL SUCH WARRANTIES, CONDITIONS, UNDERTAKINGS AND TERMS ARE HEREBY
+EXCLUDED.
+
+7. Limitation of Liability
+VAADIN LTD. AND/OR LICENSOR WILL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+PUNITIVE OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND WHATSOEVER
+AND HOWSOEVER CAUSED (INCLUDING BUSINESS INTERRUPTION, OR ANY LOSS OF BUSINESS,
+ANTICIPATED SAVINGS, REVENUE, GOODWILL, MANAGEMENT TIME, LOSS OF PROFITS OR OF
+CONTRACTS, LOSS OF OPERATION TIME, LOSS OF REPUTATION OR OF DATA) INCLUDING
+NEGLIGENCE, WHETHER IN CONTRACT OR TORT, EVEN IF THEY HAVE BEEN ADVISED OF THE
+POSSIBILITY. DEVELOPER AND/OR LICENSEE WILL USE REASONABLE EFFORTS TO MITIGATE
+THEIR LOSS SUFFERED. VAADIN LTD'S AND/OR LICENSOR'S AGGREGATE LIABILITY AND THAT
+OF ITS AFFILIATES AND SUPPLIERS UNDER OR IN CONNECTION WITH THIS LICENSE
+AGREEMENT WILL BE LIMITED TO THE AMOUNT ACTUALLY PAID FOR THE LICENSED SOFTWARE
+DURING THE MOST RECENT SUBSCRIPTION PERIOD.
+
+8. Updates, new versions maintenance and support
+Licensor may, at its sole discretion, during the Subscription term provide
+maintenance releases, updates and upgrades as new versions of the Licensed
+Software.
+
+Licensee is not entitled to receive support for the Licensed Software, but
+Licensor may, at its sole discretion during the Subscription term, provide
+support either for free or for a fee.
+
+9. Miscellaneous
+9.1 No Waiver
+
+The failure of Licensor to exercise any of its rights under this Agreement or to
+require the performance of any term or provision of this Agreement, or any
+waiver by the Licensor of any term or provision or breach of this Agreement,
+shall not prevent a subsequent exercise or enforcement of such right or be
+deemed a waiver of any subsequent breach of the same or any other term or
+provision of this Agreement. Any waiver of the performance of any of the terms
+or conditions of this Agreement shall be effective only if in writing and signed
+by the Party against which such waiver is to be enforced.
+
+9.2 Headings
+
+The headings in this Agreement are for the convenience of the Parties only and
+are not intended to define or limit the scope or interpretation of the Agreement
+or any provision hereof.
+
+9.3 Severability
+
+If any term of this Agreement is invalid or unenforceable, such terms or
+provisions shall not invalidate the rest of the Agreement which shall remain in
+full force and effect as if such invalidated or unenforceable terms or
+conditions had not been made a part of this Agreement. In the event this Clause
+(Severability) becomes operative, Parties agree to attempt to negotiate
+settlement that carries out the economic intent of the terms or provisions found
+invalid or unenforceable.
+
+9.4 Export Control
+
+The Licensed Software may be subject to import and export controls in other
+countries. Licensee agrees to strictly comply with all applicable import and
+export regulations and acknowledge that Licensee has the responsibility to
+obtain licenses to export, re-export, transfer or import Licensed Software.
+
+9.5 Entire Agreement and Assignment
+
+Agreement sets forth the entire agreement between the Parties with respect to
+the subject matter hereof and supersedes any prior proposals and
+representations, whether written or oral. Neither Party shall have the right to
+assign this Agreement to a third party without the prior written consent of the
+other party. However, Licensor shall have the right to assign this Agreement and
+the rights and obligations contained therein to a company belonging to the same
+group of companies as Licensor, and to a third party to which the business of
+Licensor is transferred.
+
+9.6 Governing Law and Jurisdiction
+
+9.6.1 For customers domiciled in the United States
+
+If the Customer’s domicile is in the United States, the Agreement shall be
+governed by and construed in accordance with the substantive laws of the State
+of California. The Agreement shall be construed and enforced without regard to
+the United Nations Convention on the International Sale of Goods (CISG). Any
+dispute or controversy or claim arising out of or relating to this Agreement, or
+the breach, termination or validity thereof, shall be resolved by final and
+binding arbitration in accordance with the International Chamber of Commerce
+Rules of Arbitration, by one (1) arbitrator appointed according to the
+aforementioned rules. The arbitration shall be conducted in the English
+language in San Francisco, California, United States.
+
+9.6.2 For customers domiciled outside the United States
+
+If the Customer’s domicile is outside the United States, the Agreement shall be
+governed by and construed in accordance with the substantive laws of Finland,
+excluding its choice of law provisions and the United Nations Convention on
+Contracts for the International Sale of Goods (CISG). Any dispute, controversy
+or claim arising out of or relating to the Agreement, or the breach, termination
+or validity thereof, shall be finally settled by arbitration in accordance with
+the Arbitration Rules of the Finland Chamber of Commerce. The number of
+arbitrators shall be one. The seat of arbitration shall be Turku, Finland. The
+language of the arbitration shall be English.
+
+9.7 Language
+
+The official text of the Agreement or any notices given or accounts or
+statements required hereby shall be in English.

package/README.md

@@ -0,0 +1,72 @@
+# <vaadin-grid-pro>
+
+[Live Demo ↗](https://vaadin.com/components/vaadin-grid-pro/html-examples)
+|
+[API documentation ↗](https://vaadin.com/components/vaadin-grid-pro/html-api)
+
+[<vaadin-grid-pro>](https://vaadin.com/components/vaadin-grid-pro) is a high quality data grid / data table Web Component with extended functionality, part of the [Vaadin components](https://vaadin.com/components).
+
+[![npm version](https://badgen.net/npm/v/@vaadin/grid-pro)](https://www.npmjs.com/package/@vaadin/grid-pro)
+[![Published on Vaadin Directory](https://img.shields.io/badge/Vaadin%20Directory-published-00b4f0.svg)](https://vaadin.com/directory/component/vaadinvaadin-grid-pro)
+[![Discord](https://img.shields.io/discord/732335336448852018?label=discord)](https://discord.gg/PHmkCKC)
+
+```html
+<vaadin-grid-pro>
+  <vaadin-grid-pro-edit-column path="firstName" header="First Name"></vaadin-grid-pro-edit-column>
+  <vaadin-grid-pro-edit-column path="lastName" header="Last Name"></vaadin-grid-pro-edit-column>
+  <vaadin-grid-pro-edit-column path="email" header="Email"></vaadin-grid-pro-edit-column>
+</vaadin-grid-pro>
+<script>
+  // Populate the grid with data
+  const grid = document.querySelector('vaadin-grid-pro');
+  fetch('https://demo.vaadin.com/demo-data/1.0/people?count=200')
+    .then((res) => res.json())
+    .then((json) => (grid.items = json.result));
+</script>
+```
+
+[<img src="https://raw.githubusercontent.com/vaadin/vaadin-grid-pro/master/screenshot.png" width="900" alt="Screenshot of vaadin-grid-pro">](https://vaadin.com/components/vaadin-grid-pro)
+
+## Installation
+
+Install `vaadin-grid-pro`:
+
+```sh
+npm i @vaadin/vaadin-pro --save
+```
+
+Once installed, import it in your application:
+
+```js
+import '@vaadin/grid-pro/vaadin-grid-pro.js';
+```
+
+## Getting started
+
+Vaadin components use the Lumo theme by default.
+
+To use the Material theme, import the correspondent file from the `theme/material` folder.
+
+## Entry points
+
+- The component with the Lumo theme:
+
+  `theme/lumo/vaadin-grid-pro.js`
+
+- The component with the Material theme:
+
+  `theme/material/vaadin-grid-pro.js`
+
+- Alias for `theme/lumo/vaadin-grid-pro.js`:
+
+  `vaadin-grid-pro.js`
+
+## Contributing
+
+Read the [contributing guide](https://vaadin.com/docs/latest/guide/contributing/overview) to learn about our development process, how to propose bugfixes and improvements, and how to test your changes to Vaadin components.
+
+## License
+
+Commercial Vaadin Developer License 4.0 (CVDLv4). For license terms, see LICENSE.
+
+Vaadin collects development time usage statistics to improve this product. For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@vaadin/grid-pro",
+  "version": "22.0.0-alpha7",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "vaadin-grid-pro",
+  "license": "https://raw.githubusercontent.com/vaadin/web-components/master/packages/grid-pro/LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vaadin/web-components.git",
+    "directory": "packages/grid-pro"
+  },
+  "author": "Vaadin Ltd",
+  "homepage": "https://vaadin.com/components",
+  "bugs": {
+    "url": "https://github.com/vaadin/web-components/issues"
+  },
+  "main": "vaadin-grid-pro.js",
+  "module": "vaadin-grid-pro.js",
+  "files": [
+    "src",
+    "theme",
+    "vaadin-*.d.ts",
+    "vaadin-*.js"
+  ],
+  "keywords": [
+    "Vaadin",
+    "vaadin-grid-pro",
+    "web-components",
+    "web-component",
+    "polymer"
+  ],
+  "dependencies": {
+    "@polymer/polymer": "^3.0.0",
+    "@vaadin/checkbox": "22.0.0-alpha7",
+    "@vaadin/component-base": "22.0.0-alpha7",
+    "@vaadin/grid": "22.0.0-alpha7",
+    "@vaadin/item": "22.0.0-alpha7",
+    "@vaadin/list-box": "22.0.0-alpha7",
+    "@vaadin/select": "22.0.0-alpha7",
+    "@vaadin/text-field": "22.0.0-alpha7",
+    "@vaadin/vaadin-license-checker": "^2.1.0",
+    "@vaadin/vaadin-lumo-styles": "22.0.0-alpha7",
+    "@vaadin/vaadin-material-styles": "22.0.0-alpha7",
+    "@vaadin/vaadin-themable-mixin": "22.0.0-alpha7"
+  },
+  "devDependencies": {
+    "@esm-bundle/chai": "^4.3.4",
+    "@vaadin/date-picker": "22.0.0-alpha7",
+    "@vaadin/dialog": "22.0.0-alpha7",
+    "@vaadin/polymer-legacy-adapter": "22.0.0-alpha7",
+    "@vaadin/testing-helpers": "^0.3.0",
+    "lit": "^2.0.0",
+    "sinon": "^9.2.1"
+  },
+  "gitHead": "8e89419c6b44a1d225d5859e180d7b35e47ddb52"
+}

package/src/interfaces.d.ts

@@ -0,0 +1 @@
+export type GridProEditorType = 'text' | 'checkbox' | 'select' | 'custom';

package/src/vaadin-grid-pro-edit-checkbox.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright (c) 2019 - 2021 Vaadin Ltd.
+ * This program is available under Commercial Vaadin Developer License 4.0 (CVDLv4).
+ * See <a href="https://vaadin.com/license/cvdl-4.0">the website</a> for the complete license.
+ */
+import { Checkbox } from '@vaadin/checkbox/src/vaadin-checkbox.js';
+
+/**
+ * An element used internally by `<vaadin-grid-pro>`. Not intended to be used separately.
+ *
+ * @extends Checkbox
+ * @private
+ */
+class GridProEditCheckbox extends Checkbox {
+  static get is() {
+    return 'vaadin-grid-pro-edit-checkbox';
+  }
+}
+
+customElements.define(GridProEditCheckbox.is, GridProEditCheckbox);

package/src/vaadin-grid-pro-edit-column.d.ts

@@ -0,0 +1,85 @@
+import { GridColumn } from '@vaadin/grid/src/vaadin-grid-column.js';
+
+import { GridDefaultItem, GridBodyRenderer, GridItemModel } from '@vaadin/grid';
+
+import { GridProEditorType } from './interfaces';
+
+/**
+ * `<vaadin-grid-pro-edit-column>` is a helper element for the `<vaadin-grid-pro>`
+ * that provides default inline editing for the items.
+ *
+ * __Note that the `path` property must be explicitly specified for edit column.__
+ *
+ * #### Example:
+ * ```html
+ * <vaadin-grid-pro items="[[items]]">
+ *  <vaadin-grid-pro-edit-column path="name.first"></vaadin-grid-pro-edit-column>
+ *
+ *  <vaadin-grid-column>
+ *    ...
+ * ```
+ */
+declare class GridProEditColumn<TItem = GridDefaultItem> extends GridColumn<TItem> {
+  /**
+   * JS Path of the property in the item used for the editable content.
+   */
+  path: string | null | undefined;
+
+  /**
+   * Custom function for rendering the cell content in edit mode.
+   * Receives three arguments:
+   *
+   * - `root` The cell content DOM element. Append your editor component to it.
+   * - `column` The `<vaadin-grid-pro-edit-column>` element.
+   * - `model` The object with the properties related with
+   *   the rendered item, contains:
+   *   - `model.index` The index of the item.
+   *   - `model.item` The item.
+   *   - `model.expanded` Sublevel toggle state.
+   *   - `model.level` Level of the tree represented with a horizontal offset of the toggle button.
+   *   - `model.selected` Selected state.
+   *   - `model.detailsOpened` Details opened state.
+   */
+  editModeRenderer: GridBodyRenderer<TItem> | null | undefined;
+
+  /**
+   * The list of options which should be passed to cell editor component.
+   * Used with the `select` editor type, to provide a list of items.
+   */
+  editorOptions: string[];
+
+  /**
+   * Type of the cell editor component to be rendered. Allowed values:
+   * - `text` (default) - renders a text field
+   * - `checkbox` - renders a checkbox
+   * - `select` - renders a select with a list of items passed as `editorOptions`
+   *
+   * Editor type is set to `custom` when `editModeRenderer` is set.
+   * @attr {text|checkbox|select|custom} editor-type
+   */
+  editorType: GridProEditorType;
+
+  /**
+   * Path of the property used for the value of the editor component.
+   * @attr {string} editor-value-path
+   */
+  editorValuePath: string;
+
+  _getEditorTagName(cell: HTMLElement): string;
+
+  _getEditorComponent(cell: HTMLElement): HTMLElement | null;
+
+  _getEditorValue(editor: HTMLElement): unknown | null;
+
+  _startCellEdit(cell: HTMLElement, model: GridItemModel<TItem>): void;
+
+  _stopCellEdit(cell: HTMLElement, model: GridItemModel<TItem>): void;
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'vaadin-grid-pro-edit-column': GridProEditColumn<GridDefaultItem>;
+  }
+}
+
+export { GridProEditColumn };