@burdenoff/microfe-planmagnet 2026.930.25 → 2026.1001.2

package/dist/planmagnet/reports/reportModel.js

@@ -0,0 +1,328 @@
+var e = [
+	"KPI",
+	"CHART",
+	"TABLE",
+	"TEXT"
+], t = [
+	"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"
+], n = [
+	"projectId",
+	"sprintId",
+	"teamId",
+	"from",
+	"to",
+	"limit"
+], r = {
+	PROJECT_STATUS: {
+		label: "Project status",
+		description: "A project's key, name, status and methodology.",
+		group: "Projects & work",
+		allowedParams: ["projectId"]
+	},
+	WORK_ITEMS: {
+		label: "Work items",
+		description: "A list of work items, optionally scoped to a project or sprint.",
+		group: "Projects & work",
+		allowedParams: [
+			"projectId",
+			"sprintId",
+			"limit"
+		]
+	},
+	WORK_BREAKDOWN: {
+		label: "Work breakdown",
+		description: "Open vs. done items and points, by epic, for one or every project.",
+		group: "Projects & work",
+		allowedParams: ["projectId"]
+	},
+	VELOCITY: {
+		label: "Sprint velocity",
+		description: "A project's completed points per sprint, trailing sprints, with a next-sprint forecast.",
+		group: "Delivery & flow",
+		allowedParams: ["projectId", "limit"]
+	},
+	BURNDOWN: {
+		label: "Sprint burndown",
+		description: "Daily remaining-work readings for a single sprint.",
+		group: "Delivery & flow",
+		allowedParams: ["sprintId"]
+	},
+	CUMULATIVE_FLOW: {
+		label: "Cumulative flow",
+		description: "Work-item counts by status, by day, over a date range.",
+		group: "Delivery & flow",
+		allowedParams: [
+			"projectId",
+			"from",
+			"to"
+		]
+	},
+	THROUGHPUT: {
+		label: "Throughput",
+		description: "Items and points completed per week, over a date range.",
+		group: "Delivery & flow",
+		allowedParams: [
+			"projectId",
+			"from",
+			"to"
+		]
+	},
+	CYCLE_TIME: {
+		label: "Cycle time",
+		description: "Average and median hours from in-progress to done, over a date range.",
+		group: "Delivery & flow",
+		allowedParams: [
+			"projectId",
+			"from",
+			"to"
+		]
+	},
+	STATUS_FLOW: {
+		label: "Status flow",
+		description: "Status-to-status transition counts over a date range.",
+		group: "Delivery & flow",
+		allowedParams: [
+			"projectId",
+			"from",
+			"to"
+		]
+	},
+	DELIVERY_KPIS: {
+		label: "Delivery KPIs",
+		description: "On-time release and milestone rates over a date range.",
+		group: "Delivery & flow",
+		allowedParams: [
+			"projectId",
+			"from",
+			"to"
+		]
+	},
+	QUALITY_METRICS: {
+		label: "Quality metrics",
+		description: "Bugs opened/resolved, defect ratio and gate pass rate over a date range.",
+		group: "Quality",
+		allowedParams: [
+			"projectId",
+			"from",
+			"to"
+		]
+	},
+	RISKS: {
+		label: "Risks",
+		description: "A project's risk register.",
+		group: "Quality",
+		allowedParams: ["projectId", "limit"]
+	},
+	BUDGET_VARIANCE: {
+		label: "Budget variance",
+		description: "A project's budgets, spend vs. total and variance.",
+		group: "Budget & time",
+		allowedParams: ["projectId", "limit"]
+	},
+	TIME_BY_PERSON: {
+		label: "Time by person",
+		description: "Logged hours by person, over a date range.",
+		group: "Budget & time",
+		allowedParams: [
+			"projectId",
+			"from",
+			"to",
+			"limit"
+		]
+	},
+	TEAM_WORKLOAD: {
+		label: "Team workload",
+		description: "A team's members and their open item/point counts.",
+		group: "Budget & time",
+		allowedParams: ["teamId", "limit"]
+	}
+}, i = (() => {
+	let e = [
+		"Projects & work",
+		"Delivery & flow",
+		"Quality",
+		"Budget & time"
+	], n = new Map(e.map((e) => [e, []]));
+	for (let e of t) {
+		let t = r[e].group;
+		n.get(t)?.push(e);
+	}
+	return e.map((e) => ({
+		group: e,
+		sources: n.get(e) ?? []
+	}));
+})();
+function a(e) {
+	return t.includes(e);
+}
+var o = {
+	projectId: "Project",
+	sprintId: "Sprint",
+	teamId: "Team",
+	from: "From",
+	to: "To",
+	limit: "Limit"
+};
+function s(e) {
+	let t = /* @__PURE__ */ new Map(), n = 0, r = 0, i = 0;
+	for (let a of e) {
+		let e = Math.min(Math.max(1, Math.round(a.w)), 12), o = Math.max(1, Math.round(a.h));
+		n + e > 12 && (n = 0, r += i, i = 0), t.set(a.id, {
+			x: n,
+			y: r,
+			w: e,
+			h: o
+		}), n += e, i = Math.max(i, o);
+	}
+	return t;
+}
+function c(e) {
+	let t = s(e.map((e) => ({
+		id: e.id,
+		w: e.layout.w,
+		h: e.layout.h
+	})));
+	return e.map((e) => ({
+		...e,
+		layout: t.get(e.id) ?? e.layout
+	}));
+}
+function l(e) {
+	let t = e?.match(/^definition\.widgets\[(\d+)\]/);
+	return t ? Number(t[1]) : null;
+}
+function u(t) {
+	let i = [];
+	if (t.length === 0) return i.push({
+		field: "definition.widgets",
+		message: "Add at least one widget."
+	}), i;
+	t.length > 24 && i.push({
+		field: "definition.widgets",
+		message: `At most 24 widgets are allowed (this report has ${t.length}).`
+	});
+	let s = /* @__PURE__ */ new Set();
+	return t.forEach((t, c) => {
+		let l = `definition.widgets[${c}]`;
+		if (t.id.trim() ? s.has(t.id) ? i.push({
+			field: `${l}.id`,
+			message: "Widget ids must be unique."
+		}) : s.add(t.id) : i.push({
+			field: `${l}.id`,
+			message: "Widget is missing an id."
+		}), e.includes(t.type) || i.push({
+			field: `${l}.type`,
+			message: "Choose a widget type."
+		}), t.title.trim() || i.push({
+			field: `${l}.title`,
+			message: "Give this widget a title."
+		}), !a(t.source)) i.push({
+			field: `${l}.source`,
+			message: "Choose a data source."
+		});
+		else {
+			let e = new Set(r[t.source].allowedParams);
+			for (let a of n) {
+				let n = t.params[a];
+				n == null || n === "" || e.has(a) || i.push({
+					field: `${l}.params.${a}`,
+					message: `${o[a]} isn't used by ${r[t.source].label}.`
+				});
+			}
+			t.params.limit !== void 0 && t.params.limit !== null && (!Number.isInteger(t.params.limit) || t.params.limit < 1) && i.push({
+				field: `${l}.params.limit`,
+				message: "Limit must be a whole number of 1 or more."
+			});
+		}
+		(!Number.isInteger(t.layout.w) || t.layout.w < 1 || t.layout.w > 12) && i.push({
+			field: `${l}.layout.w`,
+			message: "Width must be between 1 and 12."
+		}), (!Number.isInteger(t.layout.h) || t.layout.h < 1) && i.push({
+			field: `${l}.layout.h`,
+			message: "Height must be 1 or more."
+		});
+	}), i;
+}
+var d = 0;
+function f() {
+	return d += 1, `w${Date.now().toString(36)}${d}${Math.random().toString(36).slice(2, 6)}`;
+}
+function p(e = "WORK_ITEMS") {
+	return {
+		id: f(),
+		type: "TABLE",
+		title: r[e].label,
+		source: e,
+		params: {},
+		layout: {
+			x: 0,
+			y: 0,
+			w: 6,
+			h: 4
+		}
+	};
+}
+function m(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function h(e) {
+	return typeof e == "string" || typeof e == "number" || typeof e == "boolean";
+}
+function g(e) {
+	return Object.entries(e).filter((e) => h(e[1]));
+}
+function _(e) {
+	if (Array.isArray(e)) return e.filter(m);
+	if (!m(e)) return [];
+	for (let t of Object.values(e)) if (Array.isArray(t) && t.every(m)) return t;
+	return [e];
+}
+function v(e) {
+	let t = e.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/_/g, " ").toLowerCase();
+	return t.charAt(0).toUpperCase() + t.slice(1);
+}
+var y = [
+	"name",
+	"title",
+	"label",
+	"key",
+	"projectName",
+	"sprintName",
+	"userId",
+	"actorId",
+	"periodStart",
+	"date",
+	"fromStatus",
+	"status",
+	"id"
+];
+function b(e) {
+	if (e.length === 0) return null;
+	let t = new Set(e.flatMap((e) => g(e).map(([e]) => e)));
+	for (let e of y) if (t.has(e)) return e;
+	return [...t].find((t) => typeof e[0]?.[t] == "string") ?? null;
+}
+function x(e, t) {
+	let n = /* @__PURE__ */ new Map(), r = [];
+	for (let i of e) for (let [e, a] of g(i)) e === t || typeof a != "number" || (n.has(e) || r.push(e), n.set(e, (n.get(e) ?? 0) + 1));
+	let i = Math.max(1, Math.ceil(e.length / 2));
+	return r.filter((e) => (n.get(e) ?? 0) >= i);
+}
+//#endregion
+export { o as PARAM_LABELS, r as REPORT_SOURCE_SPECS, i as SOURCE_GROUPS, e as WIDGET_TYPES, p as blankWidget, _ as extractRows, v as humanizeKey, f as newWidgetId, b as pickLabelField, x as pickNumericFields, c as repackWidgets, g as scalarFields, u as validateReportDraft, l as widgetIndexFromField };
+
+//# sourceMappingURL=reportModel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reportModel.js","names":[],"sources":["../../../src/planmagnet/reports/reportModel.ts"],"sourcesContent":["/**\n * Reports (ANR-13/14/15/16, BOFF-8048 follow-on): shared types, source metadata and pure helpers for the report\n * builder + viewer. Mirrors the server's own source-of-truth so the UI never drifts from what actually runs:\n *\n *   - `REPORT_SOURCE_SPECS` mirrors wspace-planmagnet-svc's `report-sources.ts` (`REPORT_SOURCE_SPECS`) — the\n *     per-source allowed param keys. A param a source doesn't use is rejected at save time by the server with a\n *     field-scoped BAD_USER_INPUT; this file's `allowedParams` lets the builder never offer that param in the\n *     first place, and `validateWidgetDraft` catches it before the round trip.\n *   - `packLayout` decides where each widget sits on the 12-column grid from its position in the widgets array\n *     (the builder's reorder controls) and its own `w`/`h` — a left-to-right, wrap-on-overflow shelf pack, the\n *     same algorithm CSS flex-wrap performs visually (see `ReportGridCanvas.tsx`), so the preview and the\n *     persisted `layout` never disagree. There is no free-form drag-to-position: only reorder (where) and\n *     resize (how big) are exposed, so every layout this UI can produce is representable and always passes the\n *     server's bounds check (`x >= 0`, `y >= 0`, `w >= 1`, `h >= 1`, `x + w <= 12`).\n *   - `validateReportDraft` mirrors wspace-planmagnet-svc's `report-definition.ts` (`assertReportDefinition`)\n *     closely enough that a draft which passes it also passes the server — widget count (1..24), unique ids,\n *     required type/title/source, and params restricted to the ones the widget's source actually reads. Field\n *     paths match the server's own (`definition.widgets[i].…`) so a BAD_USER_INPUT that slips past client\n *     validation (e.g. a rule this file doesn't yet know) still maps back to the right widget via\n *     `widgetIndexFromField`.\n */\n\nexport const GRID_COLUMNS = 12;\nexport const MAX_WIDGETS = 24;\n\nexport const WIDGET_TYPES = ['KPI', 'CHART', 'TABLE', 'TEXT'] as const;\nexport type WidgetType = (typeof WIDGET_TYPES)[number];\n\nexport const REPORT_SOURCES = [\n  'PROJECT_STATUS',\n  'VELOCITY',\n  'BURNDOWN',\n  'CUMULATIVE_FLOW',\n  'CYCLE_TIME',\n  'THROUGHPUT',\n  'QUALITY_METRICS',\n  'DELIVERY_KPIS',\n  'BUDGET_VARIANCE',\n  'TIME_BY_PERSON',\n  'STATUS_FLOW',\n  'WORK_BREAKDOWN',\n  'TEAM_WORKLOAD',\n  'RISKS',\n  'WORK_ITEMS',\n] as const;\nexport type ReportSource = (typeof REPORT_SOURCES)[number];\n\nexport type WidgetParamKey = 'projectId' | 'sprintId' | 'teamId' | 'from' | 'to' | 'limit';\nconst ALL_PARAM_KEYS: readonly WidgetParamKey[] = [\n  'projectId',\n  'sprintId',\n  'teamId',\n  'from',\n  'to',\n  'limit',\n];\n\nexport interface SourceSpec {\n  label: string;\n  description: string;\n  group: string;\n  allowedParams: readonly WidgetParamKey[];\n}\n\n/** 1:1 with wspace-planmagnet-svc's REPORT_SOURCE_SPECS — see this file's header. */\nexport const REPORT_SOURCE_SPECS: Record<ReportSource, SourceSpec> = {\n  PROJECT_STATUS: {\n    label: 'Project status',\n    description: \"A project's key, name, status and methodology.\",\n    group: 'Projects & work',\n    allowedParams: ['projectId'],\n  },\n  WORK_ITEMS: {\n    label: 'Work items',\n    description: 'A list of work items, optionally scoped to a project or sprint.',\n    group: 'Projects & work',\n    allowedParams: ['projectId', 'sprintId', 'limit'],\n  },\n  WORK_BREAKDOWN: {\n    label: 'Work breakdown',\n    description: 'Open vs. done items and points, by epic, for one or every project.',\n    group: 'Projects & work',\n    allowedParams: ['projectId'],\n  },\n  VELOCITY: {\n    label: 'Sprint velocity',\n    description:\n      \"A project's completed points per sprint, trailing sprints, with a next-sprint forecast.\",\n    group: 'Delivery & flow',\n    allowedParams: ['projectId', 'limit'],\n  },\n  BURNDOWN: {\n    label: 'Sprint burndown',\n    description: 'Daily remaining-work readings for a single sprint.',\n    group: 'Delivery & flow',\n    allowedParams: ['sprintId'],\n  },\n  CUMULATIVE_FLOW: {\n    label: 'Cumulative flow',\n    description: 'Work-item counts by status, by day, over a date range.',\n    group: 'Delivery & flow',\n    allowedParams: ['projectId', 'from', 'to'],\n  },\n  THROUGHPUT: {\n    label: 'Throughput',\n    description: 'Items and points completed per week, over a date range.',\n    group: 'Delivery & flow',\n    allowedParams: ['projectId', 'from', 'to'],\n  },\n  CYCLE_TIME: {\n    label: 'Cycle time',\n    description: 'Average and median hours from in-progress to done, over a date range.',\n    group: 'Delivery & flow',\n    allowedParams: ['projectId', 'from', 'to'],\n  },\n  STATUS_FLOW: {\n    label: 'Status flow',\n    description: 'Status-to-status transition counts over a date range.',\n    group: 'Delivery & flow',\n    allowedParams: ['projectId', 'from', 'to'],\n  },\n  DELIVERY_KPIS: {\n    label: 'Delivery KPIs',\n    description: 'On-time release and milestone rates over a date range.',\n    group: 'Delivery & flow',\n    allowedParams: ['projectId', 'from', 'to'],\n  },\n  QUALITY_METRICS: {\n    label: 'Quality metrics',\n    description: 'Bugs opened/resolved, defect ratio and gate pass rate over a date range.',\n    group: 'Quality',\n    allowedParams: ['projectId', 'from', 'to'],\n  },\n  RISKS: {\n    label: 'Risks',\n    description: \"A project's risk register.\",\n    group: 'Quality',\n    allowedParams: ['projectId', 'limit'],\n  },\n  BUDGET_VARIANCE: {\n    label: 'Budget variance',\n    description: \"A project's budgets, spend vs. total and variance.\",\n    group: 'Budget & time',\n    allowedParams: ['projectId', 'limit'],\n  },\n  TIME_BY_PERSON: {\n    label: 'Time by person',\n    description: 'Logged hours by person, over a date range.',\n    group: 'Budget & time',\n    allowedParams: ['projectId', 'from', 'to', 'limit'],\n  },\n  TEAM_WORKLOAD: {\n    label: 'Team workload',\n    description: \"A team's members and their open item/point counts.\",\n    group: 'Budget & time',\n    allowedParams: ['teamId', 'limit'],\n  },\n};\n\n/** Sources grouped for the \"Add widget\" dialog, in a fixed, reviewed order (not alphabetical / enum order). */\nexport const SOURCE_GROUPS: { group: string; sources: ReportSource[] }[] = (() => {\n  const order = ['Projects & work', 'Delivery & flow', 'Quality', 'Budget & time'];\n  const groups = new Map<string, ReportSource[]>(order.map((g) => [g, []]));\n  for (const source of REPORT_SOURCES) {\n    const group = REPORT_SOURCE_SPECS[source].group;\n    groups.get(group)?.push(source);\n  }\n  return order.map((group) => ({ group, sources: groups.get(group) ?? [] }));\n})();\n\nexport function isReportSource(value: string): value is ReportSource {\n  return (REPORT_SOURCES as readonly string[]).includes(value);\n}\n\nexport const PARAM_LABELS: Record<WidgetParamKey, string> = {\n  projectId: 'Project',\n  sprintId: 'Sprint',\n  teamId: 'Team',\n  from: 'From',\n  to: 'To',\n  limit: 'Limit',\n};\n\n// ─── Wire types (match graphql/wspace.graphql's Planmagnet* Report types exactly) ────────────────────────────\n\nexport interface WidgetLayout {\n  x: number;\n  y: number;\n  w: number;\n  h: number;\n}\n\nexport interface WidgetParams {\n  projectId?: string | null;\n  sprintId?: string | null;\n  teamId?: string | null;\n  from?: string | null;\n  to?: string | null;\n  limit?: number | null;\n}\n\nexport interface ReportWidget {\n  id: string;\n  type: WidgetType;\n  title: string;\n  source: ReportSource;\n  params: WidgetParams;\n  layout: WidgetLayout;\n}\n\nexport interface ReportDefinition {\n  widgets: ReportWidget[];\n}\n\nexport type ReportVisibility = 'PRIVATE' | 'WORKSPACE';\n\nexport interface ReportSummary {\n  id: string;\n  name: string;\n  description: string | null;\n  ownerId: string;\n  visibility: ReportVisibility;\n  templateKey: string | null;\n  workspaceId: string;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ReportRecord extends ReportSummary {\n  definition: ReportDefinition;\n}\n\nexport interface ReportTemplate {\n  key: string;\n  name: string;\n  description: string;\n  definition: ReportDefinition;\n}\n\nexport type WidgetRunStatus = 'OK' | 'FORBIDDEN' | 'ERROR';\n\nexport interface WidgetRunResult {\n  widgetId: string;\n  source: ReportSource;\n  status: WidgetRunStatus;\n  message: string | null;\n  result: unknown;\n}\n\nexport type ReportRunTrigger = 'MANUAL' | 'SCHEDULE';\nexport type ReportDeliveryStatus = 'PENDING_NOTIFICATIONS';\n\nexport interface ReportRun {\n  id: string;\n  reportId: string;\n  workspaceId: string;\n  trigger: ReportRunTrigger;\n  generatedAt: string;\n  generatedBy: string;\n  deliveryStatus: ReportDeliveryStatus | null;\n  widgets: WidgetRunResult[];\n}\n\nexport type ReportScheduleCadence = 'DAILY' | 'WEEKLY' | 'MONTHLY';\nexport type ReportExportFormat = 'CSV' | 'JSON' | 'XML';\n\nexport interface ReportSchedule {\n  id: string;\n  reportId: string;\n  workspaceId: string;\n  active: boolean;\n  cadence: ReportScheduleCadence;\n  hourUtc: number;\n  dayOfWeek: number | null;\n  dayOfMonth: number | null;\n  format: ReportExportFormat;\n  recipientIds: string[];\n  nextRunAt: string;\n  lastRunAt: string | null;\n  lastRunId: string | null;\n  lastError: string | null;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ReportShare {\n  id: string;\n  reportId: string;\n  workspaceId: string;\n  createdBy: string;\n  createdAt: string;\n  expiresAt: string;\n  revokedAt: string | null;\n  hasPassword: boolean;\n  watermark: string;\n  accessCount: number;\n  lastAccessedAt: string | null;\n  runId: string;\n  /** Only set on the response of the create mutation — never stored, never returned again. */\n  token?: string | null;\n}\n\nexport interface SharedReport {\n  reportName: string;\n  generatedAt: string;\n  watermark: string;\n  widgets: WidgetRunResult[];\n}\n\n// ─── Layout packing ───────────────────────────────────────────────────────────────────────────────────────\n\n/**\n * Left-to-right, wrap-on-overflow shelf pack over the 12-column grid, in array order. The same rule CSS\n * flex-wrap renders visually (`ReportGridCanvas.tsx` uses `width: w/12 * 100%` on flex-wrap children), so the\n * on-screen order always matches the persisted `layout`. Every widget's `w` is clamped to at most\n * `GRID_COLUMNS` first, so a corrupt/legacy value can never produce an unsatisfiable layout.\n */\nexport function packLayout<T extends { id: string; w: number; h: number }>(\n  widgets: readonly T[]\n): Map<string, WidgetLayout> {\n  const layouts = new Map<string, WidgetLayout>();\n  let x = 0;\n  let y = 0;\n  let rowHeight = 0;\n  for (const widget of widgets) {\n    const w = Math.min(Math.max(1, Math.round(widget.w)), GRID_COLUMNS);\n    const h = Math.max(1, Math.round(widget.h));\n    if (x + w > GRID_COLUMNS) {\n      x = 0;\n      y += rowHeight;\n      rowHeight = 0;\n    }\n    layouts.set(widget.id, { x, y, w, h });\n    x += w;\n    rowHeight = Math.max(rowHeight, h);\n  }\n  return layouts;\n}\n\n/** Re-derives every widget's `layout` from its position in `widgets` (order = reading/visual order) and its\n *  own `w`/`h`, discarding whatever `x`/`y` it already carried — those are a rendering consequence, not\n *  independent state, once only reorder+resize (not free placement) are exposed. */\nexport function repackWidgets(widgets: ReportWidget[]): ReportWidget[] {\n  const layouts = packLayout(widgets.map((w) => ({ id: w.id, w: w.layout.w, h: w.layout.h })));\n  return widgets.map((w) => ({ ...w, layout: layouts.get(w.id) ?? w.layout }));\n}\n\n// ─── Validation (mirrors report-definition.ts's assertReportDefinition) ──────────────────────────────────────\n\nexport interface FieldError {\n  /** e.g. \"definition.widgets[2].params.projectId\" — matches the server's own `extensions.field`. */\n  field: string;\n  message: string;\n}\n\n/** The widget index a server or client field-scoped error refers to, or null for a report-level field\n *  (name/description/visibility) or one this pattern doesn't recognize. */\nexport function widgetIndexFromField(field: string | undefined | null): number | null {\n  const match = field?.match(/^definition\\.widgets\\[(\\d+)\\]/);\n  return match ? Number(match[1]) : null;\n}\n\nexport function validateReportDraft(widgets: ReportWidget[]): FieldError[] {\n  const errors: FieldError[] = [];\n  if (widgets.length === 0) {\n    errors.push({ field: 'definition.widgets', message: 'Add at least one widget.' });\n    return errors;\n  }\n  if (widgets.length > MAX_WIDGETS) {\n    errors.push({\n      field: 'definition.widgets',\n      message: `At most ${MAX_WIDGETS} widgets are allowed (this report has ${widgets.length}).`,\n    });\n  }\n  const seenIds = new Set<string>();\n  widgets.forEach((widget, index) => {\n    const field = `definition.widgets[${index}]`;\n    if (!widget.id.trim()) {\n      errors.push({ field: `${field}.id`, message: 'Widget is missing an id.' });\n    } else if (seenIds.has(widget.id)) {\n      errors.push({ field: `${field}.id`, message: 'Widget ids must be unique.' });\n    } else {\n      seenIds.add(widget.id);\n    }\n    if (!WIDGET_TYPES.includes(widget.type)) {\n      errors.push({ field: `${field}.type`, message: 'Choose a widget type.' });\n    }\n    if (!widget.title.trim()) {\n      errors.push({ field: `${field}.title`, message: 'Give this widget a title.' });\n    }\n    if (!isReportSource(widget.source)) {\n      errors.push({ field: `${field}.source`, message: 'Choose a data source.' });\n    } else {\n      const allowed = new Set<string>(REPORT_SOURCE_SPECS[widget.source].allowedParams);\n      for (const key of ALL_PARAM_KEYS) {\n        const value = widget.params[key];\n        if (value === undefined || value === null || value === '') continue;\n        if (!allowed.has(key)) {\n          errors.push({\n            field: `${field}.params.${key}`,\n            message: `${PARAM_LABELS[key]} isn't used by ${REPORT_SOURCE_SPECS[widget.source].label}.`,\n          });\n        }\n      }\n      if (widget.params.limit !== undefined && widget.params.limit !== null) {\n        if (!Number.isInteger(widget.params.limit) || widget.params.limit < 1) {\n          errors.push({\n            field: `${field}.params.limit`,\n            message: 'Limit must be a whole number of 1 or more.',\n          });\n        }\n      }\n    }\n    if (\n      !Number.isInteger(widget.layout.w) ||\n      widget.layout.w < 1 ||\n      widget.layout.w > GRID_COLUMNS\n    ) {\n      errors.push({\n        field: `${field}.layout.w`,\n        message: `Width must be between 1 and ${GRID_COLUMNS}.`,\n      });\n    }\n    if (!Number.isInteger(widget.layout.h) || widget.layout.h < 1) {\n      errors.push({ field: `${field}.layout.h`, message: 'Height must be 1 or more.' });\n    }\n  });\n  return errors;\n}\n\nlet idCounter = 0;\n/** A widget id unique within this browser session — the server only requires uniqueness within one report, but\n *  a monotonic counter plus a random suffix means two widgets added in the same millisecond never collide. */\nexport function newWidgetId(): string {\n  idCounter += 1;\n  return `w${Date.now().toString(36)}${idCounter}${Math.random().toString(36).slice(2, 6)}`;\n}\n\nexport function blankWidget(source: ReportSource = 'WORK_ITEMS'): ReportWidget {\n  return {\n    id: newWidgetId(),\n    type: 'TABLE',\n    title: REPORT_SOURCE_SPECS[source].label,\n    source,\n    params: {},\n    layout: { x: 0, y: 0, w: 6, h: 4 },\n  };\n}\n\n// ─── Generic result shaping (for the widget renderer) ─────────────────────────────────────────────────────────\n\nexport type Row = Record<string, unknown>;\n\nfunction isPlainObject(value: unknown): value is Row {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isScalar(value: unknown): value is string | number | boolean {\n  return typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean';\n}\n\n/** Only this widget's own primitive fields — never a nested array/object, so a table/KPI never tries to render\n *  `children`/`context`/etc. as a cell value. */\nexport function scalarFields(row: Row): [string, string | number | boolean][] {\n  return Object.entries(row).filter((entry): entry is [string, string | number | boolean] =>\n    isScalar(entry[1])\n  );\n}\n\n/**\n * Finds the rows a CHART/TABLE widget should render from an arbitrary result: the result itself when it is\n * already an array of objects, otherwise the first array-valued property of an object result (covers every\n * executor in report-run.service.ts: `sprints`, `points`, `items`, `projects`, or a bare array), otherwise a\n * single-row table of the object's own scalar fields (PROJECT_STATUS, DELIVERY_KPIS, QUALITY_METRICS,\n * CYCLE_TIME's own summary fields).\n */\nexport function extractRows(result: unknown): Row[] {\n  if (Array.isArray(result)) return result.filter(isPlainObject);\n  if (!isPlainObject(result)) return [];\n  for (const value of Object.values(result)) {\n    if (Array.isArray(value) && value.every(isPlainObject)) return value as Row[];\n  }\n  return [result];\n}\n\n/** camelCase/SCREAMING_SNAKE -> \"Camel Case\" / \"Screaming Snake\", for a generic field-name label. */\nexport function humanizeKey(key: string): string {\n  const spaced = key\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .replace(/_/g, ' ')\n    .toLowerCase();\n  return spaced.charAt(0).toUpperCase() + spaced.slice(1);\n}\n\nconst LABEL_KEY_PRIORITY = [\n  'name',\n  'title',\n  'label',\n  'key',\n  'projectName',\n  'sprintName',\n  'userId',\n  'actorId',\n  'periodStart',\n  'date',\n  'fromStatus',\n  'status',\n  'id',\n];\n\n/** The best field to use as a chart's category axis / a row's display label, preferring identity-ish fields. */\nexport function pickLabelField(rows: Row[]): string | null {\n  if (rows.length === 0) return null;\n  const keys = new Set(rows.flatMap((row) => scalarFields(row).map(([k]) => k)));\n  for (const candidate of LABEL_KEY_PRIORITY) {\n    if (keys.has(candidate)) return candidate;\n  }\n  const firstString = [...keys].find((k) => typeof rows[0]?.[k] === 'string');\n  return firstString ?? null;\n}\n\n/** Numeric fields present on (almost) every row, in first-seen order, excluding the label field. */\nexport function pickNumericFields(rows: Row[], excludeKey: string | null): string[] {\n  const counts = new Map<string, number>();\n  const order: string[] = [];\n  for (const row of rows) {\n    for (const [key, value] of scalarFields(row)) {\n      if (key === excludeKey || typeof value !== 'number') continue;\n      if (!counts.has(key)) order.push(key);\n      counts.set(key, (counts.get(key) ?? 0) + 1);\n    }\n  }\n  const threshold = Math.max(1, Math.ceil(rows.length / 2));\n  return order.filter((key) => (counts.get(key) ?? 0) >= threshold);\n}\n"],"mappings":"AAyBA,IAAa,IAAe;CAAC;CAAO;CAAS;CAAS;CAAO,EAGhD,IAAiB;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,EAIK,IAA4C;CAChD;CACA;CACA;CACA;CACA;CACA;CACD,EAUY,IAAwD;CACnE,gBAAgB;EACd,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe,CAAC,YAAY;EAC7B;CACD,YAAY;EACV,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe;GAAC;GAAa;GAAY;GAAQ;EAClD;CACD,gBAAgB;EACd,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe,CAAC,YAAY;EAC7B;CACD,UAAU;EACR,OAAO;EACP,aACE;EACF,OAAO;EACP,eAAe,CAAC,aAAa,QAAQ;EACtC;CACD,UAAU;EACR,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe,CAAC,WAAW;EAC5B;CACD,iBAAiB;EACf,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe;GAAC;GAAa;GAAQ;GAAK;EAC3C;CACD,YAAY;EACV,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe;GAAC;GAAa;GAAQ;GAAK;EAC3C;CACD,YAAY;EACV,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe;GAAC;GAAa;GAAQ;GAAK;EAC3C;CACD,aAAa;EACX,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe;GAAC;GAAa;GAAQ;GAAK;EAC3C;CACD,eAAe;EACb,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe;GAAC;GAAa;GAAQ;GAAK;EAC3C;CACD,iBAAiB;EACf,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe;GAAC;GAAa;GAAQ;GAAK;EAC3C;CACD,OAAO;EACL,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe,CAAC,aAAa,QAAQ;EACtC;CACD,iBAAiB;EACf,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe,CAAC,aAAa,QAAQ;EACtC;CACD,gBAAgB;EACd,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe;GAAC;GAAa;GAAQ;GAAM;GAAQ;EACpD;CACD,eAAe;EACb,OAAO;EACP,aAAa;EACb,OAAO;EACP,eAAe,CAAC,UAAU,QAAQ;EACnC;CACF,EAGY,WAAqE;CAChF,IAAM,IAAQ;EAAC;EAAmB;EAAmB;EAAW;EAAgB,EAC1E,IAAS,IAAI,IAA4B,EAAM,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACzE,MAAK,IAAM,KAAU,GAAgB;EACnC,IAAM,IAAQ,EAAoB,GAAQ;AAC1C,IAAO,IAAI,EAAM,EAAE,KAAK,EAAO;;AAEjC,QAAO,EAAM,KAAK,OAAW;EAAE;EAAO,SAAS,EAAO,IAAI,EAAM,IAAI,EAAE;EAAE,EAAE;IACxE;AAEJ,SAAgB,EAAe,GAAsC;AACnE,QAAQ,EAAqC,SAAS,EAAM;;AAG9D,IAAa,IAA+C;CAC1D,WAAW;CACX,UAAU;CACV,QAAQ;CACR,MAAM;CACN,IAAI;CACJ,OAAO;CACR;AAwID,SAAgB,EACd,GAC2B;CAC3B,IAAM,oBAAU,IAAI,KAA2B,EAC3C,IAAI,GACJ,IAAI,GACJ,IAAY;AAChB,MAAK,IAAM,KAAU,GAAS;EAC5B,IAAM,IAAI,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,EAAO,EAAE,CAAC,EAAA,GAAe,EAC7D,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,EAAO,EAAE,CAAC;AAQ3C,EAPI,IAAI,IAAA,OACN,IAAI,GACJ,KAAK,GACL,IAAY,IAEd,EAAQ,IAAI,EAAO,IAAI;GAAE;GAAG;GAAG;GAAG;GAAG,CAAC,EACtC,KAAK,GACL,IAAY,KAAK,IAAI,GAAW,EAAE;;AAEpC,QAAO;;AAMT,SAAgB,EAAc,GAAyC;CACrE,IAAM,IAAU,EAAW,EAAQ,KAAK,OAAO;EAAE,IAAI,EAAE;EAAI,GAAG,EAAE,OAAO;EAAG,GAAG,EAAE,OAAO;EAAG,EAAE,CAAC;AAC5F,QAAO,EAAQ,KAAK,OAAO;EAAE,GAAG;EAAG,QAAQ,EAAQ,IAAI,EAAE,GAAG,IAAI,EAAE;EAAQ,EAAE;;AAa9E,SAAgB,EAAqB,GAAiD;CACpF,IAAM,IAAQ,GAAO,MAAM,gCAAgC;AAC3D,QAAO,IAAQ,OAAO,EAAM,GAAG,GAAG;;AAGpC,SAAgB,EAAoB,GAAuC;CACzE,IAAM,IAAuB,EAAE;AAC/B,KAAI,EAAQ,WAAW,EAErB,QADA,EAAO,KAAK;EAAE,OAAO;EAAsB,SAAS;EAA4B,CAAC,EAC1E;AAET,CAAI,EAAQ,SAAA,MACV,EAAO,KAAK;EACV,OAAO;EACP,SAAS,mDAA+D,EAAQ,OAAO;EACxF,CAAC;CAEJ,IAAM,oBAAU,IAAI,KAAa;AAqDjC,QApDA,EAAQ,SAAS,GAAQ,MAAU;EACjC,IAAM,IAAQ,sBAAsB,EAAM;AAc1C,MAbK,EAAO,GAAG,MAAM,GAEV,EAAQ,IAAI,EAAO,GAAG,GAC/B,EAAO,KAAK;GAAE,OAAO,GAAG,EAAM;GAAM,SAAS;GAA8B,CAAC,GAE5E,EAAQ,IAAI,EAAO,GAAG,GAJtB,EAAO,KAAK;GAAE,OAAO,GAAG,EAAM;GAAM,SAAS;GAA4B,CAAC,EAMvE,EAAa,SAAS,EAAO,KAAK,IACrC,EAAO,KAAK;GAAE,OAAO,GAAG,EAAM;GAAQ,SAAS;GAAyB,CAAC,EAEtE,EAAO,MAAM,MAAM,IACtB,EAAO,KAAK;GAAE,OAAO,GAAG,EAAM;GAAS,SAAS;GAA6B,CAAC,EAE5E,CAAC,EAAe,EAAO,OAAO,CAChC,GAAO,KAAK;GAAE,OAAO,GAAG,EAAM;GAAU,SAAS;GAAyB,CAAC;OACtE;GACL,IAAM,IAAU,IAAI,IAAY,EAAoB,EAAO,QAAQ,cAAc;AACjF,QAAK,IAAM,KAAO,GAAgB;IAChC,IAAM,IAAQ,EAAO,OAAO;AACxB,SAAiC,QAAQ,MAAU,MAClD,EAAQ,IAAI,EAAI,IACnB,EAAO,KAAK;KACV,OAAO,GAAG,EAAM,UAAU;KAC1B,SAAS,GAAG,EAAa,GAAK,iBAAiB,EAAoB,EAAO,QAAQ,MAAM;KACzF,CAAC;;AAGN,GAAI,EAAO,OAAO,UAAU,KAAA,KAAa,EAAO,OAAO,UAAU,SAC3D,CAAC,OAAO,UAAU,EAAO,OAAO,MAAM,IAAI,EAAO,OAAO,QAAQ,MAClE,EAAO,KAAK;IACV,OAAO,GAAG,EAAM;IAChB,SAAS;IACV,CAAC;;AAcR,GATE,CAAC,OAAO,UAAU,EAAO,OAAO,EAAE,IAClC,EAAO,OAAO,IAAI,KAClB,EAAO,OAAO,IAAA,OAEd,EAAO,KAAK;GACV,OAAO,GAAG,EAAM;GAChB,SAAS;GACV,CAAC,GAEA,CAAC,OAAO,UAAU,EAAO,OAAO,EAAE,IAAI,EAAO,OAAO,IAAI,MAC1D,EAAO,KAAK;GAAE,OAAO,GAAG,EAAM;GAAY,SAAS;GAA6B,CAAC;GAEnF,EACK;;AAGT,IAAI,IAAY;AAGhB,SAAgB,IAAsB;AAEpC,QADA,KAAa,GACN,IAAI,KAAK,KAAK,CAAC,SAAS,GAAG,GAAG,IAAY,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE;;AAGzF,SAAgB,EAAY,IAAuB,cAA4B;AAC7E,QAAO;EACL,IAAI,GAAa;EACjB,MAAM;EACN,OAAO,EAAoB,GAAQ;EACnC;EACA,QAAQ,EAAE;EACV,QAAQ;GAAE,GAAG;GAAG,GAAG;GAAG,GAAG;GAAG,GAAG;GAAG;EACnC;;AAOH,SAAS,EAAc,GAA8B;AACnD,QAAO,OAAO,KAAU,cAAY,KAAkB,CAAC,MAAM,QAAQ,EAAM;;AAG7E,SAAS,EAAS,GAAoD;AACpE,QAAO,OAAO,KAAU,YAAY,OAAO,KAAU,YAAY,OAAO,KAAU;;AAKpF,SAAgB,EAAa,GAAiD;AAC5E,QAAO,OAAO,QAAQ,EAAI,CAAC,QAAQ,MACjC,EAAS,EAAM,GAAG,CACnB;;AAUH,SAAgB,EAAY,GAAwB;AAClD,KAAI,MAAM,QAAQ,EAAO,CAAE,QAAO,EAAO,OAAO,EAAc;AAC9D,KAAI,CAAC,EAAc,EAAO,CAAE,QAAO,EAAE;AACrC,MAAK,IAAM,KAAS,OAAO,OAAO,EAAO,CACvC,KAAI,MAAM,QAAQ,EAAM,IAAI,EAAM,MAAM,EAAc,CAAE,QAAO;AAEjE,QAAO,CAAC,EAAO;;AAIjB,SAAgB,EAAY,GAAqB;CAC/C,IAAM,IAAS,EACZ,QAAQ,sBAAsB,QAAQ,CACtC,QAAQ,MAAM,IAAI,CAClB,aAAa;AAChB,QAAO,EAAO,OAAO,EAAE,CAAC,aAAa,GAAG,EAAO,MAAM,EAAE;;AAGzD,IAAM,IAAqB;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAGD,SAAgB,EAAe,GAA4B;AACzD,KAAI,EAAK,WAAW,EAAG,QAAO;CAC9B,IAAM,IAAO,IAAI,IAAI,EAAK,SAAS,MAAQ,EAAa,EAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAC9E,MAAK,IAAM,KAAa,EACtB,KAAI,EAAK,IAAI,EAAU,CAAE,QAAO;AAGlC,QADoB,CAAC,GAAG,EAAK,CAAC,MAAM,MAAM,OAAO,EAAK,KAAK,MAAO,SAAS,IACrD;;AAIxB,SAAgB,EAAkB,GAAa,GAAqC;CAClF,IAAM,oBAAS,IAAI,KAAqB,EAClC,IAAkB,EAAE;AAC1B,MAAK,IAAM,KAAO,EAChB,MAAK,IAAM,CAAC,GAAK,MAAU,EAAa,EAAI,CACtC,OAAQ,KAAc,OAAO,KAAU,aACtC,EAAO,IAAI,EAAI,IAAE,EAAM,KAAK,EAAI,EACrC,EAAO,IAAI,IAAM,EAAO,IAAI,EAAI,IAAI,KAAK,EAAE;CAG/C,IAAM,IAAY,KAAK,IAAI,GAAG,KAAK,KAAK,EAAK,SAAS,EAAE,CAAC;AACzD,QAAO,EAAM,QAAQ,OAAS,EAAO,IAAI,EAAI,IAAI,MAAM,EAAU"}

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

