@devxcrew/ui 1.0.81

package/README.md

@@ -0,0 +1,43 @@
+# @devxcrew/ui
+
+React controls, application layouts, workspace primitives, and shared visual settings.
+
+## Start
+
+```sh
+npm install
+npm run check
+npm run pack
+```
+
+Each repository owns package-lock.json, node_modules, dist, and its version.
+The release archive is written to dist/releases.
+
+## Integration
+
+Use a React 19 frontend with a bundler such as Vite. Install React and React DOM in the app. Import @devxcrew/ui/styles.css. Include the installed package dist/src folder in Tailwind source scanning. Prefer subpath imports to keep feature dependencies out of simple pages.
+
+Compiled UI modules target frontend bundlers and contain extensionless internal imports. Direct Node.js execution and unbundled browser imports are not supported. The package has no unit tests yet. The starter provides browser coverage for API connectivity, theme controls, mobile layout, and failure recovery, not every exported control.
+
+## Agent reference
+
+Start with [Assist](assist/README.md) and [the agent guide](assist/AGENT-GUIDE.md).
+Read [package details](assist/documentation/package-reference.md), [audit notes](assist/documentation/audit.md), and [the changelog](assist/documentation/CHANGELOG.md).
+
+## Maintenance tools
+
+This repository installs @devxcrew/tools as a development dependency.
+Install a pinned tools version from the configured npm registry.
+The common implementation lives in D:\codexsun\shared\tools.
+For distributed repositories, install a pinned tools version from the private registry.
+
+```sh
+npm run version:show
+npm run version:bump -- --dry-run --title "Package update"
+npm run changelog:append -- --title "Maintenance" --note "Describe the verified change."
+npm run github:now -- --dry-run
+npm run lines:fix
+```
+
+Read [versioning](assist/operations/versioning.md) before a release.
+Remote repositories and registry publishing are not configured.

package/assist/AGENT-GUIDE.md

@@ -0,0 +1,29 @@
+# UI Agent Guide
+
+## Required reading
+
+Read governance/rules.md and documentation/package-reference.md before changing code.
+Read operations/versioning.md before changing versions or release tools.
+Inspect the owning source, public export, dependency declaration, and tests.
+
+## Ownership
+
+Own reusable controls, accessible interaction primitives, layout wrappers, styling tokens, dark mode surfaces, and design variants. Apps supply branding, navigation, user actions, workspaces, business forms, and permissions.
+
+Keep this repository independent. Import sibling packages only through published public exports.
+Treat @devxcrew/tools as development tooling, never as a runtime dependency.
+
+## Verification
+
+Run npm run check, npm run format:check, and npm run pack.
+Build validates exports and keeps tests out of the release output.
+Install published npm versions in the starter and run its build and clone verification after packaging changes.
+Use starter browser tests after frontend behavior or frontend dependency changes.
+Report unverified integrations clearly. Do not equate mocks or scope tests with live database evidence.
+
+## Documentation
+
+Update package-reference.md when a public contract or integration requirement changes.
+Append concrete changes under the current changelog version.
+Do not create historical CXApp product entries or task-specific handoff files.
+Do not bump versions unless requested. Do not run Docker.

package/assist/README.md

@@ -0,0 +1,22 @@
+# UI Assist Pack
+
+This folder is the active reference for humans and agents maintaining @devxcrew/ui.
+It uses the CXApp Assist layout without its product-specific plans or lockstep workspace rules.
+
+## Reading order
+
+1. Read AGENT-GUIDE.md.
+2. Read governance/rules.md.
+3. Read documentation/package-reference.md and the affected public exports.
+4. Read operations/versioning.md for tooling or release work.
+
+## Folder guide
+
+- documentation/package-reference.md: ownership, exports, dependencies, integration and limits.
+- documentation/project-inventory.md: current repository layout.
+- documentation/audit.md: reviewed findings and verification limits.
+- documentation/CHANGELOG.md: active version state and history.
+- governance/rules.md: maintenance boundaries and checks.
+- operations/versioning.md: version, changelog, GitHub and LF commands.
+
+Historical changelog entries are evidence, not current instructions.

package/assist/documentation/CHANGELOG.md

@@ -0,0 +1,72 @@
+# Changelog
+
+## Version State
+
+Current version: 1.0.81
+
+Release tag: v-1.0.81
+
+Changelog label: v 1.0.81
+
+History starts with this standalone package baseline. CXApp business history is not copied.
+
+## v-1.0.81
+
+### [v 1.0.81] 2026-10-02 12:08 pm - Devxcrew replacement release
+
+#### Database Changes
+
+- Database update: No (manual).
+
+#### App Codebase Changes
+
+- Use @devxcrew/tools for shared maintenance and devxcrew repository metadata.
+
+## v-1.0.80
+
+### [v 1.0.80] 2026-10-02 11:52 am - Tools ownership and naming migration
+
+#### Database Changes
+
+- Database update: No (manual).
+
+#### App Codebase Changes
+
+- Moved shared maintenance to @devxcrew/tools. CLI now creates apps only. Uses devxcrew commands, platform imports, and .devxcrew-tools.json profiles. Registry lock regeneration awaits the tools release.
+
+### [v 1.0.80] 2026-10-02 11:30 am - Fresh devxcrew repository
+
+#### Database Changes
+
+- Database update: No (manual).
+
+#### App Codebase Changes
+
+- Started fresh Git history under devxcrew with a short repository name. Npm publishing is deferred.
+
+### [v 1.0.80] 2026-10-02 11:06 am - Public npm package preparation
+
+#### Database Changes
+
+- Database update: No (manual).
+
+#### App Codebase Changes
+
+- Prepared @devxcrew package metadata, independent GitHub checks, and OIDC publishing. Uses @devxcrew/cli 1.0.0 from npm.
+
+### [v 1.0.80] 2026-10-02 10:04 am - Independent package maintenance and audit
+
+#### Database Changes
+
+- Database update: No (manual).
+- No database migration, provisioning, or live persistence validation was performed.
+
+#### App Codebase Changes
+
+- Maintained this package as an independent npm project and local Git repository.
+- Added Assist references, governance, package inventory, audit notes, and release documentation.
+- Reused @codexsun/cli for builds, boundaries, exports, GitHub review, version bumps, changelogs, and LF normalization.
+- Preserved independent package versions and application-owned business modules.
+- Package checks, compiled exports, production dependency audit, GitHub dry run, and version-bump dry run passed.
+
+- UI has no unit tests. Two starter browser tests passed for the shared shell and API failure recovery.

