@fayz-ai/plugin-forms 0.10.0 → 0.10.1

package/dist/analytics/cards.d.ts

@@ -0,0 +1,3 @@
+import type { AnalyticsCardDef } from '@fayz-ai/core';
+export declare function buildFormsAnalyticsCards(): AnalyticsCardDef[];
+//# sourceMappingURL=cards.d.ts.map

package/dist/analytics/cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/analytics/cards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AA2BrD,wBAAgB,wBAAwB,IAAI,gBAAgB,EAAE,CA2E7D"}

package/dist/config.d.ts

@@ -9,6 +9,12 @@ export interface CustomFormsPluginOptions {
     labels?: Partial<CustomFormsLabels>;
     /** App-owned registries shown inside Forms & Documents settings. */
     settingsRegistries?: PluginRegistryDef[];
+    /**
+     * Pass `false` to leave form submissions out of /analytics. Contributed by
+     * default — a filled form has no other place in the product where it can be
+     * read in bulk.
+     */
+    analyticsCards?: false;
 }
 export interface CustomFormsLabels {
     pageTitle: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE3D,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,YAAY,CAAC,EAAE,uBAAuB,CAAA;IACtC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACnC,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAA;CAC1B;AAYD,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAInF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE3D,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,YAAY,CAAC,EAAE,uBAAuB,CAAA;IACtC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACnC,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAA;IACxC;;;;OAIG;IACH,cAAc,CAAC,EAAE,KAAK,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAA;CAC1B;AAYD,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,iBAAiB,CAInF"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAUnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AA2CxD,YAAY,EAAE,wBAAwB,EAAE,CAAA;AACxC,OAAO,EAAE,4BAA4B,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAEvH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,cAAc,CAmL1F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAUnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AA4CxD,YAAY,EAAE,wBAAwB,EAAE,CAAA;AACxC,OAAO,EAAE,4BAA4B,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAEvH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,cAAc,CAwL1F"}

package/dist/index.js

@@ -1,10 +1,10 @@
 import { createOrUpdateFormTool, prefillFromPerson, FormRenderer, printDocument } from './chunk-RBLXIKWB.js';
 import React2, { useState, useCallback, useRef, useMemo, useEffect } from 'react';
-import { registerTranslations, createSafeDataProvider, getSupabaseClientOptional, useTranslation, getActiveTenantId, emitDomainEvent, useDataVersion } from '@fayz-ai/core';
-import { PluginSettingsPanel, registerTimelineSource, useLimitGuard, invalidateLimit, askAI, PermissionGate, QuickActionsButton } from '@fayz-ai/admin';
+import { tl, registerTranslations, createSafeDataProvider, getSupabaseClientOptional, useTranslation, getActiveTenantId, emitDomainEvent, useDataVersion } from '@fayz-ai/core';
+import { PluginSettingsPanel, registerTimelineSource, useLimitGuard, invalidateLimit, askAI, PermissionGate, PageActions } from '@fayz-ai/admin';
 import { create } from 'zustand';
-import { FileText, Image, Paperclip, Pencil, Archive, Plus, Search, ArrowLeft, Printer, ChevronDown, Upload, Eye } from 'lucide-react';
-import { Badge, Button, PageHeaderActions, Card, DataTable, useSaveBar, Dropdown, DropdownTrigger, DropdownContent, DropdownSeparator, DropdownLabel } from '@fayz-ai/ui';
+import { FileText, Image, Paperclip, Plus, WandSparkles, Pencil, Archive, Search, ArrowLeft, Printer, ChevronDown, Upload, Eye } from 'lucide-react';
+import { Badge, RowActions, Button, PageHeaderActions, Card, DataTable, useSaveBar, Dropdown, DropdownTrigger, DropdownContent, DropdownSeparator, DropdownLabel } from '@fayz-ai/ui';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
 // src/data/tables.ts
