@astrake/lumora-ui 0.2.2 → 0.7.3

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # Changelog
 
+## Unreleased
+
+---
+
+## [0.7.3] — 2026-05-23
+
+### Added
+
+- update shared skins for select, forms, timeline, calendar, and planner (`10cf2ba`)
+- extend LuCalendar with mini size and showEventLabels prop (`41462de`)
+- add LuPlanner weekly scheduling component (`759cc1f`)
+- redesign LuTimeline with compact, numbered, and status variants (`ed6ff6c`)
+- enhance LuDataGrid with sorting, select-all, and local search/filter (`8374caf`)
+- overhaul LuCheckbox, LuRadio, LuSwitch with improved skins and tri-state switch (`2248907`)
+- redesign LuSelect with search, groups, and chip multi-select (`b6c8d4f`)
+- add LuToast, LuChip, LuAccordion (`f85b57e`)
+- add LuDrawer, LuList, LuPopover, LuBottomSheet; integrate floating-ui (`04fd13b`)
+- complete v0.3.0 to v0.5.0 roadmap (`14ec1c8`)
+
+### Fixed
+
+- restore LuThemeSwitch recipe (`35f5988`)
+- repair LuFormWizard step navigation and layout (`c8a5ba9`)
+- resolve remaining headless violations and strengthen tests (`d4f8e25`)
+
+### Changed
+
+- restructure navigation into functional categories (`c2575d6`)
+- remove domain-specific components from core exports (`1310993`)
+
+### Documentation
+
+- add LuCodeBlock documentation page (`02a6f77`)
+- integrate missing v0.5.0 components and fix charts renderer error (`ffbf80d`)
+
+### Maintenance
+
+- bump version to 0.7.2 (`b4ea3c4`)
+- bump version to 0.7.1 (`754ee2b`)
+- bump version to 0.7.0 (`0fe5c37`)
+- bump version to 0.6.0 (`2e62243`)
+- bump version to 0.5.0 (`18b82f6`)
+
+
+---
+
+## [0.7.2] — 2026-05-23
+
+### Fixed
+- Fixed CI release workflow git authentication: added `token: ${{ secrets.GITHUB_TOKEN }}` to checkout step and explicit remote URL configuration before tag push to resolve "No such device or address" error.
+
+---
+
+## [0.7.1] — 2026-05-23
+
+### Fixed
+- Fixed GitHub Actions release workflow `npm publish` double-packing issue.
+
+---
+
+## [0.7.0] — 2026-05-23
+
+### Added
+- `LuPlanner` — Weekly scheduling grid with absolute-positioned time slots, event blocks, and `slot-click` / `event-click` emissions
+- `LuSelect` — Rebuilt with text search/filter, option groups, chip-based multi-select, clearable state, and async-ready slot API
+- `LuDataGrid` — Column sorting (asc/desc/none cycle), header select-all checkbox, local text search bar, per-column filter support
+- `LuTimeline` — `compact` and `numbered` layout variants; `status` prop for per-item color coding (success/warning/error/info)
+- `LuSwitch` — Indeterminate / tri-state variant via `indeterminate` prop
+- `LuCalendar` — `size="mini"` compact variant and `showEventLabels` boolean prop
+- Showcase: `LuCodeBlock` dedicated documentation page
+- New skin keys: `timeline.*`, `calendar.*`, `planner.*`, `select.*` (chip, group, search, clearable styles)
+- Test coverage: 5 new test files — `LuCheckbox`, `LuRadio`, `LuSwitch`, `LuSelect`, `LuPlanner`
+
+### Fixed
+- `LuFormWizard` — Step navigation regressions and layout rendering corrected
+- `LuCheckbox` / `LuRadio` / `LuSwitch` — Complete default-skin visual overhaul: accessible focus rings, checked/disabled states, label alignment
+
+---
+
+## [0.6.0] — 2026-05-23
+
+### ⚠ Breaking Changes
+- Removed from core exports: `LuEntityCard`, `LuEntityCardStat`, `LuPageHeader`, `LuNotificationCenter`, `LuDashboardGrid`, `LuThemeSwitch`, `LuThemeSelect`, `LuEmbeddedPOS*` (5 components). Moved to showcase recipes.
+
+### Added
+- `LuDrawer` — Overlay/push drawer panel (left/right/top/bottom)
+- `LuList`, `LuListItem`, `LuListDivider`, `LuListSubheader` — Structured list primitives
+- `LuPopover` — Rich content anchored to trigger (floating-ui)
+- `LuBottomSheet` — Mobile-friendly bottom panel with drag support
+- `LuToast` + `useLuToast()` — Non-blocking notification system
+- `LuChip`, `LuChipGroup` — Interactive selection chips
+- `LuAccordion` — Grouped collapsibles with exclusive-open mode
+- `useFloating()` — Shared floating-ui composable
+- Showcase: 11 functional navigation categories + Recipes section
+
+### Changed
+- `LuTooltip` — Now uses floating-ui for precise positioning with auto-flip
+- `LuMenu` — Now uses floating-ui, replaces hardcoded CSS alignment
+- `LuDesktopRailBar` promoted as the recommended rail/mini-drawer pattern
+
+---
+
+## [0.5.0] — 2026-05-22
+
+### Added
+
+- **`LuEntityCard` + `LuEntityCardStat`** — Rich entity summary cards with avatar, meta, stats grid, and actions slots.
+- Complete v0.3.0 to v0.5.0 roadmap implementation.
+
+---
+
 ## [0.2.2] — 2026-05-14
 
 ### Fixed
