@ai-matrx/rich-content 0.2.4 → 0.2.7

package/dist/utils/lifted/errors.js

@@ -0,0 +1,29 @@
+import { extractErrorMessage } from "@ai-matrx/data/net";
+import { makeAssertData } from "@ai-matrx/kit/errors";
+import {
+  humanizeBackendError,
+  makeAssertData as makeAssertData2,
+  operationFailed,
+  stripTerminalCodes
+} from "@ai-matrx/kit/errors";
+function makeGovernedDataAsserter(action, governanceCode) {
+  const assertData = makeAssertData(action);
+  return function assertGovernedData(data, error, override) {
+    if (error) {
+      const message = extractErrorMessage(error).split(" \xB7 ")[0];
+      const governed = message.match(governanceCode);
+      if (governed) {
+        throw new Error(message.slice(governed[0].length), { cause: error });
+      }
+    }
+    return assertData(data, error, override);
+  };
+}
+export {
+  extractErrorMessage,
+  humanizeBackendError,
+  makeAssertData2 as makeAssertData,
+  makeGovernedDataAsserter,
+  operationFailed,
+  stripTerminalCodes
+};

package/dist/utils/lifted/html-document.d.ts

@@ -0,0 +1 @@
+export declare function isCompleteHtmlDocument(code: string): boolean;

package/dist/utils/lifted/html-document.js

@@ -0,0 +1,12 @@
+function isCompleteHtmlDocument(code) {
+  if (!code) return false;
+  const trimmed = code.trim();
+  const hasDoctype = /^\s*<!DOCTYPE\s+html/i.test(trimmed);
+  const hasHtmlTag = /<html[^>]*>/i.test(trimmed) && /<\/html>/i.test(trimmed);
+  const hasHead = /<head[^>]*>/i.test(trimmed) && /<\/head>/i.test(trimmed);
+  const hasBody = /<body[^>]*>/i.test(trimmed) && /<\/body>/i.test(trimmed);
+  return hasDoctype && hasHtmlTag && hasHead && hasBody;
+}
+export {
+  isCompleteHtmlDocument
+};

package/dist/utils/lifted/languageOptions.d.ts

@@ -0,0 +1,9 @@
+export interface LanguageOption {
+    value: string;
+    label: string;
+    /** Common file extensions (no leading dot). */
+    exts: string[];
+}
+export declare const LANGUAGE_OPTIONS: LanguageOption[];
+export declare function extensionForLanguage(language: string): string;
+export declare function languageFromName(name: string): string;

package/dist/utils/lifted/languageOptions.js

@@ -0,0 +1,52 @@
+const LANGUAGE_OPTIONS = [
+  { value: "plaintext", label: "Plain Text", exts: ["txt"] },
+  { value: "typescript", label: "TypeScript", exts: ["ts", "tsx"] },
+  {
+    value: "javascript",
+    label: "JavaScript",
+    exts: ["js", "jsx", "mjs", "cjs"]
+  },
+  { value: "python", label: "Python", exts: ["py"] },
+  { value: "json", label: "JSON", exts: ["json"] },
+  { value: "html", label: "HTML", exts: ["html", "htm"] },
+  { value: "css", label: "CSS", exts: ["css"] },
+  { value: "scss", label: "SCSS", exts: ["scss"] },
+  { value: "markdown", label: "Markdown", exts: ["md", "mdx"] },
+  { value: "yaml", label: "YAML", exts: ["yml", "yaml"] },
+  { value: "xml", label: "XML", exts: ["xml"] },
+  { value: "sql", label: "SQL", exts: ["sql"] },
+  { value: "shell", label: "Shell", exts: ["sh", "bash", "zsh"] },
+  { value: "go", label: "Go", exts: ["go"] },
+  { value: "rust", label: "Rust", exts: ["rs"] },
+  { value: "java", label: "Java", exts: ["java"] },
+  { value: "csharp", label: "C#", exts: ["cs"] },
+  { value: "cpp", label: "C++", exts: ["cpp", "cc", "cxx", "h", "hpp"] },
+  { value: "c", label: "C", exts: ["c"] },
+  { value: "php", label: "PHP", exts: ["php"] },
+  { value: "ruby", label: "Ruby", exts: ["rb"] },
+  { value: "swift", label: "Swift", exts: ["swift"] },
+  { value: "kotlin", label: "Kotlin", exts: ["kt", "kts"] },
+  { value: "dart", label: "Dart", exts: ["dart"] },
+  { value: "dockerfile", label: "Dockerfile", exts: ["dockerfile"] },
+  { value: "toml", label: "TOML", exts: ["toml"] },
+  { value: "ini", label: "INI", exts: ["ini"] }
+];
+const EXT_TO_LANG = /* @__PURE__ */ new Map();
+for (const opt of LANGUAGE_OPTIONS) {
+  for (const ext of opt.exts) EXT_TO_LANG.set(ext, opt.value);
+}
+function extensionForLanguage(language) {
+  const opt = LANGUAGE_OPTIONS.find((o) => o.value === language);
+  return opt?.exts[0] ?? "txt";
+}
+function languageFromName(name) {
+  const dot = name.lastIndexOf(".");
+  if (dot < 0) return "plaintext";
+  const ext = name.slice(dot + 1).toLowerCase();
+  return EXT_TO_LANG.get(ext) ?? "plaintext";
+}
+export {
+  LANGUAGE_OPTIONS,
+  extensionForLanguage,
+  languageFromName
+};

