@ai-matrx/design-system 0.86.353 → 0.86.355

package/dist/email-input-dialog.js

@@ -7,7 +7,7 @@ import {
 } from "./chunk-XERGQT2M.js";
 import {
   ErrorActions
-} from "./chunk-HKLIRHT2.js";
+} from "./chunk-LJKF267O.js";
 import {
   Dialog,
   DialogContent,

package/dist/index.cjs

@@ -1306,6 +1306,103 @@ var init_drawer = __esm({
   }
 });
 
+// src/desktop/errors.ts
+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 };
+}
+var RULES, RAW;
+var init_errors = __esm({
+  "src/desktop/errors.ts"() {
+    "use strict";
+    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." }
+    ];
+    RAW = /\b[A-Z]{2,}[A-Z_]*\b|[\\/][\w.-]+[\\/]|\bat \S+ \(|\{|\}|errno|stack|undefined|null|\bspawn\b/;
+  }
+});
+
+// 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 : "";
+}
+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 isOfflineError(error, message) {
+  if (typeof navigator !== "undefined" && navigator.onLine === false) return true;
+  return offlineText(`${message ?? ""} ${errorSentenceOf(error)}`);
+}
+function offlineText(text) {
+  const t = text.trim();
+  return t !== "" && (describeError(t).code === "OFFLINE" || /networkerror|network request failed|load failed/i.test(t));
+}
+function isRawErrorText(text) {
+  return MACHINE_PREFIX.test(text) || RAW_TEXT.test(text);
+}
+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;
+}
+var TIMED_OUT_SENTENCE, FALLBACK_ERROR_SENTENCE, ANY_HOST_CODES, MACHINE_PREFIX, RAW_TEXT;
+var init_error_sentence = __esm({
+  "src/error-sentence.ts"() {
+    "use strict";
+    init_errors();
+    TIMED_OUT_SENTENCE = "That took too long. Nothing was lost; try again.";
+    FALLBACK_ERROR_SENTENCE = "Something went wrong. Try again.";
+    ANY_HOST_CODES = /* @__PURE__ */ new Set(["OFFLINE", "TIMEOUT", "UNAUTHORIZED", "FORBIDDEN", "NOT_FOUND", "RATE_LIMIT", "SERVER"]);
+    MACHINE_PREFIX = /^\s*(?:\[[\w./-]+\]\s*|[a-z][\w]*(?:[._][\w]+)+:\s+)/;
+    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;
+  }
+});
+
 // src/error-box.tsx
 function ErrorActionsProvider({
   render,
@@ -1330,11 +1427,17 @@ function ErrorActions(props) {
   if (!render) return null;
   return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(import_jsx_runtime10.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 React8, import_jsx_runtime10, CONTEXT_KEY, registry2, ErrorActionsContext, MENUS_KEY, menusRegistry, ErrorCardMenusContext, ErrorBox;
 var init_error_box = __esm({
   "src/error-box.tsx"() {
     "use strict";
     React8 = __toESM(require("react"), 1);
+    init_error_sentence();
     import_jsx_runtime10 = require("react/jsx-runtime");
     CONTEXT_KEY = /* @__PURE__ */ Symbol.for("@ai-matrx/design-system/error-actions");
     registry2 = globalThis;
@@ -1365,7 +1468,7 @@ var init_error_box = __esm({
         ...origin !== void 0 ? { origin } : {}
       };
       return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(Tag, { ref, role: "alert", "data-error-box": "", ...rest, children: [
-        children ?? message,
+        sayable(children ?? message, error),
         /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(ErrorActions, { ...facts })
       ] });
     });
@@ -4387,6 +4490,7 @@ __export(src_exports, {
   ErrorBox: () => ErrorBox,
   ErrorCardMenusProvider: () => ErrorCardMenusProvider,
   ErrorNotice: () => ErrorNotice,
+  FALLBACK_ERROR_SENTENCE: () => FALLBACK_ERROR_SENTENCE,
   FIELD_SURFACE_CLASS: () => FIELD_SURFACE_CLASS,
   FIRST_USE_HINT_DETAIL_MAX: () => FIRST_USE_HINT_DETAIL_MAX,
   FIRST_USE_HINT_TITLE_MAX: () => FIRST_USE_HINT_TITLE_MAX,
@@ -4619,6 +4723,8 @@ __export(src_exports, {
   insertLines: () => insertLines,
   isInsideFloatingLayer: () => isInsideFloatingLayer,
   isModalLayerOpen: () => isModalLayerOpen,
+  isOfflineError: () => isOfflineError,
+  isRawErrorText: () => isRawErrorText,
   isRecordUuid: () => isRecordUuid,
   isTimedOutError: () => isTimedOutError,
   keepFloatingLayersInside: () => keepFloatingLayersInside,
@@ -4634,6 +4740,7 @@ __export(src_exports, {
   parseSocial: () => parseSocial,
   parseUrl: () => parseUrl,
   peekRecordData: () => peekRecordData,
+  peopleErrorSentence: () => peopleErrorSentence,
   phoneGrid: () => phoneGrid,
   placeBox: () => placeBox,
   placementOf: () => placementOf,
@@ -5409,24 +5516,8 @@ init_icons();
 init_cn();
 init_button();
 init_error_box();
+init_error_sentence();
 var import_jsx_runtime13 = 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,
@@ -5446,7 +5537,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 actions2 = actionsProp ?? (timedOut && onRetry ? /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(Button, { type: "button", size: "sm", variant: "outline", "data-error-retry": "", onClick: onRetry, children: "Try again" }) : void 0);
   const menus = useErrorCardMenus();
   const input = {
@@ -5538,6 +5629,9 @@ function ErrorNotice({
   return /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(menus.Boundary, { title: menuTitle, text: menuText, children: card });
 }
 
+// src/index.ts
+init_error_sentence();
+
 // src/read-state/read-gate.tsx
 init_icons();
 
@@ -14534,7 +14628,7 @@ function EmailValue({ email, owner, state = "ok", peek = true, about }) {
     ...ok ? { primary: { label: "Send email", onSelect: () => window.location.assign(mailtoHref(parsed.address)) } } : {},
     copyData: { email: parsed.address, ...owner ? { owner } : {} }
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime92.jsx)(ValueShell, { kind: "email", glyph: MailGlyph, text: parsed.address, copy: parsed.address, state, record, peek, about });
+  return /* @__PURE__ */ (0, import_jsx_runtime92.jsx)(ValueShell, { kind: "email", glyph: MailGlyph, text: parsed.address, copy: parsed.address, state, record, peek, ...about !== void 0 ? { about } : {} });
 }
 function PhoneValue({ phone, owner, state = "ok", peek = true, defaultCallingCode = "1", about }) {
   const parsed = parsePhone(phone, defaultCallingCode);
@@ -14559,7 +14653,7 @@ function PhoneValue({ phone, owner, state = "ok", peek = true, defaultCallingCod
     ...ok ? { primary: { label: "Call", onSelect: () => window.location.assign(telHref(parsed)) } } : {},
     copyData: { phone: parsed.e164 ?? parsed.raw, display: parsed.display, ...parsed.region ? { region: parsed.region } : {}, ...owner ? { owner } : {} }
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime92.jsx)(ValueShell, { kind: "phone number", glyph: PhoneGlyph, text: parsed.display, copy: parsed.e164 ?? parsed.raw, state, record, peek, about });
+  return /* @__PURE__ */ (0, import_jsx_runtime92.jsx)(ValueShell, { kind: "phone number", glyph: PhoneGlyph, text: parsed.display, copy: parsed.e164 ?? parsed.raw, state, record, peek, ...about !== void 0 ? { about } : {} });
 }
 var VALIDATION_TONE = { verified: "success", partial: "warning", unknown: "danger" };
 var VALIDATION_TEXT = { verified: "Verified address", partial: "Partly matched", unknown: "No match found" };
@@ -14618,7 +14712,7 @@ function AddressValue({ address, owner, state = "ok", peek = true, multiline = f
       state,
       record,
       peek,
-      about,
+      ...about !== void 0 ? { about } : {},
       ...multiline ? { wrap: true } : {}
     }
   );
@@ -14660,7 +14754,7 @@ function SocialHandleValue(props) {
       state,
       record: socialRecord(parsed, props, glyph),
       peek,
-      about: props.about
+      ...props.about !== void 0 ? { about: props.about } : {}
     }
   );
 }
@@ -14684,7 +14778,7 @@ function UrlValue({ url, title, owner, state = "ok", peek = true, icon = true, a
     ...ok ? { primary: { label: "Open", onSelect: () => (0, import_outbound2.openOutbound)(parsed.href) } } : {},
     copyData: { url: parsed.href ?? url, domain: parsed.domain, ...title ? { title } : {} }
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime92.jsx)(ValueShell, { kind: "link", ...icon ? { glyph: GlobeIcon } : {}, text: parsed.display, copy: parsed.href ?? url, state, record, peek, about });
+  return /* @__PURE__ */ (0, import_jsx_runtime92.jsx)(ValueShell, { kind: "link", ...icon ? { glyph: GlobeIcon } : {}, text: parsed.display, copy: parsed.href ?? url, state, record, peek, ...about !== void 0 ? { about } : {} });
 }
 function ContactValue({ type, value, platform, followers, title, icon, ...common }) {
   switch (type) {