@praxisui/core 1.0.0-beta.30 → 1.0.0-beta.40

package/README.md

@@ -115,6 +115,99 @@ Observação: os IDs de widgets usados na página devem estar registrados via `C
   [`public-api.ts`](https://github.com/codexrodrigues/praxis/blob/main/frontend-libs/praxis-ui-workspace/projects/praxis-core/src/public-api.ts)
   para a lista consolidada de serviços, tokens, modelos e utilitários disponíveis para importação.
 
+## ⚙️ Global Config (bootstrap)
+
+- Use `provideGlobalConfigTenant(...)` para definir o tenant e bloquear o bootstrap até a config remota ser carregada.
+- Se não houver tenant, use `provideGlobalConfigReady()` para apenas aguardar o carregamento remoto.
+
+## 🌐 Global Actions (shell + widgets)
+
+O core agora suporta **ações globais** executadas por widgets e pelo Widget Shell, permitindo integrar navegação, dialog, toast, analytics, API e rotas dinâmicas de forma padronizada.
+
+### 1) Providers (plug-and-play no host)
+
+```ts
+import {
+  providePraxisGlobalActions,
+  providePraxisToastGlobalActions,
+  providePraxisAnalyticsGlobalActions,
+} from '@praxisui/core';
+import { providePraxisDialogGlobalActions } from '@praxisui/dialog';
+
+providers: [
+  ...providePraxisGlobalActions({ dialog: false, toast: false, analytics: false }),
+  providePraxisDialogGlobalActions(),
+  providePraxisToastGlobalActions(),
+  providePraxisAnalyticsGlobalActions({ prefix: 'app' }),
+]
+```
+
+### 2) Mapeando outputs para ações globais
+
+`WidgetDefinition.outputs` pode apontar para ações globais:
+
+```ts
+definition: {
+  id: 'praxis-dynamic-form',
+  outputs: {
+    formSubmit: {
+      type: 'api.post',
+      params: { url: '/api/clientes', body: '${payload.formData}' }
+    }
+  }
+}
+```
+
+### 3) Ação global no Widget Shell
+
+```ts
+shell: {
+  actions: [
+    { id: 'back', icon: 'arrow_back', command: 'global:navigation.back' }
+  ]
+}
+```
+
+### 4) Catálogo básico de ações globais
+
+- `navigation.back`
+- `navigation.openExternal` → `{ url }`
+- `dialog.alert` → `{ title, message, variant }`
+- `dialog.prompt` → `{ title, message, placeholder, defaultValue }`
+- `dialog.open` → `{ componentId, inputs, size, data }`
+- `toast.success` / `toast.error` → `{ message }`
+- `clipboard.copy` → `{ text }`
+- `trackEvent` → `{ eventName, payload }`
+- `log` → `{ level, message, payload }`
+- `api.get` / `api.post` / `api.patch` → `{ url, params|body }`
+- `route.register` → `{ path, componentId|loadChildren, data?, resolve?, guards?, canMatch?, canActivateChild?, replace?, position? }`
+
+### 5) Rotas dinâmicas (route.register)
+
+Requer `componentId` **ou** `loadChildren`. Guards são resolvidos pelo host via `GLOBAL_ROUTE_GUARD_RESOLVER`.
+
+```ts
+// payload
+{
+  path: '/clientes/novo',
+  componentId: 'praxis-dynamic-page',
+  data: { pageId: 'clientes-novo' },
+  guards: ['auth', 'permission:clientes.create'],
+  position: 'before-wildcard'
+}
+```
+
+As rotas registradas são persistidas em `GlobalConfig.routes.dynamic`. O host deve re‑hidratar isso no bootstrap (ex.: ler `GlobalConfigService` e re‑aplicar com `route.register`).
+
+### 7) Output mapeado para ação global x conexões
+
+Quando `WidgetDefinition.outputs[output]` aponta para uma ação global (não `'emit'`), o evento **não** é repassado para conexões locais — a ação global tem prioridade.
+
+### 6) Estilo de toast
+
+O estilo padrão usa as classes `.pdx-toast-success` / `.pdx-toast-error`.  
+Inclua estilos equivalentes no app host (ou sobrescreva com `providePraxisToastGlobalActions`).
+
 ## 🔎 Schema Viewer (para Showcases)
 
 Para exibir os metadados e schemas usados por um exemplo (ex.: na aba “Schema” de um showcase), use o componente `SchemaViewerComponent` e (opcionalmente) injete o contexto via `SCHEMA_VIEWER_CONTEXT`.
@@ -130,7 +223,7 @@ import { SchemaViewerComponent, SCHEMA_VIEWER_CONTEXT } from '@praxisui/core';
   imports: [PraxisTabs, SchemaViewerComponent],
   template: `
     <!-- Aba Preview -->
-    <praxis-tabs [config]="tabs"></praxis-tabs>
+    <praxis-tabs [config]="tabs" tabsId="tabs-preview"></praxis-tabs>
 
     <!-- Aba Schema -->
     <praxis-schema-viewer [context]="schemaCtx"></praxis-schema-viewer>