@ovalbee/reportifact 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { default as Reportifact } from './Reportifact.vue';
+export { default as ReportifactTable } from './widgets/Table.vue';
+export { default as ReportifactMarkdown } from './widgets/Markdown.vue';
+export { default as ReportifactChart } from './widgets/Chart.vue';
+export type { ReportifactMediaRequest, ReportifactMediaResolver, ReportifactMediaResult, ReportifactMediaRole, } from './mediaResolver';
+export type { ReportifactCustomWidget, ReportifactCustomWidgetProps, ReportifactCustomWidgets, ReportifactWidgetContext, } from './customWidgets';

package/dist/markdownTable-B5207r3E.js

@@ -0,0 +1,32 @@
+function c(e) {
+  return e.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((r) => r.trim());
+}
+function p(e) {
+  return e.trim().toLowerCase().replace(/[^a-z0-9]+([a-z0-9])/g, (r, n) => n.toUpperCase()).replace(/[^a-z0-9]/g, "");
+}
+function o(e) {
+  return /^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$/.test(e);
+}
+function l(e) {
+  const r = e.split(`
+`).map((t) => t.trim()).filter((t) => t.includes("|")), n = r.findIndex((t, i) => i + 1 < r.length && o(r[i + 1]));
+  if (n < 0) return [];
+  const m = c(r[n]).map(p);
+  return r.slice(n + 2).filter((t) => !o(t)).map((t) => {
+    const i = c(t);
+    return m.reduce((s, u, a) => (s[u] = i[a] ?? "", s), {});
+  });
+}
+function d(e) {
+  const r = typeof e == "number" ? e : Number(e);
+  return Number.isFinite(r) ? r >= 0.75 ? "high" : r >= 0.45 ? "mid" : "low" : "mid";
+}
+function b(e) {
+  const r = typeof e == "number" ? e : Number(e);
+  return Number.isFinite(r) ? Math.max(0, Math.min(1, r)) * 100 : 0;
+}
+export {
+  b as a,
+  d as m,
+  l as p
+};

package/dist/markdownTable-Cbn1Du3L.cjs

@@ -0,0 +1,2 @@
+"use strict";function c(e){return e.trim().replace(/^\|/,"").replace(/\|$/,"").split("|").map(r=>r.trim())}function l(e){return e.trim().toLowerCase().replace(/[^a-z0-9]+([a-z0-9])/g,(r,n)=>n.toUpperCase()).replace(/[^a-z0-9]/g,"")}function o(e){return/^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$/.test(e)}function p(e){const r=e.split(`
+`).map(t=>t.trim()).filter(t=>t.includes("|")),n=r.findIndex((t,i)=>i+1<r.length&&o(r[i+1]));if(n<0)return[];const m=c(r[n]).map(l);return r.slice(n+2).filter(t=>!o(t)).map(t=>{const i=c(t);return m.reduce((s,u,a)=>(s[u]=i[a]??"",s),{})})}function f(e){const r=typeof e=="number"?e:Number(e);return Number.isFinite(r)?r>=.75?"high":r>=.45?"mid":"low":"mid"}function d(e){const r=typeof e=="number"?e:Number(e);return Number.isFinite(r)?Math.max(0,Math.min(1,r))*100:0}exports.metricPercent=d;exports.metricTone=f;exports.parseMarkdownTable=p;

package/dist/mediaResolver.d.ts

@@ -0,0 +1,18 @@
+export type ReportifactMediaRole = 'image' | 'overlay';
+export type ReportifactMediaRequest = {
+    role: ReportifactMediaRole;
+    index: number;
+    item: Record<string, unknown>;
+    src?: string;
+    asset?: string;
+    annotation?: string;
+    imageAsset?: string;
+    imageSrc?: string;
+    imageUrl?: string | null;
+    drawTags?: boolean;
+    defaultResolve: (src: string) => string;
+};
+export type ReportifactMediaResult = {
+    url: string | null;
+};
+export type ReportifactMediaResolver = (request: ReportifactMediaRequest) => Promise<ReportifactMediaResult | string | null | undefined> | ReportifactMediaResult | string | null | undefined;