package/dist/utils/lifted/languages.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Central Language Utilities
+ * Single source of truth for all language mappings and conversions
+ */
+export declare function normalizeLanguage(lang: string): string;
+/**
+ * Map language identifiers to Monaco Editor-compatible language names
+ * @param lang - The language identifier (may be undefined, null, or invalid)
+ * @returns A valid Monaco language name, defaulting to 'plaintext' if invalid
+ */
+export declare function mapLanguageForMonaco(lang: string): string;
+/**
+ * Normalize a fence language to the canonical view-language name
+ * (`js` → `javascript`, `sh` → `bash`, …) — used for language checks such as
+ * "is this a complete HTML document". Highlighting itself is Shiki's
+ * (code-block/highlight/shiki-highlighter.ts), which resolves its own grammars.
+ * @param lang - The language identifier (may be undefined, null, or invalid)
+ * @returns The canonical language name, defaulting to 'text' if invalid
+ */
+export declare function normalizeViewLanguage(lang: string): string;
+/**
+ * Get file extension for Monaco Editor JSX/TSX support
+ * Used when creating Monaco models to enable proper syntax highlighting
+ * @param lang - The language identifier
+ * @returns File extension (e.g., '.tsx', '.jsx') or undefined for other languages
+ */
+export declare function getMonacoFileExtension(lang: string): string | undefined;
+/**
+ * Get comprehensive file extension for any language
+ * Used for file downloads and general file identification
+ * @param lang - The language identifier
+ * @returns File extension string (e.g., '.ts', '.py', '.txt')
+ */
+export declare function getFileExtension(lang: string): string;

package/dist/utils/lifted/languages.js