@@ -0,0 +1,15 @@
+/**
+ * The public shared-report route (ANR-17). Unlike every other route constant in this package
+ * (`product/routes.ts`, `integrations/routes.ts`), this one is NOT relative to this MFE's `basePath` — the host
+ * shell mounts `SharedReportPage` on its own top-level router, OUTSIDE the authenticated app shell/basePath
+ * tree entirely (no nav chrome, no auth guard), so the path is absolute and fixed. It lives under `/public/`
+ * because fe-libs' shell-route table gives every `/public/*` path the public layout — the product header and
+ * footer, but no sidebar or breadcrumb — so an anonymous reader never sees the signed-in navigation and no host
+ * needs its own exception.
+ */
+export declare const SHARED_REPORT_BASE_PATH = "/public/report";
+/** For the host's own `<Route path={SHARED_REPORT_ROUTE_PATH} element={<SharedReportPage />} />`. */
+export declare const SHARED_REPORT_ROUTE_PATH = "/public/report/:token";
+/** The full, copyable link for a share token, from the current origin. */
+export declare function sharedReportLink(token: string): string;
+//# sourceMappingURL=sharedReportRoute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sharedReportRoute.d.ts","sourceRoot":"","sources":["../../../src/planmagnet/reports/sharedReportRoute.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AACxD,qGAAqG;AACrG,eAAO,MAAM,wBAAwB,0BAAsC,CAAC;AAE5E,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD"}

