create-react-admin-template 0.0.0-stage → 0.1.0

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 (736) hide show
  1. package/README.md +46 -2
  2. package/bin/create.mjs +5 -0
  3. package/package.json +22 -4
  4. package/template/.dockerignore +12 -0
  5. package/template/.editorconfig +12 -0
  6. package/template/.env +14 -0
  7. package/template/.env.development +5 -0
  8. package/template/.env.production +2 -0
  9. package/template/.env.test +5 -0
  10. package/template/.github/workflows/ci.yml +40 -0
  11. package/template/.gitlab-ci.yml +208 -0
  12. package/template/.husky/commit-msg +1 -0
  13. package/template/.husky/pre-commit +1 -0
  14. package/template/.nvmrc +1 -0
  15. package/template/.prettierignore +11 -0
  16. package/template/.prettierrc +47 -0
  17. package/template/Dockerfile +16 -0
  18. package/template/README.md +372 -0
  19. package/template/build/advancedTable.ts +103 -0
  20. package/template/build/environment.ts +150 -0
  21. package/template/commitlint.config.js +32 -0
  22. package/template/components.json +21 -0
  23. package/template/deploy/README.md +132 -0
  24. package/template/deploy/host-nginx/react-admin-api.conf +14 -0
  25. package/template/deploy/host-nginx/react-admin-web.conf +8 -0
  26. package/template/deploy/nginx.conf +38 -0
  27. package/template/docs/activity-status.md +217 -0
  28. package/template/docs/audit-logs.md +158 -0
  29. package/template/docs/authentication-adapters.md +219 -0
  30. package/template/docs/browser-security.md +58 -0
  31. package/template/docs/bundle-budgets.md +65 -0
  32. package/template/docs/component-source-governance.md +99 -0
  33. package/template/docs/data-masking.md +169 -0
  34. package/template/docs/enterprise-scaffold.md +208 -0
  35. package/template/docs/feature-data-template.md +227 -0
  36. package/template/docs/feature-flags.md +169 -0
  37. package/template/docs/file-capabilities.md +196 -0
  38. package/template/docs/locale-and-i18n.md +132 -0
  39. package/template/docs/mutation-idempotency.md +24 -0
  40. package/template/docs/optional-editors.md +203 -0
  41. package/template/docs/page-feedback.md +83 -0
  42. package/template/docs/query-data-conventions.md +178 -0
  43. package/template/docs/realtime-collaboration.md +140 -0
  44. package/template/docs/reporting-printing-templates.md +156 -0
  45. package/template/docs/scaffold-capability-roadmap.md +226 -0
  46. package/template/docs/scaffold-guide.md +443 -0
  47. package/template/docs/template-changelog.md +30 -0
  48. package/template/docs/template-versioning.md +26 -0
  49. package/template/docs/tenant-workspace-context.md +147 -0
  50. package/template/docs/unsaved-changes.md +58 -0
  51. package/template/docs/white-label.md +102 -0
  52. package/template/eslint.config.js +697 -0
  53. package/template/gitignore +39 -0
  54. package/template/index.html +26 -0
  55. package/template/knip.config.ts +42 -0
  56. package/template/lint-staged.config.js +8 -0
  57. package/template/package.json +133 -0
  58. package/template/pnpm-lock.yaml +8694 -0
  59. package/template/public/favicon.ico +0 -0
  60. package/template/public/logo.svg +1 -0
  61. package/template/public/runtime-config.json +49 -0
  62. package/template/scaffold.template.json +5 -0
  63. package/template/src/Application.tsx +114 -0
  64. package/template/src/api/ApiError.ts +33 -0
  65. package/template/src/api/activity/ActivityProvider.tsx +167 -0
  66. package/template/src/api/activity/access.ts +13 -0
  67. package/template/src/api/activity/errors.ts +17 -0
  68. package/template/src/api/activity/index.ts +67 -0
  69. package/template/src/api/activity/model.ts +227 -0
  70. package/template/src/api/activity/query.ts +163 -0
  71. package/template/src/api/activity/source.ts +16 -0
  72. package/template/src/api/activity/subscription.ts +292 -0
  73. package/template/src/api/activity/transports.ts +271 -0
  74. package/template/src/api/activity/types.ts +402 -0
  75. package/template/src/api/authClient.ts +134 -0
  76. package/template/src/api/authSession.ts +307 -0
  77. package/template/src/api/clients/configureApiClient.ts +62 -0
  78. package/template/src/api/clients/httpStatus.ts +4 -0
  79. package/template/src/api/config/services.json +7 -0
  80. package/template/src/api/demoAuthClient.ts +46 -0
  81. package/template/src/api/enums/EnumCatalogProvider.tsx +169 -0
  82. package/template/src/api/enums/EnumDictionary.ts +55 -0
  83. package/template/src/api/enums/access.ts +130 -0
  84. package/template/src/api/enums/catalog.ts +216 -0
  85. package/template/src/api/enums/errors.ts +21 -0
  86. package/template/src/api/enums/index.ts +48 -0
  87. package/template/src/api/enums/query.ts +82 -0
  88. package/template/src/api/enums/scope.ts +58 -0
  89. package/template/src/api/enums/types.ts +251 -0
  90. package/template/src/api/hooks/error.ts +198 -0
  91. package/template/src/api/hooks/index.ts +4 -0
  92. package/template/src/api/hooks/request.ts +99 -0
  93. package/template/src/api/hooks/requestId.ts +65 -0
  94. package/template/src/api/hooks/response.ts +22 -0
  95. package/template/src/api/hooks/types.ts +20 -0
  96. package/template/src/api/idempotency/index.ts +1 -0
  97. package/template/src/api/idempotency/key.ts +23 -0
  98. package/template/src/api/index.ts +14 -0
  99. package/template/src/api/metadata/MetadataProvider.tsx +37 -0
  100. package/template/src/api/metadata/index.ts +2 -0
  101. package/template/src/api/metadata/types.ts +30 -0
  102. package/template/src/api/parameters/GlobalParameterProvider.tsx +210 -0
  103. package/template/src/api/parameters/access.ts +117 -0
  104. package/template/src/api/parameters/catalog.ts +170 -0
  105. package/template/src/api/parameters/errors.ts +21 -0
  106. package/template/src/api/parameters/index.ts +53 -0
  107. package/template/src/api/parameters/query.ts +84 -0
  108. package/template/src/api/parameters/scope.ts +58 -0
  109. package/template/src/api/parameters/types.ts +214 -0
  110. package/template/src/api/query/index.ts +13 -0
  111. package/template/src/api/query/keys.ts +155 -0
  112. package/template/src/api/query/mutation.ts +48 -0
  113. package/template/src/api/query/react.ts +36 -0
  114. package/template/src/api/query/scope.ts +38 -0
  115. package/template/src/api/query/types.ts +147 -0
  116. package/template/src/api/types.ts +144 -0
  117. package/template/src/application/types.ts +52 -0
  118. package/template/src/auditLogs/errors.ts +17 -0
  119. package/template/src/auditLogs/export.ts +85 -0
  120. package/template/src/auditLogs/index.ts +54 -0
  121. package/template/src/auditLogs/model.ts +526 -0
  122. package/template/src/auditLogs/query.ts +113 -0
  123. package/template/src/auditLogs/react.ts +36 -0
  124. package/template/src/auditLogs/source.ts +51 -0
  125. package/template/src/auditLogs/types.ts +357 -0
  126. package/template/src/authentication/controller.ts +351 -0
  127. package/template/src/authentication/index.ts +8 -0
  128. package/template/src/authentication/redirect.ts +72 -0
  129. package/template/src/authentication/types.ts +300 -0
  130. package/template/src/bootstrap.tsx +96 -0
  131. package/template/src/components/AppDataTable/AppDataTable.tsx +74 -0
  132. package/template/src/components/AppDataTable/index.ts +2 -0
  133. package/template/src/components/AppDataTable/types.ts +27 -0
  134. package/template/src/components/AppDialog/AppConfirmDialog.tsx +44 -0
  135. package/template/src/components/AppDialog/AppDialog.tsx +113 -0
  136. package/template/src/components/AppDialog/index.ts +3 -0
  137. package/template/src/components/AppDialog/messages.tsx +22 -0
  138. package/template/src/components/AppDialog/types.ts +53 -0
  139. package/template/src/components/AppPageForm/AppPageForm.tsx +21 -0
  140. package/template/src/components/AppPageForm/PageForm.tsx +765 -0
  141. package/template/src/components/AppPageForm/SOURCE.md +26 -0
  142. package/template/src/components/AppPageForm/config.ts +253 -0
  143. package/template/src/components/AppPageForm/controller.ts +580 -0
  144. package/template/src/components/AppPageForm/index.ts +2 -0
  145. package/template/src/components/AppPageForm/messages.ts +90 -0
  146. package/template/src/components/AppPageForm/optionUtils.ts +91 -0
  147. package/template/src/components/AppPageForm/options.ts +397 -0
  148. package/template/src/components/AppPageForm/query.ts +44 -0
  149. package/template/src/components/AppPageForm/style.css +119 -0
  150. package/template/src/components/AppPageForm/types.ts +632 -0
  151. package/template/src/components/AppPageForm/validation.ts +233 -0
  152. package/template/src/components/AppTable/AppTable.tsx +26 -0
  153. package/template/src/components/AppTable/SOURCE.md +72 -0
  154. package/template/src/components/AppTable/cell/customCell/TableCellLayer.tsx +73 -0
  155. package/template/src/components/AppTable/cell/customCell/actions/ActionDropdownCell.tsx +104 -0
  156. package/template/src/components/AppTable/cell/customCell/cellLayer.ts +358 -0
  157. package/template/src/components/AppTable/cell/customCell/componentProps.ts +30 -0
  158. package/template/src/components/AppTable/cell/customCell/date/TemporalPickerEditor.tsx +54 -0
  159. package/template/src/components/AppTable/cell/customCell/index.ts +2 -0
  160. package/template/src/components/AppTable/cell/customCell/select/SelectCellEditor.tsx +225 -0
  161. package/template/src/components/AppTable/cell/customCell/tableCellLayer.css +20 -0
  162. package/template/src/components/AppTable/cell/customCell/tooltip/TooltipCell.tsx +45 -0
  163. package/template/src/components/AppTable/cell/customCell/types.ts +63 -0
  164. package/template/src/components/AppTable/cell/customCell/useCellLayerLifecycle.ts +111 -0
  165. package/template/src/components/AppTable/cell/frameworkCell/TableCellComponentLayer.tsx +40 -0
  166. package/template/src/components/AppTable/cell/frameworkCell/cellComponentSession.ts +203 -0
  167. package/template/src/components/AppTable/cell/frameworkCell/index.ts +3 -0
  168. package/template/src/components/AppTable/cell/index.ts +2 -0
  169. package/template/src/components/AppTable/columns/TableColumnEditor.tsx +257 -0
  170. package/template/src/components/AppTable/columns/index.ts +1 -0
  171. package/template/src/components/AppTable/columns/useTableColumnPreferenceActions.ts +85 -0
  172. package/template/src/components/AppTable/config/defaults.ts +46 -0
  173. package/template/src/components/AppTable/config/index.ts +2 -0
  174. package/template/src/components/AppTable/config/license.ts +39 -0
  175. package/template/src/components/AppTable/config/resolver.ts +25 -0
  176. package/template/src/components/AppTable/config/types.ts +377 -0
  177. package/template/src/components/AppTable/engine/bottom/index.ts +1 -0
  178. package/template/src/components/AppTable/engine/bottom/types.ts +14 -0
  179. package/template/src/components/AppTable/engine/cell/constants.ts +32 -0
  180. package/template/src/components/AppTable/engine/cell/customCell/actions/index.ts +1 -0
  181. package/template/src/components/AppTable/engine/cell/customCell/actions/renderer.ts +162 -0
  182. package/template/src/components/AppTable/engine/cell/customCell/date/index.ts +1 -0
  183. package/template/src/components/AppTable/engine/cell/customCell/date/renderer.ts +116 -0
  184. package/template/src/components/AppTable/engine/cell/customCell/editors/editorBounds.ts +57 -0
  185. package/template/src/components/AppTable/engine/cell/customCell/editors/editorTrigger.ts +46 -0
  186. package/template/src/components/AppTable/engine/cell/customCell/editors/index.ts +3 -0
  187. package/template/src/components/AppTable/engine/cell/customCell/editors/layerEditor.ts +244 -0
  188. package/template/src/components/AppTable/engine/cell/customCell/index.ts +7 -0
  189. package/template/src/components/AppTable/engine/cell/customCell/renderers/columnRenderer.ts +245 -0
  190. package/template/src/components/AppTable/engine/cell/customCell/renderers/confirmInput.ts +57 -0
  191. package/template/src/components/AppTable/engine/cell/customCell/renderers/display.ts +78 -0
  192. package/template/src/components/AppTable/engine/cell/customCell/renderers/index.ts +3 -0
  193. package/template/src/components/AppTable/engine/cell/customCell/renderers/itemList.ts +60 -0
  194. package/template/src/components/AppTable/engine/cell/customCell/renderers/links.ts +131 -0
  195. package/template/src/components/AppTable/engine/cell/customCell/renderers/selection.ts +41 -0
  196. package/template/src/components/AppTable/engine/cell/customCell/renderers/shared.ts +71 -0
  197. package/template/src/components/AppTable/engine/cell/customCell/renderers/step.ts +37 -0
  198. package/template/src/components/AppTable/engine/cell/customCell/renderers/switch.ts +45 -0
  199. package/template/src/components/AppTable/engine/cell/customCell/select/index.ts +1 -0
  200. package/template/src/components/AppTable/engine/cell/customCell/select/renderer.ts +33 -0
  201. package/template/src/components/AppTable/engine/cell/customCell/tooltip/index.ts +1 -0
  202. package/template/src/components/AppTable/engine/cell/customCell/tooltip/tooltip.ts +94 -0
  203. package/template/src/components/AppTable/engine/cell/customCell/types.ts +82 -0
  204. package/template/src/components/AppTable/engine/cell/formatting.ts +355 -0
  205. package/template/src/components/AppTable/engine/cell/formula.ts +145 -0
  206. package/template/src/components/AppTable/engine/cell/index.ts +7 -0
  207. package/template/src/components/AppTable/engine/cell/multiSelect.ts +96 -0
  208. package/template/src/components/AppTable/engine/cell/options.ts +339 -0
  209. package/template/src/components/AppTable/engine/cell/types.ts +53 -0
  210. package/template/src/components/AppTable/engine/columns/column.ts +430 -0
  211. package/template/src/components/AppTable/engine/columns/config/columns.ts +33 -0
  212. package/template/src/components/AppTable/engine/columns/config/index.ts +4 -0
  213. package/template/src/components/AppTable/engine/columns/config/mutation.ts +138 -0
  214. package/template/src/components/AppTable/engine/columns/config/temporal.ts +11 -0
  215. package/template/src/components/AppTable/engine/columns/config/validation.ts +106 -0
  216. package/template/src/components/AppTable/engine/columns/constants.ts +6 -0
  217. package/template/src/components/AppTable/engine/columns/gridColumns.ts +332 -0
  218. package/template/src/components/AppTable/engine/columns/index.ts +4 -0
  219. package/template/src/components/AppTable/engine/columns/rendererPolicies.ts +129 -0
  220. package/template/src/components/AppTable/engine/component/resolver.ts +272 -0
  221. package/template/src/components/AppTable/engine/component/types.ts +384 -0
  222. package/template/src/components/AppTable/engine/config/constants.ts +33 -0
  223. package/template/src/components/AppTable/engine/config/grid/compiler.ts +65 -0
  224. package/template/src/components/AppTable/engine/config/grid/defaults.ts +82 -0
  225. package/template/src/components/AppTable/engine/config/grid/ownership.ts +35 -0
  226. package/template/src/components/AppTable/engine/config/grid/runtimeDelta.ts +34 -0
  227. package/template/src/components/AppTable/engine/config/grid/types.ts +30 -0
  228. package/template/src/components/AppTable/engine/pagination/config.ts +75 -0
  229. package/template/src/components/AppTable/engine/pagination/constants.ts +5 -0
  230. package/template/src/components/AppTable/engine/pagination/index.ts +3 -0
  231. package/template/src/components/AppTable/engine/pagination/types.ts +70 -0
  232. package/template/src/components/AppTable/engine/preference/index.ts +2 -0
  233. package/template/src/components/AppTable/engine/preference/preference.ts +535 -0
  234. package/template/src/components/AppTable/engine/preference/types.ts +28 -0
  235. package/template/src/components/AppTable/engine/right/index.ts +1 -0
  236. package/template/src/components/AppTable/engine/right/types.ts +18 -0
  237. package/template/src/components/AppTable/engine/search/config.ts +64 -0
  238. package/template/src/components/AppTable/engine/search/constants.ts +8 -0
  239. package/template/src/components/AppTable/engine/search/index.ts +7 -0
  240. package/template/src/components/AppTable/engine/search/localQuery.ts +145 -0
  241. package/template/src/components/AppTable/engine/search/query.ts +203 -0
  242. package/template/src/components/AppTable/engine/search/remoteQuery.ts +99 -0
  243. package/template/src/components/AppTable/engine/search/searchInteraction.ts +46 -0
  244. package/template/src/components/AppTable/engine/search/types.ts +155 -0
  245. package/template/src/components/AppTable/engine/selection/config.ts +13 -0
  246. package/template/src/components/AppTable/engine/selection/index.ts +4 -0
  247. package/template/src/components/AppTable/engine/selection/selection.ts +357 -0
  248. package/template/src/components/AppTable/engine/selection/selectionHeader.ts +88 -0
  249. package/template/src/components/AppTable/engine/selection/types.ts +66 -0
  250. package/template/src/components/AppTable/engine/shared/action.ts +11 -0
  251. package/template/src/components/AppTable/engine/shared/constants.ts +2 -0
  252. package/template/src/components/AppTable/engine/shared/decimal.ts +114 -0
  253. package/template/src/components/AppTable/engine/shared/feedback.ts +62 -0
  254. package/template/src/components/AppTable/engine/shared/index.ts +13 -0
  255. package/template/src/components/AppTable/engine/shared/interaction.ts +55 -0
  256. package/template/src/components/AppTable/engine/shared/messages.ts +161 -0
  257. package/template/src/components/AppTable/engine/shared/row.ts +32 -0
  258. package/template/src/components/AppTable/engine/shared/scheduler.ts +17 -0
  259. package/template/src/components/AppTable/engine/shared/tableKey.ts +31 -0
  260. package/template/src/components/AppTable/engine/shared/theme.ts +196 -0
  261. package/template/src/components/AppTable/engine/shared/treeRows.ts +155 -0
  262. package/template/src/components/AppTable/engine/shared/types.ts +58 -0
  263. package/template/src/components/AppTable/engine/shared/valueSnapshot.ts +46 -0
  264. package/template/src/components/AppTable/engine/summary/config/export.ts +117 -0
  265. package/template/src/components/AppTable/engine/summary/config/index.ts +3 -0
  266. package/template/src/components/AppTable/engine/summary/config/summary.ts +62 -0
  267. package/template/src/components/AppTable/engine/summary/config/types.ts +93 -0
  268. package/template/src/components/AppTable/engine/summary/constants.ts +13 -0
  269. package/template/src/components/AppTable/engine/summary/excelJs.ts +133 -0
  270. package/template/src/components/AppTable/engine/summary/export.ts +311 -0
  271. package/template/src/components/AppTable/engine/summary/index.ts +6 -0
  272. package/template/src/components/AppTable/engine/summary/selectionSum.ts +92 -0
  273. package/template/src/components/AppTable/engine/summary/summary.ts +457 -0
  274. package/template/src/components/AppTable/engine/table/clipboard/index.ts +1 -0
  275. package/template/src/components/AppTable/engine/table/clipboard/transfer.ts +9 -0
  276. package/template/src/components/AppTable/engine/table/controller/TableController.ts +802 -0
  277. package/template/src/components/AppTable/engine/table/controller/errors.ts +106 -0
  278. package/template/src/components/AppTable/engine/table/controller/index.ts +4 -0
  279. package/template/src/components/AppTable/engine/table/controller/latestAbortableTask.ts +33 -0
  280. package/template/src/components/AppTable/engine/table/controller/tableDataReplacement.ts +60 -0
  281. package/template/src/components/AppTable/engine/table/controller/tableDomainConfiguration.ts +94 -0
  282. package/template/src/components/AppTable/engine/table/controller/tableEditingCommands.ts +163 -0
  283. package/template/src/components/AppTable/engine/table/controller/tableGridHost.ts +324 -0
  284. package/template/src/components/AppTable/engine/table/controller/tableIdentity.ts +68 -0
  285. package/template/src/components/AppTable/engine/table/controller/tableMutationPipeline.ts +79 -0
  286. package/template/src/components/AppTable/engine/table/controller/tableQueryCoordinator.ts +187 -0
  287. package/template/src/components/AppTable/engine/table/controller/tableReportingCoordinator.ts +143 -0
  288. package/template/src/components/AppTable/engine/table/controller/tableSaveCoordinator.ts +227 -0
  289. package/template/src/components/AppTable/engine/table/controller/tableSaveValidation.ts +29 -0
  290. package/template/src/components/AppTable/engine/table/controller/tableSnapshot.ts +58 -0
  291. package/template/src/components/AppTable/engine/table/controller/types.ts +202 -0
  292. package/template/src/components/AppTable/engine/table/editing/baselineStore.ts +134 -0
  293. package/template/src/components/AppTable/engine/table/editing/changeSet.ts +492 -0
  294. package/template/src/components/AppTable/engine/table/editing/changeSetSettlement.ts +633 -0
  295. package/template/src/components/AppTable/engine/table/editing/commitResultIndex.ts +75 -0
  296. package/template/src/components/AppTable/engine/table/editing/constants.ts +15 -0
  297. package/template/src/components/AppTable/engine/table/editing/dirtyCellIndex.ts +96 -0
  298. package/template/src/components/AppTable/engine/table/editing/index.ts +6 -0
  299. package/template/src/components/AppTable/engine/table/editing/mutation.ts +173 -0
  300. package/template/src/components/AppTable/engine/table/editing/rowKey.ts +10 -0
  301. package/template/src/components/AppTable/engine/table/editing/types.ts +404 -0
  302. package/template/src/components/AppTable/engine/table/editing/validation.ts +452 -0
  303. package/template/src/components/AppTable/engine/table/grid/cellMeta.ts +90 -0
  304. package/template/src/components/AppTable/engine/table/grid/handsontable.ts +25 -0
  305. package/template/src/components/AppTable/engine/table/grid/handsontableExtensions.d.ts +26 -0
  306. package/template/src/components/AppTable/engine/table/grid/index.ts +5 -0
  307. package/template/src/components/AppTable/engine/table/grid/moduleRegistry.ts +39 -0
  308. package/template/src/components/AppTable/engine/table/grid/runtime.ts +31 -0
  309. package/template/src/components/AppTable/engine/table/grid/types.ts +25 -0
  310. package/template/src/components/AppTable/engine/table/hooks/fixedEndHooks.ts +44 -0
  311. package/template/src/components/AppTable/engine/table/hooks/gridHooks.ts +108 -0
  312. package/template/src/components/AppTable/engine/table/hooks/headerHooks.ts +103 -0
  313. package/template/src/components/AppTable/engine/table/hooks/index.ts +3 -0
  314. package/template/src/components/AppTable/engine/table/index.ts +6 -0
  315. package/template/src/components/AppTable/engine/table/layout/constants.ts +2 -0
  316. package/template/src/components/AppTable/engine/table/layout/dropdownMenu.ts +89 -0
  317. package/template/src/components/AppTable/engine/table/layout/fixedColumns.ts +44 -0
  318. package/template/src/components/AppTable/engine/table/layout/fixedEndOverlay.ts +90 -0
  319. package/template/src/components/AppTable/engine/table/layout/fixedEndOverlayAccessibility.ts +104 -0
  320. package/template/src/components/AppTable/engine/table/layout/fixedEndOverlayRenderer.ts +690 -0
  321. package/template/src/components/AppTable/engine/table/layout/fixedEndOverlaySignature.ts +58 -0
  322. package/template/src/components/AppTable/engine/table/layout/fixedEndRuntime.ts +137 -0
  323. package/template/src/components/AppTable/engine/table/layout/handsontableDomAdapter.ts +40 -0
  324. package/template/src/components/AppTable/engine/table/layout/height.ts +72 -0
  325. package/template/src/components/AppTable/engine/table/layout/index.ts +14 -0
  326. package/template/src/components/AppTable/engine/table/layout/layoutScheduler.ts +60 -0
  327. package/template/src/components/AppTable/engine/table/layout/mergeCells.ts +146 -0
  328. package/template/src/components/AppTable/engine/table/layout/nestedHeaders.ts +271 -0
  329. package/template/src/components/AppTable/engine/table/layout/types.ts +10 -0
  330. package/template/src/components/AppTable/engine/toolbar/index.ts +1 -0
  331. package/template/src/components/AppTable/engine/toolbar/types.ts +56 -0
  332. package/template/src/components/AppTable/index.ts +11 -0
  333. package/template/src/components/AppTable/messages.ts +256 -0
  334. package/template/src/components/AppTable/pagination/TablePaginationBar.tsx +193 -0
  335. package/template/src/components/AppTable/pagination/index.ts +1 -0
  336. package/template/src/components/AppTable/pagination/paginationItems.ts +56 -0
  337. package/template/src/components/AppTable/preference/index.ts +1 -0
  338. package/template/src/components/AppTable/preference/useTablePreference.ts +208 -0
  339. package/template/src/components/AppTable/reporting/index.ts +1 -0
  340. package/template/src/components/AppTable/reporting/useTableReporting.ts +342 -0
  341. package/template/src/components/AppTable/search/TableSearchBar.tsx +301 -0
  342. package/template/src/components/AppTable/search/TableSearchConditionEditor.tsx +254 -0
  343. package/template/src/components/AppTable/search/TableSearchField.tsx +338 -0
  344. package/template/src/components/AppTable/search/TableSearchFields.tsx +65 -0
  345. package/template/src/components/AppTable/search/constants.ts +9 -0
  346. package/template/src/components/AppTable/search/index.ts +3 -0
  347. package/template/src/components/AppTable/search/tableSearchBar.css +164 -0
  348. package/template/src/components/AppTable/search/types.ts +7 -0
  349. package/template/src/components/AppTable/search/useTableQuery.ts +373 -0
  350. package/template/src/components/AppTable/selection/index.ts +1 -0
  351. package/template/src/components/AppTable/selection/useTableSelection.ts +188 -0
  352. package/template/src/components/AppTable/sensitiveData.tsx +41 -0
  353. package/template/src/components/AppTable/shared/styles.ts +2 -0
  354. package/template/src/components/AppTable/styles/index.css +6 -0
  355. package/template/src/components/AppTable/styles/tableComponent.css +297 -0
  356. package/template/src/components/AppTable/styles/theme.css +133 -0
  357. package/template/src/components/AppTable/table/components/TableComponent.tsx +567 -0
  358. package/template/src/components/AppTable/table/components/TableErrorFeedback.tsx +36 -0
  359. package/template/src/components/AppTable/table/components/TableGridViewport.tsx +85 -0
  360. package/template/src/components/AppTable/table/components/index.ts +2 -0
  361. package/template/src/components/AppTable/table/components/types.ts +90 -0
  362. package/template/src/components/AppTable/table/controller/configuration.ts +89 -0
  363. package/template/src/components/AppTable/table/controller/index.ts +2 -0
  364. package/template/src/components/AppTable/table/controller/useTableController.ts +155 -0
  365. package/template/src/components/AppTable/table/controller/useTableLifecycle.ts +97 -0
  366. package/template/src/components/AppTable/table/grid/index.ts +1 -0
  367. package/template/src/components/AppTable/table/grid/useTableGrid.ts +857 -0
  368. package/template/src/components/AppTable/table/grid/useTableGridRuntimeSettings.ts +49 -0
  369. package/template/src/components/AppTable/table/index.ts +4 -0
  370. package/template/src/components/AppTable/table/layout/TablePanels.tsx +389 -0
  371. package/template/src/components/AppTable/table/layout/index.ts +7 -0
  372. package/template/src/components/AppTable/table/layout/types.ts +3 -0
  373. package/template/src/components/AppTable/table/layout/useResizablePanel.ts +213 -0
  374. package/template/src/components/AppTable/table/layout/useTableAdaptiveHeight.ts +238 -0
  375. package/template/src/components/AppTable/table/layout/useTablePanels.ts +329 -0
  376. package/template/src/components/AppTable/table/layout/useTableTheme.ts +123 -0
  377. package/template/src/components/AppTable/toolbar/TableToolbar.tsx +336 -0
  378. package/template/src/components/AppTable/toolbar/index.ts +1 -0
  379. package/template/src/components/BrandLogo/BrandLogo.tsx +41 -0
  380. package/template/src/components/BrandLogo/index.ts +1 -0
  381. package/template/src/components/Can/Can.tsx +19 -0
  382. package/template/src/components/Can/index.ts +7 -0
  383. package/template/src/components/Can/types.ts +41 -0
  384. package/template/src/components/EnumBadge/EnumBadge.tsx +44 -0
  385. package/template/src/components/EnumBadge/index.ts +2 -0
  386. package/template/src/components/EnumBadge/types.ts +16 -0
  387. package/template/src/components/EnumText/EnumText.tsx +33 -0
  388. package/template/src/components/EnumText/index.ts +2 -0
  389. package/template/src/components/EnumText/types.ts +13 -0
  390. package/template/src/components/FilePreview/FilePreview.tsx +120 -0
  391. package/template/src/components/FilePreview/index.ts +11 -0
  392. package/template/src/components/FilePreview/preview.ts +88 -0
  393. package/template/src/components/FilePreview/types.ts +91 -0
  394. package/template/src/components/FileUpload/FileUpload.tsx +172 -0
  395. package/template/src/components/FileUpload/index.ts +2 -0
  396. package/template/src/components/FileUpload/types.ts +32 -0
  397. package/template/src/components/JsonEditor/JsonEditor.tsx +103 -0
  398. package/template/src/components/JsonEditor/index.ts +1 -0
  399. package/template/src/components/JsonEditor/types.ts +14 -0
  400. package/template/src/components/PageFeedback/PageFeedback.tsx +194 -0
  401. package/template/src/components/PageFeedback/index.ts +10 -0
  402. package/template/src/components/PageFeedback/types.ts +31 -0
  403. package/template/src/components/PasswordInput/PasswordInput.tsx +50 -0
  404. package/template/src/components/PasswordInput/index.ts +1 -0
  405. package/template/src/components/RouteDialog/RouteDialog.tsx +20 -0
  406. package/template/src/components/RouteDialog/index.ts +2 -0
  407. package/template/src/components/RouteDialog/types.ts +8 -0
  408. package/template/src/components/RouteDialog/useRouteDialogNavigation.ts +30 -0
  409. package/template/src/components/SensitiveData/SensitiveData.tsx +337 -0
  410. package/template/src/components/SensitiveData/index.ts +2 -0
  411. package/template/src/components/SensitiveData/types.ts +31 -0
  412. package/template/src/components/StatusBadge/StatusBadge.tsx +28 -0
  413. package/template/src/components/StatusBadge/index.ts +2 -0
  414. package/template/src/components/StatusBadge/statusBadgeStyles.ts +30 -0
  415. package/template/src/components/StatusBadge/types.ts +7 -0
  416. package/template/src/components/layout/AppHeader/AppHeader.tsx +57 -0
  417. package/template/src/components/layout/AppHeader/HeaderSearch.tsx +160 -0
  418. package/template/src/components/layout/AppHeader/HeaderUserMenu.tsx +59 -0
  419. package/template/src/components/layout/AppHeader/ThemeControls.tsx +44 -0
  420. package/template/src/components/layout/AppHeader/index.ts +1 -0
  421. package/template/src/components/layout/AppHeader/themeOptions.ts +13 -0
  422. package/template/src/components/layout/AppSidebar.tsx +268 -0
  423. package/template/src/components/layout/PageContainer.tsx +16 -0
  424. package/template/src/components/ui/avatar.tsx +108 -0
  425. package/template/src/components/ui/badge.tsx +47 -0
  426. package/template/src/components/ui/button.tsx +63 -0
  427. package/template/src/components/ui/card.tsx +60 -0
  428. package/template/src/components/ui/checkbox.tsx +31 -0
  429. package/template/src/components/ui/collapsible.tsx +33 -0
  430. package/template/src/components/ui/command.tsx +181 -0
  431. package/template/src/components/ui/dialog.tsx +157 -0
  432. package/template/src/components/ui/dropdown-menu.tsx +254 -0
  433. package/template/src/components/ui/form.tsx +141 -0
  434. package/template/src/components/ui/input.tsx +20 -0
  435. package/template/src/components/ui/label.tsx +23 -0
  436. package/template/src/components/ui/pagination.tsx +127 -0
  437. package/template/src/components/ui/popover.tsx +41 -0
  438. package/template/src/components/ui/select.tsx +187 -0
  439. package/template/src/components/ui/separator.tsx +25 -0
  440. package/template/src/components/ui/sheet.tsx +142 -0
  441. package/template/src/components/ui/sidebar.tsx +878 -0
  442. package/template/src/components/ui/skeleton.tsx +13 -0
  443. package/template/src/components/ui/sonner.tsx +33 -0
  444. package/template/src/components/ui/tooltip.tsx +54 -0
  445. package/template/src/config/RuntimeConfigErrorPage.tsx +48 -0
  446. package/template/src/config/appConfig.ts +126 -0
  447. package/template/src/config/buildInfo.ts +8 -0
  448. package/template/src/config/observabilityAdapter.ts +8 -0
  449. package/template/src/config/runtimeConfig.ts +360 -0
  450. package/template/src/config/types.ts +195 -0
  451. package/template/src/context/ThemeProvider.tsx +84 -0
  452. package/template/src/context/UnsavedChangesProvider.tsx +123 -0
  453. package/template/src/context/applicationScope.ts +39 -0
  454. package/template/src/context/types.ts +41 -0
  455. package/template/src/dataMasking/index.ts +14 -0
  456. package/template/src/dataMasking/masking.ts +139 -0
  457. package/template/src/dataMasking/types.ts +144 -0
  458. package/template/src/featureFlags/FeatureFlagProvider.tsx +143 -0
  459. package/template/src/featureFlags/FeatureGate.tsx +12 -0
  460. package/template/src/featureFlags/catalog.ts +140 -0
  461. package/template/src/featureFlags/errors.ts +17 -0
  462. package/template/src/featureFlags/index.ts +43 -0
  463. package/template/src/featureFlags/query.ts +103 -0
  464. package/template/src/featureFlags/registry.ts +149 -0
  465. package/template/src/featureFlags/scope.ts +27 -0
  466. package/template/src/featureFlags/types.ts +241 -0
  467. package/template/src/features/auth/AuthLayout.tsx +17 -0
  468. package/template/src/features/auth/index.ts +2 -0
  469. package/template/src/features/auth/signIn/components/UserAuthForm.tsx +121 -0
  470. package/template/src/features/auth/signIn/index.tsx +71 -0
  471. package/template/src/features/auth/signIn/messages.ts +37 -0
  472. package/template/src/features/auth/signIn/types.ts +4 -0
  473. package/template/src/features/errors/ForbiddenError.tsx +34 -0
  474. package/template/src/features/errors/GeneralError.tsx +46 -0
  475. package/template/src/features/errors/MaintenanceError.tsx +31 -0
  476. package/template/src/features/errors/NotFoundError.tsx +34 -0
  477. package/template/src/features/errors/RouteError.tsx +72 -0
  478. package/template/src/features/errors/UnauthorizedError.tsx +34 -0
  479. package/template/src/features/errors/index.ts +6 -0
  480. package/template/src/features/errors/messages.ts +56 -0
  481. package/template/src/features/home/index.tsx +107 -0
  482. package/template/src/features/home/messages.ts +59 -0
  483. package/template/src/features/showcase/AccessShowcasePage.tsx +284 -0
  484. package/template/src/features/showcase/AdvancedTableDemo.tsx +120 -0
  485. package/template/src/features/showcase/FeedbackShowcasePage.tsx +142 -0
  486. package/template/src/features/showcase/FileShowcasePage.tsx +110 -0
  487. package/template/src/features/showcase/FormShowcasePage.tsx +156 -0
  488. package/template/src/features/showcase/MetadataShowcasePage.tsx +241 -0
  489. package/template/src/features/showcase/ShowcasePageHeader.tsx +24 -0
  490. package/template/src/features/showcase/TableShowcasePage.tsx +436 -0
  491. package/template/src/features/showcase/accessMessages.ts +67 -0
  492. package/template/src/features/showcase/index.ts +6 -0
  493. package/template/src/features/showcase/messages.ts +192 -0
  494. package/template/src/files/download.ts +82 -0
  495. package/template/src/files/errors.ts +15 -0
  496. package/template/src/files/filename.ts +61 -0
  497. package/template/src/files/index.ts +38 -0
  498. package/template/src/files/types.ts +299 -0
  499. package/template/src/files/useFileTask.ts +153 -0
  500. package/template/src/files/useFileUpload.ts +117 -0
  501. package/template/src/files/validation.ts +109 -0
  502. package/template/src/layouts/AppLayout.tsx +37 -0
  503. package/template/src/lib/accessControl.ts +42 -0
  504. package/template/src/lib/navigationRedirect.ts +26 -0
  505. package/template/src/lib/utils.ts +6 -0
  506. package/template/src/locale/LocaleProvider.tsx +37 -0
  507. package/template/src/locale/context.ts +15 -0
  508. package/template/src/locale/formatters.ts +123 -0
  509. package/template/src/locale/hooks.ts +35 -0
  510. package/template/src/locale/index.ts +17 -0
  511. package/template/src/locale/messages.ts +151 -0
  512. package/template/src/locale/types.ts +167 -0
  513. package/template/src/main.tsx +5 -0
  514. package/template/src/observability/browser.ts +37 -0
  515. package/template/src/observability/consoleAdapter.ts +18 -0
  516. package/template/src/observability/index.ts +26 -0
  517. package/template/src/observability/observer.ts +118 -0
  518. package/template/src/observability/redaction.ts +85 -0
  519. package/template/src/observability/types.ts +119 -0
  520. package/template/src/optionalEditors/controller.ts +327 -0
  521. package/template/src/optionalEditors/errors.ts +21 -0
  522. package/template/src/optionalEditors/index.ts +35 -0
  523. package/template/src/optionalEditors/model.ts +253 -0
  524. package/template/src/optionalEditors/react.ts +89 -0
  525. package/template/src/optionalEditors/types.ts +254 -0
  526. package/template/src/permissions/index.ts +3 -0
  527. package/template/src/permissions/types.ts +5 -0
  528. package/template/src/permissions/usePermission.ts +16 -0
  529. package/template/src/realtimeCollaboration/controller.ts +355 -0
  530. package/template/src/realtimeCollaboration/errors.ts +20 -0
  531. package/template/src/realtimeCollaboration/index.ts +39 -0
  532. package/template/src/realtimeCollaboration/model.ts +212 -0
  533. package/template/src/realtimeCollaboration/react.ts +72 -0
  534. package/template/src/realtimeCollaboration/types.ts +251 -0
  535. package/template/src/reporting/errors.ts +21 -0
  536. package/template/src/reporting/generation.ts +87 -0
  537. package/template/src/reporting/index.ts +42 -0
  538. package/template/src/reporting/model.ts +373 -0
  539. package/template/src/reporting/print.ts +16 -0
  540. package/template/src/reporting/query.ts +50 -0
  541. package/template/src/reporting/react.ts +17 -0
  542. package/template/src/reporting/source.ts +13 -0
  543. package/template/src/reporting/types.ts +219 -0
  544. package/template/src/router/RootRouteLayout.tsx +11 -0
  545. package/template/src/router/authLifecycle.ts +39 -0
  546. package/template/src/router/config.ts +293 -0
  547. package/template/src/router/interceptors.ts +48 -0
  548. package/template/src/router/lazyRouteComponents.ts +78 -0
  549. package/template/src/router/messages.ts +48 -0
  550. package/template/src/router/navigation.ts +167 -0
  551. package/template/src/router/router.ts +66 -0
  552. package/template/src/router/searchSchemas.ts +9 -0
  553. package/template/src/router/types.ts +76 -0
  554. package/template/src/stores/authSessionStorage.ts +27 -0
  555. package/template/src/stores/authStore.ts +165 -0
  556. package/template/src/stores/types.ts +36 -0
  557. package/template/src/stores/uiPreferenceStore.ts +34 -0
  558. package/template/src/styles/index.css +141 -0
  559. package/template/src/styles/theme.css +213 -0
  560. package/template/src/tenantWorkspace/TenantWorkspaceProvider.tsx +102 -0
  561. package/template/src/tenantWorkspace/index.ts +33 -0
  562. package/template/src/tenantWorkspace/store.ts +184 -0
  563. package/template/src/tenantWorkspace/switch.ts +206 -0
  564. package/template/src/tenantWorkspace/types.ts +155 -0
  565. package/template/src/vite-env.d.ts +20 -0
  566. package/template/stylelint.config.js +28 -0
  567. package/template/tests/integration/Application.test.tsx +269 -0
  568. package/template/tests/integration/layout/AppHeader.test.tsx +182 -0
  569. package/template/tests/integration/layout/AppSidebar.test.tsx +121 -0
  570. package/template/tests/integration/layout/__screenshots__/AppHeader.test.tsx/AppHeader-command-search-hides-the-duplicate-header-trigger-when-the-desktop-sidebar-collapses-1.png +0 -0
  571. package/template/tests/integration/router/__screenshots__/config.test.ts/route-tree-authentication-boundaries-exposes-only-scaffold-navigation-metadata-1.png +0 -0
  572. package/template/tests/integration/router/config.test.ts +123 -0
  573. package/template/tests/integration/router/interceptors.test.ts +100 -0
  574. package/template/tests/setup/accessibility.ts +25 -0
  575. package/template/tests/setup/runtimeConfig.ts +3 -0
  576. package/template/tests/unit/api/ApiError.test.ts +25 -0
  577. package/template/tests/unit/api/__screenshots__/authSession.test.ts/administrator-authentication-clears-the-session-if-a-refresh-identity-loses-administrator-access-1.png +0 -0
  578. package/template/tests/unit/api/__screenshots__/authSession.test.ts/administrator-authentication-creates-a-session-from-the-generated-login-response-for-an-admin-1.png +0 -0
  579. package/template/tests/unit/api/__screenshots__/authSession.test.ts/administrator-authentication-rejects-and-revokes-the-generated-login-result-for-an-ordinary-user-1.png +0 -0
  580. package/template/tests/unit/api/activity/ActivityProvider.test.tsx +131 -0
  581. package/template/tests/unit/api/activity/__screenshots__/transports.test.ts/activity-transport-adapters-polls-sequentially-and-advances-the-last-event-ID-1.png +0 -0
  582. package/template/tests/unit/api/activity/modelAndQuery.test.ts +144 -0
  583. package/template/tests/unit/api/activity/subscription.test.ts +103 -0
  584. package/template/tests/unit/api/activity/transports.test.ts +145 -0
  585. package/template/tests/unit/api/authClient.test.ts +110 -0
  586. package/template/tests/unit/api/authSession.test.ts +289 -0
  587. package/template/tests/unit/api/clients/configureApiClient.test.ts +198 -0
  588. package/template/tests/unit/api/demoAuthClient.test.ts +47 -0
  589. package/template/tests/unit/api/enums/access.test.ts +107 -0
  590. package/template/tests/unit/api/enums/catalog.test.ts +200 -0
  591. package/template/tests/unit/api/enums/query.test.ts +110 -0
  592. package/template/tests/unit/api/enums/useEnum.test.tsx +98 -0
  593. package/template/tests/unit/api/enums/useEnumCatalog.test.tsx +68 -0
  594. package/template/tests/unit/api/hooks/error.test.ts +168 -0
  595. package/template/tests/unit/api/hooks/request.test.ts +170 -0
  596. package/template/tests/unit/api/hooks/response.test.ts +46 -0
  597. package/template/tests/unit/api/metadata/MetadataProvider.test.tsx +102 -0
  598. package/template/tests/unit/api/parameters/catalog.test.ts +147 -0
  599. package/template/tests/unit/api/parameters/query.test.ts +78 -0
  600. package/template/tests/unit/api/parameters/useGlobalParameter.test.tsx +89 -0
  601. package/template/tests/unit/api/query/queryPolicy.test.ts +245 -0
  602. package/template/tests/unit/api/query/useAppQueryScope.test.tsx +74 -0
  603. package/template/tests/unit/auditLogs/auditLogHooks.test.tsx +194 -0
  604. package/template/tests/unit/auditLogs/auditLogs.test.ts +199 -0
  605. package/template/tests/unit/authentication/__screenshots__/authentication.test.ts/authentication-controller-completes-Step-up-callbacks-without-creating-a-second-login-result-1.png +0 -0
  606. package/template/tests/unit/authentication/__screenshots__/authentication.test.ts/authentication-controller-moves-from-challenge-to-completion-without-retaining-tokens-in-snapshot-1.png +0 -0
  607. package/template/tests/unit/authentication/authentication.test.ts +376 -0
  608. package/template/tests/unit/components/AppDialog.test.tsx +225 -0
  609. package/template/tests/unit/components/AppTable.test.tsx +129 -0
  610. package/template/tests/unit/components/AppTableLayoutTransition.test.ts +118 -0
  611. package/template/tests/unit/components/AppTableLocalization.test.ts +58 -0
  612. package/template/tests/unit/components/AppTableSensitiveData.test.ts +35 -0
  613. package/template/tests/unit/components/AppTableUpgrade.test.tsx +179 -0
  614. package/template/tests/unit/components/AppTableUpgradeCore.test.ts +258 -0
  615. package/template/tests/unit/components/BrandLogo.test.tsx +24 -0
  616. package/template/tests/unit/components/Can.test.tsx +80 -0
  617. package/template/tests/unit/components/Dialog.test.tsx +56 -0
  618. package/template/tests/unit/components/EnumPresentation.test.tsx +64 -0
  619. package/template/tests/unit/components/FilePreviewEngine.test.ts +51 -0
  620. package/template/tests/unit/components/JsonEditor.test.tsx +47 -0
  621. package/template/tests/unit/components/LocalizedSharedComponents.test.tsx +36 -0
  622. package/template/tests/unit/components/OverlayLayer.test.tsx +151 -0
  623. package/template/tests/unit/components/PageFeedback.test.tsx +143 -0
  624. package/template/tests/unit/components/PageForm.test.tsx +272 -0
  625. package/template/tests/unit/components/PageFormCore.test.ts +74 -0
  626. package/template/tests/unit/components/PasswordInput.test.tsx +105 -0
  627. package/template/tests/unit/components/ScaffoldComponents.test.tsx +64 -0
  628. package/template/tests/unit/components/SensitiveData.test.tsx +151 -0
  629. package/template/tests/unit/components/StatusBadge.test.tsx +36 -0
  630. package/template/tests/unit/components/TableComponent.test.tsx +644 -0
  631. package/template/tests/unit/components/TableCore.test.ts +145 -0
  632. package/template/tests/unit/components/ThemeAccessibility.test.tsx +27 -0
  633. package/template/tests/unit/components/__screenshots__/BatchOperationDialog.test.tsx/confirms-a-batch-action-and-presents-partial-failure-details-1.png +0 -0
  634. package/template/tests/unit/components/__screenshots__/PageForm.test.tsx/PageForm-writes-uploaded-values-through-the-public-file-field-and-resets-dirty-state-1.png +0 -0
  635. package/template/tests/unit/components/__screenshots__/PasswordInput.test.tsx/PasswordInput-toggles-the-password-visibility-when-the-show-password-button-is-clicked-1.png +0 -0
  636. package/template/tests/unit/components/__screenshots__/TableComponent.test.tsx/TableComponent-pins-trailing-action-columns-and-removes-their-header-menu-by-default-1.png +0 -0
  637. package/template/tests/unit/components/__screenshots__/TableComponent.test.tsx/TableComponent-renders-shadcn-components-through-cellComponent-1.png +0 -0
  638. package/template/tests/unit/components/__screenshots__/TableComponent.test.tsx/TableComponent-renders-the-toolbar-without-a-bottom-divider-1.png +0 -0
  639. package/template/tests/unit/components/__screenshots__/TableComponent.test.tsx/TableComponent-resyncs-adaptive-height-after-a-column-resize-changes-wrapped-row-height-1.png +0 -0
  640. package/template/tests/unit/config/RuntimeConfigErrorPage.test.tsx +23 -0
  641. package/template/tests/unit/config/appConfig.test.ts +98 -0
  642. package/template/tests/unit/config/appTableContracts.test.mjs +120 -0
  643. package/template/tests/unit/config/bundleBudget.test.mjs +190 -0
  644. package/template/tests/unit/config/componentGovernance.test.mjs +156 -0
  645. package/template/tests/unit/config/deployConfig.test.mjs +211 -0
  646. package/template/tests/unit/config/eslintConfig.test.mjs +101 -0
  647. package/template/tests/unit/config/featureBoundaries.test.mjs +126 -0
  648. package/template/tests/unit/config/npmPackage.test.mjs +37 -0
  649. package/template/tests/unit/config/releaseArtifact.test.mjs +105 -0
  650. package/template/tests/unit/config/runtimeConfig.test.ts +225 -0
  651. package/template/tests/unit/config/scaffoldCheck.test.mjs +53 -0
  652. package/template/tests/unit/config/scaffoldFeature.test.mjs +177 -0
  653. package/template/tests/unit/config/scaffoldInit.test.mjs +218 -0
  654. package/template/tests/unit/config/scaffoldProject.test.mjs +378 -0
  655. package/template/tests/unit/config/scaffoldTransaction.test.mjs +77 -0
  656. package/template/tests/unit/config/viteConfig.test.mjs +371 -0
  657. package/template/tests/unit/context/ThemeProvider.test.tsx +108 -0
  658. package/template/tests/unit/context/UnsavedChangesProvider.test.tsx +94 -0
  659. package/template/tests/unit/context/__screenshots__/ThemeProvider.test.tsx/ThemeProvider-uses-the-neutral-black-palette-for-the-app-and-scoped-table-theme-1.png +0 -0
  660. package/template/tests/unit/context/applicationScope.test.ts +62 -0
  661. package/template/tests/unit/dataMasking/dataMasking.test.ts +95 -0
  662. package/template/tests/unit/featureFlags/featureFlags.test.ts +169 -0
  663. package/template/tests/unit/featureFlags/useFeatureFlag.test.tsx +108 -0
  664. package/template/tests/unit/features/FeatureLocalization.test.tsx +54 -0
  665. package/template/tests/unit/features/RouteError.test.tsx +40 -0
  666. package/template/tests/unit/features/auth/signIn/UserAuthForm.test.tsx +79 -0
  667. package/template/tests/unit/features/auth/signIn/__screenshots__/UserAuthForm.test.tsx/UserAuthForm-passes-validated-values-to-onSubmit-1.png +0 -0
  668. package/template/tests/unit/features/auth/signIn/__screenshots__/UserAuthForm.test.tsx/UserAuthForm-shows-validation-messages-when-submitting-an-empty-form-1.png +0 -0
  669. package/template/tests/unit/files/fileHooks.test.tsx +130 -0
  670. package/template/tests/unit/files/files.test.ts +112 -0
  671. package/template/tests/unit/lib/accessControl.test.ts +69 -0
  672. package/template/tests/unit/locale/locale.test.tsx +90 -0
  673. package/template/tests/unit/observability/browser.test.ts +48 -0
  674. package/template/tests/unit/observability/observer.test.ts +115 -0
  675. package/template/tests/unit/optionalEditors/__screenshots__/useOptionalEditor.test.tsx/useOptionalEditor-fails-permission-precheck-before-loading-the-project-SDK-1.png +0 -0
  676. package/template/tests/unit/optionalEditors/__screenshots__/useOptionalEditor.test.tsx/useOptionalEditor-mounts-a-route-scoped-SDK-into-the-dedicated-host-with-permission-1.png +0 -0
  677. package/template/tests/unit/optionalEditors/optionalEditors.test.ts +313 -0
  678. package/template/tests/unit/optionalEditors/useOptionalEditor.test.tsx +141 -0
  679. package/template/tests/unit/realtimeCollaboration/collaboration.test.ts +240 -0
  680. package/template/tests/unit/realtimeCollaboration/useRealtimeCollaboration.test.tsx +115 -0
  681. package/template/tests/unit/reporting/reporting.test.ts +195 -0
  682. package/template/tests/unit/reporting/reportingHooks.test.tsx +203 -0
  683. package/template/tests/unit/router/authLifecycle.test.ts +55 -0
  684. package/template/tests/unit/router/navigation.test.ts +55 -0
  685. package/template/tests/unit/router/redirects.test.ts +22 -0
  686. package/template/tests/unit/scaffoldFeatureTemplate/featureTemplate.test.ts +42 -0
  687. package/template/tests/unit/scaffoldFeatureTemplate/publicContract.test.ts +28 -0
  688. package/template/tests/unit/scaffoldFeatureTemplate/queries.test.tsx +289 -0
  689. package/template/tests/unit/stores/authStore.test.ts +128 -0
  690. package/template/tests/unit/stores/uiPreferenceStore.test.ts +56 -0
  691. package/template/tests/unit/tenantWorkspace/tenantWorkspace.test.tsx +261 -0
  692. package/template/tools/bundle/budgets.json +48 -0
  693. package/template/tools/bundle/check.mjs +307 -0
  694. package/template/tools/component-governance/check.mjs +703 -0
  695. package/template/tools/component-governance/manifest.json +112 -0
  696. package/template/tools/deployment/browser-smoke.mjs +76 -0
  697. package/template/tools/deployment/browser-smoke.sh +141 -0
  698. package/template/tools/openapi/generate.mjs +268 -0
  699. package/template/tools/openapi/templates/README.md +14 -0
  700. package/template/tools/openapi/templates/base/README.md +7 -0
  701. package/template/tools/openapi/templates/base/data-contracts.eta +44 -0
  702. package/template/tools/openapi/templates/base/http-client.eta +3 -0
  703. package/template/tools/openapi/templates/base/http-clients/axios-http-client.eta +132 -0
  704. package/template/tools/openapi/templates/base/http-clients/fetch-http-client.eta +220 -0
  705. package/template/tools/openapi/templates/base/route-docs.eta +31 -0
  706. package/template/tools/openapi/templates/base/route-name.eta +43 -0
  707. package/template/tools/openapi/templates/base/route-type.eta +22 -0
  708. package/template/tools/openapi/templates/default/README.md +7 -0
  709. package/template/tools/openapi/templates/default/api.eta +67 -0
  710. package/template/tools/openapi/templates/default/http-client.eta +137 -0
  711. package/template/tools/openapi/templates/default/procedure-call.eta +99 -0
  712. package/template/tools/openapi/templates/default/route-docs.eta +40 -0
  713. package/template/tools/openapi/templates/default/route-types.eta +28 -0
  714. package/template/tools/openapi/templates/modular/README.md +7 -0
  715. package/template/tools/openapi/templates/modular/api.eta +28 -0
  716. package/template/tools/openapi/templates/modular/procedure-call.eta +99 -0
  717. package/template/tools/openapi/templates/modular/route-types.eta +18 -0
  718. package/template/tools/release/artifact.mjs +258 -0
  719. package/template/tools/scaffold/add-capability.mjs +409 -0
  720. package/template/tools/scaffold/capability-catalog.json +163 -0
  721. package/template/tools/scaffold/check.mjs +326 -0
  722. package/template/tools/scaffold/create-feature.mjs +444 -0
  723. package/template/tools/scaffold/create-project.mjs +482 -0
  724. package/template/tools/scaffold/init.example.json +64 -0
  725. package/template/tools/scaffold/init.mjs +419 -0
  726. package/template/tools/scaffold/lockfile.mjs +193 -0
  727. package/template/tools/scaffold/templates/feature/index.ts +19 -0
  728. package/template/tools/scaffold/templates/feature/model.ts +142 -0
  729. package/template/tools/scaffold/templates/feature/queries.ts +154 -0
  730. package/template/tools/scaffold/templates/feature/repository.ts +206 -0
  731. package/template/tools/scaffold/templates/feature/types.ts +168 -0
  732. package/template/tools/scaffold/workspace-transaction.mjs +111 -0
  733. package/template/tsconfig.app.json +31 -0
  734. package/template/tsconfig.json +12 -0
  735. package/template/tsconfig.node.json +24 -0
  736. package/template/vite.config.ts +121 -0