@@ -0,0 +1,175 @@
+function normalizeLanguage(lang) {
+  const langLower = lang.toLowerCase();
+  const languageMap = {
+    "js": "javascript",
+    "ts": "typescript",
+    "jsx": "jsx",
+    "tsx": "tsx",
+    "react": "typescript",
+    "typescript": "typescript",
+    "javascript": "javascript",
+    "py": "python",
+    "python": "python",
+    "rb": "ruby",
+    "ruby": "ruby",
+    "go": "go",
+    "rust": "rust",
+    "java": "java",
+    "cpp": "cpp",
+    "c": "c",
+    "cs": "csharp",
+    "csharp": "csharp",
+    "php": "php",
+    "swift": "swift",
+    "kotlin": "kotlin",
+    "html": "html",
+    "css": "css",
+    "scss": "scss",
+    "json": "json",
+    "yaml": "yaml",
+    "yml": "yaml",
+    "xml": "xml",
+    "sql": "sql",
+    "bash": "bash",
+    "sh": "bash",
+    "shell": "bash",
+    "markdown": "markdown",
+    "md": "markdown"
+  };
+  return languageMap[langLower] || lang;
+}
+function mapLanguageForMonaco(lang) {
+  if (!lang || typeof lang !== "string") {
+    return "plaintext";
+  }
+  const languageMap = {
+    "react": "typescript",
+    // React components → TypeScript (Monaco uses 'typescript' for TSX)
+    "jsx": "javascript",
+    // JavaScript JSX → Monaco uses 'javascript' for JSX
+    "tsx": "typescript",
+    // TypeScript JSX → Monaco uses 'typescript' for TSX
+    "typescript": "typescript",
+    "javascript": "javascript",
+    "js": "javascript",
+    "ts": "typescript",
+    "html": "html",
+    "css": "css",
+    "scss": "scss",
+    "json": "json",
+    "markdown": "markdown",
+    "md": "markdown",
+    "bash": "shell",
+    "shell": "shell",
+    "sh": "shell",
+    "sql": "sql",
+    "python": "python",
+    "py": "python",
+    "diff": "diff",
+    "java": "java",
+    "csharp": "csharp",
+    "cs": "csharp",
+    "php": "php",
+    "ruby": "ruby",
+    "go": "go",
+    "rust": "rust",
+    "yaml": "yaml",
+    "yml": "yaml",
+    "xml": "xml",
+    "text": "plaintext",
+    "plaintext": "plaintext"
+  };
+  const normalizedLang = lang.trim().toLowerCase();
+  return languageMap[normalizedLang] || normalizedLang || "plaintext";
+}
+function normalizeViewLanguage(lang) {
+  if (!lang || typeof lang !== "string") {
+    return "text";
+  }
+  const languageMap = {
+    "react": "tsx",
+    // React components → TypeScript JSX
+    "jsx": "jsx",
+    // JavaScript JSX
+    "tsx": "tsx",
+    // TypeScript JSX
+    "typescript": "typescript",
+    "javascript": "javascript",
+    "js": "javascript",
+    "ts": "typescript",
+    "html": "html",
+    "css": "css",
+    "json": "json",
+    "markdown": "markdown",
+    "md": "markdown",
+    "bash": "bash",
+    "shell": "bash",
+    "sql": "sql",
+    "python": "python",
+    "py": "python",
+    "diff": "diff",
+    "text": "text",
+    "plaintext": "text"
+  };
+  const normalizedLang = lang.trim().toLowerCase();
+  return languageMap[normalizedLang] || normalizedLang || "text";
+}
+function getMonacoFileExtension(lang) {
+  if (!lang || typeof lang !== "string") {
+    return void 0;
+  }
+  const normalized = lang.trim().toLowerCase();
+  if (normalized === "tsx" || normalized === "react") return ".tsx";
+  if (normalized === "jsx") return ".jsx";
+  return void 0;
+}
+function getFileExtension(lang) {
+  if (!lang || typeof lang !== "string") {
+    return ".txt";
+  }
+  const extensionMap = {
+    "typescript": ".ts",
+    "javascript": ".js",
+    "jsx": ".jsx",
+    "tsx": ".tsx",
+    "react": ".tsx",
+    "json": ".json",
+    "html": ".html",
+    "css": ".css",
+    "scss": ".scss",
+    "python": ".py",
+    "py": ".py",
+    "java": ".java",
+    "cpp": ".cpp",
+    "c": ".c",
+    "csharp": ".cs",
+    "cs": ".cs",
+    "php": ".php",
+    "ruby": ".rb",
+    "rb": ".rb",
+    "go": ".go",
+    "rust": ".rs",
+    "swift": ".swift",
+    "kotlin": ".kt",
+    "sql": ".sql",
+    "shell": ".sh",
+    "sh": ".sh",
+    "bash": ".sh",
+    "yaml": ".yaml",
+    "yml": ".yaml",
+    "xml": ".xml",
+    "markdown": ".md",
+    "md": ".md",
+    "text": ".txt",
+    "plaintext": ".txt"
+  };
+  const normalizedLang = lang.trim().toLowerCase();
+  return extensionMap[normalizedLang] || ".txt";
+}
+export {
+  getFileExtension,
+  getMonacoFileExtension,
+  mapLanguageForMonaco,
+  normalizeLanguage,
+  normalizeViewLanguage
+};

package/dist/utils/lifted/loading-spinner.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+type LoadingVariant = 'dots' | 'bars' | 'brain' | 'minimal' | 'workflow';
+type LoadingSize = 'sm' | 'md' | 'lg';
+interface LoadingSpinnerProps {
+    variant?: LoadingVariant;
+    size?: LoadingSize;
+    message?: string;
+    className?: string;
+    showMessage?: boolean;
+    fullscreen?: boolean;
+    overlay?: boolean;
+    title?: string;
+    subtitle?: string;
+    showFeatureIndicators?: boolean;
+    showProgressSteps?: boolean;
+}
+declare const LoadingSpinner: React.FC<LoadingSpinnerProps>;
+export default LoadingSpinner;