@@ -40,20 +151,11 @@
 
 ---
 
-
 ## [0.2.1] — 2026-05-12
+
 - Package publishing now ships compiled `dist` outputs (`.js` + `.d.ts`) and exports no longer point to raw `src/*.ts` entrypoints, preventing downstream strict TypeScript checks from surfacing Lumora internals.
 - Cleaned internal type noise in core source (`unused imports/params`, `type`-only `VNode` import) so workspace `vue-tsc` checks remain clean.
 
----
-
-## [0.2.0] — 2026-04-27
-
-### Maintenance
-
-- bump version to 0.2.0 (`d52e5c1`)
-
-
 ---
 
 ## [0.2.0] — 2026-04-27
@@ -71,7 +173,7 @@
 - Various visual hierarchy issues in documentation via typography `LuText` adjustments.
 
 ### Changed
-- **Zero-Raw-HTML Adherence**: Removed all raw DOM nodes (`div`, `span`, etc.) and `PreviewBlock` from the showcase application in favor of 100% native `Lu*` primitives. 
+- **Zero-Raw-HTML Adherence**: Removed all raw DOM nodes (`div`, `span`, etc.) and `PreviewBlock` from the showcase application in favor of 100% native `Lu*` primitives.
 - Integrated Shiki to `@astrake/lumora-ui` core package dependencies.
 
 ---
@@ -93,14 +195,6 @@
 
 ---
 
-## [0.1.6] — 2026-04-25
-
-### Maintenance
-
-- bump version to 0.1.6 - add LuForm validation orchestrator (`1f11734`)
-
----
-
 ## [0.1.6] — 2026-04-26
 
 ### Added
@@ -126,7 +220,6 @@
 
 - prepack hook to include README and CHANGELOG in npm tarball (`e69bdfb`)
 
-
 ---
 
 ## [0.1.3] — 2026-04-25