@@ -0,0 +1,878 @@
1
+ import * as React from 'react'
2
+ import { cva, type VariantProps } from 'class-variance-authority'
3
+ import { PanelLeftIcon } from 'lucide-react'
4
+ import { Slot } from 'radix-ui'
5
+ import { cn } from '@/lib/utils'
6
+ import { Button } from '@/components/ui/button'
7
+ import { Input } from '@/components/ui/input'
8
+ import { Separator } from '@/components/ui/separator'
9
+ import { Skeleton } from '@/components/ui/skeleton'
10
+ import {
11
+ Tooltip,
12
+ TooltipContent,
13
+ TooltipProvider,
14
+ TooltipTrigger,
15
+ } from '@/components/ui/tooltip'
16
+
17
+ const SIDEBAR_WIDTH_DEFAULT = 256
18
+ const SIDEBAR_WIDTH_MIN = 208
19
+ const SIDEBAR_WIDTH_MAX = 384
20
+ const SIDEBAR_WIDTH_ICON = '3rem'
21
+ const SIDEBAR_KEYBOARD_SHORTCUT = 'b'
22
+
23
+ type SidebarContextProps = {
24
+ state: 'expanded' | 'collapsed'
25
+ open: boolean
26
+ setOpen: (open: boolean) => void
27
+ toggleSidebar: () => void
28
+ nSidebarWidth: number
29
+ fnSetSidebarWidth: (nWidth: number) => void
30
+ }
31
+
32
+ const SidebarContext = React.createContext<SidebarContextProps | null>(null)
33
+
34
+ function useSidebar() {
35
+ const context = React.useContext(SidebarContext)
36
+ if (!context) {
37
+ throw new Error('useSidebar must be used within a SidebarProvider.')
38
+ }
39
+
40
+ return context
41
+ }
42
+
43
+ function SidebarProvider({
44
+ defaultOpen = true,
45
+ defaultWidth = SIDEBAR_WIDTH_DEFAULT,
46
+ open: openProp,
47
+ onOpenChange: setOpenProp,
48
+ width: nWidthProp,
49
+ onWidthChange: fnSetWidthProp,
50
+ className,
51
+ style,
52
+ children,
53
+ ...props
54
+ }: React.ComponentProps<'div'> & {
55
+ defaultOpen?: boolean
56
+ defaultWidth?: number
57
+ open?: boolean
58
+ onOpenChange?: (open: boolean) => void
59
+ width?: number
60
+ onWidthChange?: (nWidth: number) => void
61
+ }) {
62
+ // This is the internal state of the sidebar.
63
+ // We use openProp and setOpenProp for control from outside the component.
64
+ const [_open, _setOpen] = React.useState(defaultOpen)
65
+ const [nInternalSidebarWidth, fnSetSidebarWidthState] = React.useState(() =>
66
+ Math.min(
67
+ SIDEBAR_WIDTH_MAX,
68
+ Math.max(SIDEBAR_WIDTH_MIN, Math.round(defaultWidth))
69
+ )
70
+ )
71
+ const open = openProp ?? _open
72
+ const nSidebarWidth = Math.min(
73
+ SIDEBAR_WIDTH_MAX,
74
+ Math.max(SIDEBAR_WIDTH_MIN, Math.round(nWidthProp ?? nInternalSidebarWidth))
75
+ )
76
+ const setOpen = React.useCallback(
77
+ (value: boolean | ((value: boolean) => boolean)) => {
78
+ const openState = typeof value === 'function' ? value(open) : value
79
+ if (setOpenProp) {
80
+ setOpenProp(openState)
81
+ } else {
82
+ _setOpen(openState)
83
+ }
84
+ },
85
+ [setOpenProp, open]
86
+ )
87
+
88
+ // Helper to toggle the sidebar.
89
+ const toggleSidebar = React.useCallback(() => {
90
+ setOpen((open) => !open)
91
+ }, [setOpen])
92
+
93
+ const fnSetSidebarWidth = React.useCallback(
94
+ (nWidth: number) => {
95
+ const nNextWidth = Math.min(
96
+ SIDEBAR_WIDTH_MAX,
97
+ Math.max(SIDEBAR_WIDTH_MIN, Math.round(nWidth))
98
+ )
99
+
100
+ if (fnSetWidthProp) {
101
+ fnSetWidthProp(nNextWidth)
102
+ } else {
103
+ fnSetSidebarWidthState(nNextWidth)
104
+ }
105
+ },
106
+ [fnSetWidthProp]
107
+ )
108
+
109
+ // Adds a keyboard shortcut to toggle the sidebar.
110
+ React.useEffect(() => {
111
+ const handleKeyDown = (event: KeyboardEvent) => {
112
+ if (
113
+ event.key === SIDEBAR_KEYBOARD_SHORTCUT &&
114
+ (event.metaKey || event.ctrlKey)
115
+ ) {
116
+ event.preventDefault()
117
+ toggleSidebar()
118
+ }
119
+ }
120
+
121
+ window.addEventListener('keydown', handleKeyDown)
122
+ return () => window.removeEventListener('keydown', handleKeyDown)
123
+ }, [toggleSidebar])
124
+
125
+ // We add a state so that we can do data-state="expanded" or "collapsed".
126
+ // This makes it easier to style the sidebar with Tailwind classes.
127
+ const state = open ? 'expanded' : 'collapsed'
128
+
129
+ const contextValue = React.useMemo<SidebarContextProps>(
130
+ () => ({
131
+ state,
132
+ open,
133
+ setOpen,
134
+ toggleSidebar,
135
+ nSidebarWidth,
136
+ fnSetSidebarWidth,
137
+ }),
138
+ [state, open, setOpen, toggleSidebar, nSidebarWidth, fnSetSidebarWidth]
139
+ )
140
+
141
+ return (
142
+ <SidebarContext.Provider value={contextValue}>
143
+ <TooltipProvider delayDuration={0}>
144
+ <div
145
+ data-slot='sidebar-wrapper'
146
+ style={
147
+ {
148
+ '--sidebar-width': `${nSidebarWidth}px`,
149
+ '--sidebar-width-icon': SIDEBAR_WIDTH_ICON,
150
+ ...style,
151
+ } as React.CSSProperties
152
+ }
153
+ className={cn(
154
+ 'group/sidebar-wrapper flex h-svh min-h-0 w-full has-data-[variant=inset]:bg-sidebar',
155
+ className
156
+ )}
157
+ {...props}
158
+ >
159
+ {children}
160
+ </div>
161
+ </TooltipProvider>
162
+ </SidebarContext.Provider>
163
+ )
164
+ }
165
+
166
+ function Sidebar({
167
+ side = 'left',
168
+ variant = 'sidebar',
169
+ collapsible = 'offcanvas',
170
+ className,
171
+ children,
172
+ ...props
173
+ }: React.ComponentProps<'div'> & {
174
+ side?: 'left' | 'right'
175
+ variant?: 'sidebar' | 'floating' | 'inset'
176
+ collapsible?: 'offcanvas' | 'icon' | 'none'
177
+ }) {
178
+ const { state } = useSidebar()
179
+
180
+ if (collapsible === 'none') {
181
+ return (
182
+ <div
183
+ data-slot='sidebar'
184
+ className={cn(
185
+ 'flex h-full w-(--sidebar-width) flex-col bg-sidebar text-sidebar-foreground',
186
+ className
187
+ )}
188
+ {...props}
189
+ >
190
+ {children}
191
+ </div>
192
+ )
193
+ }
194
+
195
+ return (
196
+ <div
197
+ className='group peer block text-sidebar-foreground'
198
+ data-state={state}
199
+ data-collapsible={state === 'collapsed' ? collapsible : ''}
200
+ data-variant={variant}
201
+ data-side={side}
202
+ data-slot='sidebar'
203
+ >
204
+ {/* This element reserves the desktop sidebar width. */}
205
+ <div
206
+ data-slot='sidebar-gap'
207
+ className={cn(
208
+ 'relative w-(--sidebar-width) bg-transparent transition-[width] duration-200 ease-linear',
209
+ 'group-data-[collapsible=offcanvas]:w-0',
210
+ 'group-data-[side=right]:rotate-180',
211
+ variant === 'floating' || variant === 'inset'
212
+ ? 'group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4)))]'
213
+ : 'group-data-[collapsible=icon]:w-(--sidebar-width-icon)'
214
+ )}
215
+ />
216
+ <div
217
+ data-slot='sidebar-container'
218
+ className={cn(
219
+ 'fixed inset-y-0 z-60 flex h-svh w-(--sidebar-width) transition-[left,right,width] duration-200 ease-linear',
220
+ side === 'left'
221
+ ? 'left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]'
222
+ : 'right-0 group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)]',
223
+ // Adjust the padding for floating and inset variants.
224
+ variant === 'floating' || variant === 'inset'
225
+ ? 'p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]'
226
+ : 'group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:border-r group-data-[side=right]:border-l',
227
+ className
228
+ )}
229
+ {...props}
230
+ >
231
+ <div
232
+ data-sidebar='sidebar'
233
+ data-slot='sidebar-inner'
234
+ className='flex h-full w-full flex-col bg-sidebar group-data-[variant=floating]:rounded-lg group-data-[variant=floating]:border group-data-[variant=floating]:border-sidebar-border group-data-[variant=floating]:shadow-sm'
235
+ >
236
+ {children}
237
+ </div>
238
+ </div>
239
+ </div>
240
+ )
241
+ }
242
+
243
+ function SidebarTrigger({
244
+ className,
245
+ onClick,
246
+ ...props
247
+ }: React.ComponentProps<typeof Button>) {
248
+ const { toggleSidebar } = useSidebar()
249
+
250
+ return (
251
+ <Button
252
+ data-sidebar='trigger'
253
+ data-slot='sidebar-trigger'
254
+ variant='ghost'
255
+ size='icon'
256
+ className={cn('size-7', className)}
257
+ onClick={(event) => {
258
+ onClick?.(event)
259
+ toggleSidebar()
260
+ }}
261
+ {...props}
262
+ >
263
+ <PanelLeftIcon />
264
+ <span className='sr-only'>切换侧边栏</span>
265
+ </Button>
266
+ )
267
+ }
268
+
269
+ type TSidebarResizeState = {
270
+ nPointerId: number
271
+ nStartX: number
272
+ nStartWidth: number
273
+ nDirection: 1 | -1
274
+ objWrapper: HTMLElement | null
275
+ strBodyCursor: string
276
+ strBodyUserSelect: string
277
+ arrTransitionElements: Array<{
278
+ objElement: HTMLElement
279
+ strTransition: string
280
+ }>
281
+ }
282
+
283
+ function SidebarRail({
284
+ className,
285
+ onKeyDown: fnOnKeyDown,
286
+ onLostPointerCapture: fnOnLostPointerCapture,
287
+ onPointerCancel: fnOnPointerCancel,
288
+ onPointerDown: fnOnPointerDown,
289
+ onPointerMove: fnOnPointerMove,
290
+ onPointerUp: fnOnPointerUp,
291
+ ...props
292
+ }: React.ComponentProps<'div'>) {
293
+ const { state, nSidebarWidth, fnSetSidebarWidth } = useSidebar()
294
+ const objResizeStateRef = React.useRef<TSidebarResizeState | null>(null)
295
+
296
+ function fnGetResizeDirection(objHandle: HTMLElement): 1 | -1 {
297
+ const strSide = objHandle.closest<HTMLElement>('[data-side]')?.dataset.side
298
+
299
+ return strSide === 'right' ? -1 : 1
300
+ }
301
+
302
+ function fnFinishResize(objHandle: HTMLElement) {
303
+ const objResizeState = objResizeStateRef.current
304
+
305
+ if (!objResizeState) return
306
+
307
+ if (objHandle.hasPointerCapture(objResizeState.nPointerId)) {
308
+ objHandle.releasePointerCapture(objResizeState.nPointerId)
309
+ }
310
+
311
+ document.body.style.cursor = objResizeState.strBodyCursor
312
+ document.body.style.userSelect = objResizeState.strBodyUserSelect
313
+ objResizeState.arrTransitionElements.forEach(
314
+ ({ objElement, strTransition }) => {
315
+ objElement.style.transition = strTransition
316
+ }
317
+ )
318
+ delete objHandle.dataset.resizing
319
+ if (objResizeState.objWrapper) {
320
+ delete objResizeState.objWrapper.dataset.resizing
321
+ }
322
+ objResizeStateRef.current = null
323
+ }
324
+
325
+ React.useEffect(
326
+ () => () => {
327
+ const objResizeState = objResizeStateRef.current
328
+
329
+ if (!objResizeState) return
330
+
331
+ document.body.style.cursor = objResizeState.strBodyCursor
332
+ document.body.style.userSelect = objResizeState.strBodyUserSelect
333
+ objResizeState.arrTransitionElements.forEach(
334
+ ({ objElement, strTransition }) => {
335
+ objElement.style.transition = strTransition
336
+ }
337
+ )
338
+ if (objResizeState.objWrapper) {
339
+ delete objResizeState.objWrapper.dataset.resizing
340
+ }
341
+ },
342
+ []
343
+ )
344
+
345
+ return (
346
+ <div
347
+ data-sidebar='rail'
348
+ data-slot='sidebar-rail'
349
+ role='separator'
350
+ aria-label='调整侧边栏宽度'
351
+ aria-orientation='vertical'
352
+ aria-valuemin={SIDEBAR_WIDTH_MIN}
353
+ aria-valuemax={SIDEBAR_WIDTH_MAX}
354
+ aria-valuenow={nSidebarWidth}
355
+ tabIndex={state === 'expanded' ? 0 : -1}
356
+ title='拖动调整侧边栏宽度'
357
+ onPointerDown={(objEvent) => {
358
+ fnOnPointerDown?.(objEvent)
359
+ if (
360
+ objEvent.defaultPrevented ||
361
+ !objEvent.isPrimary ||
362
+ objEvent.button !== 0 ||
363
+ state !== 'expanded'
364
+ ) {
365
+ return
366
+ }
367
+
368
+ objEvent.preventDefault()
369
+ const objHandle = objEvent.currentTarget
370
+ const objWrapper = objHandle.closest<HTMLElement>(
371
+ '[data-slot=sidebar-wrapper]'
372
+ )
373
+ const arrTransitionElements = Array.from(
374
+ objWrapper?.querySelectorAll<HTMLElement>(
375
+ '[data-slot=sidebar-gap], [data-slot=sidebar-container]'
376
+ ) ?? []
377
+ ).map((objElement) => ({
378
+ objElement,
379
+ strTransition: objElement.style.transition,
380
+ }))
381
+
382
+ objHandle.setPointerCapture(objEvent.pointerId)
383
+ objHandle.dataset.resizing = 'true'
384
+ if (objWrapper) objWrapper.dataset.resizing = 'true'
385
+ objResizeStateRef.current = {
386
+ nPointerId: objEvent.pointerId,
387
+ nStartX: objEvent.clientX,
388
+ nStartWidth: nSidebarWidth,
389
+ nDirection: fnGetResizeDirection(objHandle),
390
+ objWrapper,
391
+ strBodyCursor: document.body.style.cursor,
392
+ strBodyUserSelect: document.body.style.userSelect,
393
+ arrTransitionElements,
394
+ }
395
+ arrTransitionElements.forEach(({ objElement }) => {
396
+ objElement.style.transition = 'none'
397
+ })
398
+ document.body.style.cursor = 'col-resize'
399
+ document.body.style.userSelect = 'none'
400
+ }}
401
+ onPointerMove={(objEvent) => {
402
+ fnOnPointerMove?.(objEvent)
403
+ const objResizeState = objResizeStateRef.current
404
+
405
+ if (
406
+ objEvent.defaultPrevented ||
407
+ !objResizeState ||
408
+ objResizeState.nPointerId !== objEvent.pointerId
409
+ ) {
410
+ return
411
+ }
412
+
413
+ objEvent.preventDefault()
414
+ fnSetSidebarWidth(
415
+ objResizeState.nStartWidth +
416
+ (objEvent.clientX - objResizeState.nStartX) *
417
+ objResizeState.nDirection
418
+ )
419
+ }}
420
+ onPointerUp={(objEvent) => {
421
+ fnOnPointerUp?.(objEvent)
422
+ fnFinishResize(objEvent.currentTarget)
423
+ }}
424
+ onPointerCancel={(objEvent) => {
425
+ fnOnPointerCancel?.(objEvent)
426
+ fnFinishResize(objEvent.currentTarget)
427
+ }}
428
+ onLostPointerCapture={(objEvent) => {
429
+ fnOnLostPointerCapture?.(objEvent)
430
+ fnFinishResize(objEvent.currentTarget)
431
+ }}
432
+ onKeyDown={(objEvent) => {
433
+ fnOnKeyDown?.(objEvent)
434
+ if (objEvent.defaultPrevented || state !== 'expanded') return
435
+
436
+ const nDirection = fnGetResizeDirection(objEvent.currentTarget)
437
+ const nStep = objEvent.shiftKey ? 24 : 8
438
+
439
+ if (objEvent.key === 'Home') {
440
+ objEvent.preventDefault()
441
+ fnSetSidebarWidth(SIDEBAR_WIDTH_MIN)
442
+ } else if (objEvent.key === 'End') {
443
+ objEvent.preventDefault()
444
+ fnSetSidebarWidth(SIDEBAR_WIDTH_MAX)
445
+ } else if (objEvent.key === 'ArrowLeft') {
446
+ objEvent.preventDefault()
447
+ fnSetSidebarWidth(nSidebarWidth - nStep * nDirection)
448
+ } else if (objEvent.key === 'ArrowRight') {
449
+ objEvent.preventDefault()
450
+ fnSetSidebarWidth(nSidebarWidth + nStep * nDirection)
451
+ }
452
+ }}
453
+ className={cn(
454
+ 'absolute inset-y-0 z-20 w-4 -translate-x-1/2 cursor-col-resize touch-none outline-none select-none group-data-[side=left]:-right-4 group-data-[side=right]:left-0 after:absolute after:inset-y-0 after:left-1/2 after:w-px hover:after:bg-sidebar-ring focus-visible:after:bg-sidebar-ring data-[resizing=true]:after:bg-sidebar-ring',
455
+ 'group-data-[collapsible=icon]:pointer-events-none group-data-[collapsible=icon]:opacity-0',
456
+ className
457
+ )}
458
+ {...props}
459
+ />
460
+ )
461
+ }
462
+
463
+ function SidebarInset({ className, ...props }: React.ComponentProps<'div'>) {
464
+ return (
465
+ <div
466
+ data-slot='sidebar-inset'
467
+ className={cn(
468
+ 'relative flex min-h-0 w-full flex-1 flex-col bg-background',
469
+ 'peer-data-[variant=inset]:m-2 peer-data-[variant=inset]:ml-0 peer-data-[variant=inset]:rounded-xl peer-data-[variant=inset]:shadow-sm peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2',
470
+ className
471
+ )}
472
+ {...props}
473
+ />
474
+ )
475
+ }
476
+
477
+ function SidebarInput({
478
+ className,
479
+ ...props
480
+ }: React.ComponentProps<typeof Input>) {
481
+ return (
482
+ <Input
483
+ data-slot='sidebar-input'
484
+ data-sidebar='input'
485
+ className={cn('h-8 w-full bg-background shadow-none', className)}
486
+ {...props}
487
+ />
488
+ )
489
+ }
490
+
491
+ function SidebarHeader({ className, ...props }: React.ComponentProps<'div'>) {
492
+ return (
493
+ <div
494
+ data-slot='sidebar-header'
495
+ data-sidebar='header'
496
+ className={cn('flex flex-col gap-2 p-2', className)}
497
+ {...props}
498
+ />
499
+ )
500
+ }
501
+
502
+ function SidebarFooter({ className, ...props }: React.ComponentProps<'div'>) {
503
+ return (
504
+ <div
505
+ data-slot='sidebar-footer'
506
+ data-sidebar='footer'
507
+ className={cn('flex flex-col gap-2 p-2', className)}
508
+ {...props}
509
+ />
510
+ )
511
+ }
512
+
513
+ function SidebarSeparator({
514
+ className,
515
+ ...props
516
+ }: React.ComponentProps<typeof Separator>) {
517
+ return (
518
+ <Separator
519
+ data-slot='sidebar-separator'
520
+ data-sidebar='separator'
521
+ className={cn('mx-2 w-auto bg-sidebar-border', className)}
522
+ {...props}
523
+ />
524
+ )
525
+ }
526
+
527
+ function SidebarContent({ className, ...props }: React.ComponentProps<'div'>) {
528
+ return (
529
+ <div
530
+ data-slot='sidebar-content'
531
+ data-sidebar='content'
532
+ className={cn(
533
+ 'flex min-h-0 flex-1 flex-col gap-2 overflow-auto group-data-[collapsible=icon]:overflow-hidden',
534
+ className
535
+ )}
536
+ {...props}
537
+ />
538
+ )
539
+ }
540
+
541
+ function SidebarGroup({ className, ...props }: React.ComponentProps<'div'>) {
542
+ return (
543
+ <div
544
+ data-slot='sidebar-group'
545
+ data-sidebar='group'
546
+ className={cn('relative flex w-full min-w-0 flex-col p-2', className)}
547
+ {...props}
548
+ />
549
+ )
550
+ }
551
+
552
+ function SidebarGroupLabel({
553
+ className,
554
+ asChild = false,
555
+ ...props
556
+ }: React.ComponentProps<'div'> & { asChild?: boolean }) {
557
+ const Comp = asChild ? Slot.Root : 'div'
558
+
559
+ return (
560
+ <Comp
561
+ data-slot='sidebar-group-label'
562
+ data-sidebar='group-label'
563
+ className={cn(
564
+ 'flex h-8 shrink-0 items-center rounded-md px-2 text-xs font-medium text-sidebar-foreground/70 ring-sidebar-ring outline-hidden transition-[margin,opacity] duration-200 ease-linear focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0',
565
+ 'group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0',
566
+ className
567
+ )}
568
+ {...props}
569
+ />
570
+ )
571
+ }
572
+
573
+ function SidebarGroupAction({
574
+ className,
575
+ asChild = false,
576
+ ...props
577
+ }: React.ComponentProps<'button'> & { asChild?: boolean }) {
578
+ const Comp = asChild ? Slot.Root : 'button'
579
+
580
+ return (
581
+ <Comp
582
+ data-slot='sidebar-group-action'
583
+ data-sidebar='group-action'
584
+ className={cn(
585
+ 'absolute top-3.5 right-3 flex aspect-square w-5 items-center justify-center rounded-md p-0 text-sidebar-foreground ring-sidebar-ring outline-hidden transition-transform hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0',
586
+ 'group-data-[collapsible=icon]:hidden',
587
+ className
588
+ )}
589
+ {...props}
590
+ />
591
+ )
592
+ }
593
+
594
+ function SidebarGroupContent({
595
+ className,
596
+ ...props
597
+ }: React.ComponentProps<'div'>) {
598
+ return (
599
+ <div
600
+ data-slot='sidebar-group-content'
601
+ data-sidebar='group-content'
602
+ className={cn('w-full text-sm', className)}
603
+ {...props}
604
+ />
605
+ )
606
+ }
607
+
608
+ function SidebarMenu({ className, ...props }: React.ComponentProps<'ul'>) {
609
+ return (
610
+ <ul
611
+ data-slot='sidebar-menu'
612
+ data-sidebar='menu'
613
+ className={cn('flex w-full min-w-0 flex-col gap-1', className)}
614
+ {...props}
615
+ />
616
+ )
617
+ }
618
+
619
+ function SidebarMenuItem({ className, ...props }: React.ComponentProps<'li'>) {
620
+ return (
621
+ <li
622
+ data-slot='sidebar-menu-item'
623
+ data-sidebar='menu-item'
624
+ className={cn('group/menu-item relative', className)}
625
+ {...props}
626
+ />
627
+ )
628
+ }
629
+
630
+ const sidebarMenuButtonVariants = cva(
631
+ 'peer/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md p-2 text-left text-sm ring-sidebar-ring outline-hidden transition-[width,height,padding] group-has-data-[sidebar=menu-action]/menu-item:pr-8 group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:p-2! hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-[active=true]:bg-sidebar-primary data-[active=true]:font-medium data-[active=true]:text-sidebar-primary-foreground data-[active=true]:hover:bg-sidebar-primary data-[active=true]:hover:text-sidebar-primary-foreground [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0',
632
+ {
633
+ variants: {
634
+ variant: {
635
+ default: 'hover:bg-sidebar-accent hover:text-sidebar-accent-foreground',
636
+ outline:
637
+ 'bg-background shadow-[0_0_0_1px_var(--sidebar-border)] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground hover:shadow-[0_0_0_1px_var(--sidebar-accent)]',
638
+ },
639
+ size: {
640
+ default: 'h-8 text-sm',
641
+ sm: 'h-7 text-xs',
642
+ lg: 'h-12 text-sm group-data-[collapsible=icon]:p-0!',
643
+ },
644
+ },
645
+ defaultVariants: {
646
+ variant: 'default',
647
+ size: 'default',
648
+ },
649
+ }
650
+ )
651
+
652
+ function SidebarMenuButton({
653
+ asChild = false,
654
+ isActive = false,
655
+ variant = 'default',
656
+ size = 'default',
657
+ tooltip,
658
+ className,
659
+ ...props
660
+ }: React.ComponentProps<'button'> & {
661
+ asChild?: boolean
662
+ isActive?: boolean
663
+ tooltip?: string | React.ComponentProps<typeof TooltipContent>
664
+ } & VariantProps<typeof sidebarMenuButtonVariants>) {
665
+ const Comp = asChild ? Slot.Root : 'button'
666
+ const { state } = useSidebar()
667
+
668
+ const button = (
669
+ <Comp
670
+ data-slot='sidebar-menu-button'
671
+ data-sidebar='menu-button'
672
+ data-size={size}
673
+ data-active={isActive}
674
+ className={cn(sidebarMenuButtonVariants({ variant, size }), className)}
675
+ {...props}
676
+ />
677
+ )
678
+
679
+ if (!tooltip) {
680
+ return button
681
+ }
682
+
683
+ if (typeof tooltip === 'string') {
684
+ tooltip = {
685
+ children: tooltip,
686
+ }
687
+ }
688
+
689
+ return (
690
+ <Tooltip>
691
+ <TooltipTrigger asChild>{button}</TooltipTrigger>
692
+ <TooltipContent
693
+ side='right'
694
+ align='center'
695
+ hidden={state !== 'collapsed'}
696
+ {...tooltip}
697
+ />
698
+ </Tooltip>
699
+ )
700
+ }
701
+
702
+ function SidebarMenuAction({
703
+ className,
704
+ asChild = false,
705
+ showOnHover = false,
706
+ ...props
707
+ }: React.ComponentProps<'button'> & {
708
+ asChild?: boolean
709
+ showOnHover?: boolean
710
+ }) {
711
+ const Comp = asChild ? Slot.Root : 'button'
712
+
713
+ return (
714
+ <Comp
715
+ data-slot='sidebar-menu-action'
716
+ data-sidebar='menu-action'
717
+ className={cn(
718
+ 'absolute top-1.5 right-1 flex aspect-square w-5 items-center justify-center rounded-md p-0 text-sidebar-foreground ring-sidebar-ring outline-hidden transition-transform peer-hover/menu-button:text-sidebar-accent-foreground hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0',
719
+ 'peer-data-[size=sm]/menu-button:top-1',
720
+ 'peer-data-[size=default]/menu-button:top-1.5',
721
+ 'peer-data-[size=lg]/menu-button:top-2.5',
722
+ 'group-data-[collapsible=icon]:hidden',
723
+ showOnHover &&
724
+ 'opacity-0 group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 peer-data-[active=true]/menu-button:text-sidebar-primary-foreground data-[state=open]:opacity-100',
725
+ className
726
+ )}
727
+ {...props}
728
+ />
729
+ )
730
+ }
731
+
732
+ function SidebarMenuBadge({
733
+ className,
734
+ ...props
735
+ }: React.ComponentProps<'div'>) {
736
+ return (
737
+ <div
738
+ data-slot='sidebar-menu-badge'
739
+ data-sidebar='menu-badge'
740
+ className={cn(
741
+ 'pointer-events-none absolute right-1 flex h-5 min-w-5 items-center justify-center rounded-md px-1 text-xs font-medium text-sidebar-foreground tabular-nums select-none',
742
+ 'peer-hover/menu-button:text-sidebar-accent-foreground peer-data-[active=true]/menu-button:text-sidebar-primary-foreground',
743
+ 'peer-data-[size=sm]/menu-button:top-1',
744
+ 'peer-data-[size=default]/menu-button:top-1.5',
745
+ 'peer-data-[size=lg]/menu-button:top-2.5',
746
+ 'group-data-[collapsible=icon]:hidden',
747
+ className
748
+ )}
749
+ {...props}
750
+ />
751
+ )
752
+ }
753
+
754
+ function SidebarMenuSkeleton({
755
+ className,
756
+ showIcon = false,
757
+ ...props
758
+ }: React.ComponentProps<'div'> & {
759
+ showIcon?: boolean
760
+ }) {
761
+ // Random width between 50 to 90%.
762
+ const width = React.useMemo(() => {
763
+ return `${Math.floor(Math.random() * 40) + 50}%`
764
+ }, [])
765
+
766
+ return (
767
+ <div
768
+ data-slot='sidebar-menu-skeleton'
769
+ data-sidebar='menu-skeleton'
770
+ className={cn('flex h-8 items-center gap-2 rounded-md px-2', className)}
771
+ {...props}
772
+ >
773
+ {showIcon && (
774
+ <Skeleton
775
+ className='size-4 rounded-md'
776
+ data-sidebar='menu-skeleton-icon'
777
+ />
778
+ )}
779
+ <Skeleton
780
+ className='h-4 max-w-(--skeleton-width) flex-1'
781
+ data-sidebar='menu-skeleton-text'
782
+ style={
783
+ {
784
+ '--skeleton-width': width,
785
+ } as React.CSSProperties
786
+ }
787
+ />
788
+ </div>
789
+ )
790
+ }
791
+
792
+ function SidebarMenuSub({ className, ...props }: React.ComponentProps<'ul'>) {
793
+ return (
794
+ <ul
795
+ data-slot='sidebar-menu-sub'
796
+ data-sidebar='menu-sub'
797
+ className={cn(
798
+ 'mx-3.5 flex min-w-0 translate-x-px flex-col gap-1 border-l border-sidebar-border px-2.5 py-0.5',
799
+ 'group-data-[collapsible=icon]:hidden',
800
+ className
801
+ )}
802
+ {...props}
803
+ />
804
+ )
805
+ }
806
+
807
+ function SidebarMenuSubItem({
808
+ className,
809
+ ...props
810
+ }: React.ComponentProps<'li'>) {
811
+ return (
812
+ <li
813
+ data-slot='sidebar-menu-sub-item'
814
+ data-sidebar='menu-sub-item'
815
+ className={cn('group/menu-sub-item relative', className)}
816
+ {...props}
817
+ />
818
+ )
819
+ }
820
+
821
+ function SidebarMenuSubButton({
822
+ asChild = false,
823
+ size = 'md',
824
+ isActive = false,
825
+ className,
826
+ ...props
827
+ }: React.ComponentProps<'a'> & {
828
+ asChild?: boolean
829
+ size?: 'sm' | 'md'
830
+ isActive?: boolean
831
+ }) {
832
+ const Comp = asChild ? Slot.Root : 'a'
833
+
834
+ return (
835
+ <Comp
836
+ data-slot='sidebar-menu-sub-button'
837
+ data-sidebar='menu-sub-button'
838
+ data-size={size}
839
+ data-active={isActive}
840
+ className={cn(
841
+ 'flex h-7 min-w-0 -translate-x-px items-center gap-2 overflow-hidden rounded-md px-2 text-sidebar-foreground ring-sidebar-ring outline-hidden hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0 [&>svg]:text-current',
842
+ 'data-[active=true]:bg-sidebar-primary data-[active=true]:text-sidebar-primary-foreground data-[active=true]:hover:bg-sidebar-primary data-[active=true]:hover:text-sidebar-primary-foreground',
843
+ size === 'sm' && 'text-xs',
844
+ size === 'md' && 'text-sm',
845
+ 'group-data-[collapsible=icon]:hidden',
846
+ className
847
+ )}
848
+ {...props}
849
+ />
850
+ )
851
+ }
852
+
853
+ export {
854
+ Sidebar,
855
+ SidebarContent,
856
+ SidebarFooter,
857
+ SidebarGroup,
858
+ SidebarGroupAction,
859
+ SidebarGroupContent,
860
+ SidebarGroupLabel,
861
+ SidebarHeader,
862
+ SidebarInput,
863
+ SidebarInset,
864
+ SidebarMenu,
865
+ SidebarMenuAction,
866
+ SidebarMenuBadge,
867
+ SidebarMenuButton,
868
+ SidebarMenuItem,
869
+ SidebarMenuSkeleton,
870
+ SidebarMenuSub,
871
+ SidebarMenuSubButton,
872
+ SidebarMenuSubItem,
873
+ SidebarProvider,
874
+ SidebarRail,
875
+ SidebarSeparator,
876
+ SidebarTrigger,
877
+ useSidebar,
878
+ }