@oondemand/oon-core-front 0.3.11 → 0.3.14

package/dist/index.d.ts

@@ -246,6 +246,7 @@ interface OonColumnDef {
     permissions?: string[];
     capabilities?: string[];
 }
+type OonFormFieldWidget = "default" | "checkbox";
 interface OonFormFieldDef {
     field: string;
     label?: string;
@@ -255,6 +256,19 @@ interface OonFormFieldDef {
     /** model relacionada quando kind === "ref". */
     ref?: string;
     renderer?: string;
+    /** Controle visual pontual sem substituir a página/formulário inteiro. */
+    widget?: OonFormFieldWidget;
+    /** Valor persistido quando um checkbox está marcado. Default: true. */
+    checkedValue?: string | number | boolean;
+    /** Valor persistido quando um checkbox está desmarcado. Default: false. */
+    uncheckedValue?: string | number | boolean;
+    /** Agrupa campos relacionados em um bloco visual comum. */
+    group?: string;
+    /** Rótulo exibido uma vez acima do grupo. Default: group. */
+    groupLabel?: string;
+    groupDescription?: string;
+    /** Exibe controles do mesmo grupo na mesma linha quando houver espaço. */
+    inline?: boolean;
     permissions?: string[];
     capabilities?: string[];
 }
@@ -267,6 +281,138 @@ interface OonActionDef {
     capabilities?: string[];
     action?: string;
 }
+type OonListFilterDef = {
+    field: string;
+    label?: string;
+    type?: "text" | "select" | "date" | "dateRange" | "numberRange" | "boolean" | "ref";
+    options?: Array<{
+        label: string;
+        value: string | number | boolean | null;
+    }>;
+    defaultValue?: unknown;
+    placeholder?: string;
+};
+type OonConditionDef = {
+    field: string;
+    exists: boolean;
+} | {
+    field: string;
+    equals: unknown;
+} | {
+    field: string;
+    notEquals: unknown;
+} | {
+    field: string;
+    in: unknown[];
+} | {
+    field: string;
+    gt: number;
+} | {
+    field: string;
+    gte: number;
+} | {
+    field: string;
+    lt: number;
+} | {
+    field: string;
+    lte: number;
+};
+type OonRowActionDef = {
+    id?: string;
+    label: string;
+    icon?: string;
+    type: "openDetailModal" | "navigate" | "apiAction" | "customAction";
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    endpoint?: string;
+    href?: string;
+    initialTab?: string;
+    confirm?: {
+        title?: string;
+        description?: string;
+    };
+    disabledWhen?: OonConditionDef;
+    hiddenWhen?: OonConditionDef;
+    refresh?: Array<"self" | "parent" | "all" | string>;
+    roles?: string[];
+    permissions?: string[];
+    capabilities?: string[];
+    renderer?: string;
+};
+type OonCollectionListConfig = {
+    filters?: OonListFilterDef[];
+    columns?: Array<string | OonColumnDef>;
+    rowActions?: OonRowActionDef[];
+};
+type OonRelationDef = {
+    model: string;
+    foreignKey: string;
+    parentKey?: string;
+    label?: string;
+};
+type OonRelatedGridColumnDef = OonColumnDef & {
+    editable?: boolean;
+    readonly?: boolean;
+    format?: "text" | "number" | "currency" | "percent" | "date" | "badge";
+    editor?: "string" | "number" | "currency" | "date" | "enum" | "select" | "ref" | "boolean" | "textarea";
+    hidden?: boolean;
+    roles?: string[];
+    required?: boolean;
+    display?: "badgeExists" | "badge" | string;
+};
+type OonSummaryCardDef = {
+    label: string;
+    source?: "field" | "relatedCount" | "relatedSum" | "relatedAvg" | "customMetric";
+    field?: string;
+    relation?: string | OonRelationDef;
+    metric?: string;
+    format?: "text" | "number" | "currency" | "percent" | "date" | "badge";
+};
+type OonDetailTabDef = {
+    id: string;
+    label: string;
+    type: "summary";
+    cards?: OonSummaryCardDef[];
+} | {
+    id: string;
+    label: string;
+    type: "form";
+    groups?: Array<{
+        label: string;
+        description?: string;
+        fields: string[];
+        columns?: 1 | 2 | 3 | 4;
+    }>;
+    fields?: string[];
+} | {
+    id: string;
+    label: string;
+    type: "relatedGrid";
+    relation: string | OonRelationDef;
+    editable?: boolean;
+    editMode?: "inline" | "modal" | "drawer";
+    columns?: Array<string | OonRelatedGridColumnDef>;
+    rowActions?: OonRowActionDef[];
+} | {
+    id: string;
+    label: string;
+    type: "readonlyGrid";
+    relation: string | OonRelationDef;
+    columns?: Array<string | OonRelatedGridColumnDef>;
+    rowActions?: OonRowActionDef[];
+} | {
+    id: string;
+    label: string;
+    type: "customComponent";
+    component: string;
+    props?: Record<string, unknown>;
+};
+type OonDetailModalConfig = {
+    enabled?: boolean;
+    titleField?: string;
+    size?: "md" | "lg" | "xl" | "full";
+    defaultTab?: string;
+    tabs: OonDetailTabDef[];
+};
 interface CollectionViewDef {
     type: "collection";
     /** id de rota/menu; default = model em minúsculas. */
@@ -280,12 +426,15 @@ interface CollectionViewDef {
     mode?: CollectionMode;
     /** modo "full": colunas explícitas. */
     columns?: OonColumnDef[];
-    /** modo "full": campos de formulário explícitos. */
+    /** Campos explícitos ou overrides pontuais sobre a metadata do model. */
     form?: OonFormFieldDef[];
     importExport?: boolean;
     renderer?: string;
     cardRenderer?: string;
     actions?: OonActionDef[];
+    list?: OonCollectionListConfig;
+    relations?: Record<string, OonRelationDef>;
+    detailModal?: OonDetailModalConfig;
     permissions?: string[];
     capabilities?: string[];
 }
@@ -448,6 +597,11 @@ interface CentralUiManifest {
         path?: string;
         label?: string;
         section?: string;
+        /** Overrides pontuais de campos; os demais continuam vindo da metadata. */
+        form?: OonFormFieldDef[];
+        list?: OonCollectionListConfig;
+        relations?: Record<string, OonRelationDef>;
+        detailModal?: OonDetailModalConfig;
     }>;
     pipelines?: Array<{
         name?: string;
@@ -517,8 +671,11 @@ interface CoreCollectionProps {
     columns?: OonColumnDef[];
     form?: OonFormFieldDef[];
     importExport?: boolean;
+    list?: OonCollectionListConfig;
+    relations?: Record<string, OonRelationDef>;
+    detailModal?: OonDetailModalConfig;
 }
-declare function CoreCollection({ model, label, section, mode, endpoint, columns, form, importExport }: CoreCollectionProps): react.JSX.Element;
+declare function CoreCollection({ model, label, section, mode, endpoint, columns, form, importExport, list, relations, detailModal }: CoreCollectionProps): react.JSX.Element;
 
 interface CoreDocumentProps {
     model: string;