Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import {
DocumentListSuccessSchema,
type TemplatesListSuccess,
} from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { Info } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
import { CopyablePromptList } from '@/components/empty-state/CopyablePromptList';
import { CreatePromptComposer } from '@/components/empty-state/CreatePromptComposer';
import { CreateView, FileCreationActions } from '@/components/empty-state/CreateView';
import { EmptyStateHeader } from '@/components/empty-state/EmptyStateHeader';
import { getEmptyStateCopy } from '@/components/empty-state/empty-state-copy';
import { filterVisibleEntries } from '@/components/file-tree-utils';
import { PackCardGrid } from '@/components/PackCardGrid';
import { SeedDialog } from '@/components/SeedDialog';
import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip';
import { type AsyncState, useAllTemplates } from '@/hooks/use-folder-config';
import { useIsEmbedded } from '@/hooks/use-is-embedded';
import { emitCreateTopLevelFile } from '@/lib/create-file-events';
import type { OkPackId } from '@/lib/desktop-bridge-types';
import { subscribeToDocumentsChanged } from '@/lib/documents-events';
import { fetchDocumentListShared } from '@/lib/documents-fetch';
import { cn } from '@/lib/utils';
export function EmptyEditorState({
terminalOpen = false,
bottomDockOpen = false,
agentsOpen = false,
onRageStreak,
}: {
terminalOpen?: boolean;
bottomDockOpen?: boolean;
agentsOpen?: boolean;
onRageStreak?: () => void;
}) {
const templatesState = useAllTemplates();
const [seedDialogOpen, setSeedDialogOpen] = useState(false);
const [seedDialogInitialPackId, setSeedDialogInitialPackId] = useState<OkPackId | undefined>(
undefined,
);
const [documentCount, setDocumentCount] = useState<number | null>(null);
const [celebrateSignal, setCelebrateSignal] = useState(0);
const documentCountResolvedRef = useRef(false);
const celebrateTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
useEffect(() => {
let cancelled = false;
async function refresh() {
try {
const { ok, body } = await fetchDocumentListShared();
if (cancelled) return;
const success = ok ? DocumentListSuccessSchema.safeParse(body) : null;
if (success?.success) {
setDocumentCount(countEntries(success.data.documents));
documentCountResolvedRef.current = true;
} else if (!documentCountResolvedRef.current) {
setDocumentCount(1);
documentCountResolvedRef.current = true;
}
} catch {
if (!cancelled && !documentCountResolvedRef.current) {
setDocumentCount(1);
documentCountResolvedRef.current = true;
}
}
}
void refresh();
const unsubscribe = subscribeToDocumentsChanged((channels) => {
if (channels.includes('files')) void refresh();
});
return () => {
cancelled = true;
unsubscribe();
clearTimeout(celebrateTimerRef.current);
};
}, []);
function handleSeedApplied() {
clearTimeout(celebrateTimerRef.current);
celebrateTimerRef.current = setTimeout(() => setCelebrateSignal((prev) => prev + 1), 500);
fetchDocumentListShared()
.then(({ ok, body }) => {
if (!ok) return;
const success = DocumentListSuccessSchema.safeParse(body);
if (success.success) {
setDocumentCount(countEntries(success.data.documents));
}
})
.catch(() => {});
}
const messageReady = documentCount !== null;
const isOnboarding = documentCount === 0;
function handleDialogOpenChange(next: boolean) {
setSeedDialogOpen(next);
if (!next) setSeedDialogInitialPackId(undefined);
}
if (terminalOpen || agentsOpen) {
return (
<div
data-testid="empty-editor-state"
className="@container/emptystate flex min-h-0 flex-1 flex-col items-center overflow-y-auto subtle-scrollbar pb-8 pt-10"
>
<div
className={cn(
'flex w-full shrink-0 flex-col items-center px-4 @md/emptystate:px-10 @2xl/emptystate:px-16',
bottomDockOpen ? 'mt-auto' : 'my-auto',
)}
>
{messageReady ? (
<PanelEmptyState
templatesState={templatesState}
isOnboarding={isOnboarding}
celebrateSignal={celebrateSignal}
onRageStreak={onRageStreak}
/>
) : null}
</div>
</div>
);
}
return (
<div
data-testid="empty-editor-state"
className="@container/emptystate flex min-h-0 flex-1 flex-col items-center overflow-y-auto subtle-scrollbar"
>
<div className="flex w-full flex-1 flex-col items-center px-4 @md/emptystate:px-10 @2xl/emptystate:px-16">
{messageReady ? (
isOnboarding ? (
<OnboardingView
onRageStreak={onRageStreak}
celebrateSignal={celebrateSignal}
onPackSelect={(packId) => {
setSeedDialogInitialPackId(packId);
setSeedDialogOpen(true);
}}
/>
) : (
<CreateView
templatesState={templatesState}
onRageStreak={onRageStreak}
celebrateSignal={celebrateSignal}
onAddStarterPack={() => {
setSeedDialogOpen(true);
}}
/>
)
) : null}
<SeedDialog
open={seedDialogOpen}
onOpenChange={handleDialogOpenChange}
onSeedApplied={handleSeedApplied}
initialPackId={seedDialogInitialPackId}
/>
</div>
</div>
);
}
export function countEntries(
entries: ReadonlyArray<{ kind?: unknown; docName?: string; path?: string }>,
): number {
return filterVisibleEntries(entries).filter(
(entry) => entry.kind === 'document' || entry.kind === 'folder',
).length;
}
function PanelEmptyState({
templatesState,
isOnboarding,
celebrateSignal,
onRageStreak,
}: {
templatesState: AsyncState<TemplatesListSuccess>;
isOnboarding: boolean;
celebrateSignal: number;
onRageStreak?: () => void;
}) {
const { t } = useLingui();
const isEmbedded = useIsEmbedded();
const { title, subtitle } = getEmptyStateCopy({ isOnboarding, isEmbedded });
return (
<div className="flex w-full max-w-5xl flex-col gap-8">
<EmptyStateHeader
title={t(title)}
subtitle={t(subtitle)}
celebrateSignal={celebrateSignal}
onRageStreak={onRageStreak}
/>
<FileCreationActions templatesState={templatesState} compact />
</div>
);
}
function OnboardingView({
celebrateSignal,
onPackSelect,
onRageStreak,
}: {
celebrateSignal: number;
onPackSelect: (packId: OkPackId) => void;
onRageStreak?: () => void;
}) {
const { t } = useLingui();
const isEmbedded = useIsEmbedded();
const { title, subtitle } = getEmptyStateCopy({ isOnboarding: true, isEmbedded });
return (
<div className="flex w-full flex-col gap-10 py-12 max-w-5xl my-auto">
<EmptyStateHeader
title={t(title)}
subtitle={t(subtitle)}
celebrateSignal={celebrateSignal}
onRageStreak={onRageStreak}
/>
{isEmbedded ? (
<CopyablePromptList scenario="new-project" />
) : (
<CreatePromptComposer scenario="new-project" />
)}
<div className="flex w-full flex-col gap-3">
<TemplateDivider label={isEmbedded ? t`Use a starter pack` : t`Or use a starter pack`} />
<PackCardGrid
onPackSelect={onPackSelect}
onCreateBlankFile={() => emitCreateTopLevelFile()}
collapsedPackIds={['okf', 'entity-vault']}
/>
</div>
</div>
);
}
function TemplateDivider({ label }: { label: string }) {
const { t } = useLingui();
return (
<div className="flex items-center gap-1.5">
<span className="font-mono text-2xs uppercase tracking-wider text-muted-foreground whitespace-nowrap">
{label}
</span>
<Tooltip>
<TooltipTrigger
className="text-muted-foreground transition-colors hover:text-foreground"
aria-label={t`What is a starter pack?`}
data-testid="starter-pack-info"
>
<Info className="size-3.5" aria-hidden />
</TooltipTrigger>
<TooltipContent className="max-w-xs">
<p className="leading-relaxed wrap-break-word">
<Trans>
Ready-made folders and templates to get you started quickly. Select a pack to preview
what gets created, then add it to your project.
</Trans>
</p>
</TooltipContent>
</Tooltip>
</div>
);
}