@ai-matrx/design-system 0.86.354 → 0.86.356

package/dist/lite-table.cjs

@@ -229,6 +229,85 @@ Button.displayName = "Button";
 
 // src/error-box.tsx
 var React2 = __toESM(require("react"), 1);
+
+// src/desktop/errors.ts
+var RULES = [
+  { code: "ENOENT", test: /\b(spawn\s+\S+\s+)?ENOENT\b|command not found|no such file or directory/i, cause: "A program or file it needs isn't on this computer. Install it or update Matrx, then try again." },
+  { code: "EACCES", test: /\bEACCES\b|\bEPERM\b|permission denied|operation not permitted|not authori[sz]ed by the user/i, cause: "Matrx isn't allowed to do that. Grant access in System Settings \u203A Privacy & Security, then try again." },
+  { code: "EADDRINUSE", test: /\bEADDRINUSE\b|address already in use|port .* (is )?(already )?in use/i, cause: "Another program is already using that port. Stop it, or choose another port." },
+  { code: "ECONNREFUSED", test: /\bECONNREFUSED\b|connection refused/i, cause: "The service isn't answering. It may have stopped; start it again." },
+  { code: "OFFLINE", test: /\bENOTFOUND\b|\bEAI_AGAIN\b|\bENETUNREACH\b|getaddrinfo|network (is )?unreachable|failed to fetch|offline/i, cause: "Can't reach the internet. Check the connection and try again." },
+  { code: "TIMEOUT", test: /\bETIMEDOUT\b|timed? ?out|\bTIMEOUT\b|deadline exceeded/i, cause: "It took too long to answer. Try again in a moment." },
+  { code: "ENOSPC", test: /\bENOSPC\b|no space left/i, cause: "The disk is full. Free some space, then try again." },
+  { code: "ENOMEM", test: /\bENOMEM\b|out of memory|cannot allocate memory/i, cause: "The computer ran out of memory. Close something and try again." },
+  { code: "UNAUTHORIZED", test: /\b401\b|unauthori[sz]ed|invalid (api )?key|not signed in|jwt expired|session expired/i, cause: "You're signed out, or the key was refused. Sign in again." },
+  { code: "FORBIDDEN", test: /\b403\b|forbidden/i, cause: "This account isn't allowed to do that." },
+  { code: "NOT_FOUND", test: /\b404\b|not found/i, cause: "It isn't there any more. Refresh and try again." },
+  { code: "RATE_LIMIT", test: /\b429\b|rate.?limit|too many requests/i, cause: "Too many requests just now. Wait a moment and try again." },
+  { code: "SERVER", test: /\b5\d\d\b|internal server error|bad gateway|service unavailable/i, cause: "The server had a problem. Try again in a moment." },
+  { code: "EXITED", test: /exited with code|process exited|crashed|SIGKILL|SIGSEGV|SIGTERM/i, cause: "The service stopped unexpectedly. Start it again; Copy details if it keeps happening." }
+];
+var RAW = /\b[A-Z]{2,}[A-Z_]*\b|[\\/][\w.-]+[\\/]|\bat \S+ \(|\{|\}|errno|stack|undefined|null|\bspawn\b/;
+function rawText(error) {
+  if (error instanceof Error) return error.message || error.name;
+  if (typeof error === "string") return error;
+  if (error && typeof error === "object" && "message" in error && typeof error.message === "string") {
+    return error.message;
+  }
+  return "";
+}
+function describeError(error, fallback = "Something went wrong. Try again.") {
+  const detail = rawText(error).trim();
+  if (!detail) return { cause: fallback, detail: "" };
+  for (const rule of RULES) {
+    if (rule.test.test(detail)) return { cause: rule.cause, detail, code: rule.code };
+  }
+  if (!RAW.test(detail) && detail.length <= 160) return { cause: detail, detail: "" };
+  return { cause: fallback, detail };
+}
+
+// src/error-sentence.ts
+function errorSentenceOf(error) {
+  if (error == null || error === true || error === false) return "";
+  if (typeof error === "string") return error;
+  if (typeof error !== "object") return String(error);
+  const message = error.message;
+  return typeof message === "string" ? message : "";
+}
+var TIMED_OUT_SENTENCE = "That took too long. Nothing was lost; try again.";
+var FALLBACK_ERROR_SENTENCE = "Something went wrong. Try again.";
+function isTimedOutError(error, message, code) {
+  if (code === "57014" || code === "timed_out") return true;
+  if (error && typeof error === "object") {
+    const o = error;
+    if (o.code === "57014" || o.code === "timed_out" || o.sqlstate === "57014") return true;
+  }
+  const text = `${message ?? ""} ${errorSentenceOf(error)}`;
+  return /canceling statement due to statement timeout/i.test(text);
+}
+function offlineText(text) {
+  const t = text.trim();
+  return t !== "" && (describeError(t).code === "OFFLINE" || /networkerror|network request failed|load failed/i.test(t));
+}
+var ANY_HOST_CODES = /* @__PURE__ */ new Set(["OFFLINE", "TIMEOUT", "UNAUTHORIZED", "FORBIDDEN", "NOT_FOUND", "RATE_LIMIT", "SERVER"]);
+var MACHINE_PREFIX = /^\s*(?:\[[\w./-]+\]\s*|[a-z][\w]*(?:[._][\w]+)+:\s+)/;
+var RAW_TEXT = /\b(?:Type|Reference|Syntax|Range|Internal|Eval|URI)Error\b|\bat\s+[\w$.<>]+\s*\(|\.(?:[cm]?[jt]sx?|py):\d+|(?:^|[\s(])(?:\/[\w.@-]+){2,}|\bundefined is not\b|\bcannot read propert(?:y|ies)\b|\bis not a function\b|\bunexpected token\b/i;
+function peopleErrorSentence(error, message, options = {}) {
+  if (isTimedOutError(error, message, options.code)) return TIMED_OUT_SENTENCE;
+  const fallback = options.fallback ?? FALLBACK_ERROR_SENTENCE;
+  const raw = message?.trim() || errorSentenceOf(error).trim();
+  if (!raw) return fallback;
+  let text = raw;
+  for (let i = 0; i < 3 && MACHINE_PREFIX.test(text); i++) text = text.replace(MACHINE_PREFIX, "").trim();
+  if (!text) return fallback;
+  if (offlineText(text) || RAW_TEXT.test(text) || text !== raw) {
+    const said = describeError(text, fallback);
+    return said.code && ANY_HOST_CODES.has(said.code) ? said.cause : fallback;
+  }
+  return text;
+}
+
+// src/error-box.tsx
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var CONTEXT_KEY = /* @__PURE__ */ Symbol.for("@ai-matrx/design-system/error-actions");
 var registry = globalThis;
@@ -247,6 +326,11 @@ function ErrorActions(props) {
   if (!render) return null;
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_jsx_runtime3.Fragment, { children: render(props) });
 }
+function sayable(body, error) {
+  if (typeof body === "string") return peopleErrorSentence(error, body);
+  if (Array.isArray(body)) return body.map((b) => typeof b === "string" && b.trim() ? peopleErrorSentence(error, b) : b);
+  return body;
+}
 var ErrorBox = React2.forwardRef(function ErrorBox2({
   as = "p",
   message,
@@ -270,30 +354,13 @@ var ErrorBox = React2.forwardRef(function ErrorBox2({
     ...origin !== void 0 ? { origin } : {}
   };
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Tag, { ref, role: "alert", "data-error-box": "", ...rest, children: [
-    children ?? message,
+    sayable(children ?? message, error),
     /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(ErrorActions, { ...facts })
   ] });
 });
 
 // src/error-notice.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
-function errorSentenceOf(error) {
-  if (error == null || error === true || error === false) return "";
-  if (typeof error === "string") return error;
-  if (typeof error !== "object") return String(error);
-  const message = error.message;
-  return typeof message === "string" ? message : "";
-}
-var TIMED_OUT_SENTENCE = "That took too long. Nothing was lost; try again.";
-function isTimedOutError(error, message, code) {
-  if (code === "57014" || code === "timed_out") return true;
-  if (error && typeof error === "object") {
-    const o = error;
-    if (o.code === "57014" || o.code === "timed_out" || o.sqlstate === "57014") return true;
-  }
-  const text = `${message ?? ""} ${errorSentenceOf(error)}`;
-  return /canceling statement due to statement timeout/i.test(text);
-}
 function ErrorNotice({
   title,
   message,
@@ -313,7 +380,7 @@ function ErrorNotice({
   className
 }) {
   const timedOut = isTimedOutError(error, message, code);
-  const sentence = timedOut ? TIMED_OUT_SENTENCE : message?.trim() || errorSentenceOf(error).trim() || "Something went wrong.";
+  const sentence = peopleErrorSentence(error, message, { code });
   const actions = actionsProp ?? (timedOut && onRetry ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Button, { type: "button", size: "sm", variant: "outline", "data-error-retry": "", onClick: onRetry, children: "Try again" }) : void 0);
   const menus = useErrorCardMenus();
   const input = {