Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
fix: guide empty 3D libraries and collapse re-render options (#11011)
Adam Eivyd5e6752c3457
diff --git a/client/src/pages/Media3D.jsx b/client/src/pages/Media3D.jsxindex 4c3a4eeb0e..fee5ef7ece 100644--- a/client/src/pages/Media3D.jsx+++ b/client/src/pages/Media3D.jsx@@ -2,6 +2,7 @@ import { useCallback, useEffect, useMemo, useState } from 'react';import { Link } from 'react-router';import { Boxes, CheckCircle2, AlertTriangle, Loader2, ImagePlus, Sparkles, Settings2, ChevronDown } from 'lucide-react';import PageHeader from '../components/PageHeader';+import EmptyState from '../components/EmptyState';import { createImageTo3dModel, getImageTo3dModel, listImageTo3dModels } from '../services/api';import { useModelLifecycle } from '../hooks/useModelLifecycle';import { useImageTo3dTargets } from '../hooks/useImageTo3dTargets';@@ -50,15 +51,23 @@ export default function Media3D() {// Existing image-to-3D records (newest-first) so the page doubles as a library:// each links to its `/3d/:id` detail view.const [records, setRecords] = useState([]);+ const [recordsLoading, setRecordsLoading] = useState(true);+ const [recordsError, setRecordsError] = useState(false);// Central HF-token status (stored / env / cli) for the gated-model notice. `present`// is tri-state — see useHfTokenStatus; `null` means unknown, not absent.const { present: hfTokenPresent, source: hfTokenSource, refresh: refreshHfToken } = useHfTokenStatus();const mountedRef = useMounted(); // gate setState after the create awaitsconst loadRecords = useCallback(() => {+ setRecordsLoading(true);+ setRecordsError(false);listImageTo3dModels({ silent: true })- .then((data) => { if (mountedRef.current) setRecords(Array.isArray(data) ? data : []); })- .catch(() => { /* the library section just stays empty on a transient failure */ });+ .then((data) => {+ if (!Array.isArray(data)) throw new Error('Invalid model list');+ if (mountedRef.current) setRecords(data);+ })+ .catch(() => { if (mountedRef.current) setRecordsError(true); })+ .finally(() => { if (mountedRef.current) setRecordsLoading(false); });}, [mountedRef]);// Reactively fold a created/updated record into the library instead of@@ -320,45 +329,67 @@ export default function Media3D() {{/* Library of existing renders — each opens its `/3d/:id` detailview (GLB viewer + download). URL is the source of truth for what'sopen, so every card is a deep link. */}- {records.length > 0 && (- <section className="mb-6">+ <section className="mb-6"><h2 className="mb-2 text-xs font-medium uppercase tracking-wide text-gray-400">Your 3D models</h2>- <div className="grid grid-cols-2 gap-3 sm:grid-cols-3 md:grid-cols-4">- {records.map((record) => {- const status = imageTo3dStatusMeta(record.status);- return (- <Link- key={record.id}- to={`/3d/${record.id}`}- className="group overflow-hidden rounded-lg border border-port-border bg-port-card hover:border-port-accent"- >- <div className="relative aspect-square bg-port-bg">- {record.sourceImage?.path && (- <MediaImage- src={record.sourceImage.path}- alt={record.name || 'Source image'}- className="h-full w-full object-cover opacity-90 group-hover:opacity-100"- />- )}- {record.status === 'ready' && (- <span className="port-media-overlay-strong absolute right-1.5 top-1.5 rounded p-1 text-port-success">- <Boxes className="h-3.5 w-3.5" />- </span>- )}- </div>- <div className="p-2">- <p className="truncate text-xs font-medium text-white" title={record.name}>{record.name || 'Untitled'}</p>- <div className="mt-0.5 flex items-center justify-between gap-1">- <span className={`text-[11px] ${status.className}`}>{status.label}</span>- <span className="text-[11px] text-gray-500">{timeAgo(record.updatedAt)}</span>+ {recordsLoading ? (+ <p role="status" className="py-4 text-sm text-gray-400">Loading your 3D models…</p>+ ) : recordsError ? (+ <EmptyState+ icon={AlertTriangle}+ headingLevel={3}+ title="Could not load your 3D models"+ message="Retry to load your model collection."+ actionLabel="Retry loading models"+ onAction={loadRecords}+ />+ ) : records.length === 0 ? (+ <div className="rounded-xl border border-port-border bg-port-card">+ <EmptyState+ icon={Boxes}+ headingLevel={3}+ title="No 3D models yet"+ message="Your generated models will appear here. Select a source image above and click Generate 3D to create your first model."+ actionLabel="Select a source image"+ onAction={() => setPickerOpen(true)}+ />+ </div>+ ) : (+ <div className="grid grid-cols-2 gap-3 sm:grid-cols-3 md:grid-cols-4">+ {records.map((record) => {+ const status = imageTo3dStatusMeta(record.status);+ return (+ <Link+ key={record.id}+ to={`/3d/${record.id}`}+ className="group overflow-hidden rounded-lg border border-port-border bg-port-card hover:border-port-accent"+ >+ <div className="relative aspect-square bg-port-bg">+ {record.sourceImage?.path && (+ <MediaImage+ src={record.sourceImage.path}+ alt={record.name || 'Source image'}+ className="h-full w-full object-cover opacity-90 group-hover:opacity-100"+ />+ )}+ {record.status === 'ready' && (+ <span className="port-media-overlay-strong absolute right-1.5 top-1.5 rounded p-1 text-port-success">+ <Boxes className="h-3.5 w-3.5" />+ </span>+ )}</div>- </div>- </Link>- );- })}- </div>- </section>- )}+ <div className="p-2">+ <p className="truncate text-xs font-medium text-white" title={record.name}>{record.name || 'Untitled'}</p>+ <div className="mt-0.5 flex items-center justify-between gap-1">+ <span className={`text-[11px] ${status.className}`}>{status.label}</span>+ <span className="text-[11px] text-gray-500">{timeAgo(record.updatedAt)}</span>+ </div>+ </div>+ </Link>+ );+ })}+ </div>+ )}+ </section>{/* Install/repair lives under Models → 3D — these are on-device runtimes, notrenders — so the generate flow just names the state and links there (#4728). */}diff --git a/client/src/pages/Media3D.test.jsx b/client/src/pages/Media3D.test.jsxindex be88de9795..e2b6c2e1c6 100644--- a/client/src/pages/Media3D.test.jsx+++ b/client/src/pages/Media3D.test.jsx@@ -301,6 +301,23 @@ describe('Media3D — generation workspace', () => {expect(await screen.findByTestId('glb-viewer')).toHaveTextContent('/data/models3d/robot.glb');});+ it('distinguishes a pending or failed library from empty and lets users recover and select an image', async () => {+ let rejectList;+ listImageTo3dModels.mockReturnValueOnce(new Promise((resolve, reject) => { rejectList = reject; }));+ renderAt();+ expect(screen.getByText('Loading your 3D models…')).toBeInTheDocument();+ expect(screen.queryByText('No 3D models yet')).not.toBeInTheDocument();+ await act(async () => rejectList(new Error('offline')));+ expect(await screen.findByText('Could not load your 3D models')).toBeInTheDocument();+ expect(screen.queryByText('No 3D models yet')).not.toBeInTheDocument();++ listImageTo3dModels.mockResolvedValueOnce([]);+ fireEvent.click(screen.getByRole('button', { name: 'Retry loading models' }));+ expect(await screen.findByText('No 3D models yet')).toBeInTheDocument();+ fireEvent.click(screen.getByRole('button', { name: 'Select a source image' }));+ expect(screen.getByRole('button', { name: 'Pick hero' })).toBeInTheDocument();+ });+it('lists existing 3D records as deep links to their detail route', async () => {listImageTo3dModels.mockResolvedValue([{ id: 'image3d-abc', name: 'Example Beacon', status: 'ready', updatedAt: new Date(0).toISOString(), sourceImage: { path: '/data/images/beacon.png' } },diff --git a/client/src/pages/Media3DDetail.jsx b/client/src/pages/Media3DDetail.jsxindex f3ab802c4b..c378951374 100644--- a/client/src/pages/Media3DDetail.jsx+++ b/client/src/pages/Media3DDetail.jsx@@ -1,6 +1,6 @@import { useCallback, useEffect, useRef, useState } from 'react';import { Link, useNavigate, useParams } from 'react-router';-import { ArrowLeft, Boxes, AlertTriangle, Loader2, RefreshCw, Trash2 } from 'lucide-react';+import { ArrowLeft, Boxes, AlertTriangle, Loader2, RefreshCw, Trash2, ChevronDown } from 'lucide-react';import { getImageTo3dModel, generateImageTo3dModel, deleteImageTo3dModel, imageTo3dAssetUrl, imageTo3dFullMeshUrl } from '../services/api';import useMounted from '../hooks/useMounted';import { useModelLifecycle } from '../hooks/useModelLifecycle';@@ -207,30 +207,36 @@ export default function Media3DDetail() {</p></header>- <div className="mb-4 rounded-lg border border-port-border bg-port-card p-3">- <ImageTo3dRenderOptions- stepsSupported={record.supportsRenderOptions?.steps !== false}- detailSupported={record.supportsRenderOptions?.detail !== false}- alphaModeSupported={record.supportsRenderOptions?.alphaMode !== false}- steps={steps}- onStepsChange={setSteps}- seed={seed}- onSeedChange={setSeed}- keyBackground={keyBackground}- onKeyBackgroundChange={setKeyBackground}- detail={detail}- onDetailChange={setDetail}- alphaMode={alphaMode}- onAlphaModeChange={setAlphaMode}- normalMapSupported={record.supportsRenderOptions?.normalMap !== false}- normalMap={normalMap}- onNormalMapChange={setNormalMap}- subjectScale={subjectScale}- onSubjectScaleChange={setSubjectScale}- sourcePreviewUrl={record.sourceImage?.path || null}- disabled={busy || isGenerating}- />- </div>+ <details className="group mb-4 rounded-lg border border-port-border bg-port-card p-3">+ <summary className="flex min-h-[44px] cursor-pointer list-none items-center justify-between text-sm font-medium text-gray-300">+ Re-render options+ <ChevronDown className="h-4 w-4 transition-transform group-open:rotate-180" aria-hidden="true" />+ </summary>+ <div className="mt-3">+ <ImageTo3dRenderOptions+ stepsSupported={record.supportsRenderOptions?.steps !== false}+ detailSupported={record.supportsRenderOptions?.detail !== false}+ alphaModeSupported={record.supportsRenderOptions?.alphaMode !== false}+ steps={steps}+ onStepsChange={setSteps}+ seed={seed}+ onSeedChange={setSeed}+ keyBackground={keyBackground}+ onKeyBackgroundChange={setKeyBackground}+ detail={detail}+ onDetailChange={setDetail}+ alphaMode={alphaMode}+ onAlphaModeChange={setAlphaMode}+ normalMapSupported={record.supportsRenderOptions?.normalMap !== false}+ normalMap={normalMap}+ onNormalMapChange={setNormalMap}+ subjectScale={subjectScale}+ onSubjectScaleChange={setSubjectScale}+ sourcePreviewUrl={record.sourceImage?.path || null}+ disabled={busy || isGenerating}+ />+ </div>+ </details>{confirmingDelete && (<InlineConfirmRow