dap-design-system 0.10.0 → 0.10.1

package/README.md

@@ -1 +1,59 @@
-# DAP Design System
+# Welcome to the DÁP design system component library
+
+This web component library is designed to be used with any frontend framework and is based on custom webcomponents with [litJS](https://lit.dev/).
+
+[Documentation](https://services.gov.hu/design-system-dev/)
+
+## Quick start
+
+To get started with the DÁP Design System, follow these steps:
+
+Install the library using your preferred package manager or load it directly from a CDN:
+
+Package manager [(npm)](https://www.npmjs.com/package/dap-design-system)
+
+```bash
+npm install dap-design-system
+
+yarn add dap-design-system
+
+pnpm add dap-design-system
+```
+
+CDN
+
+```html
+<script type="module" src="https://cdn.jsdelivr.net/npm/dap-design-system" />
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/dap-design-system/dist/light.theme.css" />
+```
+
+Start using the components in your application:
+
+   ```jsx
+   <dap-ds-button>My first button!</dap-ds-button>
+   ```
+
+That's it! You're now ready to start building beautiful web applications with the DÁP Design System Component Library.
+
+## Benefits of web components
+
+Web components are a set of web platform APIs that allow you to create new custom, reusable, encapsulated HTML tags to use in web pages and web apps. Custom components and widgets build on the Web Component standards, will work across modern browsers, and can be used with any JavaScript library or framework that works with HTML.
+
+[Custom elements](https://html.spec.whatwg.org/multipage/custom-elements.html) in HTML are a way to define your own elements along with their behavior. You can use custom elements to create reusable components that can be used in web pages and web apps.
+Read more about web components [here](https://developer.mozilla.org/en-US/docs/Web/Web_Components).
+
+Web components are supported by all modern browsers, including Chrome, Firefox, Safari, and Edge. For more information on browser support, see [Can I Use](https://caniuse.com/custom-elementsv1).
+
+## Architecture
+
+The DÁP Design System Component Library is built using the following technologies and libraries:
+
+- Components are built with [litJS](https://lit.dev/)
+- Component metadata is generated by the [Custom Elements Manifest Analyzer](https://github.com/open-wc/custom-elements-manifest)
+- Icons are from the [Remix icons](https://remixicon.com/) library
+- Positioning of dropdowns, tooltips is handled by [Floating UI](https://floating-ui.com/)
+- CDN hosting is provided by [jsDelivr](https://www.jsdelivr.com/)
+- Development and production tooling is provided by [Vite](https://vitejs.dev/)
+- [Storybook](https://storybook.js.org/) is used for component development and documentation
+- [Sass](https://sass-lang.com/) CSS preprocessor is used for styling
+- No styling framework is used, all styles are custom

package/dist/dds.d.ts

@@ -877,6 +877,7 @@ export declare class DapDSCalendar extends DdsElement {
     isDateInAllowedRange(date: Dayjs): boolean;
     isMonthInAllowedRange(year: number, month: number): boolean;
     isDateInAllowedRangeByDate(year: number, month: number, date: number): boolean;
+    getAllowedMonths(currentDate: Dayjs): string[];
     setMonth(month: number): void;
     setDay(day: number): void;
     setYear(year: number): void;
@@ -1921,6 +1922,7 @@ export declare class DapDSOptionList extends DapDSOptionList_base {
     options?: any[];
     queryTimeout: number | undefined;
     queryString: string;
+    firstLoad: boolean;
     private currentOption;
     selectedIndex: number;
     private optionEls;
@@ -2185,6 +2187,7 @@ export declare class DapDSRadioGroup extends GenericFormElement {
  * @attribute {string} description - The description of the search.
  * @attribute {string} tooltip - The tooltip of the search.
  * @attribute {'sm' | 'lg'} size - The size of the search. Default is 'md'.
+ * @attribute {'none' | 'typehead' | 'autocomplete' | 'manual'} searchMode - The search mode of the select.
  * @attribute {boolean} disabled - Whether the search is disabled.
  * @attribute {boolean} required - Whether the search is required.
  * @attribute {boolean} readonly - Whether the search is readonly.
@@ -2196,7 +2199,6 @@ export declare class DapDSRadioGroup extends GenericFormElement {
  * @attribute {boolean} allowManualInput - Whether the search allows manual input, or free text.
  * @attribute {boolean} searchForText - Whether the search should search for the selected item text.
  * @attribute {boolean} noTextComplete - Whether the search should not complete the text.
- * @attribute {'none' | 'typehead' | 'autocomplete' | 'manual'} searchMode - The search mode of the select.
  * @attribute {string} searchButtonAriaLabel - The aria label of the search button.
  * @attribute {boolean} openOnEmpty - Whether the search should open on empty results.
  *
@@ -2422,7 +2424,7 @@ export declare class DapDSSwitch extends LabelPositionedFormElement {
  * @attribute {boolean} disabled - The disabled state of the tab.
  *
  * @slot - The tab title template.
- * @slot content - The tab content. When KeepContent attribute is not set on dap-ds-tab-group component, then the content must be put inside the html template element with slot="content".
+ * @slot content - The tab content.
  *
  * @csspart base - The main tab content container.
  */
@@ -2431,11 +2433,7 @@ export declare class DapDSTab extends DdsElement {
     tabId: string;
     disabled: boolean;
     private _selected;
-    private _contentTemplate;
-    connectedCallback(): void;
-    handleContentSlotChange(_event: Event): void;
-    removeContent(): void;
-    appendContent(): void;
+    firstUpdated(): void;
     render(): TemplateResult_2<1>;
 }
 
@@ -2459,18 +2457,19 @@ export declare class DapDSTab extends DdsElement {
  * @csspart tab-content - The tab content container.
  */
 export declare class DapDSTabGroup extends DdsElement {
+    defaultSlot: HTMLSlotElement;
     static styles: CSSResult;
     selectedTabId: string;
     size: CommonSize;
-    keepContent: boolean;
     mobile: boolean;
     tabNavElements: HTMLElement[];
+    private _tabElements;
     private _tabNavItems;
     private _activeTabIds;
     private _initialEmit;
     emitTabSelect(tabId: string): void;
     attributeChangedCallback(name: string, oldValue: string | null, value: string | null): void;
-    handleSlotChange(event: Event): void;
+    protected firstUpdated(_changedProperties: PropertyValueMap<any> | Map<PropertyKey, unknown>): void;
     handleClick(tabId: string | null): void;
     handleKeyDown(event: KeyboardEvent): void;
     render(): TemplateResult_2<1>;