package/assist/documentation/audit.md

@@ -0,0 +1,33 @@
+# Package Audit
+
+Reviewed on 2026-10-02. This audit covers source ownership, dependency declarations, public exports, packaging, maintenance tools, and integration limits.
+
+## Findings and actions
+
+- Confirmed React and React DOM are peer dependencies supplied by the app.
+- Confirmed no backend package or product-private source import is present.
+- Added compiled export and CSS asset checks.
+- UI unit coverage remains absent. Starter browser tests cover the shared shell only.
+- Root barrel imports can include optional editor/chart dependencies. Prefer subpath imports.
+- App-provided navigation and branding prevent shared product-specific menus.
+
+## Maintenance findings
+
+- Local repositories previously copied build and boundary scripts. They now consume one versioned @codexsun/cli archive.
+- Assist references and active changelogs were missing. Added the CXApp documentation layout and release naming conventions.
+- Text files used mixed line endings. Added shared LF check/fix commands, .gitattributes and .editorconfig.
+- Package versions stay independent. Version tools update only the selected repository and preserve dependency ranges.
+
+## Evidence and limits
+
+Package checks include parsed source boundaries, version alignment, LF checks, TypeScript, lint and existing tests.
+Build checks every declared compiled export and excludes test files.
+The common tooling has fixture tests for versions, history, dry runs, LF exclusions, output validation, and GitHub review.
+Starter checks cover consuming the archives. Verification results are recorded in the current changelog.
+No remote push, registry publish, Docker, central identity, or live database deployment is part of this audit.
+
+## Recorded checks
+
+- Package boundaries, version alignment, LF checks, TypeScript, lint and compiled exports passed.
+- npm audit --omit=dev reported zero known vulnerabilities for this package lockfile on 2026-10-02.
+- GitHub and version-bump dry runs passed without mutations.

package/assist/documentation/package-reference.md

