@agent-native/core-corpus 0.214.0 → 0.216.0

package/corpus/templates/slides-2/app/components/design-system/DesignSystemSetup.tsx

@@ -0,0 +1,2021 @@
+import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
+import {
+  isDesignSystemCodeIndexingAllowed,
+  isDesignSystemTierAtMax,
+  readDesignSystemTierLimitFailure,
+  type DesignSystemTierLimit,
+} from "@agent-native/core/client/design-system-tier-limit";
+import {
+  actionErrorMessage,
+  useActionQuery,
+  useActionMutation,
+} from "@agent-native/core/client/hooks";
+import { useT } from "@agent-native/core/client/i18n";
+import { withBuilderUtmTrackingParams } from "@agent-native/core/shared";
+import { openAgentSidebar } from "@agent-native/toolkit/app/shared";
+import {
+  IconWorld,
+  IconComponents,
+  IconLoader2,
+  IconBrandGithub,
+  IconBrandFigma,
+  IconFolder,
+  IconX,
+  IconFileDescription,
+  IconPhoto,
+  IconCheck,
+  IconExternalLink,
+  IconChevronDown,
+  IconRefresh,
+  IconLock,
+} from "@tabler/icons-react";
+import { useState, useCallback, useEffect, useRef, useMemo } from "react";
+import { toast } from "sonner";
+
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/components/ui/alert-dialog";
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogDescription,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Progress } from "@/components/ui/progress";
+import { ScrollArea } from "@/components/ui/scroll-area";
+import { Skeleton } from "@/components/ui/skeleton";
+import { Textarea } from "@/components/ui/textarea";
+import { useDesignSystemWorkflows } from "@/hooks/use-design-system-workflows";
+import { cn } from "@/lib/utils";
+
+import {
+  DECODE_JOB_MAX_POLLS,
+  DECODE_JOB_POLL_INTERVAL_MS,
+  DECODE_JOB_TIMEOUT_MESSAGE,
+  uploadAndIndexFigmaFiles,
+  type DecodeJobStatus,
+} from "./builder-design-system-upload";
+import {
+  MAX_BUILDER_INDEX_UPLOAD_BYTES,
+  formatFileSize,
+  type BuilderIndexResult,
+} from "./builder-index-response";
+
+interface DesignSystemSetupProps {
+  open: boolean;
+  onClose: () => void;
+  onComplete: () => void;
+  editingId?: string;
+}
+
+interface GitHubLink {
+  id: string;
+  url: string;
+  ref?: string;
+  include?: string[];
+}
+
+interface UploadedFile {
+  id: string;
+  name: string;
+  type: string;
+  size: number;
+  textContent?: string;
+}
+
+type BuilderSourceKind = "figma" | "code" | "github" | "mixed";
+
+interface BuilderSourceDetails {
+  builderDesignSystemId: string;
+  builderJobId: string;
+  builderUrl?: string;
+  builderStatus?: string;
+  sourceKind?: BuilderSourceKind;
+  tokenValues?: Record<string, string>;
+  docCount?: number | null;
+  warning?: string;
+  githubSources?: Array<{
+    repoUrl: string;
+    ref?: string;
+    include?: string[];
+    exclude?: string[];
+  }>;
+  syncedAt?: string;
+}
+
+interface ExistingDesignSystem {
+  title?: string;
+  description?: string;
+  data?: string | null;
+  customInstructions?: string;
+  builder?: BuilderSourceDetails | null;
+}
+
+interface BuilderIndexInput {
+  projectName?: string;
+  description?: string;
+  githubSources?: Array<{
+    repoUrl: string;
+    ref?: string;
+    include?: string[];
+    exclude?: string[];
+  }>;
+  githubRepoUrl?: string;
+  codeFiles?: Array<{
+    filename: string;
+    content: string;
+    mimeType?: string;
+    encoding?: "utf8" | "base64";
+  }>;
+  designMd?: string;
+}
+
+type OtherSource = "brand" | "code" | "files" | "existing" | "context";
+
+function normalizeWebsiteUrlInput(input: string): string | null {
+  const trimmed = input.trim();
+  if (!trimmed) return null;
+
+  const withProtocol = /^[a-z][a-z\d+.-]*:\/\//i.test(trimmed)
+    ? trimmed
+    : /^[a-z\d-]+$/i.test(trimmed)
+      ? `https://${trimmed}.com`
+      : `https://${trimmed}`;
+
+  try {
+    const parsed = new URL(withProtocol);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+      return null;
+    }
+    if (!parsed.hostname || /\s/.test(parsed.hostname)) return null;
+    const normalized = parsed.toString();
+    return normalized.endsWith("/") && !parsed.pathname.slice(1)
+      ? normalized.slice(0, -1)
+      : normalized;
+  } catch {
+    // coercion-ok: malformed website input is the form's existing invalid-value result.
+    return null;
+  }
+}
+
+function isDesignMdFile(file: UploadedFile) {
+  const name = file.name.split(/[\\/]/).pop()?.toLowerCase() ?? file.name;
+  return name === "design.md" || name === "design.mdx";
+}
+
+export function DesignSystemSetup(props: DesignSystemSetupProps) {
+  const enabled = useDesignSystemWorkflows();
+  return enabled || props.editingId ? (
+    <DesignSystemSetupContent {...props} />
+  ) : null;
+}
+
+function DesignSystemSetupContent({
+  open,
+  onClose,
+  onComplete,
+  editingId,
+}: DesignSystemSetupProps) {
+  const t = useT();
+  const [companyName, setCompanyName] = useState("");
+  const [websiteUrl, setWebsiteUrl] = useState("");
+  const [websiteUrls, setWebsiteUrls] = useState<string[]>([]);
+  const [githubUrl, setGithubUrl] = useState("");
+  const [githubRef, setGithubRef] = useState("");
+  const [githubPaths, setGithubPaths] = useState("");
+  const [githubLinks, setGithubLinks] = useState<GitHubLink[]>([]);
+  const [codeFiles, setCodeFiles] = useState<UploadedFile[]>([]);
+  const [docFiles, setDocFiles] = useState<UploadedFile[]>([]);
+  const [imageFiles, setImageFiles] = useState<UploadedFile[]>([]);
+  const [brandNotes, setBrandNotes] = useState("");
+  const [customInstructions, setCustomInstructions] = useState("");
+  const [generating, setGenerating] = useState(false);
+  const [builderIndexing, setBuilderIndexing] = useState(false);
+  const [builderUploadProgress, setBuilderUploadProgress] = useState<
+    number | null
+  >(null);
+  const [builderIndexResult, setBuilderIndexResult] =
+    useState<BuilderIndexResult | null>(null);
+  const [builderIndexError, setBuilderIndexError] = useState<string | null>(
+    null,
+  );
+  const [sourcePanel, setSourcePanel] = useState<"figma" | "other">("figma");
+  const [otherSource, setOtherSource] = useState<OtherSource | null>(null);
+  const [decodeStatus, setDecodeStatus] = useState<DecodeJobStatus | null>(
+    null,
+  );
+  const [decodeDesignSystemId, setDecodeDesignSystemId] = useState<
+    string | null
+  >(null);
+  const decodeTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  const stopDecodePolling = useCallback(() => {
+    if (decodeTimeoutRef.current) clearTimeout(decodeTimeoutRef.current);
+    decodeTimeoutRef.current = null;
+    setDecodeDesignSystemId(null);
+  }, []);
+
+  const startDecodePolling = useCallback(
+    (designSystemId: string) => {
+      stopDecodePolling();
+      setDecodeStatus({
+        status: "pending",
+        branchUrl: null,
+        error: null,
+        framesProcessed: 0,
+        totalFrames: 0,
+      });
+      setDecodeDesignSystemId(designSystemId);
+      decodeTimeoutRef.current = setTimeout(() => {
+        decodeTimeoutRef.current = null;
+        setDecodeStatus((prev) => ({
+          status: "error",
+          branchUrl: prev?.branchUrl ?? null,
+          error: DECODE_JOB_TIMEOUT_MESSAGE,
+          framesProcessed: prev?.framesProcessed ?? 0,
+          totalFrames: prev?.totalFrames ?? 0,
+        }));
+        setBuilderIndexing(false);
+        setDecodeDesignSystemId(null);
+      }, DECODE_JOB_POLL_INTERVAL_MS * DECODE_JOB_MAX_POLLS);
+    },
+    [stopDecodePolling],
+  );
+
+  useEffect(
+    () => () => {
+      if (decodeTimeoutRef.current) clearTimeout(decodeTimeoutRef.current);
+    },
+    [],
+  );
+
+  const codeInputRef = useRef<HTMLInputElement>(null);
+  const docInputRef = useRef<HTMLInputElement>(null);
+  const imageInputRef = useRef<HTMLInputElement>(null);
+  const figInputRef = useRef<HTMLInputElement>(null);
+  const updateSystemMutation = useActionMutation("update-design-system");
+  const syncSystemMutation = useActionMutation(
+    "sync-design-system-with-builder",
+  );
+  const indexUploadedFilesMutation = useActionMutation(
+    "index-uploaded-design-system-files",
+  );
+  const indexSystemMutation = useActionMutation<
+    BuilderIndexResult,
+    BuilderIndexInput
+  >("index-design-system-with-builder");
+
+  const decodeStatusQuery = useActionQuery(
+    "get-design-system-decode-job-status",
+    { designSystemId: decodeDesignSystemId ?? "" },
+    {
+      enabled: Boolean(decodeDesignSystemId) && builderIndexing,
+      retry: false,
+      queryKeyScope: builderIndexResult?.jobId
+        ? [builderIndexResult.jobId]
+        : [],
+      refetchInterval: (query) => {
+        if (query.state.status === "error") return false;
+        if (query.state.dataUpdateCount >= DECODE_JOB_MAX_POLLS) return false;
+        const status = query.state.data as DecodeJobStatus | undefined;
+        return status?.branchUrl ||
+          status?.status === "complete" ||
+          status?.status === "error"
+          ? false
+          : DECODE_JOB_POLL_INTERVAL_MS;
+      },
+    },
+  );
+
+  useEffect(() => {
+    if (!decodeDesignSystemId) return;
+    const status = decodeStatusQuery.data as DecodeJobStatus | undefined;
+    if (status) {
+      setDecodeStatus(status);
+      if (
+        status.branchUrl ||
+        status.status === "complete" ||
+        status.status === "error"
+      ) {
+        setBuilderIndexResult((current) =>
+          status.branchUrl && current
+            ? { ...current, builderUrl: status.branchUrl }
+            : current,
+        );
+        setBuilderIndexing(false);
+        stopDecodePolling();
+      }
+    }
+    if (decodeStatusQuery.isError) {
+      const message =
+        actionErrorMessage(decodeStatusQuery.error) ??
+        t("designSystemSetup.figParseFailed");
+      setDecodeStatus((previous) => ({
+        status: "error",
+        branchUrl: previous?.branchUrl ?? null,
+        error: message,
+        framesProcessed: previous?.framesProcessed ?? 0,
+        totalFrames: previous?.totalFrames ?? 0,
+      }));
+      setBuilderIndexing(false);
+      stopDecodePolling();
+    }
+  }, [
+    decodeDesignSystemId,
+    decodeStatusQuery.data,
+    decodeStatusQuery.error,
+    decodeStatusQuery.isError,
+    stopDecodePolling,
+    t,
+  ]);
+
+  const {
+    data: existingDs,
+    isLoading: existingDsLoading,
+    isError: existingDsError,
+  } = useActionQuery<ExistingDesignSystem>(
+    "get-design-system",
+    editingId ? { id: editingId } : undefined,
+    {
+      enabled: !!editingId && open,
+      refetchInterval: (query) =>
+        query.state.data?.builder?.docCount === 0 ? 5_000 : false,
+    },
+  );
+
+  const { data: designSystemsData } = useActionQuery<{
+    designSystems: Array<{ id: string; title: string }>;
+  }>("list-design-systems");
+
+  const existingSystems = designSystemsData?.designSystems ?? [];
+  const [selectedSystemId, setSelectedSystemId] = useState("");
+
+  const { data: tierLimit } = useActionQuery<DesignSystemTierLimit>(
+    "get-design-system-tier-limit",
+    undefined,
+    { enabled: open && !editingId },
+  );
+  const atMax = isDesignSystemTierAtMax(tierLimit);
+  const codeIndexingAllowed = isDesignSystemCodeIndexingAllowed(tierLimit);
+  const [tierLimitUpgradeUrl, setTierLimitUpgradeUrl] = useState<string | null>(
+    null,
+  );
+
+  useEffect(() => {
+    if (existingDs && editingId) {
+      const builder = existingDs.builder;
+      setCompanyName(existingDs.title ?? "");
+      const parsed = parseDesignSystemData(existingDs.data);
+      const generatedDescription = builder
+        ? `Builder indexed design system ${builder.builderDesignSystemId}`
+        : null;
+      setBrandNotes(
+        builder
+          ? existingDs.description !== generatedDescription
+            ? (existingDs.description ?? "")
+            : ""
+          : parsed.ok && typeof parsed.value.notes === "string"
+            ? parsed.value.notes
+            : (existingDs.description ?? ""),
+      );
+      setCustomInstructions(
+        builder &&
+          isGeneratedBuilderInstructions(existingDs.customInstructions, builder)
+          ? ""
+          : (existingDs.customInstructions ?? ""),
+      );
+    }
+  }, [existingDs, editingId]);
+
+  useEffect(() => {
+    if (!open) {
+      setCompanyName("");
+      setWebsiteUrl("");
+      setWebsiteUrls([]);
+      setGithubUrl("");
+      setGithubRef("");
+      setGithubPaths("");
+      setGithubLinks([]);
+      setCodeFiles([]);
+      setDocFiles([]);
+      setImageFiles([]);
+      setBrandNotes("");
+      setCustomInstructions("");
+      setSelectedSystemId("");
+      setBuilderIndexing(false);
+      setBuilderIndexResult(null);
+      setBuilderIndexError(null);
+      stopDecodePolling();
+      setDecodeStatus(null);
+    }
+  }, [open, stopDecodePolling]);
+
+  const hasAnySources = useMemo(() => {
+    return (
+      companyName.trim() ||
+      websiteUrls.length > 0 ||
+      githubLinks.length > 0 ||
+      codeFiles.length > 0 ||
+      builderIndexResult ||
+      docFiles.length > 0 ||
+      imageFiles.length > 0 ||
+      selectedSystemId ||
+      brandNotes.trim() ||
+      customInstructions.trim()
+    );
+  }, [
+    companyName,
+    websiteUrls,
+    githubLinks,
+    codeFiles,
+    builderIndexResult,
+    docFiles,
+    imageFiles,
+    selectedSystemId,
+    brandNotes,
+    customInstructions,
+  ]);
+
+  const selectOtherSource = useCallback((source: OtherSource) => {
+    setSourcePanel("other");
+    setOtherSource((current) => (current === source ? null : source));
+  }, []);
+
+  const addWebsiteUrl = useCallback(() => {
+    const url = normalizeWebsiteUrlInput(websiteUrl);
+    if (!url) return;
+    setWebsiteUrls((prev) => (prev.includes(url) ? prev : [...prev, url]));
+    setWebsiteUrl("");
+  }, [websiteUrl]);
+
+  const addGithubLink = useCallback(() => {
+    const url = githubUrl.trim();
+    if (!url) return;
+    const include = githubPaths
+      .split(/[\n,]/)
+      .map((path) => path.trim().replace(/^\/+|\/+$/g, ""))
+      .filter(Boolean);
+    setGithubLinks((prev) => [
+      ...prev,
+      {
+        id: crypto.randomUUID(),
+        url,
+        ...(githubRef.trim() ? { ref: githubRef.trim() } : {}),
+        ...(include.length > 0 ? { include: [...new Set(include)] } : {}),
+      },
+    ]);
+    setGithubUrl("");
+    setGithubRef("");
+    setGithubPaths("");
+  }, [githubPaths, githubRef, githubUrl]);
+
+  const readTextFiles = useCallback(
+    (
+      fileList: FileList,
+      setter: React.Dispatch<React.SetStateAction<UploadedFile[]>>,
+    ) => {
+      const newFiles: UploadedFile[] = [];
+      const promises: Promise<void>[] = [];
+      Array.from(fileList).forEach((f) => {
+        const file: UploadedFile = {
+          id: crypto.randomUUID(),
+          name: f.name,
+          type: f.type,
+          size: f.size,
+        };
+        if (
+          f.size < 200 * 1024 &&
+          (f.name.match(
+            /\.(css|scss|sass|less|ts|tsx|js|jsx|json|html|svg|xml|md|markdown|mdx|txt)$/i,
+          ) ||
+            f.type.startsWith("text/"))
+        ) {
+          promises.push(
+            f.text().then((text) => {
+              file.textContent = text;
+            }),
+          );
+        }
+        newFiles.push(file);
+      });
+      void Promise.all(promises).then(() => {
+        setter((prev) => [...prev, ...newFiles]);
+      });
+    },
+    [],
+  );
+
+  const processBuilderIndexFile = useCallback(
+    async (file: File | undefined) => {
+      if (!file) return;
+      if (!file.name.toLowerCase().endsWith(".fig")) {
+        setBuilderIndexError(t("designSystemSetup.figFileRequired"));
+        return;
+      }
+      if (file.size > MAX_BUILDER_INDEX_UPLOAD_BYTES) {
+        setBuilderIndexError(
+          t("designSystemSetup.figFileTooLarge", {
+            maxSize: formatFileSize(MAX_BUILDER_INDEX_UPLOAD_BYTES),
+          }),
+        );
+        return;
+      }
+
+      setBuilderIndexError(null);
+      setBuilderIndexResult(null);
+      setBuilderUploadProgress(null);
+      stopDecodePolling();
+      setDecodeStatus(null);
+      setBuilderIndexing(true);
+      try {
+        const suggestedTitle =
+          file.name
+            .replace(/\.fig$/i, "")
+            .replace(/[-_]+/g, " ")
+            .trim() || "Imported brand";
+        const parsed = await uploadAndIndexFigmaFiles([file], {
+          projectName: companyName.trim() || suggestedTitle,
+          onProgress: setBuilderUploadProgress,
+          indexUploadedFiles: (input) =>
+            indexUploadedFilesMutation.mutateAsync(input),
+        });
+        setBuilderUploadProgress(null);
+        if (parsed.jobId) {
+          if (!parsed.localDesignSystemId) {
+            throw new Error(
+              "Builder indexing started without a local design-system id.",
+            );
+          }
+          setBuilderIndexResult(parsed);
+          startDecodePolling(parsed.localDesignSystemId);
+        } else {
+          setBuilderIndexResult(parsed);
+          setBuilderIndexing(false);
+        }
+      } catch (err) {
+        setBuilderUploadProgress(null);
+        setBuilderIndexError(
+          actionErrorMessage(err) ??
+            (err instanceof Error
+              ? err.message
+              : t("designSystemSetup.figParseFailed")),
+        );
+        setBuilderIndexing(false);
+      }
+    },
+    [
+      companyName,
+      indexUploadedFilesMutation.mutateAsync,
+      t,
+      startDecodePolling,
+      stopDecodePolling,
+    ],
+  );
+
+  const handleBuilderIndexUpload = useCallback(
+    (event: React.ChangeEvent<HTMLInputElement>) => {
+      void processBuilderIndexFile(event.target.files?.[0]);
+      event.target.value = "";
+    },
+    [processBuilderIndexFile],
+  );
+
+  const handleBuilderIndexDrop = useCallback(
+    (event: React.DragEvent<HTMLButtonElement>) => {
+      event.preventDefault();
+      event.stopPropagation();
+      void processBuilderIndexFile(event.dataTransfer.files?.[0]);
+    },
+    [processBuilderIndexFile],
+  );
+
+  const addImageFiles = useCallback((files: FileList) => {
+    const newFiles = Array.from(files).map((file) => ({
+      id: crypto.randomUUID(),
+      name: file.name,
+      type: file.type,
+      size: file.size,
+    }));
+    setImageFiles((previous) => [...previous, ...newFiles]);
+  }, []);
+
+  const handleEditSave = async () => {
+    if (!editingId || !existingDs) return;
+    setGenerating(true);
+    try {
+      await updateSystemMutation.mutateAsync({
+        id: editingId,
+        title: companyName || "My Brand",
+        description: brandNotes,
+        customInstructions,
+      });
+      onComplete();
+      toast.success(t("designSystemSetup.updated"));
+    } catch {
+      toast.error(t("designSystemSetup.updateFailed"));
+    } finally {
+      setGenerating(false);
+    }
+  };
+
+  const handleSync = useCallback(async () => {
+    if (!editingId || !existingDs?.builder?.githubSources?.length) return;
+    setGenerating(true);
+    try {
+      await syncSystemMutation.mutateAsync({ id: editingId });
+      toast.success(t("designSystemSetup.syncStarted"));
+    } catch (error) {
+      toast.error(t("designSystemSetup.syncFailed"), {
+        description:
+          error instanceof Error
+            ? error.message
+            : t("designSystemSetup.syncFailed"),
+      });
+    } finally {
+      setGenerating(false);
+    }
+  }, [editingId, existingDs, syncSystemMutation, t]);
+
+  const handleGenerate = useCallback(async () => {
+    if (editingId) {
+      await handleEditSave();
+      return;
+    }
+
+    const isGithubOnlySource =
+      githubLinks.length > 0 &&
+      websiteUrls.length === 0 &&
+      codeFiles.length === 0 &&
+      !builderIndexResult &&
+      docFiles.length === 0 &&
+      imageFiles.length === 0 &&
+      !selectedSystemId &&
+      !brandNotes.trim() &&
+      !customInstructions.trim();
+    if (isGithubOnlySource) {
+      setGenerating(true);
+      setTierLimitUpgradeUrl(null);
+      try {
+        await indexSystemMutation.mutateAsync({
+          projectName: companyName.trim() || undefined,
+          githubSources: githubLinks.map((link) => ({
+            repoUrl: link.url,
+            ...(link.ref ? { ref: link.ref } : {}),
+            ...(link.include?.length ? { include: link.include } : {}),
+          })),
+        });
+        toast.success(t("designSystemSetup.generationStarted"));
+        onComplete();
+      } catch (error) {
+        const tierFailure = readDesignSystemTierLimitFailure(
+          error,
+          t("designSystemSetup.updateFailed"),
+        );
+        if (tierFailure) {
+          setTierLimitUpgradeUrl(tierFailure.upgradeUrl);
+        }
+        toast.error(t("designSystemSetup.updateFailed"), {
+          description:
+            tierFailure?.message ??
+            (error instanceof Error
+              ? error.message
+              : t("designSystemSetup.updateFailed")),
+        });
+      } finally {
+        setGenerating(false);
+      }
+      return;
+    }
+
+    const requestedTitle = companyName.trim();
+    const localDesignSystemId = builderIndexResult?.localDesignSystemId;
+    if (requestedTitle && localDesignSystemId) {
+      try {
+        await updateSystemMutation.mutateAsync({
+          id: localDesignSystemId,
+          title: requestedTitle,
+        });
+      } catch (error) {
+        toast.error(t("designSystemSetup.updateFailed"), {
+          description:
+            error instanceof Error
+              ? error.message
+              : t("designSystemSetup.updateFailed"),
+        });
+        return;
+      }
+    }
+
+    const TEXT_INLINE_MAX = 5000;
+    const inlineText = (text: string) =>
+      text.length > TEXT_INLINE_MAX
+        ? `${text.slice(0, TEXT_INLINE_MAX)}\n…[truncated, ${text.length - TEXT_INLINE_MAX} more chars]`
+        : text;
+
+    const parts: string[] = [];
+    parts.push(
+      "Set up a design system from the following sources. Use Builder Design System Intelligence (DSI) as the source of truth for reusable Figma/code/design.md indexing. Analyze each source, extract design tokens (colors, fonts, spacing, borders), and create a cohesive design system for my slide decks.",
+    );
+
+    if (companyName.trim()) {
+      parts.push(
+        `\n## Company / Brand\n${companyName.trim()}\n\nUse exactly this as the design system name. Never replace it with the uploaded Figma filename.`,
+      );
+    }
+
+    if (websiteUrls.length > 0) {
+      parts.push(
+        `\n## Website URLs\nAnalyze these websites for design tokens. Call \`import-from-url\` for each:\n${websiteUrls.map((u) => `- ${u}`).join("\n")}\n\nThe shared action uses the layered real-browser renderer so hydrated React, CSS-in-JS, Tailwind, SPA content, loaded fonts, computed colors, component styles, CSS variables, and desktop/mobile screenshot evidence are captured consistently. It falls back explicitly to SSRF-safe static extraction only when a browser is unavailable. Use its design.md-style result as the source of truth for the deck style.`,
+      );
+    }
+
+    if (githubLinks.length > 0) {
+      parts.push(
+        `\n## Connect Code: GitHub Repositories\nMake one call to \`index-design-system-with-builder\` with \`githubSources\` set to this JSON array:\n\n\`\`\`json\n${JSON.stringify(
+          githubLinks.map((link) => ({
+            repoUrl: link.url,
+            ...(link.ref ? { ref: link.ref } : {}),
+            ...(link.include?.length ? { include: link.include } : {}),
+          })),
+          null,
+          2,
+        )}\n\`\`\`\n\nBuilder is the source of truth for repo/code design-system indexing. The action creates one local selectable proxy design system for Slides flows. If Builder is not connected, stop and tell me to use Builder.io (free tier available) from Settings.`,
+      );
+    }
+
+    const designMdFiles = [...codeFiles, ...docFiles].filter(
+      (file) => file.textContent && isDesignMdFile(file),
+    );
+
+    if (codeFiles.length > 0) {
+      const withContent = codeFiles.filter(
+        (f) => f.textContent && !isDesignMdFile(f),
+      );
+      if (withContent.length > 0) {
+        parts.push(
+          `\n## Connect Code: Code Files (${withContent.length} files)\nStart Builder DSI indexing with \`index-design-system-with-builder\` using these files as the \`codeFiles\` argument:`,
+        );
+        for (const f of withContent) {
+          parts.push(
+            `\n### ${f.name}\n\`\`\`\n${inlineText(f.textContent!)}\n\`\`\``,
+          );
+        }
+      }
+    }
+
+    if (designMdFiles.length > 0) {
+      parts.push(
+        `\n## Optional design.md (${designMdFiles.length} file${designMdFiles.length === 1 ? "" : "s"})\nPass this content as the \`designMd\` argument to \`index-design-system-with-builder\` alongside any Figma/code sources:`,
+      );
+      for (const f of designMdFiles) {
+        parts.push(
+          `\n### ${f.name}\n\`\`\`md\n${inlineText(f.textContent!)}\n\`\`\``,
+        );
+      }
+    }
+
+    if (builderIndexResult) {
+      parts.push(
+        `\n## Connect Figma: Builder-Indexed Figma File\nBuilder DSI indexing has already started.\n- Design system: ${builderIndexResult.designSystemId}\n- Local selectable design system: ${builderIndexResult.localDesignSystemId ?? "(not returned)"}\n- Project: ${builderIndexResult.projectId}\n- Job: ${builderIndexResult.jobId}\n- URL: ${builderIndexResult.builderUrl}\n\nUse Builder as the source of truth for indexed tokens, assets, components, and guidance. Do not call \`create-design-system\` again for this Builder-indexed source.`,
+      );
+    }
+
+    if (docFiles.length > 0) {
+      const inlined = docFiles.filter(
+        (f) => f.textContent && !isDesignMdFile(f),
+      );
+      const binary = docFiles.filter((f) => !f.textContent);
+      if (inlined.length > 0) {
+        parts.push(
+          `\n## Documents (${inlined.length} text files — content inlined)\nExtract brand cues from the content below.`,
+        );
+        for (const f of inlined) {
+          parts.push(
+            `\n### ${f.name}\n\`\`\`\n${inlineText(f.textContent!)}\n\`\`\``,
+          );
+        }
+      }
+      if (binary.length > 0) {
+        parts.push(
+          `\n## Documents\nExtract brand cues. Call \`import-document\` with metadata:\n${binary.map((f) => `- ${f.name} (${f.type}, ${formatSize(f.size)})`).join("\n")}`,
+        );
+      }
+    }
+
+    if (imageFiles.length > 0) {
+      parts.push(
+        `\n## Visual References\n${imageFiles.map((f) => `- ${f.name}`).join("\n")}`,
+      );
+    }
+
+    if (selectedSystemId) {
+      const system = existingSystems.find((s) => s.id === selectedSystemId);
+      if (system) {
+        parts.push(
+          `\n## Fork Existing Design System\nClone "${system.title}" as a starting point. Call \`import-design-project --designSystemId ${selectedSystemId}\``,
+        );
+      }
+    }
+
+    if (brandNotes.trim()) {
+      parts.push(`\n## Additional Notes\n${brandNotes.trim()}`);
+    }
+
+    if (customInstructions.trim()) {
+      parts.push(
+        `\n## Custom Instructions (durable — store on the design system)\nIf you create a local design system from non-Builder sources, pass these verbatim as the \`customInstructions\` argument. They will be re-applied every time the design system is used to generate slides:\n\n${customInstructions.trim()}`,
+      );
+    }
+
+    parts.push(
+      `\n---\nAfter processing all sources, if you started Builder DSI indexing, report the Builder job/design-system URL plus the local selectable design-system id returned by \`index-design-system-with-builder\`. Do not call \`create-design-system\` again for sources Builder indexed successfully. If \`index-design-system-with-builder\` fails or reports Builder DSI unavailable, do not finish with nothing created: call \`create-design-system\` with tokens and guidance derived from those same sources, and tell me Builder indexing was skipped and why. If you processed non-Builder sources into concrete tokens, call \`create-design-system\` with the combined tokens${
+        customInstructions.trim()
+          ? " AND the verbatim --customInstructions string from above"
+          : ""
+      }. Present a summary for review.`,
+    );
+
+    const message =
+      parts[0] ?? "Set up a design system from the selected sources.";
+    const contextParts = parts.slice(1);
+    openAgentSidebar();
+    sendToAgentChat({
+      message,
+      context: contextParts.join("\n"),
+      submit: true,
+    });
+    toast(t("designSystemSetup.generationStarted"), {
+      description: t("designSystemSetup.generationStartedDescription"),
+    });
+    onComplete();
+  }, [
+    editingId,
+    companyName,
+    websiteUrls,
+    githubLinks,
+    codeFiles,
+    builderIndexResult,
+    docFiles,
+    imageFiles,
+    selectedSystemId,
+    existingSystems,
+    brandNotes,
+    customInstructions,
+    onComplete,
+    t,
+    updateSystemMutation,
+    indexSystemMutation,
+    existingDs,
+  ]);
+
+  if (!editingId && atMax) {
+    return (
+      <AlertDialog open={open} onOpenChange={(isOpen) => !isOpen && onClose()}>
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>
+              {t("designSystems.tierLimitTitle")}
+            </AlertDialogTitle>
+            <AlertDialogDescription>
+              {tierLimit?.current != null &&
+              tierLimit?.max != null &&
+              tierLimit?.plan
+                ? t("designSystems.tierLimitDescriptionWithCount", {
+                    current: tierLimit.current,
+                    max: tierLimit.max,
+                    plan: tierLimit.plan,
+                  })
+                : t("designSystems.tierLimitDescription")}
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel className="cursor-pointer">
+              {t("designSystemSetup.cancel")}
+            </AlertDialogCancel>
+            <AlertDialogAction asChild>
+              <a
+                href={
+                  tierLimit?.upgradeUrl ??
+                  "https://builder.io/account/subscription"
+                }
+                target="_blank"
+                rel="noopener noreferrer"
+                className="cursor-pointer"
+              >
+                <IconExternalLink className="w-3.5 h-3.5" />
+                {t("designSystems.tierLimitUpgrade")}
+              </a>
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+    );
+  }
+
+  const brandNotesForm = (
+    <div
+      className={cn(
+        "space-y-2 rounded-lg border border-border bg-card p-4",
+        !editingId &&
+          (sourcePanel !== "other" || otherSource !== "context") &&
+          "hidden",
+      )}
+    >
+      {editingId && (
+        <Label
+          htmlFor="slides-design-system-brand-notes"
+          className="text-foreground/80"
+        >
+          {t("designSystemSetup.brandNotes")}
+        </Label>
+      )}
+      <Textarea
+        id="slides-design-system-brand-notes"
+        aria-label={t(
+          editingId
+            ? "designSystemSetup.brandNotes"
+            : "designSystemSetup.additionalNotes",
+        )}
+        value={brandNotes}
+        onChange={(e) => setBrandNotes(e.target.value)}
+        placeholder={t("designSystemSetup.notesPlaceholder")}
+        rows={3}
+        className="bg-accent border-border text-foreground placeholder:text-foreground/70 resize-none"
+      />
+    </div>
+  );
+  const customInstructionsForm = (
+    <div
+      className={cn(
+        "space-y-2 rounded-lg border border-border bg-card p-4",
+        !editingId &&
+          (sourcePanel !== "other" || otherSource !== "context") &&
+          "hidden",
+      )}
+    >
+      <Label
+        htmlFor="slides-design-system-custom-instructions"
+        className="text-foreground/80"
+      >
+        {t("designSystemSetup.customInstructions")}
+      </Label>
+      <Textarea
+        id="slides-design-system-custom-instructions"
+        value={customInstructions}
+        onChange={(e) => setCustomInstructions(e.target.value)}
+        placeholder={t("designSystemSetup.customInstructionsPlaceholder")}
+        rows={4}
+        className="bg-accent border-border text-foreground placeholder:text-foreground/70 resize-none"
+      />
+      <p className="text-xs text-foreground/80">
+        {t("designSystemSetup.customInstructionsDescription")}
+      </p>
+    </div>
+  );
+
+  return (
+    <Dialog open={open} onOpenChange={(isOpen) => !isOpen && onClose()}>
+      <DialogContent className="sm:max-w-2xl max-h-[85vh] p-0 bg-card border-border">
+        <DialogHeader className="px-6 pt-6 pb-0">
+          <DialogTitle className="text-foreground">
+            {editingId
+              ? t("designSystemSetup.editTitle")
+              : t("designSystemSetup.newTitle")}
+          </DialogTitle>
+          <DialogDescription className="text-foreground/80">
+            {editingId
+              ? t("designSystemSetup.editDescription")
+              : t("designSystemSetup.newDescription")}
+          </DialogDescription>
+        </DialogHeader>
+
+        <ScrollArea className="max-h-[calc(85vh-160px)] px-6">
+          {editingId &&
+          (existingDsLoading || (!existingDs && !existingDsError)) ? (
+            <DesignSystemEditSkeleton />
+          ) : editingId && existingDsError ? (
+            <DesignSystemEditError />
+          ) : (
+            <div className="space-y-5 py-4">
+              {/* Company Name */}
+              {editingId && (
+                <div className="space-y-2">
+                  <Label
+                    htmlFor="slides-design-system-company-name"
+                    className="text-foreground/80"
+                  >
+                    {t("designSystemSetup.companyBrand")}
+                  </Label>
+                  <Input
+                    id="slides-design-system-company-name"
+                    value={companyName}
+                    onChange={(e) => setCompanyName(e.target.value)}
+                    placeholder={t("designSystemSetup.companyBrandPlaceholder")}
+                    className="bg-accent border-border text-foreground placeholder:text-foreground/70"
+                  />
+                </div>
+              )}
+
+              {editingId && existingDs?.builder ? (
+                <BuilderSourceStatus
+                  builder={existingDs.builder}
+                  onSync={
+                    existingDs.builder.githubSources?.length &&
+                    existingDs.builder.sourceKind !== "mixed"
+                      ? handleSync
+                      : undefined
+                  }
+                  syncing={syncSystemMutation.isPending}
+                />
+              ) : null}
+
+              {!editingId && (
+                <>
+                  <SourceAccordionRow
+                    icon={IconBrandFigma}
+                    title={t("designSystemSetup.figmaFile")}
+                    description={t("designSystemSetup.uploadFigDescription")}
+                    expanded={sourcePanel === "figma"}
+                    onClick={() => setSourcePanel("figma")}
+                    panelId="slides-design-system-figma-source"
+                  />
+
+                  {/* Figma .fig */}
+                  <div
+                    id="slides-design-system-figma-source"
+                    className={cn(
+                      "space-y-2 rounded-lg border border-border bg-card p-4",
+                      sourcePanel !== "figma" && "hidden",
+                    )}
+                  >
+                    {!builderIndexResult ? (
+                      <>
+                        <button
+                          type="button"
+                          onClick={() => figInputRef.current?.click()}
+                          onDragOver={(event) => event.preventDefault()}
+                          onDrop={handleBuilderIndexDrop}
+                          disabled={builderIndexing}
+                          className="w-full border border-dashed border-border rounded-lg p-4 text-center hover:border-foreground/20 cursor-pointer disabled:cursor-wait"
+                        >
+                          {builderIndexing ? (
+                            <span className="inline-flex items-center gap-2 text-xs text-foreground/80">
+                              <IconLoader2 className="w-3.5 h-3.5 animate-spin" />
+                              {t("designSystemSetup.parsingFigmaFile")}
+                            </span>
+                          ) : (
+                            <span className="text-xs text-foreground/80">
+                              {t("designSystemSetup.uploadFigDescription")}
+                            </span>
+                          )}
+                        </button>
+                        {builderUploadProgress !== null && (
+                          <Progress
+                            aria-label={t("designSystemSetup.parsingFigmaFile")}
+                            value={Math.round(builderUploadProgress * 100)}
+                            className="h-1.5"
+                          />
+                        )}
+                        <input
+                          ref={figInputRef}
+                          type="file"
+                          accept=".fig"
+                          onChange={handleBuilderIndexUpload}
+                          className="hidden"
+                        />
+                        {builderIndexError && (
+                          <div
+                            role="alert"
+                            className="rounded-md border border-destructive/30 bg-destructive/10 px-3 py-2 text-sm text-destructive"
+                          >
+                            {builderIndexError}
+                          </div>
+                        )}
+                      </>
+                    ) : (
+                      <BuilderIndexPreview
+                        result={builderIndexResult}
+                        decodeStatus={decodeStatus}
+                        isIndexing={builderIndexing}
+                        displayTitle={companyName.trim()}
+                        onReset={() => {
+                          stopDecodePolling();
+                          setDecodeStatus(null);
+                          setBuilderIndexResult(null);
+                          setBuilderIndexError(null);
+                          setBuilderIndexing(false);
+                          setBuilderUploadProgress(null);
+                        }}
+                      />
+                    )}
+                  </div>
+
+                  <SourceAccordionRow
+                    icon={IconComponents}
+                    title={t("designSystemSetup.otherSources")}
+                    description={t("designSystemSetup.otherSourcesDescription")}
+                    expanded={sourcePanel === "other"}
+                    onClick={() => setSourcePanel("other")}
+                    panelId="slides-design-system-other-sources"
+                  />
+                  {sourcePanel === "other" && (
+                    <div
+                      id="slides-design-system-other-sources"
+                      className="space-y-2"
+                    >
+                      <p className="px-1 py-1 text-xs font-medium text-foreground/80">
+                        {t("designSystemSetup.chooseSourcePrompt")}
+                      </p>
+                      <div className="space-y-2">
+                        <SourceAccordionRow
+                          icon={IconComponents}
+                          title={t("designSystemSetup.companyBrand")}
+                          description={t(
+                            "designSystemSetup.companyBrandPlaceholder",
+                          )}
+                          expanded={otherSource === "brand"}
+                          onClick={() => selectOtherSource("brand")}
+                          panelId="slides-design-system-brand-source"
+                        />
+                        {otherSource === "brand" && (
+                          <div
+                            id="slides-design-system-brand-source"
+                            className={cn(
+                              "space-y-4 rounded-lg border border-border bg-card p-4",
+                              otherSource !== "brand" && "hidden",
+                            )}
+                          >
+                            <div className="space-y-2">
+                              <Input
+                                id="slides-design-system-company-name"
+                                aria-label={t("designSystemSetup.companyBrand")}
+                                value={companyName}
+                                onChange={(e) => setCompanyName(e.target.value)}
+                                placeholder={t(
+                                  "designSystemSetup.companyBrandPlaceholder",
+                                )}
+                                className="bg-accent border-border text-foreground placeholder:text-foreground/70"
+                              />
+                            </div>
+                            <div className="space-y-2">
+                              <Label className="text-foreground/80 flex items-center gap-1.5">
+                                <IconWorld className="w-3.5 h-3.5" />
+                                {t("designSystemSetup.websiteUrl")}
+                              </Label>
+                              <div className="flex gap-2">
+                                <Input
+                                  value={websiteUrl}
+                                  onChange={(e) =>
+                                    setWebsiteUrl(e.target.value)
+                                  }
+                                  placeholder={t(
+                                    "designSystemSetup.websitePlaceholder",
+                                  )}
+                                  className="bg-accent border-border text-foreground placeholder:text-foreground/70"
+                                  onBlur={() => {
+                                    const normalized =
+                                      normalizeWebsiteUrlInput(websiteUrl);
+                                    if (normalized) setWebsiteUrl(normalized);
+                                  }}
+                                  onKeyDown={(e) => {
+                                    if (e.key === "Enter") addWebsiteUrl();
+                                  }}
+                                />
+                                <Button
+                                  variant="outline"
+                                  size="sm"
+                                  onClick={addWebsiteUrl}
+                                  className="shrink-0 cursor-pointer"
+                                >
+                                  {t("designSystemSetup.add")}
+                                </Button>
+                              </div>
+                              <TagList
+                                items={websiteUrls}
+                                onRemove={(i) =>
+                                  setWebsiteUrls((p) =>
+                                    p.filter((_, j) => j !== i),
+                                  )
+                                }
+                              />
+                            </div>
+                          </div>
+                        )}
+                        <SourceAccordionRow
+                          icon={IconBrandGithub}
+                          title={t("designSystemSetup.githubRepository")}
+                          description={t("designSystemSetup.codeFilesDrop")}
+                          expanded={otherSource === "code"}
+                          onClick={() => selectOtherSource("code")}
+                          panelId="slides-design-system-code-source"
+                          locked={!codeIndexingAllowed}
+                          lockedMessage={t(
+                            "designSystemSetup.codeIndexingEnterpriseOnly",
+                          )}
+                        />
+                        {otherSource === "code" && (
+                          <>
+                            <div
+                              id="slides-design-system-code-source"
+                              className={cn(
+                                "space-y-2 rounded-lg border border-border bg-card p-4",
+                                otherSource !== "code" && "hidden",
+                              )}
+                            >
+                              <Label className="text-foreground/80 flex items-center gap-1.5">
+                                <IconBrandGithub className="w-3.5 h-3.5" />
+                                {t("designSystemSetup.githubRepository")}
+                              </Label>
+                              <div className="flex gap-2">
+                                <Input
+                                  value={githubUrl}
+                                  onChange={(e) => setGithubUrl(e.target.value)}
+                                  placeholder="https://github.com/org/repo"
+                                  className="bg-accent border-border text-foreground placeholder:text-foreground/70"
+                                  onKeyDown={(e) => {
+                                    if (e.key === "Enter") addGithubLink();
+                                  }}
+                                />
+                                <Button
+                                  variant="outline"
+                                  size="sm"
+                                  onClick={addGithubLink}
+                                  className="shrink-0 cursor-pointer"
+                                >
+                                  {t("designSystemSetup.add")}
+                                </Button>
+                              </div>
+                              <div className="grid gap-2 sm:grid-cols-2">
+                                <Input
+                                  value={githubRef}
+                                  onChange={(e) => setGithubRef(e.target.value)}
+                                  placeholder={t("designSystemSetup.githubRef")}
+                                  aria-label={t("designSystemSetup.githubRef")}
+                                  className="bg-accent border-border text-foreground placeholder:text-foreground/70"
+                                />
+                                <Input
+                                  value={githubPaths}
+                                  onChange={(e) =>
+                                    setGithubPaths(e.target.value)
+                                  }
+                                  placeholder={t(
+                                    "designSystemSetup.githubPaths",
+                                  )}
+                                  aria-label={t(
+                                    "designSystemSetup.githubPaths",
+                                  )}
+                                  className="bg-accent border-border text-foreground placeholder:text-foreground/70"
+                                />
+                              </div>
+                              <TagList
+                                items={githubLinks.map((l) =>
+                                  [l.url, l.ref, l.include?.join(", ")]
+                                    .filter(Boolean)
+                                    .join(" · "),
+                                )}
+                                onRemove={(i) =>
+                                  setGithubLinks((p) =>
+                                    p.filter((_, j) => j !== i),
+                                  )
+                                }
+                              />
+                            </div>
+
+                            <div
+                              className={cn(
+                                "space-y-2 rounded-lg border border-border bg-card p-4",
+                                otherSource !== "code" && "hidden",
+                              )}
+                            >
+                              <Label className="text-foreground/80 flex items-center gap-1.5">
+                                <IconFolder className="w-3.5 h-3.5" />
+                                {t("designSystemSetup.codeFiles")}
+                              </Label>
+                              <button
+                                onClick={() => codeInputRef.current?.click()}
+                                onDrop={(e) => {
+                                  e.preventDefault();
+                                  if (e.dataTransfer.files)
+                                    readTextFiles(
+                                      e.dataTransfer.files,
+                                      setCodeFiles,
+                                    );
+                                }}
+                                onDragOver={(e) => e.preventDefault()}
+                                className="w-full border border-dashed border-border rounded-lg p-4 text-center hover:border-foreground/20 cursor-pointer"
+                              >
+                                <p className="text-xs text-foreground/80">
+                                  {t("designSystemSetup.codeFilesDrop")}
+                                </p>
+                              </button>
+                              <input
+                                ref={codeInputRef}
+                                type="file"
+                                multiple
+                                accept=".css,.scss,.sass,.less,.ts,.tsx,.js,.jsx,.json,.html,.svg,.xml,.md,.markdown,.mdx,.txt"
+                                onChange={(e) => {
+                                  if (e.target.files)
+                                    readTextFiles(e.target.files, setCodeFiles);
+                                  e.target.value = "";
+                                }}
+                                className="hidden"
+                              />
+                              <FileList
+                                files={codeFiles}
+                                onRemove={(id) =>
+                                  setCodeFiles((p) =>
+                                    p.filter((f) => f.id !== id),
+                                  )
+                                }
+                              />
+                            </div>
+                          </>
+                        )}
+                        <SourceAccordionRow
+                          icon={IconFileDescription}
+                          title={t("designSystemSetup.documents")}
+                          description={t("designSystemSetup.documentsDrop")}
+                          expanded={otherSource === "files"}
+                          onClick={() => selectOtherSource("files")}
+                          panelId="slides-design-system-file-source"
+                        />
+                        {otherSource === "files" && (
+                          <>
+                            <div
+                              id="slides-design-system-file-source"
+                              className={cn(
+                                "space-y-2 rounded-lg border border-border bg-card p-4",
+                                otherSource !== "files" && "hidden",
+                              )}
+                            >
+                              <Label className="text-foreground/80 flex items-center gap-1.5">
+                                <IconFileDescription className="w-3.5 h-3.5" />
+                                {t("designSystemSetup.documents")}
+                              </Label>
+                              <button
+                                onClick={() => docInputRef.current?.click()}
+                                onDrop={(e) => {
+                                  e.preventDefault();
+                                  if (e.dataTransfer.files)
+                                    readTextFiles(
+                                      e.dataTransfer.files,
+                                      setDocFiles,
+                                    );
+                                }}
+                                onDragOver={(e) => e.preventDefault()}
+                                className="w-full border border-dashed border-border rounded-lg p-4 text-center hover:border-foreground/20 cursor-pointer"
+                              >
+                                <p className="text-xs text-foreground/80">
+                                  {t("designSystemSetup.documentsDrop")}
+                                </p>
+                              </button>
+                              <input
+                                ref={docInputRef}
+                                type="file"
+                                accept=".pptx,.ppt,.docx,.doc,.pdf,.xlsx,.xls,.md,.markdown,.mdx,.txt"
+                                multiple
+                                onChange={(e) => {
+                                  if (e.target.files)
+                                    readTextFiles(e.target.files, setDocFiles);
+                                  e.target.value = "";
+                                }}
+                                className="hidden"
+                              />
+                              <FileList
+                                files={docFiles}
+                                onRemove={(id) =>
+                                  setDocFiles((p) =>
+                                    p.filter((f) => f.id !== id),
+                                  )
+                                }
+                              />
+                            </div>
+
+                            <div
+                              className={cn(
+                                "space-y-2 rounded-lg border border-border bg-card p-4",
+                                otherSource !== "files" && "hidden",
+                              )}
+                            >
+                              <Label className="text-foreground/80 flex items-center gap-1.5">
+                                <IconPhoto className="w-3.5 h-3.5" />
+                                {t("designSystemSetup.visualReferences")}
+                              </Label>
+                              <button
+                                onClick={() => imageInputRef.current?.click()}
+                                onDragOver={(event) => event.preventDefault()}
+                                onDrop={(event) => {
+                                  event.preventDefault();
+                                  event.stopPropagation();
+                                  addImageFiles(event.dataTransfer.files);
+                                }}
+                                className="w-full border border-dashed border-border rounded-lg p-4 text-center hover:border-foreground/20 cursor-pointer"
+                              >
+                                <p className="text-xs text-foreground/80">
+                                  {t("designSystemSetup.visualReferencesDrop")}
+                                </p>
+                              </button>
+                              <input
+                                ref={imageInputRef}
+                                type="file"
+                                accept="image/*,.svg"
+                                multiple
+                                onChange={(e) => {
+                                  if (e.target.files)
+                                    addImageFiles(e.target.files);
+                                  e.target.value = "";
+                                }}
+                                className="hidden"
+                              />
+                              <FileList
+                                files={imageFiles}
+                                onRemove={(id) =>
+                                  setImageFiles((p) =>
+                                    p.filter((f) => f.id !== id),
+                                  )
+                                }
+                              />
+                            </div>
+                          </>
+                        )}
+                        {existingSystems.length > 0 && (
+                          <>
+                            <SourceAccordionRow
+                              icon={IconComponents}
+                              title={t("designSystemSetup.forkExisting")}
+                              description={t(
+                                "designSystemSetup.customInstructionsDescription",
+                              )}
+                              expanded={otherSource === "existing"}
+                              onClick={() => selectOtherSource("existing")}
+                              panelId="slides-design-system-existing-source"
+                            />
+                            {otherSource === "existing" && (
+                              <div
+                                id="slides-design-system-existing-source"
+                                className="space-y-2 rounded-lg border border-border bg-card p-4"
+                              >
+                                <Label className="text-foreground/80">
+                                  {t("designSystemSetup.forkExisting")}
+                                </Label>
+                                <div className="grid grid-cols-2 gap-2">
+                                  {existingSystems
+                                    .filter((s) => s.id !== editingId)
+                                    .map((ds) => (
+                                      <button
+                                        key={ds.id}
+                                        onClick={() =>
+                                          setSelectedSystemId((prev) =>
+                                            prev === ds.id ? "" : ds.id,
+                                          )
+                                        }
+                                        className={`text-left p-3 rounded-lg border cursor-pointer ${
+                                          selectedSystemId === ds.id
+                                            ? "border-primary/40 bg-primary/5"
+                                            : "border-border bg-accent hover:border-foreground/20"
+                                        }`}
+                                      >
+                                        <div className="flex items-center gap-2">
+                                          <IconComponents className="w-3.5 h-3.5 text-muted-foreground" />
+                                          <span className="text-sm text-foreground/80 truncate">
+                                            {ds.title}
+                                          </span>
+                                        </div>
+                                      </button>
+                                    ))}
+                                </div>
+                              </div>
+                            )}
+                          </>
+                        )}
+                        <SourceAccordionRow
+                          icon={IconFileDescription}
+                          title={t("designSystemSetup.additionalNotes")}
+                          description={t(
+                            "designSystemSetup.customInstructionsDescription",
+                          )}
+                          expanded={otherSource === "context"}
+                          onClick={() => selectOtherSource("context")}
+                          panelId="slides-design-system-context-source"
+                        />
+                        {otherSource === "context" && (
+                          <div
+                            id="slides-design-system-context-source"
+                            className="space-y-2"
+                          >
+                            {brandNotesForm}
+                            {customInstructionsForm}
+                          </div>
+                        )}
+                      </div>
+                    </div>
+                  )}
+                </>
+              )}
+
+              {editingId && (
+                <>
+                  {brandNotesForm}
+                  {customInstructionsForm}
+                </>
+              )}
+            </div>
+          )}
+        </ScrollArea>
+
+        {tierLimitUpgradeUrl && (
+          <div className="mx-6 mb-2 flex items-center justify-between gap-3 rounded-md border border-border bg-accent/40 px-3 py-2 text-sm text-foreground/80">
+            <span>{t("designSystems.tierLimitTitle")}</span>
+            <a
+              href={tierLimitUpgradeUrl}
+              target="_blank"
+              rel="noreferrer"
+              className="inline-flex shrink-0 items-center gap-1.5 font-medium text-primary hover:underline"
+            >
+              <IconExternalLink className="w-3.5 h-3.5" />
+              {t("designSystems.tierLimitUpgrade")}
+            </a>
+          </div>
+        )}
+
+        {/* Actions */}
+        <div className="flex justify-end gap-3 px-6 pb-6 pt-2 border-t border-border">
+          <Button
+            variant="ghost"
+            onClick={onClose}
+            disabled={generating}
+            className="text-muted-foreground hover:text-foreground cursor-pointer"
+          >
+            {t("designSystemSetup.cancel")}
+          </Button>
+          <Button
+            onClick={handleGenerate}
+            disabled={
+              editingId
+                ? generating || !existingDs || existingDsLoading
+                : builderIndexing || !hasAnySources
+            }
+            className="cursor-pointer"
+          >
+            {generating ? (
+              <>
+                <IconLoader2 className="w-4 h-4 animate-spin" />
+                {t("designSystemSetup.saving")}
+              </>
+            ) : editingId ? (
+              t("designSystemSetup.saveChanges")
+            ) : (
+              t("designSystemSetup.continueToGeneration")
+            )}
+          </Button>
+        </div>
+      </DialogContent>
+    </Dialog>
+  );
+}
+
+function parseDesignSystemData(
+  data?: string | null,
+): { ok: true; value: Record<string, unknown> } | { ok: false } {
+  if (!data) return { ok: false };
+  try {
+    const parsed: unknown = JSON.parse(data);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return { ok: false };
+    }
+    return { ok: true, value: parsed as Record<string, unknown> };
+  } catch {
+    return { ok: false };
+  }
+}
+
+function isGeneratedBuilderInstructions(
+  value: string | undefined,
+  builder: BuilderSourceDetails,
+): boolean {
+  const instructions = value?.trim();
+  if (!instructions) return false;
+  return (
+    instructions.startsWith(
+      "This design system is indexed by Builder Design System Intelligence (DSI).",
+    ) &&
+    instructions.includes(
+      `Builder design system id: ${builder.builderDesignSystemId}`,
+    ) &&
+    instructions.includes("Call get-design-system for this local id")
+  );
+}
+
+function SourceAccordionRow({
+  icon: Icon,
+  title,
+  description,
+  expanded,
+  onClick,
+  panelId,
+  className,
+  locked,
+  lockedMessage,
+}: {
+  icon: React.ComponentType<{ className?: string }>;
+  title: string;
+  description?: string;
+  expanded: boolean;
+  onClick: () => void;
+  panelId: string;
+  className?: string;
+  locked?: boolean;
+  lockedMessage?: string;
+}) {
+  const secondaryText = locked ? lockedMessage : description;
+
+  return (
+    <button
+      type="button"
+      aria-controls={panelId}
+      aria-expanded={expanded}
+      aria-disabled={locked}
+      title={locked ? lockedMessage : undefined}
+      onClick={locked ? undefined : onClick}
+      className={cn(
+        "flex w-full items-center gap-3 rounded-lg border border-border px-4 py-3 text-left transition-[background-color,border-color] duration-150 hover:bg-accent/50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        expanded && "bg-accent/40",
+        locked && "opacity-60 cursor-not-allowed hover:bg-transparent",
+        className,
+      )}
+    >
+      <Icon className="size-4 shrink-0 text-muted-foreground" />
+      <span className="min-w-0 flex-1">
+        <span className="block text-sm font-medium text-foreground/90">
+          {title}
+        </span>
+        {secondaryText ? (
+          <span className="mt-0.5 block truncate text-xs text-foreground/80">
+            {secondaryText}
+          </span>
+        ) : null}
+      </span>
+      {locked ? (
+        <IconLock className="size-4 shrink-0 text-muted-foreground" />
+      ) : (
+        <IconChevronDown
+          className={cn(
+            "size-4 shrink-0 text-muted-foreground transition-transform duration-150",
+            expanded && "rotate-180",
+          )}
+        />
+      )}
+    </button>
+  );
+}
+
+function BuilderSourceStatus({
+  builder,
+  onSync,
+  syncing = false,
+}: {
+  builder: BuilderSourceDetails;
+  onSync?: () => void;
+  syncing?: boolean;
+}) {
+  const t = useT();
+  const docCount = builder.docCount;
+  const docs = docCount ?? 0;
+  const tokens = Object.keys(builder.tokenValues ?? {}).length;
+  const hasIndexedResults = docs > 0 || tokens > 0;
+  const state = hasIndexedResults
+    ? "indexed"
+    : builder.warning
+      ? "unavailable"
+      : "indexing";
+  const sourceKind = builder.sourceKind;
+  const SourceIcon =
+    sourceKind === "figma"
+      ? IconBrandFigma
+      : sourceKind === "github"
+        ? IconBrandGithub
+        : sourceKind === "code"
+          ? IconFolder
+          : IconComponents;
+  const sourceTitle =
+    sourceKind === "figma"
+      ? t("designSystemSetup.sourceFigma")
+      : sourceKind === "github"
+        ? t("designSystemSetup.sourceGitHub")
+        : sourceKind === "code"
+          ? t("designSystemSetup.sourceCode")
+          : sourceKind === "mixed"
+            ? t("designSystemSetup.sourceMixed")
+            : t("designSystemSetup.sourceBuilder");
+  const statusDescription =
+    state === "unavailable"
+      ? t("designSystemSetup.sourceUnavailableDescription")
+      : state === "indexing"
+        ? t("designSystemSetup.sourceIndexingDescription")
+        : docs > 0 && tokens > 0
+          ? t("designSystemSetup.sourceIndexedDescription", { docs, tokens })
+          : docs > 0
+            ? t("designSystemSetup.sourceIndexedDocsOnly", { docs })
+            : tokens > 0
+              ? t("designSystemSetup.sourceIndexedTokensOnly", { tokens })
+              : t("designSystemSetup.sourceIndexedDescription", {
+                  docs,
+                  tokens,
+                });
+
+  return (
+    <section
+      aria-label={t("designSystemSetup.sourceLabel")}
+      className="rounded-lg border border-border bg-accent/30 px-4 py-3"
+    >
+      <div className="flex items-start gap-3">
+        <div className="flex size-9 shrink-0 items-center justify-center rounded-md bg-background text-muted-foreground">
+          <SourceIcon className="size-4" />
+        </div>
+        <div className="min-w-0 flex-1">
+          <p className="text-[11px] font-medium uppercase tracking-wide text-muted-foreground">
+            {t("designSystemSetup.sourceLabel")}
+          </p>
+          <p className="mt-0.5 truncate text-sm font-medium text-foreground">
+            {sourceTitle}
+          </p>
+          <p className="mt-1 text-xs leading-relaxed text-muted-foreground">
+            {statusDescription}
+          </p>
+        </div>
+      </div>
+      {builder.builderUrl || onSync ? (
+        <div className="mt-3 flex flex-wrap items-center gap-3 border-t border-border pt-3">
+          {builder.builderUrl ? (
+            <a
+              href={withBuilderUtmTrackingParams(builder.builderUrl, {
+                campaign: "product",
+                content: "design_system_intelligence",
+              })}
+              target="_blank"
+              rel="noreferrer"
+              className="inline-flex items-center gap-1.5 text-xs font-medium text-foreground underline-offset-4 hover:underline"
+            >
+              {t("designSystemSetup.sourceOpenInBuilder")}
+              <IconExternalLink className="size-3.5" />
+            </a>
+          ) : null}
+          {onSync ? (
+            <Button
+              type="button"
+              variant="ghost"
+              size="sm"
+              onClick={onSync}
+              disabled={syncing}
+              className="h-7 gap-1.5 px-2 text-xs"
+            >
+              <IconRefresh
+                className={cn("size-3.5", syncing && "animate-spin")}
+              />
+              {syncing
+                ? t("designSystemSetup.syncingSource")
+                : t("designSystemSetup.syncSource")}
+            </Button>
+          ) : null}
+        </div>
+      ) : null}
+    </section>
+  );
+}
+
+function DesignSystemEditSkeleton() {
+  const t = useT();
+  return (
+    <div
+      aria-busy="true"
+      aria-label={t("designSystemSetup.loading")}
+      className="space-y-5 py-4"
+    >
+      <div className="space-y-2">
+        <Skeleton className="h-4 w-28" />
+        <Skeleton className="h-10 w-full rounded-md" />
+      </div>
+      <div className="space-y-3 rounded-lg border border-border bg-accent/30 px-4 py-3">
+        <div className="flex items-center gap-3">
+          <Skeleton className="size-9 rounded-md" />
+          <div className="flex-1 space-y-2">
+            <Skeleton className="h-3 w-16" />
+            <Skeleton className="h-4 w-32" />
+          </div>
+          <Skeleton className="h-4 w-24" />
+        </div>
+        <Skeleton className="h-3 w-4/5" />
+        <Skeleton className="h-3 w-24" />
+      </div>
+      <div className="space-y-2">
+        <Skeleton className="h-4 w-24" />
+        <Skeleton className="h-24 w-full rounded-md" />
+      </div>
+      <div className="space-y-2">
+        <Skeleton className="h-4 w-36" />
+        <Skeleton className="h-32 w-full rounded-md" />
+        <Skeleton className="h-3 w-64" />
+      </div>
+    </div>
+  );
+}
+
+function DesignSystemEditError() {
+  const t = useT();
+  return (
+    <div
+      role="alert"
+      className="flex min-h-64 items-center justify-center py-8 text-center text-sm text-destructive"
+    >
+      {t("designSystemSetup.loadFailed")}
+    </div>
+  );
+}
+
+function TagList({
+  items,
+  onRemove,
+}: {
+  items: string[];
+  onRemove: (index: number) => void;
+}) {
+  const t = useT();
+  if (items.length === 0) return null;
+  return (
+    <div className="space-y-1">
+      {items.map((item, i) => (
+        <div
+          key={i}
+          className="flex items-center gap-2 text-sm text-foreground/80 bg-accent rounded-md px-3 py-1.5"
+        >
+          <IconCheck className="w-3.5 h-3.5 text-primary shrink-0" />
+          <span className="truncate flex-1">{item}</span>
+          <button
+            onClick={() => onRemove(i)}
+            aria-label={t("designSystemSetup.removeItem", { item })}
+            className="text-muted-foreground hover:text-foreground/70 shrink-0 cursor-pointer"
+          >
+            <IconX className="w-3.5 h-3.5" />
+          </button>
+        </div>
+      ))}
+    </div>
+  );
+}
+
+function BuilderIndexPreview({
+  result,
+  decodeStatus,
+  isIndexing,
+  displayTitle,
+  onReset,
+}: {
+  result: BuilderIndexResult;
+  decodeStatus: DecodeJobStatus | null;
+  isIndexing: boolean;
+  displayTitle?: string;
+  onReset: () => void;
+}) {
+  const t = useT();
+  const decodeDone =
+    decodeStatus == null
+      ? !result.jobId
+      : Boolean(decodeStatus.branchUrl) || decodeStatus.status === "complete";
+  const decodeFailed = decodeStatus?.status === "error";
+  const frameProgress =
+    decodeStatus && decodeStatus.totalFrames > 0
+      ? Math.min(
+          Math.round(
+            (decodeStatus.framesProcessed / decodeStatus.totalFrames) * 100,
+          ),
+          100,
+        )
+      : null;
+  const decodeText = decodeFailed
+    ? t("designSystemSetup.decodeFailed", { error: decodeStatus?.error ?? "" })
+    : null;
+  return (
+    <div className="space-y-4 rounded-lg border border-border bg-accent/40 p-4">
+      <div className="flex items-start gap-3">
+        <div className="flex h-10 w-10 shrink-0 items-center justify-center rounded-lg bg-[hsl(var(--slides-accent)/0.1)]">
+          <IconBrandFigma className="h-5 w-5 text-[hsl(var(--slides-accent))]" />
+        </div>
+        <div className="min-w-0 flex-1 space-y-1.5">
+          <h4 className="text-sm font-medium text-foreground">
+            {t("designSystemSetup.builderIndexingStarted")}
+          </h4>
+          <p className="text-xs text-foreground/80">
+            {t("designSystemSetup.builderIndexingDescription", {
+              title:
+                displayTitle ||
+                result.suggestedTitle ||
+                t("designSystemSetup.importedBrand"),
+            })}
+          </p>
+        </div>
+      </div>
+
+      {decodeText && (
+        <div className="border-t border-border pt-3 text-xs text-destructive">
+          {decodeText}
+        </div>
+      )}
+
+      {isIndexing && !decodeFailed && (
+        <div className="border-t border-border pt-3">
+          {frameProgress === null ? (
+            <span className="inline-flex items-center gap-2 text-xs text-foreground/80">
+              <IconLoader2 className="w-3.5 h-3.5 animate-spin" />
+              {t("designSystemSetup.parsingFigmaFile")}
+            </span>
+          ) : (
+            <Progress
+              aria-label={t("designSystemSetup.parsingFigmaFile")}
+              value={frameProgress}
+              className="h-1.5"
+            />
+          )}
+        </div>
+      )}
+
+      {(decodeDone || decodeFailed) && (
+        <div className="flex flex-wrap items-center gap-2 border-t border-border pt-3">
+          {decodeDone && !decodeFailed && (
+            <Button size="sm" asChild className="cursor-pointer">
+              <a
+                href={withBuilderUtmTrackingParams(result.builderUrl, {
+                  campaign: "product",
+                  content: "design_system_intelligence",
+                })}
+                target="_blank"
+                rel="noreferrer"
+              >
+                <IconExternalLink className="w-3.5 h-3.5" />
+                {t("designSystemSetup.openInBuilder")}
+              </a>
+            </Button>
+          )}
+          <Button
+            size="sm"
+            variant="ghost"
+            onClick={onReset}
+            className="cursor-pointer"
+          >
+            {t("designSystemSetup.chooseAnotherFile")}
+          </Button>
+        </div>
+      )}
+    </div>
+  );
+}
+
+function FileList({
+  files,
+  onRemove,
+}: {
+  files: UploadedFile[];
+  onRemove: (id: string) => void;
+}) {
+  const t = useT();
+  if (files.length === 0) return null;
+  return (
+    <div className="space-y-1">
+      {files.map((f) => (
+        <div
+          key={f.id}
+          className="flex items-center gap-2 text-sm text-foreground/80 bg-accent rounded-md px-3 py-1.5"
+        >
+          <IconCheck className="w-3.5 h-3.5 text-primary shrink-0" />
+          <span className="truncate flex-1">{f.name}</span>
+          <span className="text-[10px] text-muted-foreground shrink-0">
+            {formatSize(f.size)}
+          </span>
+          <button
+            onClick={() => onRemove(f.id)}
+            aria-label={t("designSystemSetup.removeItem", { item: f.name })}
+            className="text-muted-foreground hover:text-foreground/70 shrink-0 cursor-pointer"
+          >
+            <IconX className="w-3.5 h-3.5" />
+          </button>
+        </div>
+      ))}
+    </div>
+  );
+}
+
+function formatSize(bytes: number): string {
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}