@burdenoff/microfe-planmagnet 2026.930.25 → 2026.1001.2

package/dist/planmagnet/reports/reportGraphql.js

@@ -0,0 +1,360 @@
+import { gql as e } from "@apollo/client";
+//#region src/planmagnet/reports/reportGraphql.ts
+var t = e`
+  query ListPlanmagnetReports(
+    $workspaceId: ID!
+    $filter: PlanmagnetReportFilter
+    $pagination: PlanmagnetPaginationInput
+  ) {
+    planmagnetReports(workspaceId: $workspaceId, filter: $filter, pagination: $pagination) {
+      items {
+        id
+        name
+        description
+        ownerId
+        visibility
+        templateKey
+        workspaceId
+        createdAt
+        updatedAt
+      }
+      totalCount
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+    }
+  }
+`, n = e`
+  query GetPlanmagnetReport($id: ID!) {
+    planmagnetReport(id: $id) {
+      id
+      name
+      description
+      ownerId
+      visibility
+      templateKey
+      workspaceId
+      createdAt
+      updatedAt
+      definition {
+        widgets {
+          id
+          type
+          title
+          source
+          params {
+            projectId
+            sprintId
+            teamId
+            from
+            to
+            limit
+          }
+          layout {
+            x
+            y
+            w
+            h
+          }
+        }
+      }
+    }
+  }
+`, r = e`
+  query ListPlanmagnetReportTemplates {
+    planmagnetReportTemplates {
+      key
+      name
+      description
+      definition {
+        widgets {
+          id
+          type
+          title
+          source
+          params {
+            projectId
+            sprintId
+            teamId
+            from
+            to
+            limit
+          }
+          layout {
+            x
+            y
+            w
+            h
+          }
+        }
+      }
+    }
+  }
+`, i = e`
+  mutation CreatePlanmagnetReport($workspaceId: ID!, $input: PlanmagnetCreateReportInput!) {
+    planmagnetCreateReport(workspaceId: $workspaceId, input: $input) {
+      id
+      name
+      description
+      ownerId
+      visibility
+      templateKey
+      workspaceId
+      createdAt
+      updatedAt
+      definition {
+        widgets {
+          id
+          type
+          title
+          source
+          params {
+            projectId
+            sprintId
+            teamId
+            from
+            to
+            limit
+          }
+          layout {
+            x
+            y
+            w
+            h
+          }
+        }
+      }
+    }
+  }
+`, a = e`
+  mutation UpdatePlanmagnetReport($id: ID!, $input: PlanmagnetUpdateReportInput!) {
+    planmagnetUpdateReport(id: $id, input: $input) {
+      id
+      name
+      description
+      ownerId
+      visibility
+      templateKey
+      workspaceId
+      createdAt
+      updatedAt
+      definition {
+        widgets {
+          id
+          type
+          title
+          source
+          params {
+            projectId
+            sprintId
+            teamId
+            from
+            to
+            limit
+          }
+          layout {
+            x
+            y
+            w
+            h
+          }
+        }
+      }
+    }
+  }
+`, o = e`
+  mutation DeletePlanmagnetReport($id: ID!) {
+    planmagnetDeleteReport(id: $id)
+  }
+`, s = e`
+  mutation DuplicatePlanmagnetReport($id: ID!, $name: String) {
+    planmagnetDuplicateReport(id: $id, name: $name) {
+      id
+      name
+      description
+      ownerId
+      visibility
+      templateKey
+      workspaceId
+      createdAt
+      updatedAt
+    }
+  }
+`, c = e`
+  mutation RunPlanmagnetReport($id: ID!) {
+    planmagnetRunReport(id: $id) {
+      id
+      reportId
+      workspaceId
+      trigger
+      generatedAt
+      generatedBy
+      deliveryStatus
+      widgets {
+        widgetId
+        source
+        status
+        message
+        result
+      }
+    }
+  }
+`, l = e`
+  query GetPlanmagnetReportRun($id: ID!) {
+    planmagnetReportRun(id: $id) {
+      id
+      reportId
+      workspaceId
+      trigger
+      generatedAt
+      generatedBy
+      deliveryStatus
+      widgets {
+        widgetId
+        source
+        status
+        message
+        result
+      }
+    }
+  }
+`, u = e`
+  query ListPlanmagnetReportRuns($reportId: ID!, $pagination: PlanmagnetPaginationInput) {
+    planmagnetReportRuns(reportId: $reportId, pagination: $pagination) {
+      items {
+        id
+        trigger
+        generatedAt
+        generatedBy
+        deliveryStatus
+      }
+      totalCount
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+    }
+  }
+`, d = e`
+  query ExportPlanmagnetReportRun($runId: ID!, $format: PlanmagnetReportExportFormat!) {
+    planmagnetExportReportRun(runId: $runId, format: $format) {
+      filename
+      contentType
+      content
+    }
+  }
+`, f = e`
+  query ListPlanmagnetReportShares($reportId: ID!) {
+    planmagnetReportShares(reportId: $reportId) {
+      id
+      reportId
+      workspaceId
+      createdBy
+      createdAt
+      expiresAt
+      revokedAt
+      hasPassword
+      watermark
+      accessCount
+      lastAccessedAt
+      runId
+    }
+  }
+`, p = e`
+  mutation CreatePlanmagnetReportShare($runId: ID!, $input: PlanmagnetCreateReportShareInput!) {
+    planmagnetCreateReportShare(runId: $runId, input: $input) {
+      id
+      reportId
+      workspaceId
+      createdBy
+      createdAt
+      expiresAt
+      revokedAt
+      hasPassword
+      watermark
+      accessCount
+      lastAccessedAt
+      runId
+      token
+    }
+  }
+`, m = e`
+  mutation RevokePlanmagnetReportShare($id: ID!) {
+    planmagnetRevokeReportShare(id: $id)
+  }
+`, h = e`
+  query ListPlanmagnetReportSchedules($reportId: ID!) {
+    planmagnetReportSchedules(reportId: $reportId) {
+      id
+      reportId
+      workspaceId
+      active
+      cadence
+      hourUtc
+      dayOfWeek
+      dayOfMonth
+      format
+      recipientIds
+      nextRunAt
+      lastRunAt
+      lastRunId
+      lastError
+      createdAt
+      updatedAt
+    }
+  }
+`, g = e`
+  mutation CreatePlanmagnetReportSchedule(
+    $reportId: ID!
+    $input: PlanmagnetCreateReportScheduleInput!
+  ) {
+    planmagnetCreateReportSchedule(reportId: $reportId, input: $input) {
+      id
+      reportId
+      workspaceId
+      active
+      cadence
+      hourUtc
+      dayOfWeek
+      dayOfMonth
+      format
+      recipientIds
+      nextRunAt
+      lastRunAt
+      lastRunId
+      lastError
+      createdAt
+      updatedAt
+    }
+  }
+`, _ = e`
+  mutation UpdatePlanmagnetReportSchedule($id: ID!, $input: PlanmagnetUpdateReportScheduleInput!) {
+    planmagnetUpdateReportSchedule(id: $id, input: $input) {
+      id
+      reportId
+      workspaceId
+      active
+      cadence
+      hourUtc
+      dayOfWeek
+      dayOfMonth
+      format
+      recipientIds
+      nextRunAt
+      lastRunAt
+      lastRunId
+      lastError
+      createdAt
+      updatedAt
+    }
+  }
+`, v = e`
+  mutation DeletePlanmagnetReportSchedule($id: ID!) {
+    planmagnetDeleteReportSchedule(id: $id)
+  }
+`;
+//#endregion
+export { i as CREATE_REPORT, g as CREATE_REPORT_SCHEDULE, p as CREATE_REPORT_SHARE, o as DELETE_REPORT, v as DELETE_REPORT_SCHEDULE, s as DUPLICATE_REPORT, d as EXPORT_REPORT_RUN, n as GET_REPORT, l as GET_REPORT_RUN, t as LIST_REPORTS, u as LIST_REPORT_RUNS, h as LIST_REPORT_SCHEDULES, f as LIST_REPORT_SHARES, r as LIST_REPORT_TEMPLATES, m as REVOKE_REPORT_SHARE, c as RUN_REPORT, a as UPDATE_REPORT, _ as UPDATE_REPORT_SCHEDULE };
+
+//# sourceMappingURL=reportGraphql.js.map

