@praxisui/core 1.0.0-beta.1 → 1.0.0-beta.11

package/README.md

@@ -1,17 +1,24 @@
-# @praxis/core
+# @praxisui/core
 
 > Biblioteca central com interfaces e serviços fundamentais para o Praxis UI Workspace
 
+## 🔰 Exemplos / Quickstart
+
+Para ver esta biblioteca em funcionamento em uma aplicação completa, utilize o projeto de exemplo (Quickstart):
+
+- Repositório: https://github.com/codexrodrigues/praxis-ui-quickstart
+- O Quickstart demonstra a integração das bibliotecas `@praxisui/*` em um app Angular, incluindo instalação, configuração e uso em telas reais.
+
 ## 🌟 Visão Geral
 
-A biblioteca `@praxis/core` é o núcleo do Praxis UI Workspace, fornecendo interfaces robustas, serviços base e utilitários essenciais para todas as outras bibliotecas do ecossistema. Com a arquitetura unificada, oferece uma experiência de desenvolvimento consistente e type-safe.
+A biblioteca `@praxisui/core` é o núcleo do Praxis UI Workspace, fornecendo interfaces robustas, serviços base e utilitários essenciais para todas as outras bibliotecas do ecossistema. Com a arquitetura unificada, oferece uma experiência de desenvolvimento consistente e type-safe.
 
 ### Concept Usage
 
