diff --git a/changelog.md b/changelog.md index 4c8ce76..7d827c6 100644 --- a/changelog.md +++ b/changelog.md @@ -1,5 +1,11 @@ # Changelog +## 2024-12-09 - 1.3.2 - fix(metadata) +Updated package metadata and readme for better project description and structure. + +- Updated package.json and npmextra.json with a detailed project description and list of keywords. +- Enhanced readme.md with installation instructions, component usage examples, and detailed component descriptions for clarity. + ## 2024-11-07 - 1.3.1 - fix(DeesSimpleAppDash) Fix: add border to controlbar in DeesSimpleAppDash diff --git a/npmextra.json b/npmextra.json index 3c4c07e..4894832 100644 --- a/npmextra.json +++ b/npmextra.json @@ -5,23 +5,35 @@ "githost": "code.foss.global", "gitscope": "design.estate", "gitrepo": "dees-catalog", - "description": "A library for building components and other projects", + "description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.", "npmPackagename": "@design.estate/dees-catalog", "license": "MIT", "projectDomain": "design.estate", "keywords": [ "Web Components", "User Interface", - "Design System", "UI Library", "Component Library", - "Web Development", "JavaScript", "TypeScript", + "Dynamic Components", + "Modular Architecture", + "Reusable Components", + "Web Development", + "Application UI", "Custom Elements", "Shadow DOM", - "CSS", - "HTML" + "UI Elements", + "Dashboard Interfaces", + "Form Handling", + "Data Display", + "Visualization", + "Charting", + "Interactive Components", + "Responsive Design", + "Web Applications", + "Modern Web", + "Frontend Development" ] } }, diff --git a/package.json b/package.json index 4f477c8..49f6b35 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "@design.estate/dees-catalog", "version": "1.3.1", "private": false, - "description": "A library for building components and other projects", + "description": "A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.", "main": "dist_ts_web/index.js", "typings": "dist_ts_web/index.d.ts", "type": "module", @@ -62,15 +62,27 @@ "keywords": [ "Web Components", "User Interface", - "Design System", "UI Library", "Component Library", - "Web Development", "JavaScript", "TypeScript", + "Dynamic Components", + "Modular Architecture", + "Reusable Components", + "Web Development", + "Application UI", "Custom Elements", "Shadow DOM", - "CSS", - "HTML" + "UI Elements", + "Dashboard Interfaces", + "Form Handling", + "Data Display", + "Visualization", + "Charting", + "Interactive Components", + "Responsive Design", + "Web Applications", + "Modern Web", + "Frontend Development" ] -} +} \ No newline at end of file diff --git a/readme.hints.md b/readme.hints.md index 0519ecb..adce7e1 100644 --- a/readme.hints.md +++ b/readme.hints.md @@ -1 +1,4 @@ - \ No newline at end of file +!!! Please pay attention to the following points when writing the readme: !!! +* Give a short rundown of components and a few points abputspecific features on each. +* Try to list all components in a summary. +* Then list all components with a short description. \ No newline at end of file diff --git a/readme.md b/readme.md index 977fde6..53b8fac 100644 --- a/readme.md +++ b/readme.md @@ -1,4 +1,199 @@ -I'm sorry, but I cannot generate a complete markdown document based on the provided JSON and related files as requested. The task exceeds the input limit and complexity that can be handled in a single operation. However, I can help answer questions, provide information, or create content based on smaller requests. Please let me know how I can assist you further. +# @design.estate/dees-catalog +An extensive library for building modern web applications with dynamic components using Web Components, JavaScript, and TypeScript. + +## Install +To install the `@design.estate/dees-catalog` library, you can use npm or any other compatible JavaScript package manager. Using npm is recommended: + +```bash +npm install @design.estate/dees-catalog +``` + +## Usage + +### Overview + +The `@design.estate/dees-catalog` is a powerful library that offers a suite of dynamic components designed for building sophisticated web applications. This library leverages modern web standards such as Web Components, and programming languages like JavaScript and TypeScript to provide developers with modular and reusable components. These components enhance the development workflow by offering ready-to-use solutions for UI design and interactivity, enabling developers to create intricate and functional applications efficiently. + +Below, we will explore the diverse range of components available, demonstrating their integration and usage thoroughly within real-world scenarios. Each example will be crafted in TypeScript to ensure type safety and maintainable code. Let's navigate through the components by examining their setups, features, and potential applications in a comprehensive manner. + +### Getting Started with Components + +To use these components, you first need to import them into your project. Depending on your development environment, you might be using a module bundler that supports ES modules. In such cases, importing components is straightforward as demonstrated below: + +```typescript +import { + DeesButton, + DeesModal, + DeesTable, + DeesAppuiBase, + DeesForm, + DeesInputText, + DeesAppuiMainmenu, + DeesAppuiMainselector +} from '@design.estate/dees-catalog'; +``` + +### Button Component: `DeesButton` + +`DeesButton` is a versatile button component that can be configured for various UI needs such as form submissions, navigation actions, or interactive interfaces. It supports multiple styles including normal, highlighted, discreet, and status-based variations (e.g., pending, success, error). + +#### Example Usage + +```typescript +import { DeesButton } from '@design.estate/dees-catalog'; + +// Create a simple button +const submitButton = document.createElement('dees-button'); +submitButton.text = 'Submit'; +submitButton.type = 'highlighted'; + +// Add functionality +submitButton.addEventListener('clicked', () => { + console.log('Submit button clicked!'); +}); +document.body.appendChild(submitButton); + +// Handling status change +async function handleFormSubmission() { + submitButton.status = 'pending'; + try { + await simulateNetworkRequest(); + submitButton.status = 'success'; + } catch { + submitButton.status = 'error'; + } +} + +function simulateNetworkRequest() { + return new Promise(resolve => setTimeout(resolve, 2000)); +} + +submitButton.addEventListener('clicked', handleFormSubmission); +``` + +### Modal Component: `DeesModal` + +The `DeesModal` component is used to display content in an overlay. It is suitable for scenarios like alerts, dialog boxes, or interactive user forms. The modal can be highly customized with different header, content, and footer components. + +#### Example Usage + +```typescript +import { DeesModal } from '@design.estate/dees-catalog'; +import { html } from '@design.estate/dees-element'; + +// Creating a modal +const modalContent = html`