package/dist/utils/lifted/loading-spinner.js

@@ -0,0 +1,200 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import React from "react";
+import { cn } from "@ai-matrx/design-system";
+import { Loader2, Workflow, Plus } from "lucide-react";
+const animationStyles = `
+  @keyframes pulseWave {
+    0% { opacity: 0.3; transform: scale(0.8); }
+    50% { opacity: 1; transform: scale(1); }
+    100% { opacity: 0.3; transform: scale(0.8); }
+  }
+  
+  @keyframes bounce {
+    0%, 100% { transform: translateY(0); }
+    50% { transform: translateY(-5px); }
+  }
+  
+  @keyframes neuronPulse {
+    0% { transform: scale(0.8); opacity: 0.3; }
+    40% { transform: scale(1.4); opacity: 1; }
+    80% { transform: scale(0.8); opacity: 0.3; }
+    100% { transform: scale(0.8); opacity: 0.3; }
+  }
+  
+  @keyframes brainWavePulse {
+    0% { transform: scale(0.8); opacity: 0; }
+    20% { opacity: 0.2; }
+    50% { transform: scale(1.5); opacity: 0; }
+    100% { transform: scale(1.8); opacity: 0; }
+  }
+  
+  .loading-pulse-1 { animation: pulseWave 1.5s infinite ease-in-out; animation-delay: 0s; }
+  .loading-pulse-2 { animation: pulseWave 1.5s infinite ease-in-out; animation-delay: 0.3s; }
+  .loading-pulse-3 { animation: pulseWave 1.5s infinite ease-in-out; animation-delay: 0.6s; }
+  
+  .loading-bounce-1 { animation: bounce 1s infinite ease-in-out; animation-delay: 0s; }
+  .loading-bounce-2 { animation: bounce 1s infinite ease-in-out; animation-delay: 0.2s; }
+  .loading-bounce-3 { animation: bounce 1s infinite ease-in-out; animation-delay: 0.4s; }
+  .loading-bounce-4 { animation: bounce 1s infinite ease-in-out; animation-delay: 0.6s; }
+  
+  .loading-neuron-1 { animation: neuronPulse 2s infinite ease-in-out; animation-delay: 0s; }
+  .loading-neuron-2 { animation: neuronPulse 2s infinite ease-in-out; animation-delay: 0.4s; }
+  .loading-neuron-3 { animation: neuronPulse 2s infinite ease-in-out; animation-delay: 0.8s; }
+  .loading-neuron-4 { animation: neuronPulse 2s infinite ease-in-out; animation-delay: 1.2s; }
+  .loading-neuron-5 { animation: neuronPulse 2s infinite ease-in-out; animation-delay: 1.6s; }
+  
+  .loading-brain-pulse-1 { animation: brainWavePulse 2s infinite ease-in-out; animation-delay: 0s; }
+  .loading-brain-pulse-2 { animation: brainWavePulse 2s infinite ease-in-out; animation-delay: 0.5s; }
+`;
+const LoadingSpinner = ({
+  variant = "dots",
+  size = "md",
+  message,
+  className = "",
+  showMessage = true,
+  fullscreen = false,
+  overlay = false,
+  title,
+  subtitle,
+  showFeatureIndicators = false,
+  showProgressSteps = true
+}) => {
+  React.useEffect(() => {
+    const styleId = "loading-spinner-styles";
+    if (!document.getElementById(styleId)) {
+      const style = document.createElement("style");
+      style.id = styleId;
+      style.textContent = animationStyles;
+      document.head.appendChild(style);
+    }
+  }, []);
+  const getSizeClasses = () => {
+    switch (size) {
+      case "sm":
+        return { container: "gap-2", dot: "w-1.5 h-1.5", bar: "w-0.5 h-2", text: "text-xs" };
+      case "lg":
+        return { container: "gap-4", dot: "w-2.5 h-2.5", bar: "w-1.5 h-4", text: "text-base" };
+      default:
+        return { container: "gap-3", dot: "w-2 h-2", bar: "w-1 h-2.5", text: "text-sm" };
+    }
+  };
+  const sizeClasses = getSizeClasses();
+  const renderDots = () => /* @__PURE__ */ jsxs("div", { className: cn("flex items-center", sizeClasses.container), children: [
+    /* @__PURE__ */ jsx("div", { className: cn(sizeClasses.dot, "bg-primary dark:bg-primary-foreground rounded-full loading-pulse-1") }),
+    /* @__PURE__ */ jsx("div", { className: cn(sizeClasses.dot, "bg-primary dark:bg-primary-foreground rounded-full loading-pulse-2") }),
+    /* @__PURE__ */ jsx("div", { className: cn(sizeClasses.dot, "bg-primary dark:bg-primary-foreground rounded-full loading-pulse-3") })
+  ] });
+  const renderBars = () => /* @__PURE__ */ jsxs("div", { className: cn("flex items-center", sizeClasses.container), children: [
+    /* @__PURE__ */ jsx("div", { className: cn(sizeClasses.bar, "bg-primary dark:bg-primary-foreground rounded-sm loading-bounce-1") }),
+    /* @__PURE__ */ jsx("div", { className: cn(sizeClasses.bar, "bg-primary dark:bg-primary-foreground rounded-sm loading-bounce-2") }),
+    /* @__PURE__ */ jsx("div", { className: cn(sizeClasses.bar, "bg-primary dark:bg-primary-foreground rounded-sm loading-bounce-3") }),
+    /* @__PURE__ */ jsx("div", { className: cn(sizeClasses.bar, "bg-primary dark:bg-primary-foreground rounded-sm loading-bounce-4") })
+  ] });
+  const renderBrain = () => /* @__PURE__ */ jsxs("div", { className: "relative w-6 h-6 flex items-center justify-center", children: [
+    /* @__PURE__ */ jsx("div", { className: "absolute", children: /* @__PURE__ */ jsx(
+      "svg",
+      {
+        width: "24",
+        height: "24",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        className: "w-5 h-5 text-primary dark:text-primary-foreground",
+        children: /* @__PURE__ */ jsx(
+          "path",
+          {
+            d: "M12 4C9.5 4 7.5 5.5 7.5 8C7.5 9 7.5 9.5 7 10.5C6.5 11.5 6 12 6 13.5C6 15.5 7.5 17 9.5 17C10.5 17 11 16.5 12 16.5C13 16.5 13.5 17 14.5 17C16.5 17 18 15.5 18 13.5C18 12 17.5 11.5 17 10.5C16.5 9.5 16.5 9 16.5 8C16.5 5.5 14.5 4 12 4Z",
+            className: "stroke-current",
+            fill: "none",
+            strokeWidth: "1.5"
+          }
+        )
+      }
+    ) }),
+    /* @__PURE__ */ jsxs("div", { className: "absolute inset-0", children: [
+      /* @__PURE__ */ jsx("div", { className: "absolute w-1 h-1 bg-primary/60 dark:bg-primary-foreground/60 rounded-full left-[8px] top-[10px] loading-neuron-1" }),
+      /* @__PURE__ */ jsx("div", { className: "absolute w-1 h-1 bg-primary/60 dark:bg-primary-foreground/60 rounded-full left-[12px] top-[8px] loading-neuron-2" }),
+      /* @__PURE__ */ jsx("div", { className: "absolute w-1 h-1 bg-primary/60 dark:bg-primary-foreground/60 rounded-full left-[16px] top-[10px] loading-neuron-3" }),
+      /* @__PURE__ */ jsx("div", { className: "absolute w-1 h-1 bg-primary/60 dark:bg-primary-foreground/60 rounded-full left-[10px] top-[14px] loading-neuron-4" }),
+      /* @__PURE__ */ jsx("div", { className: "absolute w-1 h-1 bg-primary/60 dark:bg-primary-foreground/60 rounded-full left-[14px] top-[14px] loading-neuron-5" })
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "absolute w-full h-full rounded-full border border-primary/30 dark:border-primary-foreground/30 loading-brain-pulse-1" }),
+    /* @__PURE__ */ jsx("div", { className: "absolute w-full h-full rounded-full border border-primary/30 dark:border-primary-foreground/30 loading-brain-pulse-2" })
+  ] });
+  const renderMinimal = () => /* @__PURE__ */ jsx("div", { className: "relative", children: /* @__PURE__ */ jsx("div", { className: cn(sizeClasses.dot, "bg-primary dark:bg-primary-foreground rounded-full loading-pulse-1") }) });
+  const renderWorkflow = () => /* @__PURE__ */ jsxs("div", { className: "flex flex-col items-center justify-center space-y-6", children: [
+    /* @__PURE__ */ jsxs("div", { className: "relative", children: [
+      /* @__PURE__ */ jsx("div", { className: "w-16 h-16 bg-primary/10 dark:bg-primary-foreground/10 rounded-full flex items-center justify-center", children: /* @__PURE__ */ jsx(Workflow, { className: "w-8 h-8 text-primary dark:text-primary-foreground" }) }),
+      /* @__PURE__ */ jsx("div", { className: "absolute -top-1 -right-1 w-6 h-6 bg-primary dark:bg-primary-foreground rounded-full flex items-center justify-center", children: /* @__PURE__ */ jsx(Plus, { className: "w-3 h-3 text-primary-foreground dark:text-primary" }) }),
+      /* @__PURE__ */ jsx("div", { className: "absolute inset-0 border-2 border-transparent border-t-primary dark:border-t-primary-foreground rounded-full animate-spin" })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "text-center space-y-2", children: [
+      /* @__PURE__ */ jsxs("h2", { className: "text-lg font-semibold text-foreground flex items-center gap-2 justify-center", children: [
+        /* @__PURE__ */ jsx(Loader2, { className: "w-4 h-4 animate-spin" }),
+        title || "Loading Workflow"
+      ] }),
+      /* @__PURE__ */ jsx("p", { className: "type-body text-muted-foreground max-w-sm", children: subtitle || message || "Setting up your workflow..." })
+    ] }),
+    showProgressSteps && /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 type-secondary text-muted-foreground", children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1", children: [
+        /* @__PURE__ */ jsx("div", { className: "w-2 h-2 bg-primary dark:bg-primary-foreground rounded-full animate-pulse" }),
+        /* @__PURE__ */ jsx("span", { children: "Loading" })
+      ] }),
+      /* @__PURE__ */ jsx("div", { className: "w-4 h-px bg-muted-foreground/30" }),
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1 opacity-50", children: [
+        /* @__PURE__ */ jsx("div", { className: "w-2 h-2 bg-muted-foreground/30 rounded-full" }),
+        /* @__PURE__ */ jsx("span", { children: "Initializing" })
+      ] }),
+      /* @__PURE__ */ jsx("div", { className: "w-4 h-px bg-muted-foreground/30" }),
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1 opacity-30", children: [
+        /* @__PURE__ */ jsx("div", { className: "w-2 h-2 bg-muted-foreground/30 rounded-full" }),
+        /* @__PURE__ */ jsx("span", { children: "Ready" })
+      ] })
+    ] })
+  ] });
+  const renderSpinner = () => {
+    switch (variant) {
+      case "bars":
+        return renderBars();
+      case "brain":
+        return renderBrain();
+      case "minimal":
+        return renderMinimal();
+      case "workflow":
+        return renderWorkflow();
+      default:
+        return renderDots();
+    }
+  };
+  const getDefaultMessage = () => {
+    switch (variant) {
+      case "brain":
+        return "Processing...";
+      case "workflow":
+        return "Loading workflows...";
+      default:
+        return "Loading...";
+    }
+  };
+  if (variant === "workflow" && (fullscreen || overlay)) {
+    return /* @__PURE__ */ jsxs("div", { className: cn(
+      "flex items-center justify-center bg-background",
+      fullscreen && "h-dvh w-full",
+      className
+    ), children: [
+      overlay && /* @__PURE__ */ jsx("div", { className: "absolute inset-0 bg-background/80 backdrop-blur-sm z-50" }),
+      /* @__PURE__ */ jsx("div", { className: cn(
+        "flex flex-col items-center justify-center",
+        overlay && "relative z-50"
+      ), children: renderWorkflow() })
+    ] });
+  }
+  return /* @__PURE__ */ jsx("div", { className: cn("flex items-center", className), children: variant === "workflow" ? renderWorkflow() : /* @__PURE__ */ jsxs(Fragment, { children: [
+    renderSpinner(),
+    showMessage && /* @__PURE__ */ jsx("span", { className: cn("ml-3 text-muted-foreground", sizeClasses.text), children: message || getDefaultMessage() })
+  ] }) });
+};
+var loading_spinner_default = LoadingSpinner;
+export {
+  loading_spinner_default as default
+};

