jor / src /pages /formula-library /FormulaLibrary.jsx
Samfredoly's picture
Upload 91 files
1ce80f7 verified
Raw History Blame Contribute Delete
19.1 kB
import { useEffect, useMemo, useState } from 'react'
import { ArrowDownUp, ArrowRight, ArrowUpRight, Boxes, ChartNoAxesColumn, Check, ChevronDown, ChevronRight, Clock3, Database, GitBranch, Info, Layers, MoreVertical, Pencil, Plus, Search, ShieldCheck, Share2, Workflow } from 'lucide-react'
import { useApi } from '../../api/ApiProvider'
import { useApiQuery } from '../../api/useApiQuery'
import { useWorkspace } from '../../api/WorkspaceContext'
import './formula-library.css'
const EMPTY_MODELS = []
const modelOwner = model => model?.owner?.full_name ?? model?.owner?.email ?? 'β€”'
export function FormulaLibrary({ query = '', onNotify, onLineageChange, onDetailChange }) {
const { projectId } = useWorkspace()
const { request } = useApi()
const modelsQuery = useApiQuery(projectId ? `/v1/projects/${projectId}/models` : null)
const models = modelsQuery.data?.models ?? EMPTY_MODELS
const versions = useMemo(() => models.filter(model => model.current_version?.id), [models])
const [groups, setGroups] = useState([])
const [groupsLoading, setGroupsLoading] = useState(false)
const [groupsError, setGroupsError] = useState('')
useEffect(() => {
let active = true
if (!versions.length) { setGroups([]); setGroupsError(''); setGroupsLoading(false); return () => { active = false } }
setGroupsLoading(true)
setGroupsError('')
Promise.all(versions.map(async model => {
const result = await request(`/v1/model-versions/${model.current_version.id}/formula-groups`)
return (result.groups ?? []).map(group => ({ ...group, model }))
})).then(results => { if (active) setGroups(results.flat()) }).catch(error => { if (active) { setGroups([]); setGroupsError(error instanceof Error ? error.message : 'Could not load formula groups.') } }).finally(() => { if (active) setGroupsLoading(false) })
return () => { active = false }
}, [request, versions])
const [releaseFilter, setReleaseFilter] = useState('All')
const [ownerFilter, setOwnerFilter] = useState('All owners')
const [usageFilter, setUsageFilter] = useState('Any usage')
const [selectedId, setSelectedId] = useState(null)
const [sortNewestFirst, setSortNewestFirst] = useState(true)
const [view, setView] = useState('library')
const changeView = next => { setView(next); onLineageChange?.(next === 'lineage'); onDetailChange?.(next === 'detail') }
const visibleGroups = useMemo(() => groups.filter(g => {
const state = g.lineage_state ?? ''
const owner = modelOwner(g.model)
const matchesRelease = releaseFilter === 'All' || state.toLowerCase() === releaseFilter.toLowerCase()
const matchesOwner = ownerFilter === 'All owners' || owner === ownerFilter
const matchesUsage = usageFilter === 'Any usage' || (g.model?.name ?? '').includes(usageFilter)
return matchesRelease && matchesOwner && matchesUsage && `${g.name} ${g.description ?? ''} ${owner} ${g.version_label ?? ''} ${g.model?.name ?? ''}`.toLowerCase().includes(query.trim().toLowerCase())
}).sort((a,b) => { const cmp = new Date(a.model?.updated_at ?? 0)-new Date(b.model?.updated_at ?? 0); return sortNewestFirst ? -cmp : cmp }), [groups, releaseFilter, ownerFilter, usageFilter, query, sortNewestFirst])
const selectedGroup = groups.find(g => g.id === selectedId) ?? visibleGroups[0] ?? groups[0]
const detailQuery = useApiQuery(selectedGroup?.formulas?.[0]?.id ? `/v1/formulas/${selectedGroup.formulas[0].id}/detail` : null)
const formula = detailQuery.data
const pending = modelsQuery.loading || groupsLoading
if (view === 'detail') return <FormulaDetailScreen group={selectedGroup} formula={formula} loading={detailQuery.loading} onBack={() => changeView('library')} onViewLineage={() => changeView('lineage')} onNotify={onNotify} />
if (view === 'lineage') return <FormulaLineageScreen group={selectedGroup} formula={formula} onBack={() => changeView('detail')} />
const states = ['All', ...new Set(groups.map(g => g.lineage_state).filter(Boolean))]
const owners = ['All owners', ...new Set(models.map(modelOwner).filter(value => value !== 'β€”'))]
const usageOptions = ['Any usage', ...new Set(models.map(m => m.name).filter(Boolean))]
return <div className="formula-library-page flex flex-col gap-4">
<div className="formula-library-create-row flex justify-end"><button className="formula-create-top-button" onClick={() => onNotify('Formula group creation is unavailable: no create API contract is defined.')}><Plus size={19} />Create formula group</button></div>
<section className="formula-summary-grid grid grid-cols-[1.5fr_repeat(3,minmax(0,1fr))] gap-3 max-[1050px]:grid-cols-2 max-[580px]:grid-cols-1"><FormulaSummary dark icon={<Workflow size={27} />} label="Formula groups" value={groups.length} detail={`${models.length} models Β· current versions`} /><FormulaSummary icon={<GitBranch size={26} />} label="Current model versions" value={versions.length} detail="Across this project" /><FormulaSummary icon={<ShieldCheck size={26} />} label="Automated tests" value="β€”" detail="Unavailable" /><FormulaSummary icon={<Check size={27} />} label="Release activity" value="β€”" detail="Unavailable" /></section>
<div className="formula-filter-row flex items-center justify-between gap-4 max-[700px]:items-start max-[700px]:flex-col"><div className="formula-release-tabs flex items-center gap-2 overflow-x-auto" role="tablist" aria-label="Formula release status">{states.map(label => <button aria-selected={releaseFilter===label} className={`formula-release-tab ${releaseFilter===label?'formula-release-tab-active':''}`} key={label} onClick={()=>setReleaseFilter(label)} role="tab">{label} <b>{label==='All'?groups.length:groups.filter(g=>g.lineage_state===label).length}</b></button>)}</div><div className="formula-selectors flex items-center gap-3 max-[700px]:w-full max-[700px]:overflow-x-auto"><FormulaSelect value={ownerFilter} onChange={setOwnerFilter} options={owners}/><FormulaSelect value={usageFilter} onChange={setUsageFilter} options={usageOptions}/></div></div>
<section className="formula-list-panel rounded-[12px] bg-white p-4 max-[600px]:p-3"><div className="formula-list-heading flex items-center justify-between gap-4"><h2>Formula groups <span>({visibleGroups.length})</span></h2><button className="formula-sort-button" onClick={()=>setSortNewestFirst(v=>!v)}><ArrowDownUp size={17}/>Last updated<ChevronDown size={15}/></button></div><div className="formula-table-wrap"><div className="formula-table-header"><span>Bundle</span><span>Owner</span><span>Version</span><span>Usage</span><span>Dependencies</span><span>Tests</span><span>Release</span><span>Actions</span></div>{pending&&<p className="formula-empty-state">Loading formula groups…</p>}{groupsError&&<p className="formula-empty-state">Could not load formula groups: {groupsError}</p>}{visibleGroups.map(g=><FormulaRow key={g.id} group={g} selected={selectedGroup?.id===g.id} onInspect={()=>{setSelectedId(g.id);changeView('detail')}} onMore={()=>onNotify('No additional group actions are available.')}/>)}{!pending&&!groupsError&&!visibleGroups.length&&<p className="formula-empty-state">No formula groups are configured in this project.</p>}</div></section>
{selectedGroup&&<section className="formula-details-grid grid grid-cols-[minmax(0,1.4fr)_minmax(330px,0.9fr)] gap-3 max-[900px]:grid-cols-1"><SelectedFormula group={selectedGroup} onInspect={()=>changeView('detail')} onNotify={onNotify}/><FormulaDependencies group={selectedGroup} formula={formula} onViewLineage={()=>changeView('lineage')}/></section>}
</div>
}
function FormulaSummary({dark=false,icon,label,value,detail}){return <article className={`formula-summary-card ${dark?'formula-summary-card-dark':''}`}><span className="formula-summary-icon">{icon}</span><span className="formula-summary-copy"><small>{label}</small><b>{value}</b><span>{detail}</span></span></article>}
function FormulaSelect({value,onChange,options}){return <label className="formula-filter-select"><span className="sr-only">{value}</span><select onChange={e=>onChange(e.target.value)} value={value}>{options.map(x=><option key={x}>{x}</option>)}</select><ChevronDown size={16}/></label>}
function FormulaRow({group,selected,onInspect,onMore}){const state=group.lineage_state??'β€”',owner=modelOwner(group.model);return <article className={`formula-row ${selected?'formula-row-selected':''}`}><div className="formula-bundle-cell"><span className="formula-bundle-icon"><Workflow size={22}/></span><span><b>{group.name}</b><small>{group.description??'β€”'}</small></span></div><div className="formula-owner-cell"><i className="owner-avatar">{owner.split(/\s+/).map(x=>x[0]).join('').slice(0,2)??'β€”'}</i><span>{owner}</span></div><span className="formula-version-pill">{group.version_label??'β€”'}</span><span className="formula-table-muted">{group.model?.name??'β€”'} Β· {group.consumer_count??'β€”'} consumers</span><span className="formula-table-muted">β€”</span><span className="formula-test-count"><b>β€”</b><small>unavailable</small></span><span className={`formula-release-state formula-state-${state.toLowerCase().replaceAll(' ','-')}`}><i/>{state}</span><span className="formula-row-actions"><button className="formula-inspect-button" onClick={onInspect}>Inspect</button><button aria-label={`More actions for ${group.name}`} className="formula-more-button" onClick={onMore}><MoreVertical size={18}/></button></span><button aria-label={`Inspect ${group.name}`} className="formula-row-mobile-action" onClick={onInspect}><ArrowRight size={16}/></button></article>}
function SelectedFormula({group,onInspect,onNotify}){return <article className="formula-detail-card rounded-[12px] bg-white p-5"><div className="formula-detail-title-row"><div><h2>{group.name}</h2><p>{group.description??'β€”'}</p></div><span className="formula-release-state"><i/>{group.lineage_state??'β€”'}</span></div><div className="formula-detail-meta"><span><small>Owner</small><b>{modelOwner(group.model)}</b></span><span><small>Model</small><b>{group.model?.name??'β€”'}</b></span><span><small>Version</small><b>{group.version_label??'β€”'}</b></span><span><small>Updated</small><b>{group.model?.updated_at?new Date(group.model.updated_at).toLocaleDateString():'β€”'}</b></span></div><div className="formula-used-by"><small>Formulas</small>{(group.formulas??[]).map(f=><span key={f.id}>{f.name}</span>)}</div><div className="formula-detail-actions"><button className="formula-create-button" onClick={onInspect}><Search size={17}/>Inspect formula</button><button className="formula-history-button" onClick={()=>onNotify('Formula version history is unavailable from the current API contract.')}><Clock3 size={17}/>Version history unavailable</button></div></article>}
function FormulaDependencies({group,formula,onViewLineage}){const deps=formula?.formula_dependencies??[];return <article className="formula-dependencies-card rounded-[12px] bg-white p-5"><div className="formula-dependencies-heading"><h2>Dependencies &amp; tests</h2><button onClick={onViewLineage}>View lineage <ArrowRight size={14}/></button></div><div className="formula-dependency-chips">{deps.length?deps.map(x=><span key={`${x.variable}-${x.formula_id}`}>{x.variable} Β· {x.kind}</span>):<span>No formula dependencies reported</span>}</div><div className="formula-test-metrics"><span><small>Formulas</small><b>{group.formula_count??'β€”'}</b></span><span><small>Consumers</small><b>{formula?.consumer_count??group.consumer_count??'β€”'}</b></span><span><small>Tests</small><b>{formula?.tests?.available?'Available':'β€”'}</b></span></div><div className="formula-tests-passed"><Info size={16}/>{formula?.tests?.available?'Test data available':'Test results unavailable'}</div></article>}
function FormulaDetailScreen({group,formula,loading,onBack,onViewLineage,onNotify}){return <div className="formula-screen formula-detail-screen"><div className="formula-detail-topbar"><button className="formula-detail-breadcrumb" onClick={onBack}><b>{group?.model?.name??'Project'}</b><ChevronRight size={13}/><span>{group?.version_label??'Current model version'}</span><ChevronRight size={13}/><span>{group?.name??'Formula group'}</span></button></div>{!formula?<p className="formula-empty-state">{loading?'Loading formula details…':'Formula details unavailable.'}</p>:<><div className="formula-screen-heading"><div><div className="formula-screen-title-line"><h2>{formula.name}</h2><span className="formula-screen-status"><i/>{formula.status??'β€”'}</span></div><p>{formula.explanation??'β€”'}</p></div><div className="formula-detail-actions"><button className="formula-detail-share" onClick={()=>onNotify('Share link action is unavailable.') }><Share2 size={14}/>Share</button><button className="formula-screen-primary" onClick={()=>onNotify('Formula editing is unavailable: no edit API contract is defined.')}><Pencil size={14}/>Edit unavailable</button></div></div><div className="formula-screen-detail-grid"><main className="formula-screen-main"><section className="formula-screen-card formula-definition-card"><div className="formula-screen-card-heading"><h3>Formula</h3><span>Version {formula.version??'β€”'}</span></div><div className="formula-definition"><span>fx</span><code>{formula.expression_text??'β€”'}</code></div></section><section className="formula-screen-card formula-dependency-card"><div className="formula-screen-card-heading"><h3>Formula dependencies</h3><button onClick={onViewLineage}>View lineage <ArrowUpRight size={13}/></button></div><FormulaDependencyDiagram formula={formula}/></section><section className="formula-screen-card formula-metrics-card"><div className="formula-screen-card-heading"><h3>Formula metrics</h3></div><div className="formula-metric-grid"><span><GitBranch size={17}/><b>{formula.formula_dependencies?.length??0}</b><small>Formula dependencies</small></span><span><Layers size={17}/><b>{formula.inputs?.length??0}</b><small>Input references</small></span><span><Database size={17}/><b>{formula.dependents?.length??0}</b><small>Dependents</small></span><span><Clock3 size={17}/><b>β€”</b><small>Version history</small></span></div></section><section className="formula-screen-card formula-history-card"><div className="formula-screen-card-heading"><h3>Version history</h3></div><p>Unavailable</p></section></main><aside className="formula-screen-card formula-provenance-card"><div className="formula-screen-card-heading"><h3>Provenance and checks</h3><span className="formula-screen-status"><i/>{formula.status??'β€”'}</span></div>{[['Unit',formula.unit],['Illustrative',formula.illustrative],['Trace',formula.trace?.available?'Available':'Unavailable'],['Latest run',formula.trace?.latest_run_id]].map(([k,v])=><div className="formula-provenance-detail" key={k}><span>{k}</span><b>{v==null?'β€”':String(v)}</b></div>)}<hr/><h4><Workflow size={14}/>Source</h4><div className="formula-provenance-detail"><span>Model</span><b>{formula.model_version?.version_label??'β€”'}</b></div><div className="formula-provenance-detail"><span>Group</span><b>{formula.group?.name??'β€”'}</b></div><div className="formula-provenance-detail"><span>Output</span><b>{formula.output_variable??'β€”'}</b></div><hr/><h4><ChartNoAxesColumn size={14}/>Usage statistics</h4><div className="formula-provenance-detail"><span>Consumers</span><b>{formula.consumer_count??'β€”'}</b></div><p className="formula-detail-mock-note"><Info size={13}/>Unsupported metrics and history are unavailable.</p></aside></div></>}</div>}
function FormulaDependencyDiagram({formula}){const inputs=formula.inputs??[],deps=formula.formula_dependencies??[],outs=formula.dependents??[];return <div className="formula-dependency-diagram"><svg className="formula-diagram-connectors" viewBox="0 0 1000 280" preserveAspectRatio="none" aria-hidden="true"><g><path d="M235 45 C280 45 285 140 335 140 M665 140 H765"/></g></svg><div className="formula-diagram-column formula-diagram-inputs"><span>INPUTS</span>{inputs.map((x,i)=><div className="formula-diagram-node" key={`${x.variable}-${i}`}><i>fx</i><b>{x.variable}<small>{x.source_summary??x.kind??x.unit??''}</small></b></div>)}{deps.map(x=><div className="formula-diagram-node" key={`${x.variable}-${x.formula_id}`}><i>fx</i><b>{x.variable}<small>{x.kind??'Formula dependency'}</small></b></div>)}</div><div className="formula-diagram-current"><i>fx</i><b>{formula.name}</b><small>{formula.status??'β€”'}</small></div><div className="formula-diagram-column formula-diagram-outputs"><span>DEPENDENTS</span>{outs.map(x=><div className="formula-diagram-node formula-diagram-consumer" key={`${x.variable}-${x.formula_id}`}><i><ArrowUpRight size={14}/></i><b>{x.variable}<small>Dependent formula</small></b></div>)}</div></div>}
function FormulaLineageScreen({group,formula,onBack}){const deps=formula?.formula_dependencies??[],outs=formula?.dependents??[];return <div className="formula-screen formula-lineage-screen"><div className="formula-lineage-topbar"><button className="formula-lineage-breadcrumb" onClick={onBack}><b>{group?.model?.name??'Project'}</b><ChevronRight size={13}/>{group?.version_label??'β€”'}<ChevronRight size={13}/>{group?.name??'Formula lineage'}</button></div><div className="formula-screen-heading"><div><span className="formula-screen-eyebrow">FORMULAS</span><h2>Lineage: {formula?.name??'β€”'}</h2><p>Available formula dependencies and dependents from the API.</p></div></div><section className="formula-lineage-stats"><LineageStat icon={<GitBranch size={19}/>} value={deps.length} label="Formula dependencies" detail="Reported by API"/><LineageStat icon={<Layers size={19}/>} value={formula?.inputs?.length??0} label="Inputs" detail="Reported by API"/><LineageStat icon={<Boxes size={19}/>} value={outs.length} label="Dependents" detail="Reported by API"/><LineageStat icon={<ShieldCheck size={19}/>} value={formula?.consumer_count??'β€”'} label="Consumers" detail="Reported by API"/></section><div className="formula-lineage-layout"><main className="formula-lineage-main"><section className="formula-screen-card formula-lineage-canvas"><div className="formula-lineage-canvas-heading"><div><h3>Formula relationships</h3><span>{deps.length+outs.length+1} reported nodes</span></div></div><div className="formula-dependency-chips">{deps.map(x=><span key={`${x.variable}-${x.formula_id}`}>Dependency: {x.variable} Β· {x.kind}</span>)}<span>{formula?.name??'Formula'}</span>{outs.map(x=><span key={`${x.variable}-${x.formula_id}`}>Dependent: {x.variable}</span>)}{!deps.length&&!outs.length&&<span>No relationships reported</span>}</div></section></main><aside className="formula-screen-card formula-lineage-inspector"><h3>{formula?.name??'Formula'}</h3><p>{formula?.expression_text??'β€”'}</p><div className="formula-provenance-detail"><span>Output</span><b>{formula?.output_variable??'β€”'}</b></div></aside></div></div>}
function LineageStat({icon,value,label,detail}){return <article><span>{icon}</span><div><b>{value}</b><strong>{label}</strong><small>{detail}</small></div></article>}