# API oon-core-front

> Todos os exports públicos de @oondemand/oon-core-front e de seus subpaths ui, routing, theme, hooks e testing.

## Bootstrap e composição

| Export | Descrição |
|---|---|
| `defineOonApp(definition)` | Valida e tipa o App |
| `startOonApp(definition)` | Monta o App React |
| `appDefinitionToConfig(definition)` | Converte a definição em configuração interna |
| `defineOonRoutes`, `defineOonNavigation`, `OON_RESERVED_ROUTES` | Rotas e menu |
| `defineCollectionView`, `defineDocumentView`, `definePipelineView`, `defineDashboard`, `defineOonModule` | Composição declarativa |

## Temas

`createOonTheme`, `oonDefaultTheme`, `createOonSystem` (subpath `theme`), `useOonTheme` — tipos `OonThemeDefinition`, `OonThemeDensity`, `OonThemeContrast`, `OonThemeContextValue`.

## Domínio (fórmulas)

`evaluateDomainExpression`, `applyReactiveFormulas`, `buildDomainMutationPayload`, `coerceDomainFormValue`, `DomainExpressionError` — tipos `OonDomainExpression`, `OonDomainExpressionOperator`, `OonComputedFieldDefinition`, `OonReactiveFormField`, `ReactiveFormulaResult`.

## Componentes de domínio

`CoreCollection`, `CorePipeline`, `CoreDocument`, `CoreDashboard`, `CoreCurrency`, `CoreAssistant`, `CoreUsersAccess`, `CoreTransactionalEmail`, `CorePage`.

## UI Kit

`CorePageHeader`, `CoreToolbar`, `CoreDataGrid`, `CoreCards`, `CoreForm`, `CoreField`, `CoreRelationField`, `CoreActions`, `CoreEmptyState`, `CoreLoadingState`, `CoreErrorState`, `CoreTabs`, `CoreSummaryCards`, `CoreTimeline`, `CoreStepper`, `CoreStatusPanel`, `CoreActivityLog`, `CoreConfirmAction`, `CoreStatusBadge`, `coreStatus`, `CoreKpiGrid`, `CoreEmpty`, `CoreDataTable`, `CoreDetailDrawer`, `CoreConfirmDialog`, `CoreTechnicalDetails`, `CoreFormSection`, `CoreOrganizationSwitcher`, `coreInitials`.

Primitives (Chakra UI v3): `OonButton`, `OonInput`, `OonSelect`, `OonCard`, `OonBadge`, `OonGrid`, `OonStack`, `OonModal`, `OonDrawer`.

## Segurança e dados

| Export | Descrição |
|---|---|
| `useOonAuth`, `can` | Sessão e permissões |
| `PermissionGate`, `Can` | Gating visual |
| `useOonTenant`, `createTenantStorage` | Tenant (Apps tenant-aware) |
| `useOonApi` | `{ http, core, resource }` |
| `useOonResource(basePath)` | Cliente CRUD |
| `useCoreMetadata`, `useModelSchema(name)` | Metadata |

## Tipos

`OonAppDefinition`, `OonCoreFrontConfig`, `OonAppConfig`, `OonAppKind`, `OonTenancyModel`, `OonApiConfig`, `OonAuthConfig`, `OonAuthMode`, `OonRuntimeMode`, `OonSecurityConfig`, `OonSystemPages`, `OonModule`, `OonRoute`, `OonMenuItem`, `OonUiManifest`, `OonLayoutConfig`, `OonComponentRegistry`, `OonNavigationConfig`, `OonPageDef`, `OonBlockDef`, `OonActionDef`, `OonViewDefinition`, `CollectionViewDef`, `DocumentViewDef`, `PipelineViewDef`, `DashboardViewDef`, `DashboardWidgetDef`, `OonColumnDef`, `OonFormFieldDef`, `CoreMetadata`, `ModelSummary`, `FieldMeta`, `FieldKind`, `PaginatedResult`, `Pagination`, `ListParams`, `OonError`, `OonUser`, e os tipos de esteira `OonPipelineActionDef`, `OonPipelineDefaultActionsDef`, `OonPipelineTicketModalConfig`, `OonPipelineViewDef`.

## Subpaths

| Subpath | Conteúdo |
|---|---|
| `/ui` | Componentes de domínio, kit `Core*` e primitives |
| `/routing` | `defineOonRoutes`, `defineOonNavigation`, `OON_RESERVED_ROUTES`, `navigation`, `routeElement` |
| `/theme` | `createOonTheme`, `createOonSystem`, `oonDefaultTheme`, `useOonTheme` |
| `/hooks` | `useOonAuth`, `can`, `useOonTenant`, `useOonApi`, `useOonResource`, `useCoreMetadata`, `useModelSchema`, `useOonTheme` |
| `/testing` | `createOonTestConfig(overrides)` |

Peer dependencies: `react@^18`, `react-dom@^18`, `react-router-dom@^6`, `@chakra-ui/react@^3`, `@tanstack/react-query@^5`, `@tanstack/react-table@^8`.

Fonte: https://sdk.oonapps.com/docs/referencia/api-frontend