package/dist/utils/lifted/media-refs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * features/files/media-client/refs.ts
+ *
+ * Identity conversion between the handler's `FileSource` vocabulary and the
+ * `@ai-matrx/media` `MediaRefLike` port. Used by call sites that build a
+ * `FileSource` (via `buildMediaSource`, `recognizeOurFileUrl`, …) but render
+ * through the package hooks/components. Pure — no I/O, no minting; the one
+ * URL it constructs (share token → public share URL) goes through the
+ * canonical builder in `handler/utils/python-base`.
+ */
+import type { MediaRefLike } from "@ai-matrx/media";
+import type { FileSource } from "@ai-matrx/media/files/engine/handler/types";
+export declare function fileSourceToMediaRef(source: FileSource | null | undefined): MediaRefLike | null;

package/dist/utils/lifted/media-refs.js

@@ -0,0 +1,27 @@
+import { shareUrls } from "@ai-matrx/media/files/engine/handler/utils/python-base";
+function fileSourceToMediaRef(source) {
+  if (!source) return null;
+  switch (source.kind) {
+    case "file_id":
+      return { file_id: source.fileId, mime_type: source.mime ?? void 0 };
+    case "external_url":
+      return { url: source.url, mime_type: source.mime ?? void 0 };
+    case "public_cdn":
+      return { url: source.url, mime_type: source.mime ?? void 0 };
+    case "cloud_file":
+      return {
+        file_id: source.cloudFile.id,
+        mime_type: source.cloudFile.mimeType ?? void 0
+      };
+    case "share_link":
+      return {
+        url: shareUrls(source.token).public,
+        mime_type: source.mime ?? void 0
+      };
+    default:
+      return null;
+  }
+}
+export {
+  fileSourceToMediaRef
+};