-- [Dynamic Component Rendering](../../../../docs/concepts/dynamic-component-rendering.md)
-- [Headless UI & Design Systems](../../../../docs/concepts/headless-ui-and-design-systems.md)
-- [Configuration‑driven development](../../../../docs/concepts/configuration-driven-development.md)
-- [Declarative UI](../../../../docs/concepts/declarative-ui.md)
+- [Dynamic Component Rendering](https://github.com/codexrodrigues/praxis/blob/main/docs/concepts/dynamic-component-rendering.md)
+- [Headless UI & Design Systems](https://github.com/codexrodrigues/praxis/blob/main/docs/concepts/headless-ui-and-design-systems.md)
+- [Configuration‑driven development](https://github.com/codexrodrigues/praxis/blob/main/docs/concepts/configuration-driven-development.md)
+- [Declarative UI](https://github.com/codexrodrigues/praxis/blob/main/docs/concepts/declarative-ui.md)
 
 ## ✨ Características Principais
 
@@ -32,9 +39,12 @@ A biblioteca `@praxis/core` é o núcleo do Praxis UI Workspace, fornecendo inte
 ## 🚀 Instalação
 
 ```bash
-npm install @praxis/core
+npm install @praxisui/core
 ```
 
+Exemplo completo (app de referência)
+- Quickstart: https://github.com/codexrodrigues/praxis-ui-quickstart
+
 ### Peer dependencies (Angular v20)
 
 - `@angular/core` `^20.0.0`
@@ -48,7 +58,7 @@ npm install @praxis/core
 ```ts
 import { Component } from '@angular/core';
 import { MatIconModule } from '@angular/material/icon';
-import { PraxisIconDirective } from '@praxis/core';
+import { PraxisIconDirective } from '@praxisui/core';
 
 @Component({
   selector: 'app-icons-demo',
@@ -68,7 +78,7 @@ export class IconsDemoComponent {}
 
 ```ts
 import { Component } from '@angular/core';
-import { DynamicGridPageComponent, GridPageDefinition } from '@praxis/core';
+import { DynamicGridPageComponent, GridPageDefinition } from '@praxisui/core';
 
 @Component({
   selector: 'app-grid-demo',
@@ -101,11 +111,71 @@ Observação: os IDs de widgets usados na página devem estar registrados via `C
 
 ## 📚 API Surface
 
-- Exports públicos: consulte `projects/praxis-core/src/public-api.ts` para a lista consolidada de serviços, tokens, modelos e utilitários disponíveis para importação.
+- Exports públicos: consulte o arquivo
+  [`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.
+
+## 🔎 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`.
+
+```ts
+import { Component, Provider } from '@angular/core';
+import { PraxisTabs, TabsMetadata } from '@praxisui/tabs';
+import { SchemaViewerComponent, SCHEMA_VIEWER_CONTEXT } from '@praxisui/core';
+
+@Component({
+  standalone: true,
+  selector: 'app-tabs-showcase',
+  imports: [PraxisTabs, SchemaViewerComponent],
+  template: `
+    <!-- Aba Preview -->
+    <praxis-tabs [config]="tabs"></praxis-tabs>
+
+    <!-- Aba Schema -->
+    <praxis-schema-viewer [context]="schemaCtx"></praxis-schema-viewer>
+  `,
+  providers: [
+    {
+      provide: SCHEMA_VIEWER_CONTEXT,
+      useFactory: () => ({
+        componentId: 'praxis-tabs',
+        title: 'Tabs — Schema & Metadata',
+        rawConfig: {
+          group: { alignTabs: 'center', dynamicHeight: true },
+          tabs: [ { id: 't1', textLabel: 'Dados', content: [] } ],
+        } satisfies TabsMetadata,
+      }),
+    } as Provider,
+  ],
+})
+export class TabsShowcaseComponent {
+  tabs: TabsMetadata = { group: { dynamicHeight: true }, tabs: [] };
+  schemaCtx = {
+    componentId: 'praxis-tabs',
+    rawConfig: this.tabs,
+  };
+}
+```
+
+Campos opcionais do contexto (`SchemaViewerContext`):
+- `rawConfig` (JSON usado pelo exemplo), `effectiveConfig` (se houver merge de defaults);
+- `backendSchema` (OpenAPI/JSON Schema) e `schemaMeta` (path/operation/schemaType/schemaHash);
+- `normalizedFields` (se já normalizado; caso contrário, o componente aplica `SchemaNormalizerService`).
 
 ## 🧩 Compatibilidade
 
-- `@praxis/core` `0.0.x` → Angular `20.x`
+- `@praxisui/core` `1.0.0-beta.x` → Angular `20.x`
+
+## 📦 Publicação
+
+- Pacote ESM, gerado via `ng-packagr`.
+- Licença: Apache-2.0 (incluída no pacote).
+- Repositório e issues: [GitHub](https://github.com/codexrodrigues/praxis).
+
+## 📄 Licença
+
+Apache-2.0 — veja o arquivo `LICENSE` incluído no pacote.
 - Module format: `ESM2022`
 
 ## 📝 Interfaces Principais
@@ -485,7 +555,7 @@ class TableConfigService {
 ### Exemplo de Uso do Serviço
 
 ```typescript
-import { TableConfigService } from '@praxis/core';
+import { TableConfigService } from '@praxisui/core';
 
 @Component({...})
 export class MyComponent {
@@ -512,7 +582,7 @@ export class MyComponent {
 ### Configuração Padrão
 
 ```typescript
-import { createDefaultTableConfig } from "@praxis/core";
+import { createDefaultTableConfig } from "@praxisui/core";
 
 // Criar configuração padrão
 const defaultConfig = createDefaultTableConfig();
@@ -529,7 +599,7 @@ console.log(defaultConfig);
 ### Validação
 
 ```typescript
-import { isValidTableConfig, isTableConfigV2 } from '@praxis/core';
+import { isValidTableConfig, isTableConfigV2 } from '@praxisui/core';
 
 // Validar configuração
 const config = { columns: [...] };
@@ -546,7 +616,7 @@ if (isTableConfigV2(config)) {
 ### Manipulação de Configurações
 
 ```typescript
-import { cloneTableConfig, mergeTableConfigs, getEssentialConfig } from "@praxis/core";
+import { cloneTableConfig, mergeTableConfigs, getEssentialConfig } from "@praxisui/core";
 
 // Clonar configuração
 const clonedConfig = cloneTableConfig(originalConfig);
@@ -590,13 +660,13 @@ function mergeTableConfigs(base: TableConfig, override: Partial<TableConfig>): T
 function getEssentialConfig(config: TableConfig): Partial<TableConfig>;
 ```
 
-## 🧪 Testando com @praxis/core
+## 🧪 Testando com @praxisui/core
 
 ### Setup de Testes
 
 ```typescript
 import { TestBed } from "@angular/core/testing";
-import { TableConfigService } from "@praxis/core";
+import { TableConfigService } from "@praxisui/core";
 
 describe("TableConfigService", () => {
   let service: TableConfigService;
@@ -626,7 +696,7 @@ describe("TableConfigService", () => {
 ### Testes de Helper Functions
 
 ```typescript
-import { createDefaultTableConfig, isValidTableConfig, cloneTableConfig } from "@praxis/core";
+   import { createDefaultTableConfig, isValidTableConfig, cloneTableConfig } from "@praxisui/core";
 
 describe("Helper Functions", () => {
   it("should create valid default config", () => {
@@ -657,17 +727,17 @@ describe("Helper Functions", () => {
 
    ```typescript
    // Antes
-   import { TableConfigV1, TableConfigV2, TableConfigUnified } from "@praxis/core";
+   import { TableConfigV1, TableConfigV2, TableConfigUnified } from "@praxisui/core";
 
    // Depois
-   import { TableConfig } from "@praxis/core";
+   import { TableConfig } from "@praxisui/core";
    ```
 
 2. **Serviços Simplificados**:
 
    ```typescript
    // Antes
-   import { TableConfigAdapterService, TableConfigMigrationService } from "@praxis/core";
+   import { TableConfigAdapterService, TableConfigMigrationService } from "@praxisui/core";
 
    // Depois
    import { TableConfigService } from "@praxisui/core";