@@ -881,32 +881,40 @@ function TemplateListView({ store, config, onEdit, onNew }) {
   const loading = store((s) => s.templatesLoading);
   const usage = store((s) => s.templateUsage);
   const orgId = getFormsTenantId();
-  const createActions = useMemo(() => [
-    {
-      id: "with-ai",
-      label: t("assistant.askAI"),
-      description: t("customForms.newWithAIHint"),
-      icon: "WandSparkles",
-      highlight: true,
-      action: () => askAI({
-        hint: t("customForms.askPlaceholder"),
-        intro: {
-          role: "setup",
-          persona: t("customForms.askPersona"),
-          pitch: t("customForms.askPitch"),
-          description: t("customForms.askDescription"),
-          suggestions: [0, 1, 2].map((i) => ({ label: t(`customForms.askSuggestion.${i}`) }))
-        }
-      })
-    },
-    {
-      id: "by-hand",
-      label: t("customForms.newByHand"),
-      description: t("customForms.newByHandHint"),
-      icon: "SlidersHorizontal",
-      action: onNew
-    }
-  ], [t, onNew]);
+  const createActions = useMemo(() => {
+    const permission = { feature: "custom_forms", action: "create" };
+    return [
+      {
+        id: "new",
+        label: t("customForms.newTemplate"),
+        description: t("customForms.newByHandHint"),
+        icon: Plus,
+        intent: "primary",
+        creates: true,
+        onSelect: onNew,
+        permission
+      },
+      {
+        id: "ai",
+        label: t("assistant.askAI"),
+        description: t("customForms.newWithAIHint"),
+        icon: WandSparkles,
+        intent: "secondary",
+        creates: true,
+        onSelect: () => askAI({
+          hint: t("customForms.askPlaceholder"),
+          intro: {
+            role: "setup",
+            persona: t("customForms.askPersona"),
+            pitch: t("customForms.askPitch"),
+            description: t("customForms.askDescription"),
+            suggestions: [0, 1, 2].map((i) => ({ label: t(`customForms.askSuggestion.${i}`) }))
+          }
+        }),
+        permission
+      }
+    ];
+  }, [t, onNew]);
   const version = useDataVersion(`${FORM_TEMPLATE_EVENT}*`);
   useEffect(() => {
     if (!orgId) return;
@@ -969,32 +977,31 @@ function TemplateListView({ store, config, onEdit, onNew }) {
     {
       id: "actions",
       header: "",
-      cell: ({ row }) => /* @__PURE__ */ jsxs("div", { className: "flex justify-end gap-1", children: [
-        /* @__PURE__ */ jsx(
-          "button",
-          {
-            onClick: (e) => {
-              e.stopPropagation();
-              onEdit(row.original);
-            },
-            className: "rounded-md p-1.5 hover:bg-muted",
-            title: t("common.edit"),
-            children: /* @__PURE__ */ jsx(Pencil, { className: "h-3.5 w-3.5 text-muted-foreground" })
-          }
-        ),
-        /* @__PURE__ */ jsx(
-          "button",
-          {
-            onClick: (e) => {
-              e.stopPropagation();
-              void handleArchive(row.original);
+      // RowActions is the one renderer for what can be done to a single row —
+      // it owns the sizing, the accessible name and the rule that keeps a
+      // destructive action off the row itself.
+      cell: ({ row }) => /* @__PURE__ */ jsx(
+        RowActions,
+        {
+          actions: [
+            {
+              id: "edit",
+              label: t("common.edit"),
+              icon: Pencil,
+              onSelect: () => onEdit(row.original)
             },
-            className: "rounded-md p-1.5 hover:bg-muted",
-            title: t("customForms.archive"),
-            children: /* @__PURE__ */ jsx(Archive, { className: "h-3.5 w-3.5 text-muted-foreground" })
-          }
-        )
-      ] })
+            {
+              id: "archive",
+              label: t("customForms.archive"),
+              icon: Archive,
+              intent: "danger",
+              onSelect: () => {
+                void handleArchive(row.original);
+              }
+            }
+          ]
+        }
+      )
     }
   ], [t, usage, onEdit, handleArchive]);
   const emptyState = /* @__PURE__ */ jsxs("div", { className: "flex flex-col items-center justify-center py-6 text-center", children: [
@@ -1007,14 +1014,7 @@ function TemplateListView({ store, config, onEdit, onNew }) {
     ] }) })
   ] });
   return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