package/dist/utils/lifted/scroll-root.d.ts

@@ -0,0 +1 @@
+export declare function nearestScrollRoot(el: Element | null): Element | null;

package/dist/utils/lifted/scroll-root.js

@@ -0,0 +1,25 @@
+const scrollsByStyle = /* @__PURE__ */ new WeakMap();
+const verticalScrollers = /* @__PURE__ */ new WeakSet();
+function nearestScrollRoot(el) {
+  if (typeof window === "undefined" || !el) return null;
+  const page = document.scrollingElement;
+  for (let node = el.parentElement; node; node = node.parentElement) {
+    if (node === page || node === document.body || node === document.documentElement) return null;
+    let scrolls = scrollsByStyle.get(node);
+    if (scrolls === void 0) {
+      const { overflowY } = getComputedStyle(node);
+      scrolls = overflowY === "auto" || overflowY === "scroll";
+      scrollsByStyle.set(node, scrolls);
+    }
+    if (!scrolls) continue;
+    if (verticalScrollers.has(node)) return node;
+    if (node.scrollHeight > node.clientHeight + 1) {
+      verticalScrollers.add(node);
+      return node;
+    }
+  }
+  return null;
+}
+export {
+  nearestScrollRoot
+};

package/dist/utils/lifted/syntax-themes.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Syntax palette shared by the Shiki code view (code-block/highlight) and the
+ * Monaco editor: VS Code Dark+/Light+ everywhere, with JSON in a JetBrains
+ * Darcula–inspired palette.
+ */
+/** Darcula-inspired JSON palette — single source of truth for Shiki + Monaco. */
+export declare const JSON_SYNTAX_COLORS: {
+    readonly dark: {
+        readonly key: "#7dd3fc";
+        readonly string: "#6ee7b7";
+        readonly number: "#fbbf24";
+        readonly boolean: "#c4b5fd";
+        readonly null: "#a1a1aa";
+        readonly punctuation: "#a1a1aa";
+    };
+    readonly light: {
+        readonly key: "#0369a1";
+        readonly string: "#047857";
+        readonly number: "#b45309";
+        readonly boolean: "#6d28d9";
+        readonly null: "#71717a";
+        readonly punctuation: "#4b5563";
+    };
+};
+export declare function registerJsonMonacoThemes(monaco: {
+    editor: {
+        defineTheme: (name: string, theme: unknown) => void;
+    };
+}): void;
+export declare function isJsonLanguage(language: string | undefined): boolean;
+/** Monaco theme id for SmallCodeEditor edit mode. */
+export declare function resolveMonacoEditorTheme(language: string | undefined, mode: "light" | "dark"): string;