@lgsm/modules 1.6.20-beta.2 → 1.6.20-beta.4

package/README.md

@@ -6,6 +6,66 @@ Project using **React component library**, with **Vite**, **TypeScript** and **S
 
 Link download : https://www.npmjs.com/package/@lgsm/modules
 
+## Shared HRIS tables
+
+`DataTable`, `ServerTable`, `SortableHeader` and their configuration types now live
+in this package. `Input`, `Badge`, the `DropdownMenu` primitives and `BaseButton`
+are also exported. `BaseButton` uses children/variant/size; the existing branded
+`Button` keeps its label/primary API.
+
+```tsx
+import { DataTable, type ColumnConfig } from '@lgsm/modules'
+
+const columns: ColumnConfig[] = [{ key: 'name', label: 'Name', type: 'text' }]
+
+<DataTable
+  columns={columns}
+  data={rows}
+  permissions={{ canCreate, canModify, canDelete }}
+  onSave={handleSave}
+/>
+```
+
+The app supplies data, column definitions, validation, save callbacks and access
+flags. Missing permissions make the built-in editing actions read-only. Custom
+`headerActions` and custom cell renderers remain the app's responsibility.
+The table does not import HRIS stores, routes, layouts or LMS services. Its
+supporting UI and CSS are included in the library build.
+Library utilities are scoped to `[data-lgsm-ui]`. Public UI roots and portal
+content carry this attribute so their CSS cannot hide or resize the host shell.
+Keep it on new public components and on content rendered through a portal.
+
+HRIS keeps a small adapter in `src/components/data-table/adapters.tsx` that reads
+its menu permissions. The LMS remote receives access from the federation host
+and passes it to the same shared table. Layout, sidebar, breadcrumbs, profile
+and authentication remain in HRIS; LMS Settings business logic remains in LMS.
+
+### Local verification before publishing
+
+The two apps currently use `"@lgsm/modules": "file:../lampung-fe"`. Keep the three
+repositories beside each other. After changing this library, build it and refresh
+the installed local package in both apps:
+
+```powershell
+# lampung-fe
+bun run build
+
+# hris-admin-fe and admin-lms-fe, each in its own terminal
+bun install --force
+bun run dev
+```
+
+Keep both app dev servers running. Edits to LMS page code use federation hot
+updates; they do not require rebuilding this library. Library source changes do
+require its build and a package refresh because the apps consume `dist`.
+
+Before CI/CD, publish a new package version and replace the local `file:`
+dependency in both apps with that version. Nothing is published by local
+installation. Federation still loads the separately deployed LMS remote at
+runtime; npm provides the shared table implementation to the app builds.
+
+Focused checks: `bun run test --run src/shared-ui/DataTable/DataTable.test.tsx`.
+
 ## Features
 
 - ⚛️ **React** component library with **TypeScript**.
@@ -75,4 +135,4 @@ Please refer to:
 ### For API Service
 src > usage-example > example-apiService.tsx
 ### For Components
-src > usage-example > example-components.tsx
+src > usage-example > example-components.tsx