package/dist/planmagnet/reports/sharedReportRoute.js

@@ -0,0 +1,9 @@
+//#region src/planmagnet/reports/sharedReportRoute.ts
+var e = "/public/report", t = `${e}/:token`;
+function n(t) {
+	return `${typeof window < "u" ? window.location.origin : ""}${e}/${encodeURIComponent(t)}`;
+}
+//#endregion
+export { e as SHARED_REPORT_BASE_PATH, t as SHARED_REPORT_ROUTE_PATH, n as sharedReportLink };
+
+//# sourceMappingURL=sharedReportRoute.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sharedReportRoute.js","names":[],"sources":["../../../src/planmagnet/reports/sharedReportRoute.ts"],"sourcesContent":["/**\n * The public shared-report route (ANR-17). Unlike every other route constant in this package\n * (`product/routes.ts`, `integrations/routes.ts`), this one is NOT relative to this MFE's `basePath` — the host\n * shell mounts `SharedReportPage` on its own top-level router, OUTSIDE the authenticated app shell/basePath\n * tree entirely (no nav chrome, no auth guard), so the path is absolute and fixed. It lives under `/public/`\n * because fe-libs' shell-route table gives every `/public/*` path the public layout — the product header and\n * footer, but no sidebar or breadcrumb — so an anonymous reader never sees the signed-in navigation and no host\n * needs its own exception.\n */\nexport const SHARED_REPORT_BASE_PATH = '/public/report';\n/** For the host's own `<Route path={SHARED_REPORT_ROUTE_PATH} element={<SharedReportPage />} />`. */\nexport const SHARED_REPORT_ROUTE_PATH = `${SHARED_REPORT_BASE_PATH}/:token`;\n\n/** The full, copyable link for a share token, from the current origin. */\nexport function sharedReportLink(token: string): string {\n  const origin = typeof window !== 'undefined' ? window.location.origin : '';\n  return `${origin}${SHARED_REPORT_BASE_PATH}/${encodeURIComponent(token)}`;\n}\n"],"mappings":";AASA,IAAa,IAA0B,kBAE1B,IAA2B,GAAG,EAAwB;AAGnE,SAAgB,EAAiB,GAAuB;AAEtD,QAAO,GADQ,OAAO,SAAW,MAAc,OAAO,SAAS,SAAS,KACrD,EAAwB,GAAG,mBAAmB,EAAM"}