@@ -0,0 +1,49 @@
+# UI Package Reference
+
+## Purpose
+
+React controls, application layouts, workspace primitives, and shared visual settings.
+
+## Ownership
+
+Own reusable controls, accessible interaction primitives, layout wrappers, styling tokens, dark mode surfaces, and design variants. Apps supply branding, navigation, user actions, workspaces, business forms, and permissions.
+
+## Public exports
+
+| Export                            | Responsibility                                                                    |
+| --------------------------------- | --------------------------------------------------------------------------------- |
+| components/*                      | Radix-based controls, inputs, dialogs, tables, charts, loading states and editors |
+| layouts/*                         | App, administration, authentication, public-web and role shell wrappers           |
+| blocks/*                          | Composable navigation and shell blocks                                            |
+| workspace, workspace/_, presets/_ | Workspace sections, actions, forms, tables, totals and presentation primitives    |
+| design-system                     | Shared design variants and browser settings                                       |
+| lib/*                             | Common React hooks and class-name helpers                                         |
+| styles.css                        | Tailwind styles, Geist fonts, print styles and design tokens                      |
+
+## Runtime and build
+
+Use ESM, Node.js >=26.5 and npm >=12.0.1.
+TypeScript 6.0.3 builds JavaScript and declarations into dist/src.
+The root package manifest exports compiled files.
+npm pack runs prepack and rebuilds the release. Tests and local tools are excluded from runtime output.
+
+## Integration
+
+Use a React 19 frontend with a bundler such as Vite. Install React and React DOM in the app. Import @devxcrew/ui/styles.css. Include the installed package dist/src folder in Tailwind source scanning. Prefer subpath imports to keep feature dependencies out of simple pages.
+
+## Dependencies
+
+Runtime and peer requirements are declared in package.json.
+@devxcrew/tools is a development dependency for build, boundaries, exports, versions, changelogs, GitHub review and LF checks.
+The configured npm registry supplies the CLI development dependency.
+React and React DOM are peer dependencies. Radix, Tailwind, fonts, charts, editors, and workspace libraries remain runtime dependencies.
+
+## Limits
+
+Compiled UI modules target frontend bundlers and contain extensionless internal imports. Direct Node.js execution and unbundled browser imports are not supported. The package has no unit tests yet. The starter provides browser coverage for API connectivity, theme controls, mobile layout, and failure recovery, not every exported control.
+
+## Extension rules
+
+Add only reusable capabilities with explicit public contracts.
+Keep company-specific business concepts in app modules.
+Apps choose their own release versions, secrets, database adapters and deployment schedules.

package/assist/documentation/project-inventory.md

@@ -0,0 +1,13 @@
+# Project Inventory
+
+- package.json: npm identity, runtime exports, dependency contracts and common tool scripts.
+- package-lock.json: independent reproducible installation.
+- src: package-owned TypeScript or React implementation.
+- assist: agent reference, governance, release notes and audit record.
+- .devxcrew-tools.json: package profile for the common tools.
+- .gitattributes and .editorconfig: LF text policy and binary exceptions.
+- dist/src: generated JavaScript, declarations and CSS.
+- dist/releases: generated npm archives.
+
+Build, boundary and release tool implementations live only in @devxcrew/tools.
+This repository has its own local Git history. No remote is configured by this task.

package/assist/governance/rules.md

@@ -0,0 +1,23 @@
+# Package Governance
+
+## Repository
+
+Use npm from this repository root. Keep one local dependency tree and one lockfile.
+Put generated outputs under dist. Install shared dependencies only from the npm registry.
+Use LF for text. Mark binary archives and fonts as binary in .gitattributes.
+
+## Boundaries
+
+Own reusable controls, accessible interaction primitives, layout wrappers, styling tokens, dark mode surfaces, and design variants. Apps supply branding, navigation, user actions, workspaces, business forms, and permissions.
+
+Do not add product schemas, customer-specific workflows, invoice rules, or tenant provisioning here.
+Use public package exports. Declare runtime and peer dependencies explicitly.
+Do not import sibling private source or copy shared maintenance tools.
+
+## Checks
+
+Run npm run check, npm run format:check, and npm run pack.
+Run meaningful regression tests for fixes. Keep tests out of published runtime files.
+Preserve historical changelog entries. Keep current version, lockfile and changelog state aligned.
+Run github:now with --dry-run for review. Publishing, commits, tags and pushes require authorization.
+Docker remains deferred.

package/assist/operations/github.md

@@ -0,0 +1,9 @@
+# GitHub repository
+
+Source: https://github.com/devxcrew/ui.
+
+This repository starts with fresh Git history from the current source.
+Use the main branch. Keep versions independent.
+The npm package is @devxcrew/ui.
+Npm publishing and trusted publisher setup are deferred to the package phase.
+Earlier published npm versions retain their original repository metadata.

package/assist/operations/npm-release.md

@@ -0,0 +1,14 @@
+# Npm releases
+
+Source: https://github.com/devxcrew/ui.
+Package: @devxcrew/ui.
+
+Publish tools first, then framework and UI, then platform, then CLI.
+Apps consume pinned npm versions. Never use file or link dependencies.
+Regenerate lockfiles with npm install after the required versions exist.
+Run npm run check, npm run format:check, and npm run pack.
+Previously published versions are immutable. Change the version before republishing changed source.
+The CLI command changed to devxcrew-cli and needs a major release.
+The tools command is devxcrew-tools. Profile files are .devxcrew-tools.json.
+GitHub OIDC publishing must target the current devxcrew repository and its actual workflow file.
+Configure trusted publishing during the release phase. Do not reuse the old CODEXSUN publishing trust.

package/assist/operations/versioning.md

@@ -0,0 +1,58 @@
+# Versioning and Releases
+
+## Version policy
+
+This repository versions independently. Do not change sibling package or app versions.
+Use numeric semantic versions. Patch fixes behavior, minor adds compatible features, and major changes contracts.
+Keep CXApp naming conventions: release tag v-<version>, changelog label v <version>, and commit subject #<patch> - <title>.
+Tag names in Version State describe the intended release name. They do not prove a Git tag exists.
+
+## Active changelog
+
+Use assist/documentation/CHANGELOG.md.
+Keep Current version, Release tag, and Changelog label in its Version State block.
+Use concrete ## v-<version> sections and ### [v <version>] YYYY-MM-DD h:mm am - Title entries.
+Use Asia/Kolkata timestamps and separate Database Changes from App Codebase Changes.
+Keep historical entries unchanged. Append work under the current version until a bump is requested.
+
+## Common commands
+
+```sh
+npm run version:show
+npm run check:versions
+npm run version:bump -- --dry-run --title "Release title"
+npm run version:bump -- --title "Release title" --note "Describe changes."
+npm run version:bump -- --release minor --title "Feature release"
+npm run changelog:append -- --title "Progress" --note "Describe verified work."
+npm run lines:check
+npm run lines:fix
+npm run github:now -- --dry-run
+```
+
+Version bump defaults to patch. It updates this manifest, lockfile root versions and changelog only.
+It does not change dependency ranges, sibling versions, create commits, or create tags.
+Use --database-update Yes only when database work occurred. The default is No.
+
+## GitHub helper
+
+Run github:now in an interactive terminal after configuring a remote and upstream branch.
+It shows the current changelog subject and working tree. It offers an optional patch bump.
+It asks before fetching, staging, committing, and pushing.
+It refuses a branch behind its upstream instead of auto-stashing or merging local changes.
+First commit and first upstream configuration use ordinary Git commands.
+Dry run is read-only and works before a remote or first commit exists.
+
+## Release checks
+
+Run npm run check, npm run format:check, and npm run pack.
+Install the published npm version in consuming apps and run their checks before upgrading deployment versions.
+Run npm run release:check before authorized publishing.
+Set registry credentials for the @devxcrew scope. Run npm run release only when publishing is authorized.
+
+## Tools updates
+
+Publish an authorized tools version from D:\codexsun\shared\tools.
+Install it with npm install --save-dev --save-exact @devxcrew/tools@<version>.
+Commit the manifest and registry-generated lockfile together.
+Never add a new copy of its source scripts to this repository.
+Docker execution remains deferred.

package/dist/src/blocks/menu/sidemenu/app-sidebar.d.ts

@@ -0,0 +1,46 @@
+import * as React from "react";
+import { type LucideIcon } from "lucide-react";
+import { type SidemenuItem } from "./sub/sidemenu-section";
+import { Sidebar } from "../../../components/sidebar";
+type SidebarBrandOption = {
+    id: string;
+    logoDarkSrc?: string;
+    logoSrc?: string;
+    subtitle?: string;
+    title: string;
+};
+export type SidebarBrand = {
+    href?: string;
+    logoAlt?: string;
+    logoDarkSrc?: string;
+    logoSrc?: string;
+    options?: SidebarBrandOption[];
+    optionsLabel?: string;
+    onOptionSelect?: (id: string) => void;
+    onSecondaryOptionSelect?: (id: string) => void;
+    selectedOptionId?: string;
+    selectedSecondaryOptionId?: string;
+    secondaryOptions?: SidebarBrandOption[];
+    secondaryOptionsLabel?: string;
+    subtitle: string;
+    title: string;
+};
+export type SidebarUser = {
+    email: string;
+    fallback: string;
+    name: string;
+};
+export type SidebarUserMenuItem = {
+    icon: LucideIcon;
+    title: string;
+    url?: string;
+};
+type AppSidebarProps = React.ComponentProps<typeof Sidebar> & {
+    brand: SidebarBrand;
+    items: SidemenuItem[];
+    user: SidebarUser;
+    userMenuItems?: SidebarUserMenuItem[];
+    versionLabel?: string;
+};
+export declare function AppSidebar({ brand, className, items, user, userMenuItems, versionLabel, ...props }: AppSidebarProps): React.JSX.Element;
+export {};

package/dist/src/blocks/menu/sidemenu/app-sidebar.js

@@ -0,0 +1,30 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import * as React from "react";
+import { BadgeCheckIcon, ChevronsUpDownIcon } from "lucide-react";
+import { SidemenuSection } from "./sub/sidemenu-section";
+import { Avatar, AvatarFallback } from "../../../components/avatar";
+import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger } from "../../../components/dropdown-menu";
+import { Sidebar, SidebarContent, SidebarFooter, SidebarHeader, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarRail } from "../../../components/sidebar";
+const defaultUserMenuItems = [];
+export function AppSidebar({ brand, className, items, user, userMenuItems = defaultUserMenuItems, versionLabel = "", ...props }) {
+    return (_jsxs(Sidebar, { collapsible: "icon", variant: "inset", className: className, ...props, children: [_jsx(SidebarHeader, { children: _jsx(SidebarBrandMenu, { brand: brand }) }), _jsx(SidebarContent, { children: _jsx(SidemenuSection, { items: items }) }), _jsxs(SidebarFooter, { className: "border-t", children: [_jsx("div", { className: "px-2 text-xs text-muted-foreground group-data-[collapsible=icon]:hidden", children: versionLabel }), _jsx(SidebarMenu, { children: _jsx(SidebarMenuItem, { children: _jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs(SidebarMenuButton, { size: "lg", className: "h-14", children: [_jsx(Avatar, { className: "size-9 border bg-background", children: _jsx(AvatarFallback, { children: user.fallback }) }), _jsxs("div", { className: "min-w-0 flex-1 text-left leading-tight group-data-[collapsible=icon]:hidden", children: [_jsx("div", { className: "truncate font-semibold", children: user.name }), _jsx("div", { className: "truncate text-xs text-muted-foreground", children: user.email })] }), _jsx(ChevronsUpDownIcon, { className: "ml-auto size-4 text-muted-foreground group-data-[collapsible=icon]:hidden" })] }) }), _jsxs(DropdownMenuContent, { align: "end", side: "right", className: "w-56 p-2", children: [_jsxs("div", { className: "flex items-center gap-3 p-2", children: [_jsx(Avatar, { className: "size-9 border bg-background", children: _jsx(AvatarFallback, { children: user.fallback }) }), _jsxs("div", { className: "min-w-0", children: [_jsx("div", { className: "truncate font-semibold", children: user.name }), _jsx("div", { className: "truncate text-xs text-muted-foreground", children: user.email })] })] }), _jsx(DropdownMenuSeparator, {}), userMenuItems.map((item, index) => (_jsxs(React.Fragment, { children: [index === userMenuItems.length - 1 ? _jsx(DropdownMenuSeparator, {}) : null, _jsx(DropdownMenuItem, { asChild: Boolean(item.url), children: item.url ? (_jsxs("a", { href: item.url, children: [_jsx(item.icon, {}), item.title] })) : (_jsxs(_Fragment, { children: [_jsx(item.icon, {}), item.title] })) })] }, item.title)))] })] }) }) })] }), _jsx(SidebarRail, {})] }));
+}
+function SidebarBrandMenu({ brand }) {
+    const options = brand.options ?? [];
+    const secondaryOptions = brand.secondaryOptions ?? [];
+    const active = options.find((option) => option.id === brand.selectedOptionId) ?? options[0];
+    const current = active ?? brand;
+    const trigger = (_jsxs(SidebarMenuButton, { size: "lg", tooltip: current.title, className: "h-14", children: [_jsx(BrandIdentity, { brand: current, fallback: brand }), options.length || secondaryOptions.length ? (_jsx(ChevronsUpDownIcon, { className: "ml-auto size-4 text-sidebar-foreground/60 group-data-[collapsible=icon]:hidden" })) : null] }));
+    return (_jsx(SidebarMenu, { children: _jsx(SidebarMenuItem, { children: options.length || secondaryOptions.length ? (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: trigger }), _jsxs(DropdownMenuContent, { align: "start", side: "right", className: "w-64 p-1", children: [brand.optionsLabel ? (_jsx("div", { className: "px-2 pb-1 pt-1.5 text-[0.68rem] font-semibold uppercase tracking-wide text-muted-foreground", children: brand.optionsLabel })) : null, options.map((option) => (_jsxs(DropdownMenuItem, { onSelect: () => brand.onOptionSelect?.(option.id), children: [_jsx(BrandLogo, { brand: option, fallback: brand, compact: true }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "truncate font-medium", children: option.title }), option.subtitle ? (_jsx("div", { className: "truncate text-xs text-muted-foreground", children: option.subtitle })) : null] }), option.id === brand.selectedOptionId ? (_jsx(BadgeCheckIcon, { className: "size-4 text-primary" })) : null] }, option.id))), options.length && secondaryOptions.length ? _jsx(DropdownMenuSeparator, {}) : null, brand.secondaryOptionsLabel ? (_jsx("div", { className: "px-2 pb-1 pt-1.5 text-[0.68rem] font-semibold uppercase tracking-wide text-muted-foreground", children: brand.secondaryOptionsLabel })) : null, secondaryOptions.map((option) => (_jsxs(DropdownMenuItem, { onSelect: () => brand.onSecondaryOptionSelect?.(option.id), children: [_jsxs("div", { className: "min-w-0 flex-1 px-1", children: [_jsx("div", { className: "truncate font-medium", children: option.title }), option.subtitle ? (_jsx("div", { className: "truncate text-xs text-muted-foreground", children: option.subtitle })) : null] }), option.id === brand.selectedSecondaryOptionId ? (_jsx(BadgeCheckIcon, { className: "size-4 text-primary" })) : null] }, option.id)))] })] })) : (_jsx("a", { href: brand.href ?? "/workspace", children: trigger })) }) }));
+}
+function BrandIdentity({ brand, fallback }) {
+    return (_jsxs(_Fragment, { children: [_jsx(BrandLogo, { brand: brand, fallback: fallback }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-0.5 leading-none group-data-[collapsible=icon]:hidden", children: [_jsx("span", { className: "truncate font-semibold", children: brand.title }), _jsx("span", { className: "truncate text-xs text-muted-foreground", children: brand.subtitle ?? fallback.subtitle })] })] }));
+}
+function BrandLogo({ brand, compact = false, fallback }) {
+    const size = compact ? "size-7" : "size-8";
+    const imageSize = compact ? "size-4" : "size-5";
+    const lightSource = brand.logoSrc ?? fallback.logoSrc;
+    const darkSource = brand.logoDarkSrc ?? fallback.logoDarkSrc ?? lightSource;
+    return (_jsxs("div", { className: `flex aspect-square ${size} shrink-0 items-center justify-center overflow-hidden rounded-lg border bg-background`, children: [lightSource ? (_jsx("img", { alt: brand.logoAlt ?? fallback.logoAlt ?? brand.title, className: `${imageSize} dark:hidden`, src: lightSource })) : (_jsx("span", { className: "text-sm font-semibold dark:hidden", children: brand.title.slice(0, 1) })), darkSource ? (_jsx("img", { alt: brand.logoAlt ?? fallback.logoAlt ?? brand.title, className: `hidden ${imageSize} dark:block`, src: darkSource })) : (_jsx("span", { className: "hidden text-sm font-semibold dark:block", children: brand.title.slice(0, 1) }))] }));
+}

package/dist/src/blocks/menu/sidemenu/nav-documents.d.ts

@@ -0,0 +1,8 @@
+import { type LucideIcon } from "lucide-react";
+export declare function NavDocuments({ items }: {
+    items: {
+        name: string;
+        url: string;
+        icon: LucideIcon;
+    }[];
+}): import("react").JSX.Element;

package/dist/src/blocks/menu/sidemenu/nav-documents.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { FolderIcon, MoreHorizontalIcon, ShareIcon } from "lucide-react";
+import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from "../../../components/dropdown-menu";
+import { SidebarGroup, SidebarGroupLabel, SidebarMenu, SidebarMenuAction, SidebarMenuButton, SidebarMenuItem, useSidebar } from "../../../components/sidebar";
+export function NavDocuments({ items }) {
+    const { isMobile } = useSidebar();
+    return (_jsxs(SidebarGroup, { className: "group-data-[collapsible=icon]:hidden", children: [_jsx(SidebarGroupLabel, { children: "Documents" }), _jsxs(SidebarMenu, { children: [items.map((item) => (_jsxs(SidebarMenuItem, { children: [_jsx(SidebarMenuButton, { asChild: true, children: _jsxs("a", { href: item.url, children: [_jsx(item.icon, {}), _jsx("span", { children: item.name })] }) }), _jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs(SidebarMenuAction, { showOnHover: true, className: "rounded-sm data-[state=open]:bg-accent", children: [_jsx(MoreHorizontalIcon, {}), _jsx("span", { className: "sr-only", children: "More" })] }) }), _jsxs(DropdownMenuContent, { className: "w-24 rounded-lg", side: isMobile ? "bottom" : "right", align: isMobile ? "end" : "start", children: [_jsxs(DropdownMenuItem, { children: [_jsx(FolderIcon, {}), _jsx("span", { children: "Open" })] }), _jsxs(DropdownMenuItem, { children: [_jsx(ShareIcon, {}), _jsx("span", { children: "Share" })] })] })] })] }, item.name))), _jsx(SidebarMenuItem, { children: _jsxs(SidebarMenuButton, { className: "text-sidebar-foreground/70", children: [_jsx(MoreHorizontalIcon, { className: "text-sidebar-foreground/70" }), _jsx("span", { children: "More" })] }) })] })] }));
+}

package/dist/src/blocks/menu/sidemenu/nav-main.d.ts

@@ -0,0 +1,8 @@
+import { type LucideIcon } from "lucide-react";
+export declare function NavMain({ items }: {
+    items: {
+        title: string;
+        url: string;
+        icon?: LucideIcon;
+    }[];
+}): import("react").JSX.Element;

package/dist/src/blocks/menu/sidemenu/nav-main.js

@@ -0,0 +1,8 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MailIcon, PlusCircleIcon } from "lucide-react";
+import { Button } from "../../../components/button";
+import { SidebarGroup, SidebarGroupContent, SidebarMenu, SidebarMenuButton, SidebarMenuItem } from "../../../components/sidebar";
+export function NavMain({ items }) {
+    return (_jsx(SidebarGroup, { children: _jsxs(SidebarGroupContent, { className: "flex flex-col gap-2", children: [_jsx(SidebarMenu, { children: _jsxs(SidebarMenuItem, { className: "flex items-center gap-2", children: [_jsxs(SidebarMenuButton, { tooltip: "Quick Create", className: "min-w-8 bg-primary text-primary-foreground duration-200 ease-linear hover:bg-primary/90 hover:text-primary-foreground active:bg-primary/90 active:text-primary-foreground", children: [_jsx(PlusCircleIcon, {}), _jsx("span", { children: "Quick Create" })] }), _jsxs(Button, { size: "icon", className: "h-9 w-9 shrink-0 group-data-[collapsible=icon]:opacity-0", variant: "outline", children: [_jsx(MailIcon, {}), _jsx("span", { className: "sr-only", children: "Inbox" })] })] }) }), _jsx(SidebarMenu, { children: items.map((item) => (_jsx(SidebarMenuItem, { children: _jsx(SidebarMenuButton, { asChild: true, tooltip: item.title, children: _jsxs("a", { href: item.url, children: [item.icon && _jsx(item.icon, {}), _jsx("span", { children: item.title })] }) }) }, item.title))) })] }) }));
+}

package/dist/src/blocks/menu/sidemenu/nav-secondary.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+import { LucideIcon } from "lucide-react";
+import { SidebarGroup } from "../../../components/sidebar";
+export declare function NavSecondary({ items, ...props }: {
+    items: {
+        title: string;
+        url: string;
+        icon: LucideIcon;
+    }[];
+} & React.ComponentPropsWithoutRef<typeof SidebarGroup>): React.JSX.Element;

package/dist/src/blocks/menu/sidemenu/nav-secondary.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { SidebarGroup, SidebarGroupContent, SidebarMenu, SidebarMenuButton, SidebarMenuItem } from "../../../components/sidebar";
+export function NavSecondary({ items, ...props }) {
+    return (_jsx(SidebarGroup, { ...props, children: _jsx(SidebarGroupContent, { children: _jsx(SidebarMenu, { children: items.map((item) => (_jsx(SidebarMenuItem, { children: _jsx(SidebarMenuButton, { asChild: true, children: _jsxs("a", { href: item.url, children: [_jsx(item.icon, {}), _jsx("span", { children: item.title })] }) }) }, item.title))) }) }) }));
+}

package/dist/src/blocks/menu/sidemenu/nav-user.d.ts

@@ -0,0 +1,7 @@
+export declare function NavUser({ user }: {
+    user: {
+        name: string;
+        email: string;
+        avatar: string;
+    };
+}): import("react").JSX.Element;

package/dist/src/blocks/menu/sidemenu/nav-user.js

@@ -0,0 +1,10 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { BellIcon, LogOutIcon, MoreVerticalIcon, UserCircleIcon } from "lucide-react";
+import { Avatar, AvatarFallback, AvatarImage } from "../../../components/avatar";
+import { DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger } from "../../../components/dropdown-menu";
+import { SidebarMenu, SidebarMenuButton, SidebarMenuItem, useSidebar } from "../../../components/sidebar";
+export function NavUser({ user }) {
+    const { isMobile } = useSidebar();
+    return (_jsx(SidebarMenu, { children: _jsx(SidebarMenuItem, { children: _jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs(SidebarMenuButton, { size: "lg", className: "data-[state=open]:bg-sidebar-accent data-[state=open]:text-sidebar-accent-foreground", children: [_jsxs(Avatar, { className: "h-8 w-8 rounded-lg grayscale", children: [_jsx(AvatarImage, { src: user.avatar, alt: user.name }), _jsx(AvatarFallback, { className: "rounded-lg", children: "CN" })] }), _jsxs("div", { className: "grid flex-1 text-left text-sm leading-tight", children: [_jsx("span", { className: "truncate font-medium", children: user.name }), _jsx("span", { className: "truncate text-xs text-muted-foreground", children: user.email })] }), _jsx(MoreVerticalIcon, { className: "ml-auto size-4" })] }) }), _jsxs(DropdownMenuContent, { className: "w-[--radix-dropdown-menu-trigger-width] min-w-56 rounded-lg", side: isMobile ? "bottom" : "right", align: "end", sideOffset: 4, children: [_jsx(DropdownMenuLabel, { className: "p-0 font-normal", children: _jsxs("div", { className: "flex items-center gap-2 px-1 py-1.5 text-left text-sm", children: [_jsxs(Avatar, { className: "h-8 w-8 rounded-lg", children: [_jsx(AvatarImage, { src: user.avatar, alt: user.name }), _jsx(AvatarFallback, { className: "rounded-lg", children: "CN" })] }), _jsxs("div", { className: "grid flex-1 text-left text-sm leading-tight", children: [_jsx("span", { className: "truncate font-medium", children: user.name }), _jsx("span", { className: "truncate text-xs text-muted-foreground", children: user.email })] })] }) }), _jsx(DropdownMenuSeparator, {}), _jsxs(DropdownMenuGroup, { children: [_jsxs(DropdownMenuItem, { children: [_jsx(UserCircleIcon, {}), "Account"] }), _jsxs(DropdownMenuItem, { children: [_jsx(BellIcon, {}), "Notifications"] })] }), _jsx(DropdownMenuSeparator, {}), _jsxs(DropdownMenuItem, { children: [_jsx(LogOutIcon, {}), "Log out"] })] })] }) }) }));
+}

package/dist/src/blocks/menu/sidemenu/section-cards.d.ts

@@ -0,0 +1 @@
+export declare function SectionCards(): import("react").JSX.Element;

package/dist/src/blocks/menu/sidemenu/section-cards.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { TrendingDownIcon, TrendingUpIcon } from "lucide-react";
+import { Badge } from "../../../components/badge";
+import { Card, CardDescription, CardFooter, CardHeader, CardTitle } from "../../../components/card";
+export function SectionCards() {
+    return (_jsxs("div", { className: "*:data-[slot=card]:shadow-xs @xl/main:grid-cols-2 @5xl/main:grid-cols-4 grid grid-cols-1 gap-4 px-4 *:data-[slot=card]:bg-gradient-to-t *:data-[slot=card]:from-primary/5 *:data-[slot=card]:to-card dark:*:data-[slot=card]:bg-card lg:px-6", children: [_jsxs(Card, { className: "@container/card", children: [_jsxs(CardHeader, { className: "relative", children: [_jsx(CardDescription, { children: "Total Revenue" }), _jsx(CardTitle, { className: "@[250px]/card:text-3xl text-2xl font-semibold tabular-nums", children: "$1,250.00" }), _jsx("div", { className: "absolute right-4 top-4", children: _jsxs(Badge, { variant: "outline", className: "flex gap-1 rounded-lg text-xs", children: [_jsx(TrendingUpIcon, { className: "size-3" }), "+12.5%"] }) })] }), _jsxs(CardFooter, { className: "flex-col items-start gap-1 text-sm", children: [_jsxs("div", { className: "line-clamp-1 flex gap-2 font-medium", children: ["Trending up this month ", _jsx(TrendingUpIcon, { className: "size-4" })] }), _jsx("div", { className: "text-muted-foreground", children: "Visitors for the last 6 months" })] })] }), _jsxs(Card, { className: "@container/card", children: [_jsxs(CardHeader, { className: "relative", children: [_jsx(CardDescription, { children: "New Customers" }), _jsx(CardTitle, { className: "@[250px]/card:text-3xl text-2xl font-semibold tabular-nums", children: "1,234" }), _jsx("div", { className: "absolute right-4 top-4", children: _jsxs(Badge, { variant: "outline", className: "flex gap-1 rounded-lg text-xs", children: [_jsx(TrendingDownIcon, { className: "size-3" }), "-20%"] }) })] }), _jsxs(CardFooter, { className: "flex-col items-start gap-1 text-sm", children: [_jsxs("div", { className: "line-clamp-1 flex gap-2 font-medium", children: ["Down 20% this period ", _jsx(TrendingDownIcon, { className: "size-4" })] }), _jsx("div", { className: "text-muted-foreground", children: "Acquisition needs attention" })] })] }), _jsxs(Card, { className: "@container/card", children: [_jsxs(CardHeader, { className: "relative", children: [_jsx(CardDescription, { children: "Active Accounts" }), _jsx(CardTitle, { className: "@[250px]/card:text-3xl text-2xl font-semibold tabular-nums", children: "45,678" }), _jsx("div", { className: "absolute right-4 top-4", children: _jsxs(Badge, { variant: "outline", className: "flex gap-1 rounded-lg text-xs", children: [_jsx(TrendingUpIcon, { className: "size-3" }), "+12.5%"] }) })] }), _jsxs(CardFooter, { className: "flex-col items-start gap-1 text-sm", children: [_jsxs("div", { className: "line-clamp-1 flex gap-2 font-medium", children: ["Strong user retention ", _jsx(TrendingUpIcon, { className: "size-4" })] }), _jsx("div", { className: "text-muted-foreground", children: "Engagement exceed targets" })] })] }), _jsxs(Card, { className: "@container/card", children: [_jsxs(CardHeader, { className: "relative", children: [_jsx(CardDescription, { children: "Growth Rate" }), _jsx(CardTitle, { className: "@[250px]/card:text-3xl text-2xl font-semibold tabular-nums", children: "4.5%" }), _jsx("div", { className: "absolute right-4 top-4", children: _jsxs(Badge, { variant: "outline", className: "flex gap-1 rounded-lg text-xs", children: [_jsx(TrendingUpIcon, { className: "size-3" }), "+4.5%"] }) })] }), _jsxs(CardFooter, { className: "flex-col items-start gap-1 text-sm", children: [_jsxs("div", { className: "line-clamp-1 flex gap-2 font-medium", children: ["Steady performance ", _jsx(TrendingUpIcon, { className: "size-4" })] }), _jsx("div", { className: "text-muted-foreground", children: "Meets growth projections" })] })] })] }));
+}

package/dist/src/blocks/menu/sidemenu/sub/sidemenu-section.d.ts

@@ -0,0 +1,21 @@
+import { type LucideIcon } from "lucide-react";
+export type SidemenuSubItem = {
+    icon?: LucideIcon;
+    isActive?: boolean;
+    items?: SidemenuSubItem[];
+    onSelect?: () => void;
+    title: string;
+    url?: string;
+};
+export type SidemenuItem = {
+    title: string;
+    url?: string;
+    icon: LucideIcon;
+    isActive?: boolean;
+    onSelect?: () => void;
+    items?: SidemenuSubItem[];
+};
+export declare function SidemenuSection({ items, title }: {
+    items: SidemenuItem[];
+    title?: string;
+}): import("react").JSX.Element;

package/dist/src/blocks/menu/sidemenu/sub/sidemenu-section.js

@@ -0,0 +1,25 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "../../../../components/collapsible";
+import { SidebarGroup, SidebarGroupLabel, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem } from "../../../../components/sidebar";
+export function SidemenuSection({ items, title }) {
+    return (_jsxs(SidebarGroup, { children: [title ? _jsx(SidebarGroupLabel, { children: title }) : null, _jsx(SidebarMenu, { children: items.map((item) => {
+                    const subItems = item.items ?? [];
+                    const hasItems = subItems.length > 0;
+                    return (_jsx(Collapsible, { asChild: true, defaultOpen: item.isActive ?? false, className: "group/collapsible", children: _jsxs(SidebarMenuItem, { children: [hasItems ? (_jsx(CollapsibleTrigger, { asChild: true, children: _jsxs(SidebarMenuButton, { tooltip: item.title, children: [_jsx(item.icon, {}), _jsx("span", { className: "group-data-[collapsible=icon]:hidden", children: item.title }), _jsx(SidemenuChevron, { className: "group-data-[collapsible=icon]:hidden group-data-[state=open]/collapsible:rotate-45" })] }) })) : (_jsx(SidebarMenuButton, { asChild: true, isActive: item.isActive ?? false, tooltip: item.title, children: item.onSelect ? (_jsxs("button", { type: "button", onClick: item.onSelect, children: [_jsx(item.icon, {}), _jsx("span", { className: "group-data-[collapsible=icon]:hidden", children: item.title })] })) : (_jsxs("a", { href: item.url ?? "#", children: [_jsx(item.icon, {}), _jsx("span", { className: "group-data-[collapsible=icon]:hidden", children: item.title })] })) })), hasItems ? (_jsx(CollapsibleContent, { children: _jsx(SidebarMenuSub, { children: subItems.map((subItem) => (_jsx(SidemenuSubItemNode, { item: subItem }, subItem.title))) }) })) : null] }) }, `${item.title}-${item.isActive ? "active" : "idle"}`));
+                }) })] }));
+}
+function SidemenuSubItemNode({ item }) {
+    const children = item.items ?? [];
+    const hasChildren = children.length > 0;
+    const childActive = children.some((child) => child.isActive || child.items?.some((nested) => nested.isActive));
+    const active = item.isActive ?? childActive;
+    const Icon = item.icon;
+    if (hasChildren) {
+        return (_jsx(SidebarMenuSubItem, { children: _jsx(Collapsible, { asChild: true, defaultOpen: active, className: "group/sub-collapsible", children: _jsxs("div", { children: [_jsx(CollapsibleTrigger, { asChild: true, children: _jsx(SidebarMenuSubButton, { asChild: true, isActive: active, children: _jsxs("button", { type: "button", children: [Icon ? _jsx(Icon, { className: "size-4 shrink-0" }) : null, _jsx("span", { children: item.title }), _jsx(SidemenuChevron, { className: "group-data-[state=open]/sub-collapsible:rotate-45" })] }) }) }), _jsx(CollapsibleContent, { children: _jsx(SidebarMenuSub, { className: "mx-2 mr-0 gap-0.5 py-0.5", children: children.map((child) => (_jsx(SidemenuSubItemNode, { item: child }, child.title))) }) })] }) }) }));
+    }
+    return (_jsx(SidebarMenuSubItem, { children: _jsx(SidebarMenuSubButton, { asChild: true, isActive: active, children: item.onSelect ? (_jsxs("button", { type: "button", onClick: item.onSelect, children: [Icon ? _jsx(Icon, { className: "size-4 shrink-0" }) : null, _jsx("span", { children: item.title })] })) : (_jsxs("a", { href: item.url ?? "#", children: [Icon ? _jsx(Icon, { className: "size-4 shrink-0" }) : null, _jsx("span", { children: item.title })] })) }) }));
+}
+function SidemenuChevron({ className = "" }) {
+    return (_jsx("span", { "aria-hidden": "true", className: `ml-auto size-2 shrink-0 rotate-[-45deg] border-b border-r border-muted-foreground transition-transform duration-200 ${className}` }));
+}