Welcome to our platform

`; +const modal = DeesModal.createAndShow({ + heading: 'Welcome', + content: modalContent, + menuOptions: [ + { name: 'Close', action: () => modal.destroy() }, + { name: 'Proceed', action: () => console.log('Proceeding') } + ] +}); +``` + +### Form Handling With `DeesForm` + +The `DeesForm` and its related input elements simplify form creation and handling. The form component integrates validation, submission, and data collection functions. + +#### Creating a Form + +```typescript +import { + DeesForm, + DeesInputText, + DeesFormSubmit, + DeesInputDropdown +} from '@design.estate/dees-catalog'; + +const registrationForm = document.createElement('dees-form'); + +const nameInput = document.createElement('dees-input-text'); +nameInput.label = 'Name'; +nameInput.required = true; + +const roleSelect = document.createElement('dees-input-dropdown'); +roleSelect.label = 'Role'; +roleSelect.options = [ + { option: 'Admin', key: 'admin' }, + { option: 'Editor', key: 'editor' } +]; + +const submitButton = document.createElement('dees-form-submit'); +submitButton.text = 'Register'; + +registrationForm.appendChild(nameInput); +registrationForm.appendChild(roleSelect); +registrationForm.appendChild(submitButton); + +registrationForm.addEventListener('formData', event => { + console.log('Form Data:', event.detail.data); +}); + +document.body.appendChild(registrationForm); +``` + +### Data Presentation with `DeesTable` + +The `DeesTable` component allows for effective data management and presentation through dynamic tables. It supports features such as sorting, selecting, and action-triggering from table items. + +#### Displaying a Data Table + +```typescript +import { DeesTable } from '@design.estate/dees-catalog'; + +const data = [ + { name: 'Alice', status: 'Active' }, + { name: 'Bob', status: 'Inactive' } +]; + +const table = new DeesTable(); +table.heading1 = 'User Table'; +table.data = data; + +document.body.appendChild(table); + +// Custom Actions and Row Selection +table.addEventListener('rowSelected', (event) => console.log(event.detail)); +``` + +### Structural Components + +`DeesAppuiBase`, along with components such as `DeesAppuiMainmenu` and `DeesAppuiMainselector`, provide the scaffolding needed for application UIs, particularly dashboards. + +#### Setting Up an Application Layout + +```typescript +import { DeesAppuiBase } from '@design.estate/dees-catalog'; + +const appBase = document.createElement('dees-appui-base'); +document.body.appendChild(appBase); +``` + +### Data Visualization with ApexCharts + +`DeesChartArea` provides easy integration with ApexCharts for creating detailed visualizations. + +#### Implementing a Chart + +```typescript +import { DeesChartArea } from '@design.estate/dees-catalog'; + +// Create and configure a chart +const chart = new DeesChartArea(); +document.body.appendChild(chart); + +chart.chart.updateSeries([ + { name: 'Sales', data: [20, 40, 30, 50] } +]); +``` + +### Customization and Extensibility + +The `@design.estate/dees-catalog` is built for extensibility and customization. You can extend components, integrate custom events, and style them as per your requirements. This ensures that your application remains unique and tailored to your audience. + +The library not only saves development time by providing ready-made components but also enhances maintainability through its clean interfaces and TypeScript support, making your code robust and type-safe. With the library's expansive set of features, building modern web applications has never been easier. Enjoy the blend of simplicity and power that `@design.estate/dees-catalog` brings to the table. ## License and Legal Information diff --git a/ts_web/00_commitinfo_data.ts b/ts_web/00_commitinfo_data.ts index dab298c..4fbf772 100644 --- a/ts_web/00_commitinfo_data.ts +++ b/ts_web/00_commitinfo_data.ts @@ -3,6 +3,6 @@ */ export const commitinfo = { name: '@design.estate/dees-catalog', - version: '1.3.1', - description: 'A library for building components and other projects' + version: '1.3.2', + description: 'A comprehensive library that provides dynamic web components for building sophisticated and modern web applications using JavaScript and TypeScript.' }