@oondemand/oon-core-front 0.3.61 → 0.3.63

package/dist/index.d.ts

@@ -422,6 +422,8 @@ interface CollectionViewDef {
     path?: string;
     icon?: ReactNode;
     section?: string;
+    /** Mantém a rota disponível, mas remove a coleção do menu lateral. */
+    hidden?: boolean;
     /** "dynamic" monta tudo a partir de /core/models/:model. */
     mode?: CollectionMode;
     /** modo "full": colunas explícitas. */
@@ -497,7 +499,7 @@ interface OonPageDef {
     hidden?: boolean;
     order?: number;
 }
-type OonBlockDef = OonCustomBlockDef | OonCollectionDataGridBlockDef | OonCollectionCardsBlockDef | OonSectionBlockDef | OonMarkdownBlockDef | OonGenericBlockDef;
+type OonBlockDef = OonCustomBlockDef | OonCollectionDataGridBlockDef | OonCollectionCardsBlockDef | OonSectionBlockDef | OonMarkdownBlockDef | OonNavigationCardsBlockDef | OonGenericBlockDef;
 interface OonBaseBlockDef {
     id?: string;
     title?: string;
@@ -532,6 +534,18 @@ interface OonMarkdownBlockDef extends OonBaseBlockDef {
     type: "markdown";
     content: string;
 }
+interface OonNavigationCardDef {
+    title: string;
+    description?: string;
+    href: string;
+    actionLabel?: string;
+    external?: boolean;
+}
+interface OonNavigationCardsBlockDef extends OonBaseBlockDef {
+    type: "navigation.cards";
+    cards: OonNavigationCardDef[];
+    columns?: 1 | 2 | 3 | 4;
+}
 interface OonGenericBlockDef extends OonBaseBlockDef {
     type: "collection.form" | "pipeline.board" | "document.viewer" | "dashboard.kpi" | "tabs";
     [key: string]: unknown;
@@ -678,10 +692,28 @@ interface CentralFormFieldDef extends OonFormFieldDef {
     /** Mantém somente opções em que estes campos estejam vazios/nulos. */
     referenceEmptyFields?: string[];
 }
+type DashboardFilterPrimitive$1 = string | number | boolean | null;
+type DashboardFilterValue$1 = DashboardFilterPrimitive$1 | {
+    eq?: DashboardFilterPrimitive$1;
+    ne?: DashboardFilterPrimitive$1;
+    in?: DashboardFilterPrimitive$1[];
+    nin?: DashboardFilterPrimitive$1[];
+    gt?: DashboardFilterPrimitive$1;
+    gte?: DashboardFilterPrimitive$1;
+    lt?: DashboardFilterPrimitive$1;
+    lte?: DashboardFilterPrimitive$1;
+    exists?: boolean;
+};
+type CentralDashboardWidget = Omit<DashboardWidgetDef, "kind"> & {
+    description?: string;
+    kind?: "count" | "sum" | "groupCount" | "groupSum" | "custom";
+    groupBy?: string;
+    filters?: Record<string, DashboardFilterValue$1>;
+    format?: "number" | "currency";
+};
 /**
- * Schema do `central.ui.json` (Seção 9 do escopo). É o que o frontend
- * consumidor gerado pelo `create-central-oon` carrega — declaração pura, sem
- * código de UI. O Core converte isto em `OonCoreFrontConfig`.
+ * Schema do `central.ui.json` (Seção 9). É o que o frontend consumidor
+ * carrega; a Central declara UI e o Core converte para rotas e componentes.
  */
 interface CentralUiManifest {
     name: string;
@@ -698,12 +730,22 @@ interface CentralUiManifest {
     registry?: OonComponentRegistry;
     navigation?: OonNavigationConfig;
     pages?: OonPageDef[];
+    dashboards?: Array<{
+        id?: string;
+        label?: string;
+        path?: string;
+        section?: string;
+        hidden?: boolean;
+        order?: number;
+        widgets?: CentralDashboardWidget[];
+    }>;
     collections?: Array<{
         model: string;
         mode?: CollectionMode;
         path?: string;
         label?: string;
         section?: string;
+        hidden?: boolean;
         /** Overrides pontuais de campos; os demais continuam vindo da metadata. */
         form?: CentralFormFieldDef[];
         list?: OonCollectionListConfig;
@@ -768,11 +810,8 @@ interface ManifestRuntime {
 /** Converte o manifesto declarativo + runtime em config do Core. */
 declare function manifestToConfig(manifest: CentralUiManifest, runtime: ManifestRuntime): OonCoreFrontConfig;
 /**
- * Bootstrap a partir do `central.ui.json`. É a única linha que o `main.tsx` de
- * uma Central gerada precisa:
- *
- *   import manifest from "../central.ui.json";
- *   startFromManifest(manifest, { apiBaseUrl: import.meta.env.VITE_API_URL });
+ * Bootstrap a partir do `central.ui.json`. É a única linha que o frontend
+ * consumidor precisa para carregar o manifesto da Central.
  */
 declare function startFromManifest(manifest: CentralUiManifest, runtime: ManifestRuntime): void;
 
@@ -965,14 +1004,30 @@ interface CoreAssistantProps {
  */
 declare function CoreAssistant({ assistantCode, label, entity, endpoint }: CoreAssistantProps): react.JSX.Element;
 
+type DashboardFilterPrimitive = string | number | boolean | null;
+type DashboardFilterValue = DashboardFilterPrimitive | {
+    eq?: DashboardFilterPrimitive;
+    ne?: DashboardFilterPrimitive;
+    in?: DashboardFilterPrimitive[];
+    nin?: DashboardFilterPrimitive[];
+    gt?: DashboardFilterPrimitive;
+    gte?: DashboardFilterPrimitive;
+    lt?: DashboardFilterPrimitive;
+    lte?: DashboardFilterPrimitive;
+    exists?: boolean;
+};
+type CoreDashboardWidget = Omit<DashboardWidgetDef, "kind"> & {
+    description?: string;
+    kind?: "count" | "sum" | "groupCount" | "groupSum" | "custom";
+    groupBy?: string;
+    filters?: Record<string, DashboardFilterValue>;
+    format?: "number" | "currency";
+};
 interface CoreDashboardProps {
     label?: string;
-    widgets?: DashboardWidgetDef[];
+    widgets?: CoreDashboardWidget[];
 }
-/**
- * Dashboard do Core: renderiza widgets registrados (count/sum por model ou
- * render custom). Cache, loading e erro ficam no Core; a Central só declara.
- */
+/** Dashboard declarativo com agregações executadas integralmente no backend. */
 declare function CoreDashboard({ label, widgets }: CoreDashboardProps): react.JSX.Element;
 
 declare function CorePage({ page, registry }: {