@nice2dev/ui-tools

Nice2Dev UI Tools — FileManager, FilterBuilder, Gallery, Map, Git, Validation, Export, ColumnChooser, AuditLog, Designers

Part of the Nice2Dev UI monorepo.

Installation

npm install @nice2dev/ui-tools @nice2dev/ui

@nice2dev/ui is a peer dependency — install both.

Usage

Two import styles depending on whether the symbol is a direct re-export from @nice2dev/ui or lives in a namespace module:

// Direct components and helpers (re-exports)
import { NiceFileManager, NiceFilterBuilder, NiceGallery, NiceAuditLog } from '@nice2dev/ui-tools';

// Namespace modules (each is a Pro toolkit area)
import { Terminal, Kubernetes, SqlEditor, PdfTools } from '@nice2dev/ui-tools';
const terminal = new Terminal.Session({ ... });

import '@nice2dev/ui/style.css';

What's inside

A toolkit catalog of developer- and ops-focused tooling — both ready-to-use components and namespaced toolkit modules (PRO-7 ... PRO-31). Each namespace module is independently tree-shakable.

Direct components / hooks / helpers

| Group | Exports | | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Chat / draggable / sortable | NiceChat, NiceDraggable, NiceSortable | | Files | NiceFileUploader, NiceFileManager | | Filters / gallery / map | NiceFilterBuilder, NiceGallery, NiceMap | | Recipe | NiceRecipeEditor, createEmptyRecipe, recipeTotalMinutes | | Git | NiceGitManager | | Speech | NiceSpeechToText | | Validation | NiceValidationGroup, useNiceValidation, NiceValidator, NiceValidationSummary | | Theming | NiceThemeDesigner, NiceThemeBuilder | | Views (renderer / fetcher / cache / registry / hot-reload) | NiceViewRenderer, NiceViewFetcher, NiceViewCache, NiceViewRegistry, NiceViewHotReload, serializeViewV2, deserializeViewV2, validateViewDefinitionV2 | | Module system | NiceModuleLoaderProvider, NiceModuleRoute, useModuleLoader, NiceFeatureFlagsProvider, NiceFeatureGate, useFeatureFlag, NiceModuleHotSwap, checkModuleHealth, compareSemver | | Cross-platform | validateCrossPlatformView, isViewCompatibleWith, CURRENT_SCHEMA_VERSION | | API contracts | createStandardErpContracts, runContractTests | | Type mapping | NiceComponentTypeMapping, defaultTypeMapping | | RBAC | resolvePermissions, isAllowed, checkPermissions, serializeRbacPolicy, validateRbacPolicy | | Code generation | generateTypescriptModel, generateDartModel, generateRbacTypescript, generateAllForView | | Scaffolding | generateScaffold, listScaffoldTemplates | | View validation / diff / storybook | validateViewForDeploy, diffViews, generateStoryFromView, generateViewCatalog | | Undo | NiceUndoManager, NiceUndoProvider, useUndoManager, useUndoKeyboard, createUndoMiddleware | | Showcase | NiceShowcase | | Export / print / audit | niceExport, exportToCSV/XLSX/PDF/JSON/HTML, NiceColumnChooser, NicePrintPreview, NiceAuditLog, diffObjects | | Documents | NiceDocumentViewer | | Display style | NiceDisplayStylePicker | | Design tokens | extractTokensFromTheme, generateTokens, NiceDesignTokens | | Diagrams | NiceDiagramDesigner, validateDiagramSchema, generateMermaidSyntax | | Permissions | NicePermissionMatrix | | Downloads / torrents | DownloadManager, useDownloadManager, TorrentClient, useTorrentClient, parseMagnetLink, formatBytes, formatSpeed |

Namespace toolkit modules

PRO-x roadmap toolkits — each exported under a namespace to keep names short and avoid collisions. Import the namespace, then use the exports it provides.

| PRO area | Namespace | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PRO-7 (Infra) | RemoteDesktop, Containers, Kubernetes, VirtualMachines, CloudInstances | | PRO-8 (Net / ops) | Terminal, NetworkConfig, NetworkMonitoring, ServerManagement, DnsManagement, Certificates | | PRO-9 (DevOps) | Pipelines, IaC, ConfigManagement, Git, Artifacts, IDE, VisualScripting, AIAssistant, Debugger, Workspace | | PRO-10 (Data DB) | SqlEditor, DbDesigner, DataManagement, DbAdapters, DbAdmin | | PRO-11 (Observability) | MetricsDashboard, LogManagement, DistributedTracing, APMProfiling, AlertingIncidents | | PRO-12 (Security) | SecurityScanning, SecretManagement, AccessControl, AuditCompliance | | PRO-13 (Integration) | ApiDesigner, ApiTesting, IntegrationPlatform, MessageQueue | | PRO-14 (Docs / forms) | PdfTools, Spreadsheet, WordProcessor, FormBuilder, ReportDesigner, EmailTemplate | | PRO-15 (BI / analytics) | DashboardDesigner, ChartBuilder, DataPipeline, DataWarehouse, SelfServiceAnalytics | | PRO-16 (IoT) | DeviceManagement, SensorDashboard, EdgeComputing, ScadaIndustrial, SmartHome | | PRO-18 (ML / AI) | DatasetManagement, ModelTraining, ModelRegistry, ModelDeployment, AIPlaygrounds | | PRO-21..31 (Misc) | MobileComponents, HardwareIntegration, TestingQA, Education, ErpEnterprise, LifeManagement, ScientificResearch, Mathematics, DownloadTorrent | | SEC-008 (Privacy) | Traceless | | PRO-23 (a11y / i18n) | AccessibilityI18n | | PRO-28 (Icon tools) | IconTools | | PRO-1 (Game engine) | GameEngineAdvanced |

Moved out (re-import directly)

| Was here | Now lives in | | ---------------------------------------------------------- | ------------------------ | | NiceControlConfigurator | @nice2dev/ui-designers | | NiceViewBuilder, NiceViewDesigner | @nice2dev/ui-designers | | NiceFormBuilder, NiceFormBuilderAI, NiceFormDesigner | @nice2dev/ui-forms | | NiceDashboardDesigner | @nice2dev/ui-designers | | NiceWorkflowDesigner | @nice2dev/ui-designers |

See docs/PER_PACKAGE_IMPORT_MATRIX.md for the canonical component-to-package matrix.

Styling

import '@nice2dev/ui/style.css';

Optional legacy token aliases:

import '@nice2dev/ui/css/legacy-bg-text-aliases.css';

Examples

Live, interactive examples for every component are available in the Nice2Dev showcase — each entry exposes presets, size / state / label / error placement selectors and full prop documentation.

License

MIT — see LICENSE at the repository root.