package/dist/planmagnet/reports/reportGraphql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportGraphql.js","names":[],"sources":["../../../src/planmagnet/reports/reportGraphql.ts"],"sourcesContent":["import { gql } from '@apollo/client';\n\n/**\n * Reports GraphQL documents (ANR-13/14/15/16). Field selections match `graphql/wspace.graphql`'s\n * `Planmagnet*Report*` types exactly — validated by `bun run validate:schema` against\n * `graphql/planmagnet.graphql` + `graphql/planmagnet-gateway-roots.graphql` (see schema-drift.config.json).\n * Selection sets are written out in full in each document rather than shared via `${fragment}` interpolation —\n * `gql` here only ever parses one literal per call (no other file in this package interpolates a sub-document\n * into a `gql` tag), so this follows the same convention.\n */\n\nexport const REPORT_SUMMARY_FIELDS_DOC = `\n  id\n  name\n  description\n  ownerId\n  visibility\n  templateKey\n  workspaceId\n  createdAt\n  updatedAt\n`;\n\nexport const LIST_REPORTS = gql`\n  query ListPlanmagnetReports(\n    $workspaceId: ID!\n    $filter: PlanmagnetReportFilter\n    $pagination: PlanmagnetPaginationInput\n  ) {\n    planmagnetReports(workspaceId: $workspaceId, filter: $filter, pagination: $pagination) {\n      items {\n        id\n        name\n        description\n        ownerId\n        visibility\n        templateKey\n        workspaceId\n        createdAt\n        updatedAt\n      }\n      totalCount\n      pageInfo {\n        hasNextPage\n        endCursor\n      }\n    }\n  }\n`;\n\nexport const GET_REPORT = gql`\n  query GetPlanmagnetReport($id: ID!) {\n    planmagnetReport(id: $id) {\n      id\n      name\n      description\n      ownerId\n      visibility\n      templateKey\n      workspaceId\n      createdAt\n      updatedAt\n      definition {\n        widgets {\n          id\n          type\n          title\n          source\n          params {\n            projectId\n            sprintId\n            teamId\n            from\n            to\n            limit\n          }\n          layout {\n            x\n            y\n            w\n            h\n          }\n        }\n      }\n    }\n  }\n`;\n\nexport const LIST_REPORT_TEMPLATES = gql`\n  query ListPlanmagnetReportTemplates {\n    planmagnetReportTemplates {\n      key\n      name\n      description\n      definition {\n        widgets {\n          id\n          type\n          title\n          source\n          params {\n            projectId\n            sprintId\n            teamId\n            from\n            to\n            limit\n          }\n          layout {\n            x\n            y\n            w\n            h\n          }\n        }\n      }\n    }\n  }\n`;\n\nexport const CREATE_REPORT = gql`\n  mutation CreatePlanmagnetReport($workspaceId: ID!, $input: PlanmagnetCreateReportInput!) {\n    planmagnetCreateReport(workspaceId: $workspaceId, input: $input) {\n      id\n      name\n      description\n      ownerId\n      visibility\n      templateKey\n      workspaceId\n      createdAt\n      updatedAt\n      definition {\n        widgets {\n          id\n          type\n          title\n          source\n          params {\n            projectId\n            sprintId\n            teamId\n            from\n            to\n            limit\n          }\n          layout {\n            x\n            y\n            w\n            h\n          }\n        }\n      }\n    }\n  }\n`;\n\nexport const UPDATE_REPORT = gql`\n  mutation UpdatePlanmagnetReport($id: ID!, $input: PlanmagnetUpdateReportInput!) {\n    planmagnetUpdateReport(id: $id, input: $input) {\n      id\n      name\n      description\n      ownerId\n      visibility\n      templateKey\n      workspaceId\n      createdAt\n      updatedAt\n      definition {\n        widgets {\n          id\n          type\n          title\n          source\n          params {\n            projectId\n            sprintId\n            teamId\n            from\n            to\n            limit\n          }\n          layout {\n            x\n            y\n            w\n            h\n          }\n        }\n      }\n    }\n  }\n`;\n\nexport const DELETE_REPORT = gql`\n  mutation DeletePlanmagnetReport($id: ID!) {\n    planmagnetDeleteReport(id: $id)\n  }\n`;\n\nexport const DUPLICATE_REPORT = gql`\n  mutation DuplicatePlanmagnetReport($id: ID!, $name: String) {\n    planmagnetDuplicateReport(id: $id, name: $name) {\n      id\n      name\n      description\n      ownerId\n      visibility\n      templateKey\n      workspaceId\n      createdAt\n      updatedAt\n    }\n  }\n`;\n\nexport const RUN_REPORT = gql`\n  mutation RunPlanmagnetReport($id: ID!) {\n    planmagnetRunReport(id: $id) {\n      id\n      reportId\n      workspaceId\n      trigger\n      generatedAt\n      generatedBy\n      deliveryStatus\n      widgets {\n        widgetId\n        source\n        status\n        message\n        result\n      }\n    }\n  }\n`;\n\nexport const GET_REPORT_RUN = gql`\n  query GetPlanmagnetReportRun($id: ID!) {\n    planmagnetReportRun(id: $id) {\n      id\n      reportId\n      workspaceId\n      trigger\n      generatedAt\n      generatedBy\n      deliveryStatus\n      widgets {\n        widgetId\n        source\n        status\n        message\n        result\n      }\n    }\n  }\n`;\n\nexport const LIST_REPORT_RUNS = gql`\n  query ListPlanmagnetReportRuns($reportId: ID!, $pagination: PlanmagnetPaginationInput) {\n    planmagnetReportRuns(reportId: $reportId, pagination: $pagination) {\n      items {\n        id\n        trigger\n        generatedAt\n        generatedBy\n        deliveryStatus\n      }\n      totalCount\n      pageInfo {\n        hasNextPage\n        endCursor\n      }\n    }\n  }\n`;\n\nexport const EXPORT_REPORT_RUN = gql`\n  query ExportPlanmagnetReportRun($runId: ID!, $format: PlanmagnetReportExportFormat!) {\n    planmagnetExportReportRun(runId: $runId, format: $format) {\n      filename\n      contentType\n      content\n    }\n  }\n`;\n\nexport const LIST_REPORT_SHARES = gql`\n  query ListPlanmagnetReportShares($reportId: ID!) {\n    planmagnetReportShares(reportId: $reportId) {\n      id\n      reportId\n      workspaceId\n      createdBy\n      createdAt\n      expiresAt\n      revokedAt\n      hasPassword\n      watermark\n      accessCount\n      lastAccessedAt\n      runId\n    }\n  }\n`;\n\nexport const CREATE_REPORT_SHARE = gql`\n  mutation CreatePlanmagnetReportShare($runId: ID!, $input: PlanmagnetCreateReportShareInput!) {\n    planmagnetCreateReportShare(runId: $runId, input: $input) {\n      id\n      reportId\n      workspaceId\n      createdBy\n      createdAt\n      expiresAt\n      revokedAt\n      hasPassword\n      watermark\n      accessCount\n      lastAccessedAt\n      runId\n      token\n    }\n  }\n`;\n\nexport const REVOKE_REPORT_SHARE = gql`\n  mutation RevokePlanmagnetReportShare($id: ID!) {\n    planmagnetRevokeReportShare(id: $id)\n  }\n`;\n\nexport const LIST_REPORT_SCHEDULES = gql`\n  query ListPlanmagnetReportSchedules($reportId: ID!) {\n    planmagnetReportSchedules(reportId: $reportId) {\n      id\n      reportId\n      workspaceId\n      active\n      cadence\n      hourUtc\n      dayOfWeek\n      dayOfMonth\n      format\n      recipientIds\n      nextRunAt\n      lastRunAt\n      lastRunId\n      lastError\n      createdAt\n      updatedAt\n    }\n  }\n`;\n\nexport const CREATE_REPORT_SCHEDULE = gql`\n  mutation CreatePlanmagnetReportSchedule(\n    $reportId: ID!\n    $input: PlanmagnetCreateReportScheduleInput!\n  ) {\n    planmagnetCreateReportSchedule(reportId: $reportId, input: $input) {\n      id\n      reportId\n      workspaceId\n      active\n      cadence\n      hourUtc\n      dayOfWeek\n      dayOfMonth\n      format\n      recipientIds\n      nextRunAt\n      lastRunAt\n      lastRunId\n      lastError\n      createdAt\n      updatedAt\n    }\n  }\n`;\n\nexport const UPDATE_REPORT_SCHEDULE = gql`\n  mutation UpdatePlanmagnetReportSchedule($id: ID!, $input: PlanmagnetUpdateReportScheduleInput!) {\n    planmagnetUpdateReportSchedule(id: $id, input: $input) {\n      id\n      reportId\n      workspaceId\n      active\n      cadence\n      hourUtc\n      dayOfWeek\n      dayOfMonth\n      format\n      recipientIds\n      nextRunAt\n      lastRunAt\n      lastRunId\n      lastError\n      createdAt\n      updatedAt\n    }\n  }\n`;\n\nexport const DELETE_REPORT_SCHEDULE = gql`\n  mutation DeletePlanmagnetReportSchedule($id: ID!) {\n    planmagnetDeleteReportSchedule(id: $id)\n  }\n`;\n"],"mappings":";;AAuBA,IAAa,IAAe,CAAG;;;;;;;;;;;;;;;;;;;;;;;;;GA2BlB,IAAa,CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsChB,IAAwB,CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgC3B,IAAgB,CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCnB,IAAgB,CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCnB,IAAgB,CAAG;;;;GAMnB,IAAmB,CAAG;;;;;;;;;;;;;;GAgBtB,IAAa,CAAG;;;;;;;;;;;;;;;;;;;GAqBhB,IAAiB,CAAG;;;;;;;;;;;;;;;;;;;GAqBpB,IAAmB,CAAG;;;;;;;;;;;;;;;;;GAmBtB,IAAoB,CAAG;;;;;;;;GAUvB,IAAqB,CAAG;;;;;;;;;;;;;;;;;GAmBxB,IAAsB,CAAG;;;;;;;;;;;;;;;;;;GAoBzB,IAAsB,CAAG;;;;GAMzB,IAAwB,CAAG;;;;;;;;;;;;;;;;;;;;;GAuB3B,IAAyB,CAAG;;;;;;;;;;;;;;;;;;;;;;;;GA0B5B,IAAyB,CAAG;;;;;;;;;;;;;;;;;;;;;GAuB5B,IAAyB,CAAG"}

