@nice2dev/ui-tools 1.0.15 → 1.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +84 -16
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -7,40 +7,108 @@ Part of the [Nice2Dev](https://nice2dev.com) UI monorepo.
7
7
  ## Installation
8
8
 
9
9
  ```bash
10
- npm install @nice2dev/ui-tools
10
+ npm install @nice2dev/ui-tools @nice2dev/ui
11
11
  ```
12
12
 
13
+ `@nice2dev/ui` is a peer dependency — install both.
14
+
13
15
  ## Usage
14
16
 
17
+ Two import styles depending on whether the symbol is a direct re-export from `@nice2dev/ui` or lives in a namespace module:
18
+
15
19
  ```tsx
16
- import {} from /* component(s) */ '@nice2dev/ui-tools';
20
+ // Direct components and helpers (re-exports)
21
+ import { NiceFileManager, NiceFilterBuilder, NiceGallery, NiceAuditLog } from '@nice2dev/ui-tools';
22
+
23
+ // Namespace modules (each is a Pro toolkit area)
24
+ import { Terminal, Kubernetes, SqlEditor, PdfTools } from '@nice2dev/ui-tools';
25
+ const terminal = new Terminal.Session({ ... });
26
+
27
+ import '@nice2dev/ui/style.css';
17
28
  ```
18
29
 
19
- ## Styling
30
+ ## What's inside
20
31
 
21
- This package ships unstyled component logic. Import the shared CSS bundle once at your app entrypoint:
32
+ 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.
33
+
34
+ ### Direct components / hooks / helpers
35
+
36
+ | Group | Exports |
37
+ | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
38
+ | Chat / draggable / sortable | `NiceChat`, `NiceDraggable`, `NiceSortable` |
39
+ | Files | `NiceFileUploader`, `NiceFileManager` |
40
+ | Filters / gallery / map | `NiceFilterBuilder`, `NiceGallery`, `NiceMap` |
41
+ | Recipe | `NiceRecipeEditor`, `createEmptyRecipe`, `recipeTotalMinutes` |
42
+ | Git | `NiceGitManager` |
43
+ | Speech | `NiceSpeechToText` |
44
+ | Validation | `NiceValidationGroup`, `useNiceValidation`, `NiceValidator`, `NiceValidationSummary` |
45
+ | Theming | `NiceThemeDesigner`, `NiceThemeBuilder` |
46
+ | Views (renderer / fetcher / cache / registry / hot-reload) | `NiceViewRenderer`, `NiceViewFetcher`, `NiceViewCache`, `NiceViewRegistry`, `NiceViewHotReload`, `serializeViewV2`, `deserializeViewV2`, `validateViewDefinitionV2` |
47
+ | Module system | `NiceModuleLoaderProvider`, `NiceModuleRoute`, `useModuleLoader`, `NiceFeatureFlagsProvider`, `NiceFeatureGate`, `useFeatureFlag`, `NiceModuleHotSwap`, `checkModuleHealth`, `compareSemver` |
48
+ | Cross-platform | `validateCrossPlatformView`, `isViewCompatibleWith`, `CURRENT_SCHEMA_VERSION` |
49
+ | API contracts | `createStandardErpContracts`, `runContractTests` |
50
+ | Type mapping | `NiceComponentTypeMapping`, `defaultTypeMapping` |
51
+ | RBAC | `resolvePermissions`, `isAllowed`, `checkPermissions`, `serializeRbacPolicy`, `validateRbacPolicy` |
52
+ | Code generation | `generateTypescriptModel`, `generateDartModel`, `generateRbacTypescript`, `generateAllForView` |
53
+ | Scaffolding | `generateScaffold`, `listScaffoldTemplates` |
54
+ | View validation / diff / storybook | `validateViewForDeploy`, `diffViews`, `generateStoryFromView`, `generateViewCatalog` |
55
+ | Undo | `NiceUndoManager`, `NiceUndoProvider`, `useUndoManager`, `useUndoKeyboard`, `createUndoMiddleware` |
56
+ | Showcase | `NiceShowcase` |
57
+ | Export / print / audit | `niceExport`, `exportToCSV`/`XLSX`/`PDF`/`JSON`/`HTML`, `NiceColumnChooser`, `NicePrintPreview`, `NiceAuditLog`, `diffObjects` |
58
+ | Documents | `NiceDocumentViewer` |
59
+ | Display style | `NiceDisplayStylePicker` |
60
+ | Design tokens | `extractTokensFromTheme`, `generateTokens`, `NiceDesignTokens` |
61
+ | Diagrams | `NiceDiagramDesigner`, `validateDiagramSchema`, `generateMermaidSyntax` |
62
+ | Permissions | `NicePermissionMatrix` |
63
+ | Downloads / torrents | `DownloadManager`, `useDownloadManager`, `TorrentClient`, `useTorrentClient`, `parseMagnetLink`, `formatBytes`, `formatSpeed` |
64
+
65
+ ### Namespace toolkit modules
66
+
67
+ 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.
68
+
69
+ | PRO area | Namespace |
70
+ | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
71
+ | PRO-7 (Infra) | `RemoteDesktop`, `Containers`, `Kubernetes`, `VirtualMachines`, `CloudInstances` |
72
+ | PRO-8 (Net / ops) | `Terminal`, `NetworkConfig`, `NetworkMonitoring`, `ServerManagement`, `DnsManagement`, `Certificates` |
73
+ | PRO-9 (DevOps) | `Pipelines`, `IaC`, `ConfigManagement`, `Git`, `Artifacts`, `IDE`, `VisualScripting`, `AIAssistant`, `Debugger`, `Workspace` |
74
+ | PRO-10 (Data DB) | `SqlEditor`, `DbDesigner`, `DataManagement`, `DbAdapters`, `DbAdmin` |
75
+ | PRO-11 (Observability) | `MetricsDashboard`, `LogManagement`, `DistributedTracing`, `APMProfiling`, `AlertingIncidents` |
76
+ | PRO-12 (Security) | `SecurityScanning`, `SecretManagement`, `AccessControl`, `AuditCompliance` |
77
+ | PRO-13 (Integration) | `ApiDesigner`, `ApiTesting`, `IntegrationPlatform`, `MessageQueue` |
78
+ | PRO-14 (Docs / forms) | `PdfTools`, `Spreadsheet`, `WordProcessor`, `FormBuilder`, `ReportDesigner`, `EmailTemplate` |
79
+ | PRO-15 (BI / analytics) | `DashboardDesigner`, `ChartBuilder`, `DataPipeline`, `DataWarehouse`, `SelfServiceAnalytics` |
80
+ | PRO-16 (IoT) | `DeviceManagement`, `SensorDashboard`, `EdgeComputing`, `ScadaIndustrial`, `SmartHome` |
81
+ | PRO-18 (ML / AI) | `DatasetManagement`, `ModelTraining`, `ModelRegistry`, `ModelDeployment`, `AIPlaygrounds` |
82
+ | PRO-21..31 (Misc) | `MobileComponents`, `HardwareIntegration`, `TestingQA`, `Education`, `ErpEnterprise`, `LifeManagement`, `ScientificResearch`, `Mathematics`, `DownloadTorrent` |
83
+ | SEC-008 (Privacy) | `Traceless` |
84
+ | PRO-23 (a11y / i18n) | `AccessibilityI18n` |
85
+ | PRO-28 (Icon tools) | `IconTools` |
86
+ | PRO-1 (Game engine) | `GameEngineAdvanced` |
87
+
88
+ ### Moved out (re-import directly)
89
+
90
+ | Was here | Now lives in |
91
+ | ---------------------------------------------------------- | ------------------------ |
92
+ | `NiceControlConfigurator` | `@nice2dev/ui-designers` |
93
+ | `NiceViewBuilder`, `NiceViewDesigner` | `@nice2dev/ui-designers` |
94
+ | `NiceFormBuilder`, `NiceFormBuilderAI`, `NiceFormDesigner` | `@nice2dev/ui-forms` |
95
+ | `NiceDashboardDesigner` | `@nice2dev/ui-designers` |
96
+ | `NiceWorkflowDesigner` | `@nice2dev/ui-designers` |
97
+
98
+ See [docs/PER_PACKAGE_IMPORT_MATRIX.md](../../docs/PER_PACKAGE_IMPORT_MATRIX.md) for the canonical component-to-package matrix.
99
+
100
+ ## Styling
22
101
 
23
102
  ```tsx
24
103
  import '@nice2dev/ui/style.css';
25
104
  ```
26
105
 
27
- Optional: opt into the legacy shorthand token aliases (`--bg-*`, `--text-*`, `--border-*`, ...) when migrating from a custom design-token system:
106
+ Optional legacy token aliases:
28
107
 
29
108
  ```tsx
30
109
  import '@nice2dev/ui/css/legacy-bg-text-aliases.css';
31
110
  ```
32
111
 
33
- ## What's inside
34
-
35
- - **76** source files
36
- - Tree-shakable ESM build via Vite + tsup
37
- - Full TypeScript types
38
- - WCAG 2.1 AA accessibility baseline
39
-
40
- ## Featured components
41
-
42
- - See package source for the full export list.
43
-
44
112
  ## Examples
45
113
 
46
114
  Live, interactive examples for every component are available in the [Nice2Dev showcase](https://github.com/nice2dev/NiceToDev.UI/tree/main/packages/showcase) — each entry exposes presets, size / state / label / error placement selectors and full prop documentation.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nice2dev/ui-tools",
3
- "version": "1.0.15",
3
+ "version": "1.0.17",
4
4
  "description": "Nice2Dev UI Tools — FileManager, FilterBuilder, Gallery, Map, Git, Validation, Export, ColumnChooser, AuditLog, Designers",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -27,12 +27,12 @@
27
27
  "prepublishOnly": "npm run build"
28
28
  },
29
29
  "peerDependencies": {
30
- "@nice2dev/ui": "^1.0.15",
30
+ "@nice2dev/ui": "^1.0.17",
31
31
  "react": ">=17.0.0",
32
32
  "react-dom": ">=17.0.0"
33
33
  },
34
34
  "devDependencies": {
35
- "@nice2dev/ui": "^1.0.15",
35
+ "@nice2dev/ui": "^1.0.17",
36
36
  "@types/react": "^18.2.0",
37
37
  "@types/react-dom": "^18.2.0",
38
38
  "@vitejs/plugin-react": "^4.3.0",