-    /* @__PURE__ */ jsx(PermissionGate, { feature: "custom_forms", action: "create", children: /* @__PURE__ */ jsx(PageHeaderActions, { children: /* @__PURE__ */ jsx(
-      QuickActionsButton,
-      {
-        label: t("customForms.newTemplate"),
-        variant: "default",
-        actions: createActions
-      }
-    ) }) }),
+    /* @__PURE__ */ jsx(PageHeaderActions, { children: /* @__PURE__ */ jsx(PageActions, { actions: createActions }) }),
     /* @__PURE__ */ jsxs(Card, { className: "overflow-hidden", children: [
       /* @__PURE__ */ jsx("div", { className: "flex flex-wrap items-center gap-2 border-b border-border px-3 py-2", children: /* @__PURE__ */ jsxs("div", { className: "relative min-w-[10rem] flex-1", children: [
         /* @__PURE__ */ jsx(Search, { className: "pointer-events-none absolute left-2.5 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-muted-foreground" }),
@@ -1841,6 +1841,89 @@ function registerFormsTimelineSource() {
     }
   });
 }
+var SUBMISSIONS = "plg_forms_rep_submissions";
+var CAT = tl("Forms", "Formul\xE1rios");
+var STATUS_LABELS = {
+  draft: tl("Draft", "Rascunho"),
+  completed: tl("Completed", "Conclu\xEDdo"),
+  signed: tl("Signed", "Assinado"),
+  archived: tl("Archived", "Arquivado")
+};
+function buildFormsAnalyticsCards() {
+  const base = { domain: "custom_forms", compare: true, canonicalOwner: "public.documents" };
+  return [
+    {
+      ...base,
+      id: "forms.submissions",
+      name: tl("Form submissions", "Formul\xE1rios preenchidos"),
+      description: tl(
+        "Forms filled in during the period, whoever filled them.",
+        "Formul\xE1rios preenchidos no per\xEDodo, por quem quer que seja."
+      ),
+      icon: "FileText",
+      category: CAT,
+      grain: "submission",
+      query: {
+        source: { kind: "view", name: SUBMISSIONS },
+        dimensions: [{ key: "created_at", label: tl("Date", "Data"), grain: "auto" }],
+        measures: [{ key: "submissions", label: tl("Submissions", "Preenchimentos"), agg: "count", format: "number" }]
+      },
+      viz: { type: "kpi", spark: true },
+      dashboard: { span: 1, order: 30 }
+    },
+    {
+      ...base,
+      id: "forms.by-template",
+      name: tl("Submissions by form", "Preenchimentos por formul\xE1rio"),
+      description: tl(
+        "Which templates are actually being used \u2014 and which one nobody answers.",
+        "Quais modelos est\xE3o realmente em uso \u2014 e qual ningu\xE9m responde."
+      ),
+      icon: "ClipboardList",
+      category: CAT,
+      grain: "submission",
+      query: {
+        source: { kind: "view", name: SUBMISSIONS },
+        dimensions: [{ key: "template_name", label: tl("Form", "Formul\xE1rio") }],
+        measures: [{ key: "submissions", label: tl("Submissions", "Preenchimentos"), agg: "count", format: "number" }],
+        defaultSort: "submissions",
+        defaultSortDir: "desc"
+      },
+      viz: { type: "breakdown", limit: 8 }
+    },
+    {
+      // The list the product never had: one row per filled form, with the
+      // person behind it. No measures, so it is a plain select — the rows ARE
+      // the report, and the viewer's export button turns them into a file.
+      ...base,
+      id: "forms.submissions-list",
+      name: tl("Submission list", "Lista de preenchimentos"),
+      description: tl(
+        "Every form filled in the period, with who filled it \u2014 ready to export.",
+        "Todo formul\xE1rio preenchido no per\xEDodo, com quem preencheu \u2014 pronto para exportar."
+      ),
+      icon: "Table",
+      category: CAT,
+      grain: "submission",
+      query: {
+        source: { kind: "view", name: SUBMISSIONS },
+        defaultSort: "created_at",
+        defaultSortDir: "desc"
+      },
+      columns: [
+        { key: "created_at", label: tl("Filled", "Preenchido em"), type: "date", sortable: true },
+        { key: "template_name", label: tl("Form", "Formul\xE1rio"), type: "text" },
+        { key: "person_name", label: tl("Person", "Pessoa"), type: "person", idKey: "person_id" },
+        { key: "person_email", label: tl("E-mail", "E-mail"), type: "email" },
+        { key: "person_phone", label: tl("Phone", "Telefone"), type: "text" },
+        { key: "status", label: tl("Status", "Situa\xE7\xE3o"), type: "text", valueMap: STATUS_LABELS },
+        { key: "template_category", label: tl("Category", "Categoria"), type: "text", visible: false },
+        { key: "signed_at", label: tl("Signed at", "Assinado em"), type: "date", visible: false }
+      ],
+      viz: { type: "table" }
+    }
+  ];
+}
 function registerBuiltInProviders(formsProvider) {
   registerDocumentTypeProvider({
     id: "custom_forms:templates",
@@ -1949,6 +2032,10 @@ function createCustomFormsPlugin(options) {
       { key: "form_templates", label: "Form templates", table: "plg_forms_templates" },
       { key: "documents_month", label: "Documents / month", table: "documents", period: "month" }
     ],
+    // O formulário preenchido vira número e vira LISTA em /analytics — até aqui
+    // ele só existia dentro da ficha de uma pessoa, um de cada vez. Read model
+    // na migration 006.
+    analyticsCards: options?.analyticsCards === false ? [] : buildFormsAnalyticsCards(),
     navigation: [],
     routes: [],
     settings: [