package/dist/planmagnet/reports/reportModel.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Reports (ANR-13/14/15/16, BOFF-8048 follow-on): shared types, source metadata and pure helpers for the report
+ * builder + viewer. Mirrors the server's own source-of-truth so the UI never drifts from what actually runs:
+ *
+ *   - `REPORT_SOURCE_SPECS` mirrors wspace-planmagnet-svc's `report-sources.ts` (`REPORT_SOURCE_SPECS`) — the
+ *     per-source allowed param keys. A param a source doesn't use is rejected at save time by the server with a
+ *     field-scoped BAD_USER_INPUT; this file's `allowedParams` lets the builder never offer that param in the
+ *     first place, and `validateWidgetDraft` catches it before the round trip.
+ *   - `packLayout` decides where each widget sits on the 12-column grid from its position in the widgets array
+ *     (the builder's reorder controls) and its own `w`/`h` — a left-to-right, wrap-on-overflow shelf pack, the
+ *     same algorithm CSS flex-wrap performs visually (see `ReportGridCanvas.tsx`), so the preview and the
+ *     persisted `layout` never disagree. There is no free-form drag-to-position: only reorder (where) and
+ *     resize (how big) are exposed, so every layout this UI can produce is representable and always passes the
+ *     server's bounds check (`x >= 0`, `y >= 0`, `w >= 1`, `h >= 1`, `x + w <= 12`).
+ *   - `validateReportDraft` mirrors wspace-planmagnet-svc's `report-definition.ts` (`assertReportDefinition`)
+ *     closely enough that a draft which passes it also passes the server — widget count (1..24), unique ids,
+ *     required type/title/source, and params restricted to the ones the widget's source actually reads. Field
+ *     paths match the server's own (`definition.widgets[i].…`) so a BAD_USER_INPUT that slips past client
+ *     validation (e.g. a rule this file doesn't yet know) still maps back to the right widget via
+ *     `widgetIndexFromField`.
+ */
+export declare const GRID_COLUMNS = 12;
+export declare const MAX_WIDGETS = 24;
+export declare const WIDGET_TYPES: readonly ["KPI", "CHART", "TABLE", "TEXT"];
+export type WidgetType = (typeof WIDGET_TYPES)[number];
+export declare const REPORT_SOURCES: readonly ["PROJECT_STATUS", "VELOCITY", "BURNDOWN", "CUMULATIVE_FLOW", "CYCLE_TIME", "THROUGHPUT", "QUALITY_METRICS", "DELIVERY_KPIS", "BUDGET_VARIANCE", "TIME_BY_PERSON", "STATUS_FLOW", "WORK_BREAKDOWN", "TEAM_WORKLOAD", "RISKS", "WORK_ITEMS"];
+export type ReportSource = (typeof REPORT_SOURCES)[number];
+export type WidgetParamKey = 'projectId' | 'sprintId' | 'teamId' | 'from' | 'to' | 'limit';
+export interface SourceSpec {
+    label: string;
+    description: string;
+    group: string;
+    allowedParams: readonly WidgetParamKey[];
+}
+/** 1:1 with wspace-planmagnet-svc's REPORT_SOURCE_SPECS — see this file's header. */
+export declare const REPORT_SOURCE_SPECS: Record<ReportSource, SourceSpec>;
+/** Sources grouped for the "Add widget" dialog, in a fixed, reviewed order (not alphabetical / enum order). */
+export declare const SOURCE_GROUPS: {
+    group: string;
+    sources: ReportSource[];
+}[];
+export declare function isReportSource(value: string): value is ReportSource;
+export declare const PARAM_LABELS: Record<WidgetParamKey, string>;
+export interface WidgetLayout {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface WidgetParams {
+    projectId?: string | null;
+    sprintId?: string | null;
+    teamId?: string | null;
+    from?: string | null;
+    to?: string | null;
+    limit?: number | null;
+}
+export interface ReportWidget {
+    id: string;
+    type: WidgetType;
+    title: string;
+    source: ReportSource;
+    params: WidgetParams;
+    layout: WidgetLayout;
+}
+export interface ReportDefinition {
+    widgets: ReportWidget[];
+}
+export type ReportVisibility = 'PRIVATE' | 'WORKSPACE';
+export interface ReportSummary {
+    id: string;
+    name: string;
+    description: string | null;
+    ownerId: string;
+    visibility: ReportVisibility;
+    templateKey: string | null;
+    workspaceId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ReportRecord extends ReportSummary {
+    definition: ReportDefinition;
+}
+export interface ReportTemplate {
+    key: string;
+    name: string;
+    description: string;
+    definition: ReportDefinition;
+}
+export type WidgetRunStatus = 'OK' | 'FORBIDDEN' | 'ERROR';
+export interface WidgetRunResult {
+    widgetId: string;
+    source: ReportSource;
+    status: WidgetRunStatus;
+    message: string | null;
+    result: unknown;
+}
+export type ReportRunTrigger = 'MANUAL' | 'SCHEDULE';
+export type ReportDeliveryStatus = 'PENDING_NOTIFICATIONS';
+export interface ReportRun {
+    id: string;
+    reportId: string;
+    workspaceId: string;
+    trigger: ReportRunTrigger;
+    generatedAt: string;
+    generatedBy: string;
+    deliveryStatus: ReportDeliveryStatus | null;
+    widgets: WidgetRunResult[];
+}
+export type ReportScheduleCadence = 'DAILY' | 'WEEKLY' | 'MONTHLY';
+export type ReportExportFormat = 'CSV' | 'JSON' | 'XML';
+export interface ReportSchedule {
+    id: string;
+    reportId: string;
+    workspaceId: string;
+    active: boolean;
+    cadence: ReportScheduleCadence;
+    hourUtc: number;
+    dayOfWeek: number | null;
+    dayOfMonth: number | null;
+    format: ReportExportFormat;
+    recipientIds: string[];
+    nextRunAt: string;
+    lastRunAt: string | null;
+    lastRunId: string | null;
+    lastError: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ReportShare {
+    id: string;
+    reportId: string;
+    workspaceId: string;
+    createdBy: string;
+    createdAt: string;
+    expiresAt: string;
+    revokedAt: string | null;
+    hasPassword: boolean;
+    watermark: string;
+    accessCount: number;
+    lastAccessedAt: string | null;
+    runId: string;
+    /** Only set on the response of the create mutation — never stored, never returned again. */
+    token?: string | null;
+}
+export interface SharedReport {
+    reportName: string;
+    generatedAt: string;
+    watermark: string;
+    widgets: WidgetRunResult[];
+}
+/**
+ * Left-to-right, wrap-on-overflow shelf pack over the 12-column grid, in array order. The same rule CSS
+ * flex-wrap renders visually (`ReportGridCanvas.tsx` uses `width: w/12 * 100%` on flex-wrap children), so the
+ * on-screen order always matches the persisted `layout`. Every widget's `w` is clamped to at most
+ * `GRID_COLUMNS` first, so a corrupt/legacy value can never produce an unsatisfiable layout.
+ */
+export declare function packLayout<T extends {
+    id: string;
+    w: number;
+    h: number;
+}>(widgets: readonly T[]): Map<string, WidgetLayout>;
+/** Re-derives every widget's `layout` from its position in `widgets` (order = reading/visual order) and its
+ *  own `w`/`h`, discarding whatever `x`/`y` it already carried — those are a rendering consequence, not
+ *  independent state, once only reorder+resize (not free placement) are exposed. */
+export declare function repackWidgets(widgets: ReportWidget[]): ReportWidget[];
+export interface FieldError {
+    /** e.g. "definition.widgets[2].params.projectId" — matches the server's own `extensions.field`. */
+    field: string;
+    message: string;
+}
+/** The widget index a server or client field-scoped error refers to, or null for a report-level field
+ *  (name/description/visibility) or one this pattern doesn't recognize. */
+export declare function widgetIndexFromField(field: string | undefined | null): number | null;
+export declare function validateReportDraft(widgets: ReportWidget[]): FieldError[];
+/** A widget id unique within this browser session — the server only requires uniqueness within one report, but
+ *  a monotonic counter plus a random suffix means two widgets added in the same millisecond never collide. */
+export declare function newWidgetId(): string;
+export declare function blankWidget(source?: ReportSource): ReportWidget;
+export type Row = Record<string, unknown>;
+/** Only this widget's own primitive fields — never a nested array/object, so a table/KPI never tries to render
+ *  `children`/`context`/etc. as a cell value. */
+export declare function scalarFields(row: Row): [string, string | number | boolean][];
+/**
+ * Finds the rows a CHART/TABLE widget should render from an arbitrary result: the result itself when it is
+ * already an array of objects, otherwise the first array-valued property of an object result (covers every
+ * executor in report-run.service.ts: `sprints`, `points`, `items`, `projects`, or a bare array), otherwise a
+ * single-row table of the object's own scalar fields (PROJECT_STATUS, DELIVERY_KPIS, QUALITY_METRICS,
+ * CYCLE_TIME's own summary fields).
+ */
+export declare function extractRows(result: unknown): Row[];
+/** camelCase/SCREAMING_SNAKE -> "Camel Case" / "Screaming Snake", for a generic field-name label. */
+export declare function humanizeKey(key: string): string;
+/** The best field to use as a chart's category axis / a row's display label, preferring identity-ish fields. */
+export declare function pickLabelField(rows: Row[]): string | null;
+/** Numeric fields present on (almost) every row, in first-seen order, excluding the label field. */
+export declare function pickNumericFields(rows: Row[], excludeKey: string | null): string[];
+//# sourceMappingURL=reportModel.d.ts.map

package/dist/planmagnet/reports/reportModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportModel.d.ts","sourceRoot":"","sources":["../../../src/planmagnet/reports/reportModel.ts"],"names":[],"mappings":"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"}