package/dist/middleware.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const S=require("express"),k=require("duckdb"),C=require("path"),I=require("./utils/tfeventsParser.cjs");function D(f){const u=S.Router(),d=f.basePath||"/reportifact",v=new k.Database(":memory:"),E=new Map,j=6e4;return u.get(d+"/table/:filename",async(s,t)=>{try{const{filename:r}=s.params;if(!r.endsWith(".parquet")||r.includes("..")){t.status(400).json({error:"Invalid filename"});return}const o=C.resolve(f.dataDir,r),c=parseInt(s.query.page)||1,a=parseInt(s.query.pageSize)||10,y=s.query.sortBy,w=s.query.sortOrder==="desc"?"DESC":"ASC",n=s.query.filter,i=(c-1)*a;let g="";if(n&&n.trim()){const $=`SELECT * FROM '${o.replace(/'/g,"''")}' LIMIT 1`,p=await O(v,$);if(p.length>0){const R=Object.keys(p[0]),T=n.trim().replace(/'/g,"''");g=`WHERE (${R.map(N=>`CAST("${N.replace(/"/g,'""')}" AS VARCHAR) ILIKE '%${T}%'`).join(" OR ")})`}}let l;const h=`${o}${n||""}`,e=E.get(h);if(e&&Date.now()-e.timestamp<j)l=e.count;else{const $=`SELECT COUNT(*) as count FROM '${o.replace(/'/g,"''")}' ${g}`,p=await O(v,$);l=Number(p[0].count),E.set(h,{count:l,timestamp:Date.now()})}const m=Math.ceil(l/a),b=y?`ORDER BY "${y}" ${w}`:"",M=`SELECT * FROM '${o.replace(/'/g,"''")}' ${g} ${b} LIMIT ${a} OFFSET ${i}`,P=await O(v,M),B=P.length>0?Object.keys(P[0]):[],F=P.map($=>{const p={};for(const[R,T]of Object.entries($))p[R]=typeof T=="bigint"?Number(T):T;return p});t.json({columns:B,rows:F,page:c,pageSize:a,totalRows:l,totalPages:m})}catch(r){console.error("Reportifact error:",r),t.status(500).json({error:r instanceof Error?r.message:"Unknown error"})}}),u.get(d+"/tfevents/:filename/tags",async(s,t)=>{try{const{filename:r}=s.params;if(!r.includes(".tfevents")||r.includes("..")){t.status(400).json({error:"Invalid filename"});return}const o=C.resolve(f.dataDir,r);let c;try{c=I.parseTensorBoardEvents(o).tags}catch(a){console.error("Error getting tags:",a),t.status(500).json({error:`Failed to parse TensorBoard events file: ${a instanceof Error?a.message:"Unknown error"}`});return}t.json({tags:c,count:c.length})}catch(r){console.error("Reportifact error:",r),t.status(500).json({error:r instanceof Error?r.message:"Unknown error"})}}),u.get(d+"/tfevents/:filename",async(s,t)=>{var r;try{const{filename:o}=s.params,c=s.query.tag,a=s.query.idx;if(!o.includes(".tfevents")||o.includes("..")){t.status(400).json({error:"Invalid filename"});return}const y=C.resolve(f.dataDir,o),w=s.query.maxPoints?parseInt(s.query.maxPoints,10):void 0;let n;try{n=I.parseTensorBoardEvents(y).tags}catch(e){console.error("Error parsing TensorBoard events:",e),t.status(500).json({error:`Failed to parse TensorBoard events file: ${e instanceof Error?e.message:"Unknown error"}`});return}if(n.length===0){t.status(404).json({error:"No scalar tags found in events file"});return}let i;if(c){if(!n.includes(c)){t.status(404).json({error:`Tag '${c}' not found. Available tags: ${n.join(", ")}`});return}i=c}else if(a!==void 0){const e=parseInt(a,10);if(isNaN(e)||e<0||e>=n.length){t.status(400).json({error:`Index ${a} out of range. Available tags (0-${n.length-1}): ${n.join(", ")}`});return}i=n[e]}else i=n[0];let g;try{const e=Date.now();g=I.parseTensorBoardEvents(y,i,w);const m=Date.now()-e;if(process.env.NODE_ENV!=="production"&&m>100){const b=((r=g.scalars.get(i))==null?void 0:r.length)||0;console.log(`[TFEvents] Parsed ${b} points for tag '${i}' in ${m}ms`)}}catch(e){console.error("Error parsing TensorBoard events:",e),t.status(500).json({error:`Failed to parse TensorBoard events file: ${e instanceof Error?e.message:"Unknown error"}`});return}const l=g.scalars.get(i);if(!l||l.length===0){t.status(404).json({error:`No data found for tag '${i}'`});return}const h=[...l].sort((e,m)=>e.step-m.step);t.json({tag:i,steps:h.map(e=>e.step),values:h.map(e=>e.value)})}catch(o){console.error("Reportifact error:",o),t.status(500).json({error:o instanceof Error?o.message:"Unknown error"})}}),u.use(d,S.static(f.dataDir,{maxAge:"1h",etag:!0,lastModified:!0})),u.use(d,(s,t)=>{if(!t.headersSent){const r=s.path.replace(d,"")||s.path;t.status(404).json({error:`File not found: ${r}`})}}),u}function O(f,u){return new Promise((d,v)=>{f.all(u,(E,j)=>{E?v(E):d(j)})})}exports.default=D;exports.reportifactMiddleware=D;

package/dist/middleware.d.ts

@@ -0,0 +1,21 @@
+import { Router } from 'express';
+export interface ReportifactOptions {
+    /** Directory where parquet files are stored */
+    dataDir: string;
+    /** Base URL path for static files (default: '/reportifact') */
+    basePath?: string;
+}
+/**
+ * Creates Express middleware for serving parquet data as JSON
+ *
+ * Usage:
+ * ```ts
+ * import express from 'express';
+ * import { reportifactMiddleware } from '@ovalbee/reportifact/middleware';
+ *
+ * const app = express();
+ * app.use(reportifactMiddleware({ dataDir: './data' }));
+ * ```
+ */
+export declare function reportifactMiddleware(options: ReportifactOptions): Router;
+export default reportifactMiddleware;

package/dist/middleware.js

@@ -0,0 +1,177 @@
+import k, { Router as x } from "express";
+import A from "duckdb";
+import C from "path";
+import { parseTensorBoardEvents as I } from "./utils/tfeventsParser.js";
+function H(d) {
+  const u = x(), f = d.basePath || "/reportifact", h = new A.Database(":memory:"), v = /* @__PURE__ */ new Map(), w = 6e4;
+  return u.get(f + "/table/:filename", async (s, t) => {
+    try {
+      const { filename: r } = s.params;
+      if (!r.endsWith(".parquet") || r.includes("..")) {
+        t.status(400).json({ error: "Invalid filename" });
+        return;
+      }
+      const o = C.resolve(d.dataDir, r), c = parseInt(s.query.page) || 1, a = parseInt(s.query.pageSize) || 10, y = s.query.sortBy, T = s.query.sortOrder === "desc" ? "DESC" : "ASC", n = s.query.filter, i = (c - 1) * a;
+      let g = "";
+      if (n && n.trim()) {
+        const $ = `SELECT * FROM '${o.replace(/'/g, "''")}' LIMIT 1`, p = await O(h, $);
+        if (p.length > 0) {
+          const P = Object.keys(p[0]), j = n.trim().replace(/'/g, "''");
+          g = `WHERE (${P.map(
+            (S) => `CAST("${S.replace(/"/g, '""')}" AS VARCHAR) ILIKE '%${j}%'`
+          ).join(" OR ")})`;
+        }
+      }
+      let l;
+      const E = `${o}${n || ""}`, e = v.get(E);
+      if (e && Date.now() - e.timestamp < w)
+        l = e.count;
+      else {
+        const $ = `SELECT COUNT(*) as count FROM '${o.replace(/'/g, "''")}' ${g}`, p = await O(h, $);
+        l = Number(p[0].count), v.set(E, { count: l, timestamp: Date.now() });
+      }
+      const m = Math.ceil(l / a), b = y ? `ORDER BY "${y}" ${T}` : "", D = `SELECT * FROM '${o.replace(/'/g, "''")}' ${g} ${b} LIMIT ${a} OFFSET ${i}`, R = await O(h, D), F = R.length > 0 ? Object.keys(R[0]) : [], N = R.map(($) => {
+        const p = {};
+        for (const [P, j] of Object.entries($))
+          p[P] = typeof j == "bigint" ? Number(j) : j;
+        return p;
+      });
+      t.json({
+        columns: F,
+        rows: N,
+        page: c,
+        pageSize: a,
+        totalRows: l,
+        totalPages: m
+      });
+    } catch (r) {
+      console.error("Reportifact error:", r), t.status(500).json({
+        error: r instanceof Error ? r.message : "Unknown error"
+      });
+    }
+  }), u.get(f + "/tfevents/:filename/tags", async (s, t) => {
+    try {
+      const { filename: r } = s.params;
+      if (!r.includes(".tfevents") || r.includes("..")) {
+        t.status(400).json({ error: "Invalid filename" });
+        return;
+      }
+      const o = C.resolve(d.dataDir, r);
+      let c;
+      try {
+        c = I(o).tags;
+      } catch (a) {
+        console.error("Error getting tags:", a), t.status(500).json({
+          error: `Failed to parse TensorBoard events file: ${a instanceof Error ? a.message : "Unknown error"}`
+        });
+        return;
+      }
+      t.json({
+        tags: c,
+        count: c.length
+      });
+    } catch (r) {
+      console.error("Reportifact error:", r), t.status(500).json({
+        error: r instanceof Error ? r.message : "Unknown error"
+      });
+    }
+  }), u.get(f + "/tfevents/:filename", async (s, t) => {
+    var r;
+    try {
+      const { filename: o } = s.params, c = s.query.tag, a = s.query.idx;
+      if (!o.includes(".tfevents") || o.includes("..")) {
+        t.status(400).json({ error: "Invalid filename" });
+        return;
+      }
+      const y = C.resolve(d.dataDir, o), T = s.query.maxPoints ? parseInt(s.query.maxPoints, 10) : void 0;
+      let n;
+      try {
+        n = I(y).tags;
+      } catch (e) {
+        console.error("Error parsing TensorBoard events:", e), t.status(500).json({
+          error: `Failed to parse TensorBoard events file: ${e instanceof Error ? e.message : "Unknown error"}`
+        });
+        return;
+      }
+      if (n.length === 0) {
+        t.status(404).json({ error: "No scalar tags found in events file" });
+        return;
+      }
+      let i;
+      if (c) {
+        if (!n.includes(c)) {
+          t.status(404).json({
+            error: `Tag '${c}' not found. Available tags: ${n.join(", ")}`
+          });
+          return;
+        }
+        i = c;
+      } else if (a !== void 0) {
+        const e = parseInt(a, 10);
+        if (isNaN(e) || e < 0 || e >= n.length) {
+          t.status(400).json({
+            error: `Index ${a} out of range. Available tags (0-${n.length - 1}): ${n.join(", ")}`
+          });
+          return;
+        }
+        i = n[e];
+      } else
+        i = n[0];
+      let g;
+      try {
+        const e = Date.now();
+        g = I(y, i, T);
+        const m = Date.now() - e;
+        if (process.env.NODE_ENV !== "production" && m > 100) {
+          const b = ((r = g.scalars.get(i)) == null ? void 0 : r.length) || 0;
+          console.log(`[TFEvents] Parsed ${b} points for tag '${i}' in ${m}ms`);
+        }
+      } catch (e) {
+        console.error("Error parsing TensorBoard events:", e), t.status(500).json({
+          error: `Failed to parse TensorBoard events file: ${e instanceof Error ? e.message : "Unknown error"}`
+        });
+        return;
+      }
+      const l = g.scalars.get(i);
+      if (!l || l.length === 0) {
+        t.status(404).json({ error: `No data found for tag '${i}'` });
+        return;
+      }
+      const E = [...l].sort((e, m) => e.step - m.step);
+      t.json({
+        tag: i,
+        steps: E.map((e) => e.step),
+        values: E.map((e) => e.value)
+      });
+    } catch (o) {
+      console.error("Reportifact error:", o), t.status(500).json({
+        error: o instanceof Error ? o.message : "Unknown error"
+      });
+    }
+  }), u.use(
+    f,
+    k.static(d.dataDir, {
+      maxAge: "1h",
+      etag: !0,
+      lastModified: !0
+    })
+  ), u.use(f, (s, t) => {
+    if (!t.headersSent) {
+      const r = s.path.replace(f, "") || s.path;
+      t.status(404).json({
+        error: `File not found: ${r}`
+      });
+    }
+  }), u;
+}
+function O(d, u) {
+  return new Promise((f, h) => {
+    d.all(u, (v, w) => {
+      v ? h(v) : f(w);
+    });
+  });
+}
+export {
+  H as default,
+  H as reportifactMiddleware
+};

package/dist/portable/ReportifactFigure.vue.d.ts

@@ -0,0 +1,36 @@
+type __VLS_Props = {
+    title?: string;
+    caption?: string;
+    loading?: boolean;
+    error?: string | null;
+    fallbackSrc?: string;
+    fallbackAlt?: string;
+    sourceHref?: string;
+    sourceLabel?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    title: string;
+    loading: boolean;
+    error: string | null;
+    caption: string;
+    fallbackSrc: string;
+    fallbackAlt: string;
+    sourceHref: string;
+    sourceLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/portable/ReportifactWidgetHost.vue.d.ts

@@ -0,0 +1,17 @@
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/portable/contracts.d.ts

@@ -0,0 +1,54 @@
+import { WidgetItem } from '../utils/parseIndexMd';
+export type ReportifactWidgetItem = WidgetItem;
+export type ReportifactChartData = unknown;
+export interface ReportifactMetricCardData {
+    label: string;
+    value: string;
+    description?: string;
+}
+export interface ReportifactMetricCalloutData {
+    label?: string;
+    value: string | number;
+    description?: string;
+    /** Trusted, already-sanitized HTML. Full reports populate this from Reportifact Markdown. */
+    html?: string;
+}
+export type ReportifactMetricsRow = {
+    name: string;
+    value: number;
+    max?: number;
+};
+export interface ReportifactMetricsData {
+    rows: ReportifactMetricsRow[];
+}
+export interface ReportifactSmallTableData {
+    columns: string[];
+    rows: (string | number)[][];
+}
+export type ReportifactMetricsTableData = ReportifactMetricsData | ReportifactSmallTableData;
+export interface ReportifactTimelineRow {
+    id?: string;
+    name: string;
+    group?: string;
+    color?: string;
+    start?: number;
+    end: number;
+    cuts?: number[];
+    /** Optional host payload emitted via `row-click` when the row is clicked. */
+    click?: unknown;
+}
+export type ReportifactTimelineData = ReportifactTimelineRow[] | {
+    rows: ReportifactTimelineRow[];
+};
+export type ReportifactGalleryItem = Record<string, unknown> & {
+    imageSrc?: string;
+    overlaySrc?: string;
+    asset?: string;
+    annotation?: string;
+};
+export type ReportifactImageGalleryData = {
+    assets?: unknown[];
+    annotations?: unknown[];
+    images?: unknown[];
+    overlays?: unknown[];
+};