@@ -140,7 +233,6 @@ All notable changes to `@astrake/lumora-ui` are documented here.
 
 Format: [Keep a Changelog](https://keepachangelog.com/) · Commits: [Conventional Commits](https://www.conventionalcommits.org/)
 
-
 ---
 
 ## [0.1.0] — 2026-04-25

package/README.md

@@ -20,41 +20,35 @@
 
 | Target | Components | Use case |
 |--------|-----------|---------|
-| **Mobile** (`LuM*`) | `LuMButton`, `LuMInput`, `LuMCard`, `LuMList`, `LuMBottomSheet`, `LuMNavBar` | PWA-ready apps — touch targets ≥44px, swipe gestures, bottom nav |
-| **Desktop** (`LuD*`) | `LuDButton`, `LuDInput`, `LuDTable`, `LuDSidebar`, `LuDDropdown`, `LuDModal` | Feature-rich browser / Electron apps — data tables, keyboard shortcuts |
-| **Embedded** (`LuE*`) | `LuEButton`, `LuEDisplay`, `LuEGrid`, `LuEStatusBar`, `LuEAlert`, `LuENumpad` | Kiosk, IoT, in-car screens — fixed viewport, high contrast, minimal JS |
-| **Shared** (`Lu*`) | `LuIcon`, `LuSpinner`, `LuBadge`, `LuPortal` | Cross-surface primitives |
+| **Mobile** (`LuMobile*`) | `LuMobileShell`, `LuMobileHeader`, `LuMobileNavBar` | PWA-ready apps — touch targets ≥44px, swipe gestures, bottom nav |
+| **Desktop** (`LuDesktop*`) | `LuDesktopShell`, `LuDesktopSidebar`, `LuDesktopTopBar` | Feature-rich browser / Electron apps — resizable splits, keyboard shortcuts |
+| **Embedded** (`LuEmbedded*`) | `LuEmbeddedShell` | Retail POS, Kiosk, IoT, in-car screens — fixed viewport, high contrast, touch-first |
+| **Shared** (`Lu*`) | `LuDataGrid`, `LuKanban`, `LuBarChart`, `LuRichTextEditor`, `LuButton` | Cross-surface primitives, data-rich components, and operational features |
 
 ---
 
 ## Install
 
 ```bash
-bun add @astrake/lumora-ui
-# or
-npm install @astrake/lumora-ui
-# or
-pnpm add @astrake/lumora-ui
+bun add @astrake/lumora-ui vue@^3.5.0 tailwindcss @tailwindcss/vite \
+        echarts vue-echarts \
+        @tiptap/vue-3 @tiptap/starter-kit @tiptap/extension-placeholder \
+        vue-draggable-plus
 ```
 
-**Peer dependency:**
-
-```bash
-bun add vue@^3.5.0
-```
+> The `postinstall` script will print this command automatically after
+> `bun add @astrake/lumora-ui`.
 
 ---
 
 ## Usage
 
 ```ts
-// Import all targets
-import { LuIcon, LuSpinner } from "@astrake/lumora-ui"
+// Import shared components and layout primitives
+import { LuButton, LuDataGrid, LuKanban, LuStack } from "@astrake/lumora-ui"
 
-// Import a specific target (recommended for tree-shaking)
-import { LuMButton, LuMCard } from "@astrake/lumora-ui/mobile"
-import { LuDTable, LuDSidebar } from "@astrake/lumora-ui/desktop"
-import { LuEDisplay, LuEGrid } from "@astrake/lumora-ui/embedded"
+// Import surface-specific shells
+import { LuMobileShell, LuDesktopShell, LuEmbeddedShell } from "@astrake/lumora-ui"
 ```
 
 **Register the plugin:**
@@ -62,10 +56,11 @@ import { LuEDisplay, LuEGrid } from "@astrake/lumora-ui/embedded"
 ```ts
 // main.ts
 import { createApp } from "vue"
-import { LumoraUI } from "@astrake/lumora-ui"
+import { createLumoraUI } from "@astrake/lumora-ui"
+import "@astrake/lumora-ui/style"
 import App from "./App.vue"
 
-createApp(App).use(LumoraUI).mount("#app")
+createApp(App).use(createLumoraUI()).mount("#app")
 ```
 
 ---
@@ -94,9 +89,10 @@ Each target root overrides tokens as appropriate (e.g., Embedded reduces shadow
 | Component framework | Vue 3.5+ (Composition API) |
 | Language | TypeScript 5.9+ |
 | Bundler | Vite (library mode, three entry points) |
+| Interactive Add-ons (Peer) | Apache ECharts, Tiptap, Sortable.js (`vue-draggable-plus`) |
 | Type check | vue-tsc |
 | Tests | Vitest + @vue/test-utils |
-| Package manager | Bun 1.3.12 |
+| Package manager | Bun 1.3+ |
 
 ---
 
@@ -106,14 +102,16 @@ Each target root overrides tokens as appropriate (e.g., Embedded reduces shadow
 LumoraUI/
 ├── packages/core/        ← @astrake/lumora-ui (published package)
 │   └── src/
-│       ├── tokens/       ← CSS custom properties (--lu-*)
-│       ├── shared/       ← cross-target primitives (Lu*)
-│       ├── mobile/       ← Mobile components (LuM*)
-│       ├── desktop/      ← Desktop components (LuD*)
-│       ├── embedded/     ← Embedded components (LuE*)
+│       ├── components/   ← shared primitives + complex components (Lu*)
+│       ├── layout/       ← layout primitives (LuStack, LuGrid, LuDock, etc.)
+│       ├── shell/        ← surface shells (LuDesktopShell, LuMobileShell, etc.)
+│       ├── composables/  ← shared composition functions
+│       ├── skins/        ← SkinMap default theme
+│       ├── lumora.css    ← structural CSS baseline
 │       └── index.ts
-├── apps/showcase/        ← reference Vite + Vue 3 app
+├── apps/showcase/        ← reference Vite + Vue 3 showcase app
 ├── tools/                ← build, check, version, changelog scripts
+├── .agent/               ← AI agent rules and authoring guides
 └── docs/                 ← architecture, development, releases, legal
 ```
 
@@ -126,7 +124,7 @@ git clone https://github.com/madlybong/LumoraUI.git
 cd LumoraUI
 bun install
 bun run check      # typecheck
-bun test           # run test suite
+bun run test --run # run test suite
 bun run dev        # start the showcase app
 ```
 
@@ -138,7 +136,7 @@ bun run dev        # start the showcase app
 - [Architecture Guide](./docs/ARCHITECTURE.md)
 - [Development Workflow](./docs/DEVELOPMENT.md)
 - [Release Workflow](./docs/RELEASES.md)
-- [AI Agent Guide](./docs/AI_AGENT_GUIDE.md)
+- [AI Agent Knowledge Base](./.agent/README.md)
 - [Legal Notice & Disclaimer](./docs/LEGAL.md)
 
 ---