@nucleus-suite-pe/core 0.1.0

package/README.md

@@ -0,0 +1,71 @@
+# @nucleus-suite-pe/core
+
+Capa compartida de la suite Nucleus. Una aplicación que la instala recibe, ya resueltos:
+
+- **Sesión única.** El usuario inicia sesión una sola vez en el landing; la app la hereda por cookie.
+- **Menú y permisos.** El menú lateral lo devuelve la API de seguridad según el rol del usuario en la sede.
+- **Tema.** Catorce temas, claro y oscuro, con preset de PrimeNG.
+- **Marco.** `<nucleus-shell>` trae la barra superior, el lanzador de aplicaciones, el menú lateral y los ajustes.
+
+## Instalación
+
+```bash
+npm install @nucleus-suite-pe/core
+```
+
+Requiere Angular 21, PrimeNG 21 y `@primeuix/themes` 3 como dependencias del proyecto.
+
+## Uso mínimo
+
+`public/config.json`:
+
+```json
+{
+  "appId": "00000000-0000-0000-0000-000000000000",
+  "securityApiUrl": "https://api.nucleus-suite.com/api",
+  "appApiUrl": null,
+  "landingUrl": "https://nucleus-suite.com/"
+}
+```
+
+`src/main.ts`:
+
+```ts
+import { loadNucleusConfig, provideNucleus } from '@nucleus-suite-pe/core';
+
+loadNucleusConfig().then((config) =>
+  bootstrapApplication(App, {
+    ...appConfig,
+    providers: [...appConfig.providers, provideNucleus(config)],
+  }),
+);
+```
+
+`src/app/app.config.ts`:
+
+```ts
+import { nucleusAuthInterceptor, provideNucleusTheme } from '@nucleus-suite-pe/core';
+
+providers: [
+  provideHttpClient(withFetch(), withInterceptors([nucleusAuthInterceptor])),
+  provideNucleusTheme(),
+];
+```
+
+`angular.json`, en `styles`:
+
+```json
+"node_modules/@nucleus-suite-pe/core/styles/tokens.css"
+```
+
+Y cualquier pantalla:
+
+```html
+<nucleus-shell brand="MI APP" [heading]="titulo()">
+  <!-- tu contenido -->
+</nucleus-shell>
+```
+
+## Estado
+
+Versión `0.x`: la interfaz pública todavía puede cambiar entre versiones menores.