# dativa-lv/lx-ui architecture

> Architecture diagram of the GitHub repository dativa-lv/lx-ui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dativa-lv/lx-ui
- Repository: https://github.com/dativa-lv/lx-ui

## Overview

LX/UI is a Vue 3 component and vanilla-CSS library for building enterprise applications. Its main usage path is an application installing the LX plugin, then using registered components—often inside LxShell—to build forms and views with interactive controls, data displays, and file or date workflows. The package also provides authentication state/API helpers, shared utilities, icon sets, and accessibility directives. The graph reflects README-documented usage and relationships visible in the supplied source index and excerpts; unsampled implementation details and unshown runtime connections are omitted.

Main entry points: [`src/components/index.js`](https://github.com/dativa-lv/lx-ui/blob/main/src/components/index.js) (Component registry), [`src/lib.js`](https://github.com/dativa-lv/lx-ui/blob/main/src/lib.js) (LX plugin), [`src/components/Button.vue`](https://github.com/dativa-lv/lx-ui/blob/main/src/components/Button.vue) (Buttons), [`src/components/shell/Shell.vue`](https://github.com/dativa-lv/lx-ui/blob/main/src/components/shell/Shell.vue) (Application shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["App integration"]
  node_plugin["LX plugin<br/>[lib.js]"]
  node_registry["Component registry<br/>[index.js]"]
end

subgraph group_components["UI components"]
  node_shell["Application shell<br/>[Shell.vue]"]
  node_form["Forms<br/>[Form.vue]"]
  node_controls["Input controls<br/>[AutoComplete.vue]"]
  node_button["Buttons<br/>[Button.vue]"]
  node_data["Data views<br/>[DataGrid.vue]"]
  node_list["Lists<br/>[List.vue]"]
end

subgraph group_domain["App capabilities"]
  node_files["File workflows<br/>[FileUploader.vue]"]
  node_dates["Date selection<br/>[DateTimePicker.vue]"]
  node_chat["Chat<br/>[Chat.vue]"]
  node_auth["Authentication state<br/>[useAuthStore.js]"]
  node_authservice["Auth service<br/>[authService.js]"]
  node_apiauth["Auth API<br/>[apiAuth.js]"]
end

subgraph group_runtime["Shared runtime"]
  node_stores["Shared stores<br/>[index.js]"]
  node_utils["Utilities<br/>[index.js]"]
  node_strings["String utilities<br/>[stringUtils.js]"]
  node_general["General utilities<br/>[generalUtils.js]"]
  node_tooltip["Tooltip directive<br/>[tooltip.js]"]
  node_icons["Icon sets"]
end

node_app(("Host application"))

node_app -->|"installs"| node_plugin
node_app -->|"uses"| node_shell
node_plugin -->|"registers"| node_registry
node_plugin -->|"installs"| node_tooltip
node_plugin -->|"loads"| node_stores
node_plugin -->|"loads"| node_utils
node_plugin -->|"loads modes"| node_shell
node_registry -->|"exports"| node_shell
node_registry -->|"exports"| node_form
node_registry -->|"exports"| node_controls
node_registry -->|"exports"| node_button
node_registry -->|"exports"| node_data
node_registry -->|"exports"| node_list
node_registry -->|"exports"| node_files
node_registry -->|"exports"| node_dates
node_registry -->|"exports"| node_chat
node_button -->|"renders"| node_icons
node_button -->|"generates IDs"| node_strings
node_button -->|"formats text"| node_general
node_authservice -->|"calls"| node_apiauth
node_auth -->|"checks permissions"| node_utils

click node_plugin "https://github.com/dativa-lv/lx-ui/blob/main/src/lib.js"
click node_registry "https://github.com/dativa-lv/lx-ui/blob/main/src/components/index.js"
click node_shell "https://github.com/dativa-lv/lx-ui/blob/main/src/components/shell/Shell.vue"
click node_form "https://github.com/dativa-lv/lx-ui/blob/main/src/components/forms/Form.vue"
click node_controls "https://github.com/dativa-lv/lx-ui/blob/main/src/components/AutoComplete.vue"
click node_button "https://github.com/dativa-lv/lx-ui/blob/main/src/components/Button.vue"
click node_data "https://github.com/dativa-lv/lx-ui/blob/main/src/components/DataGrid.vue"
click node_list "https://github.com/dativa-lv/lx-ui/blob/main/src/components/list/List.vue"
click node_files "https://github.com/dativa-lv/lx-ui/blob/main/src/components/fileUploader/FileUploader.vue"
click node_dates "https://github.com/dativa-lv/lx-ui/blob/main/src/components/datePicker/DateTimePicker.vue"
click node_chat "https://github.com/dativa-lv/lx-ui/blob/main/src/components/chat/Chat.vue"
click node_auth "https://github.com/dativa-lv/lx-ui/blob/main/src/stores/useAuthStore.js"
click node_authservice "https://github.com/dativa-lv/lx-ui/blob/main/src/services/authService.js"
click node_apiauth "https://github.com/dativa-lv/lx-ui/blob/main/src/apiAuth.js"
click node_stores "https://github.com/dativa-lv/lx-ui/blob/main/src/stores/index.js"
click node_utils "https://github.com/dativa-lv/lx-ui/blob/main/src/utils/index.js"
click node_strings "https://github.com/dativa-lv/lx-ui/blob/main/src/utils/stringUtils.js"
click node_general "https://github.com/dativa-lv/lx-ui/blob/main/src/utils/generalUtils.js"
click node_tooltip "https://github.com/dativa-lv/lx-ui/blob/main/src/directives/tooltip.js"
click node_icons "https://github.com/dativa-lv/lx-ui/tree/main/src/components/icons"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_registry toneBlue
class node_shell,node_form,node_controls,node_button,node_data,node_list toneAmber
class node_files,node_dates,node_chat,node_auth,node_authservice,node_apiauth toneMint
class node_stores,node_utils,node_strings,node_general,node_tooltip,node_icons toneRose
class node_app toneIndigo
```

## Components

### App integration

- [LX plugin](https://github.com/dativa-lv/lx-ui/blob/main/src/lib.js): `src/lib.js`
- [Component registry](https://github.com/dativa-lv/lx-ui/blob/main/src/components/index.js): `src/components/index.js`

### UI components

- [Application shell](https://github.com/dativa-lv/lx-ui/blob/main/src/components/shell/Shell.vue): `src/components/shell/Shell.vue`
- [Forms](https://github.com/dativa-lv/lx-ui/blob/main/src/components/forms/Form.vue): `src/components/forms/Form.vue`
- [Input controls](https://github.com/dativa-lv/lx-ui/blob/main/src/components/AutoComplete.vue): `src/components/AutoComplete.vue`
- [Buttons](https://github.com/dativa-lv/lx-ui/blob/main/src/components/Button.vue): `src/components/Button.vue`
- [Data views](https://github.com/dativa-lv/lx-ui/blob/main/src/components/DataGrid.vue): `src/components/DataGrid.vue`
- [Lists](https://github.com/dativa-lv/lx-ui/blob/main/src/components/list/List.vue): `src/components/list/List.vue`

### App capabilities

- [File workflows](https://github.com/dativa-lv/lx-ui/blob/main/src/components/fileUploader/FileUploader.vue): `src/components/fileUploader/FileUploader.vue`
- [Date selection](https://github.com/dativa-lv/lx-ui/blob/main/src/components/datePicker/DateTimePicker.vue): `src/components/datePicker/DateTimePicker.vue`
- [Chat](https://github.com/dativa-lv/lx-ui/blob/main/src/components/chat/Chat.vue): `src/components/chat/Chat.vue`
- [Authentication state](https://github.com/dativa-lv/lx-ui/blob/main/src/stores/useAuthStore.js): `src/stores/useAuthStore.js`
- [Auth service](https://github.com/dativa-lv/lx-ui/blob/main/src/services/authService.js): `src/services/authService.js`
- [Auth API](https://github.com/dativa-lv/lx-ui/blob/main/src/apiAuth.js): `src/apiAuth.js`

### Shared runtime

- [Shared stores](https://github.com/dativa-lv/lx-ui/blob/main/src/stores/index.js): `src/stores/index.js`
- [Utilities](https://github.com/dativa-lv/lx-ui/blob/main/src/utils/index.js): `src/utils/index.js`
- [String utilities](https://github.com/dativa-lv/lx-ui/blob/main/src/utils/stringUtils.js): `src/utils/stringUtils.js`
- [General utilities](https://github.com/dativa-lv/lx-ui/blob/main/src/utils/generalUtils.js): `src/utils/generalUtils.js`
- [Tooltip directive](https://github.com/dativa-lv/lx-ui/blob/main/src/directives/tooltip.js): `src/directives/tooltip.js`
- [Icon sets](https://github.com/dativa-lv/lx-ui/tree/main/src/components/icons): `src/components/icons`

### Other components

- **Host application**

## Connections

- Host application → LX plugin: installs
- Host application → Application shell: uses
- LX plugin → Component registry: registers (evidence: `src/lib.js`)
- LX plugin → Tooltip directive: installs (evidence: `src/lib.js`)
- LX plugin → Shared stores: loads (evidence: `src/lib.js`)
- LX plugin → Utilities: loads (evidence: `src/lib.js`)
- LX plugin → Application shell: loads modes (evidence: `src/lib.js`)
- Component registry → Application shell: exports (evidence: `src/components/index.js`)
- Component registry → Forms: exports (evidence: `src/components/index.js`)
- Component registry → Input controls: exports (evidence: `src/components/index.js`)
- Component registry → Buttons: exports (evidence: `src/components/index.js`)
- Component registry → Data views: exports (evidence: `src/components/index.js`)
- Component registry → Lists: exports (evidence: `src/components/index.js`)
- Component registry → File workflows: exports (evidence: `src/components/index.js`)
- Component registry → Date selection: exports (evidence: `src/components/index.js`)
- Component registry → Chat: exports (evidence: `src/components/index.js`)
- Buttons → Icon sets: renders (evidence: `src/components/Button.vue`)
- Buttons → String utilities: generates IDs (evidence: `src/components/Button.vue`)
- Buttons → General utilities: formats text (evidence: `src/components/Button.vue`)
- Auth service → Auth API: calls (evidence: `src/services/authService.js`)
- Authentication state → Utilities: checks permissions (evidence: `src/stores/useAuthStore.js`)
