import { T3_PROJECT_FILE_NAME, type EnvironmentId, type T3ProjectFile, type T3ProjectFileScript, } from "@t3tools/contracts"; import { parseT3ProjectFile } from "@t3tools/shared/t3ProjectFile"; import { useMemo } from "react"; import { useProjectFileQuery } from "~/components/files/projectFilesQueryState"; const NO_SCRIPTS: ReadonlyArray = []; export interface T3ProjectFileState { /** * - `valid`: t3.json exists and decoded. * - `invalid`: t3.json exists but fails to decode (the server then ignores * the whole file, including `iconPath` and every script). * - `missing`: no readable t3.json at the workspace root. * - `loading`: the file query has not settled yet. */ status: "loading" | "missing" | "invalid" | "valid"; /** The decoded file when status is `valid`, null otherwise. */ file: T3ProjectFile | null; scripts: ReadonlyArray; } /** * Decoded state of the project's checked-in `t3.json`, including whether the * file exists but is broken — which the runtime otherwise swallows silently. */ export function useT3ProjectFileState( environmentId: EnvironmentId, cwd: string | null, ): T3ProjectFileState { const query = useProjectFileQuery(environmentId, cwd ?? "", T3_PROJECT_FILE_NAME, cwd !== null); const contents = query.data && !query.data.truncated ? query.data.contents : null; const isPending = query.isPending; return useMemo(() => { if (contents === null) { return { status: isPending ? "loading" : "missing", file: null, scripts: NO_SCRIPTS, } as const; } const file = parseT3ProjectFile(contents); if (file === null) { return { status: "invalid", file: null, scripts: NO_SCRIPTS } as const; } return { status: "valid", file, scripts: file.scripts ?? NO_SCRIPTS } as const; }, [contents, isPending]); } /** * Scripts declared in the project's checked-in `t3.json`, offered in the * scripts menu for import. Missing, truncated, or invalid files resolve to * an empty list. */ export function useT3ProjectFileScripts( environmentId: EnvironmentId, cwd: string | null, ): ReadonlyArray { return useT3ProjectFileState(environmentId, cwd).scripts; }