@ai-matrx/design-system 0.86.356 → 0.86.358

package/dist/email-input-dialog.js

@@ -7,7 +7,7 @@ import {
 } from "./chunk-XERGQT2M.js";
 import {
   ErrorActions
-} from "./chunk-LJKF267O.js";
+} from "./chunk-5Z5GTXKL.js";
 import {
   Dialog,
   DialogContent,
@@ -15,12 +15,13 @@ import {
   DialogFooter,
   DialogHeader,
   DialogTitle
-} from "./chunk-UWTODOMD.js";
+} from "./chunk-2BQAHLU3.js";
+import "./chunk-LEPD6TV7.js";
 import "./chunk-U24MOJWK.js";
 import "./chunk-NDTDBBMM.js";
-import "./chunk-LEPD6TV7.js";
 import "./chunk-BKCJUFD3.js";
 import "./chunk-MOZRIHJF.js";
+import "./chunk-HS6GMHKZ.js";
 import "./chunk-WFITMVDB.js";
 import "./chunk-WAT2XW7L.js";
 import {

package/dist/email-input-dialog.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/email-input-dialog.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * EmailInputDialog — moved from matrx-frontend components/dialogs/EmailInputDialog.tsx.\n *\n * Reusable dialog for collecting an email address (public / signed-out features that need one).\n * The send itself is the host's: `onSubmit(email)` resolves on success (the dialog closes) or throws\n * (the message shows under the field).\n */\n\nimport * as React from \"react\";\n\nimport { Button } from \"./button\";\nimport { Input } from \"./controls/doors\";\nimport {\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n} from \"./dialog\";\nimport { ErrorActions } from \"./error-box\";\nimport { Loader2Icon, MailIcon } from \"./icons\";\nimport { Label } from \"./label\";\n\nexport interface EmailInputDialogProps {\n  isOpen: boolean;\n  onClose: () => void;\n  onSubmit: (email: string) => Promise<void>;\n  title?: string;\n  description?: string;\n  submitLabel?: string;\n}\n\nconst isValidEmail = (email: string) => /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email);\n\nexport function EmailInputDialog({\n  isOpen,\n  onClose,\n  onSubmit,\n  title = \"Email to yourself\",\n  description = \"Enter your email address to receive the content.\",\n  submitLabel = \"Send Email\",\n}: EmailInputDialogProps) {\n  const [email, setEmail] = React.useState(\"\");\n  const [loading, setLoading] = React.useState(false);\n  const [error, setError] = React.useState<string | null>(null);\n\n  const handleSubmit = async (e: React.FormEvent) => {\n    e.preventDefault();\n    if (!email.trim()) {\n      setError(\"Email is required\");\n      return;\n    }\n    if (!isValidEmail(email)) {\n      setError(\"Please enter a valid email address\");\n      return;\n    }\n    setLoading(true);\n    setError(null);\n    try {\n      await onSubmit(email);\n      setEmail(\"\");\n      onClose();\n    } catch (err) {\n      setError(err instanceof Error ? err.message : \"Failed to send email\");\n    } finally {\n      setLoading(false);\n    }\n  };\n\n  const handleClose = () => {\n    if (loading) return;\n    setEmail(\"\");\n    setError(null);\n    onClose();\n  };\n\n  return (\n    <Dialog open={isOpen} onOpenChange={handleClose}>\n      <DialogContent size=\"sm\">\n        <form onSubmit={handleSubmit} noValidate className=\"flex flex-col gap-4\">\n          <DialogHeader>\n            <DialogTitle className=\"flex items-center gap-2\">\n              <MailIcon className=\"h-5 w-5 text-primary\" />\n              {title}\n            </DialogTitle>\n            <DialogDescription>{description}</DialogDescription>\n          </DialogHeader>\n\n          <div className=\"space-y-2\">\n            <Label htmlFor=\"email-input-dialog-email\">Email address</Label>\n            <Input\n              id=\"email-input-dialog-email\"\n              type=\"email\"\n              placeholder=\"you@example.com\"\n              value={email}\n              onChange={(e) => {\n                setEmail(e.target.value);\n                setError(null);\n              }}\n              disabled={loading}\n              autoFocus\n            />\n            {error ? (\n              <p className=\"text-sm text-destructive\">\n                {error}\n                <ErrorActions\n                  message={error}\n                  operation=\"Email this content\"\n                  source=\"inline\"\n                  origin=\"design-system/EmailInputDialog\"\n                />\n              </p>\n            ) : email.trim() && !isValidEmail(email.trim()) ? (\n              // An offer, never a block: Send stays enabled; pressing it names the problem.\n              <p className=\"text-sm text-muted-foreground\" data-email-hint>\n                Not a full address yet, like you@example.com\n              </p>\n            ) : null}\n          </div>\n\n          <DialogFooter>\n            <Button type=\"button\" variant=\"outline\" onClick={handleClose} disabled={loading}>\n              Cancel\n            </Button>\n            <Button variant=\"primary\" type=\"submit\" disabled={loading || !email.trim()}>\n              {loading ? (\n                <>\n                  <Loader2Icon className=\"mr-2 h-4 w-4 matrx-spin\" />\n                  Sending...\n                </>\n              ) : (\n                <>\n                  <MailIcon className=\"mr-2 h-4 w-4\" />\n                  {submitLabel}\n                </>\n              )}\n            </Button>\n          </DialogFooter>\n        </form>\n      </DialogContent>\n    </Dialog>\n  );\n}\n\nexport default EmailInputDialog;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,YAAY,WAAW;AA0EX,SA6CI,UA5CF,KADF;AAjDZ,IAAM,eAAe,CAAC,UAAkB,6BAA6B,KAAK,KAAK;AAExE,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,cAAc;AAChB,GAA0B;AACxB,QAAM,CAAC,OAAO,QAAQ,IAAU,eAAS,EAAE;AAC3C,QAAM,CAAC,SAAS,UAAU,IAAU,eAAS,KAAK;AAClD,QAAM,CAAC,OAAO,QAAQ,IAAU,eAAwB,IAAI;AAE5D,QAAM,eAAe,OAAO,MAAuB;AACjD,MAAE,eAAe;AACjB,QAAI,CAAC,MAAM,KAAK,GAAG;AACjB,eAAS,mBAAmB;AAC5B;AAAA,IACF;AACA,QAAI,CAAC,aAAa,KAAK,GAAG;AACxB,eAAS,oCAAoC;AAC7C;AAAA,IACF;AACA,eAAW,IAAI;AACf,aAAS,IAAI;AACb,QAAI;AACF,YAAM,SAAS,KAAK;AACpB,eAAS,EAAE;AACX,cAAQ;AAAA,IACV,SAAS,KAAK;AACZ,eAAS,eAAe,QAAQ,IAAI,UAAU,sBAAsB;AAAA,IACtE,UAAE;AACA,iBAAW,KAAK;AAAA,IAClB;AAAA,EACF;AAEA,QAAM,cAAc,MAAM;AACxB,QAAI,QAAS;AACb,aAAS,EAAE;AACX,aAAS,IAAI;AACb,YAAQ;AAAA,EACV;AAEA,SACE,oBAAC,UAAO,MAAM,QAAQ,cAAc,aAClC,8BAAC,iBAAc,MAAK,MAClB,+BAAC,UAAK,UAAU,cAAc,YAAU,MAAC,WAAU,uBACjD;AAAA,yBAAC,gBACC;AAAA,2BAAC,eAAY,WAAU,2BACrB;AAAA,4BAAC,YAAS,WAAU,wBAAuB;AAAA,QAC1C;AAAA,SACH;AAAA,MACA,oBAAC,qBAAmB,uBAAY;AAAA,OAClC;AAAA,IAEA,qBAAC,SAAI,WAAU,aACb;AAAA,0BAAC,SAAM,SAAQ,4BAA2B,2BAAa;AAAA,MACvD;AAAA,QAAC;AAAA;AAAA,UACC,IAAG;AAAA,UACH,MAAK;AAAA,UACL,aAAY;AAAA,UACZ,OAAO;AAAA,UACP,UAAU,CAAC,MAAM;AACf,qBAAS,EAAE,OAAO,KAAK;AACvB,qBAAS,IAAI;AAAA,UACf;AAAA,UACA,UAAU;AAAA,UACV,WAAS;AAAA;AAAA,MACX;AAAA,MACC,QACC,qBAAC,OAAE,WAAU,4BACV;AAAA;AAAA,QACD;AAAA,UAAC;AAAA;AAAA,YACC,SAAS;AAAA,YACT,WAAU;AAAA,YACV,QAAO;AAAA,YACP,QAAO;AAAA;AAAA,QACT;AAAA,SACF,IACE,MAAM,KAAK,KAAK,CAAC,aAAa,MAAM,KAAK,CAAC;AAAA;AAAA,QAE5C,oBAAC,OAAE,WAAU,iCAAgC,mBAAe,MAAC,0DAE7D;AAAA,UACE;AAAA,OACN;AAAA,IAEA,qBAAC,gBACC;AAAA,0BAAC,UAAO,MAAK,UAAS,SAAQ,WAAU,SAAS,aAAa,UAAU,SAAS,oBAEjF;AAAA,MACA,oBAAC,UAAO,SAAQ,WAAU,MAAK,UAAS,UAAU,WAAW,CAAC,MAAM,KAAK,GACtE,oBACC,iCACE;AAAA,4BAAC,eAAY,WAAU,2BAA0B;AAAA,QAAE;AAAA,SAErD,IAEA,iCACE;AAAA,4BAAC,YAAS,WAAU,gBAAe;AAAA,QAClC;AAAA,SACH,GAEJ;AAAA,OACF;AAAA,KACF,GACF,GACF;AAEJ;AAEA,IAAO,6BAAQ;","names":[]}
+{"version":3,"sources":["../src/email-input-dialog.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * EmailInputDialog — moved from matrx-frontend components/dialogs/EmailInputDialog.tsx.\n *\n * Reusable dialog for collecting an email address (public / signed-out features that need one).\n * The send itself is the host's: `onSubmit(email)` resolves on success (the dialog closes) or throws\n * (the message shows under the field).\n */\n\nimport * as React from \"react\";\n\nimport { Button } from \"./button\";\nimport { Input } from \"./controls/doors\";\nimport {\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogFooter,\n  DialogHeader,\n  DialogTitle,\n} from \"./dialog\";\nimport { ErrorActions } from \"./error-box\";\nimport { Loader2Icon, MailIcon } from \"./icons\";\nimport { Label } from \"./label\";\n\nexport interface EmailInputDialogProps {\n  isOpen: boolean;\n  onClose: () => void;\n  onSubmit: (email: string) => Promise<void>;\n  title?: string;\n  description?: string;\n  submitLabel?: string;\n}\n\nconst isValidEmail = (email: string) => /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email);\n\nexport function EmailInputDialog({\n  isOpen,\n  onClose,\n  onSubmit,\n  title = \"Email to yourself\",\n  description = \"Enter your email address to receive the content.\",\n  submitLabel = \"Send Email\",\n}: EmailInputDialogProps) {\n  const [email, setEmail] = React.useState(\"\");\n  const [loading, setLoading] = React.useState(false);\n  const [error, setError] = React.useState<string | null>(null);\n\n  const handleSubmit = async (e: React.FormEvent) => {\n    e.preventDefault();\n    if (!email.trim()) {\n      setError(\"Email is required\");\n      return;\n    }\n    if (!isValidEmail(email)) {\n      setError(\"Please enter a valid email address\");\n      return;\n    }\n    setLoading(true);\n    setError(null);\n    try {\n      await onSubmit(email);\n      setEmail(\"\");\n      onClose();\n    } catch (err) {\n      setError(err instanceof Error ? err.message : \"Failed to send email\");\n    } finally {\n      setLoading(false);\n    }\n  };\n\n  const handleClose = () => {\n    if (loading) return;\n    setEmail(\"\");\n    setError(null);\n    onClose();\n  };\n\n  return (\n    <Dialog open={isOpen} onOpenChange={handleClose}>\n      <DialogContent size=\"sm\">\n        <form onSubmit={handleSubmit} noValidate className=\"flex flex-col gap-4\">\n          <DialogHeader>\n            <DialogTitle className=\"flex items-center gap-2\">\n              <MailIcon className=\"h-5 w-5 text-primary\" />\n              {title}\n            </DialogTitle>\n            <DialogDescription>{description}</DialogDescription>\n          </DialogHeader>\n\n          <div className=\"space-y-2\">\n            <Label htmlFor=\"email-input-dialog-email\">Email address</Label>\n            <Input\n              id=\"email-input-dialog-email\"\n              type=\"email\"\n              placeholder=\"you@example.com\"\n              value={email}\n              onChange={(e) => {\n                setEmail(e.target.value);\n                setError(null);\n              }}\n              disabled={loading}\n              autoFocus\n            />\n            {error ? (\n              <p className=\"text-sm text-destructive\">\n                {error}\n                <ErrorActions\n                  message={error}\n                  operation=\"Email this content\"\n                  source=\"inline\"\n                  origin=\"design-system/EmailInputDialog\"\n                />\n              </p>\n            ) : email.trim() && !isValidEmail(email.trim()) ? (\n              // An offer, never a block: Send stays enabled; pressing it names the problem.\n              <p className=\"text-sm text-muted-foreground\" data-email-hint>\n                Not a full address yet, like you@example.com\n              </p>\n            ) : null}\n          </div>\n\n          <DialogFooter>\n            <Button type=\"button\" variant=\"outline\" onClick={handleClose} disabled={loading}>\n              Cancel\n            </Button>\n            <Button variant=\"primary\" type=\"submit\" disabled={loading || !email.trim()}>\n              {loading ? (\n                <>\n                  <Loader2Icon className=\"mr-2 h-4 w-4 matrx-spin\" />\n                  Sending...\n                </>\n              ) : (\n                <>\n                  <MailIcon className=\"mr-2 h-4 w-4\" />\n                  {submitLabel}\n                </>\n              )}\n            </Button>\n          </DialogFooter>\n        </form>\n      </DialogContent>\n    </Dialog>\n  );\n}\n\nexport default EmailInputDialog;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,YAAY,WAAW;AA0EX,SA6CI,UA5CF,KADF;AAjDZ,IAAM,eAAe,CAAC,UAAkB,6BAA6B,KAAK,KAAK;AAExE,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,cAAc;AAChB,GAA0B;AACxB,QAAM,CAAC,OAAO,QAAQ,IAAU,eAAS,EAAE;AAC3C,QAAM,CAAC,SAAS,UAAU,IAAU,eAAS,KAAK;AAClD,QAAM,CAAC,OAAO,QAAQ,IAAU,eAAwB,IAAI;AAE5D,QAAM,eAAe,OAAO,MAAuB;AACjD,MAAE,eAAe;AACjB,QAAI,CAAC,MAAM,KAAK,GAAG;AACjB,eAAS,mBAAmB;AAC5B;AAAA,IACF;AACA,QAAI,CAAC,aAAa,KAAK,GAAG;AACxB,eAAS,oCAAoC;AAC7C;AAAA,IACF;AACA,eAAW,IAAI;AACf,aAAS,IAAI;AACb,QAAI;AACF,YAAM,SAAS,KAAK;AACpB,eAAS,EAAE;AACX,cAAQ;AAAA,IACV,SAAS,KAAK;AACZ,eAAS,eAAe,QAAQ,IAAI,UAAU,sBAAsB;AAAA,IACtE,UAAE;AACA,iBAAW,KAAK;AAAA,IAClB;AAAA,EACF;AAEA,QAAM,cAAc,MAAM;AACxB,QAAI,QAAS;AACb,aAAS,EAAE;AACX,aAAS,IAAI;AACb,YAAQ;AAAA,EACV;AAEA,SACE,oBAAC,UAAO,MAAM,QAAQ,cAAc,aAClC,8BAAC,iBAAc,MAAK,MAClB,+BAAC,UAAK,UAAU,cAAc,YAAU,MAAC,WAAU,uBACjD;AAAA,yBAAC,gBACC;AAAA,2BAAC,eAAY,WAAU,2BACrB;AAAA,4BAAC,YAAS,WAAU,wBAAuB;AAAA,QAC1C;AAAA,SACH;AAAA,MACA,oBAAC,qBAAmB,uBAAY;AAAA,OAClC;AAAA,IAEA,qBAAC,SAAI,WAAU,aACb;AAAA,0BAAC,SAAM,SAAQ,4BAA2B,2BAAa;AAAA,MACvD;AAAA,QAAC;AAAA;AAAA,UACC,IAAG;AAAA,UACH,MAAK;AAAA,UACL,aAAY;AAAA,UACZ,OAAO;AAAA,UACP,UAAU,CAAC,MAAM;AACf,qBAAS,EAAE,OAAO,KAAK;AACvB,qBAAS,IAAI;AAAA,UACf;AAAA,UACA,UAAU;AAAA,UACV,WAAS;AAAA;AAAA,MACX;AAAA,MACC,QACC,qBAAC,OAAE,WAAU,4BACV;AAAA;AAAA,QACD;AAAA,UAAC;AAAA;AAAA,YACC,SAAS;AAAA,YACT,WAAU;AAAA,YACV,QAAO;AAAA,YACP,QAAO;AAAA;AAAA,QACT;AAAA,SACF,IACE,MAAM,KAAK,KAAK,CAAC,aAAa,MAAM,KAAK,CAAC;AAAA;AAAA,QAE5C,oBAAC,OAAE,WAAU,iCAAgC,mBAAe,MAAC,0DAE7D;AAAA,UACE;AAAA,OACN;AAAA,IAEA,qBAAC,gBACC;AAAA,0BAAC,UAAO,MAAK,UAAS,SAAQ,WAAU,SAAS,aAAa,UAAU,SAAS,oBAEjF;AAAA,MACA,oBAAC,UAAO,SAAQ,WAAU,MAAK,UAAS,UAAU,WAAW,CAAC,MAAM,KAAK,GACtE,oBACC,iCACE;AAAA,4BAAC,eAAY,WAAU,2BAA0B;AAAA,QAAE;AAAA,SAErD,IAEA,iCACE;AAAA,4BAAC,YAAS,WAAU,gBAAe;AAAA,QAClC;AAAA,SACH,GAEJ;AAAA,OACF;AAAA,KACF,GACF,GACF;AAEJ;AAEA,IAAO,6BAAQ;","names":[]}

package/dist/error-sentence.cjs

@@ -0,0 +1,130 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/error-sentence.ts
+var error_sentence_exports = {};
+__export(error_sentence_exports, {
+  CARD_ERROR_LINE: () => CARD_ERROR_LINE,
+  FALLBACK_ERROR_SENTENCE: () => FALLBACK_ERROR_SENTENCE,
+  TIMED_OUT_SENTENCE: () => TIMED_OUT_SENTENCE,
+  errorSentenceOf: () => errorSentenceOf,
+  isOfflineError: () => isOfflineError,
+  isRawErrorText: () => isRawErrorText,
+  isTimedOutError: () => isTimedOutError,
+  peopleErrorSentence: () => peopleErrorSentence
+});
+module.exports = __toCommonJS(error_sentence_exports);
+
+// 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.";
+var CARD_ERROR_LINE = {
+  OFFLINE: "No connection",
+  TIMEOUT: "Took too long. Nothing was lost.",
+  UNAUTHORIZED: "Signed out. Sign in again.",
+  FORBIDDEN: "Not allowed for this account",
+  NOT_FOUND: "Not found. Refresh and retry.",
+  RATE_LIMIT: "Too many requests. Wait a moment.",
+  SERVER: "Server problem. Try again soon.",
+  FALLBACK: "Something went wrong"
+};
+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));
+}
+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 isRawErrorText(text) {
+  return MACHINE_PREFIX.test(text) || RAW_TEXT.test(text);
+}
+function peopleErrorSentence(error, message, options = {}) {
+  const card = options.card === true;
+  if (isTimedOutError(error, message, options.code)) return card ? CARD_ERROR_LINE.TIMEOUT : TIMED_OUT_SENTENCE;
+  const fallback = options.fallback ?? (card ? CARD_ERROR_LINE.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);
+    if (!said.code || !ANY_HOST_CODES.has(said.code)) return fallback;
+    return card ? CARD_ERROR_LINE[said.code] : said.cause;
+  }
+  return text;
+}
+//# sourceMappingURL=error-sentence.cjs.map

package/dist/error-sentence.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/error-sentence.ts","../src/desktop/errors.ts"],"sourcesContent":["/**\n * THE SENTENCE A PERSON READS FOR AN ERROR — the one funnel every error surface draws through\n * (ErrorNotice, ErrorBox, the desktop Banner). Raw error text never reaches the screen: no\n * \"TypeError: Failed to fetch\", no `sidebar_conversations:` RPC prefix, no stack frame or file\n * path (Arman, 2026-10-24: notices are small and plain). The raw error still travels to the\n * Alchemy Menu / AI payload through the `error` prop; only the screen gets the sentence.\n *\n * The wording table is desktop/errors.ts `describeError` (one table for every screen); this file\n * adds what decides WHEN a sentence must go through it, narrow enough that an app's own sentence\n * (\"PDF too large\") passes untouched.\n */\nimport { describeError } from \"./desktop/errors\";\n\n/**\n * The sentence an error carries: its own message (string, Error, or any\n * object with a `message`). Empty when it has none.\n */\nexport function errorSentenceOf(error: unknown): string {\n  if (error == null || error === true || error === false) return \"\";\n  if (typeof error === \"string\") return error;\n  if (typeof error !== \"object\") return String(error);\n  const message = (error as { message?: unknown }).message;\n  return typeof message === \"string\" ? message : \"\";\n}\n\n/**\n * What a person reads when the store cancelled a call at its statement timeout\n * (SQLSTATE 57014). Postgres' own \"canceling statement due to statement\n * timeout\" is about the database, not the person; the cancelled call rolled\n * back, so nothing was written (lane AT-SLOW, 2026-10-19). The same sentence\n * @ai-matrx/records' `TIMED_OUT_MESSAGE` gives.\n */\nexport const TIMED_OUT_SENTENCE = \"That took too long. Nothing was lost; try again.\";\n\n/** What a person reads when an error says nothing a person can use. */\nexport const FALLBACK_ERROR_SENTENCE = \"Something went wrong. Try again.\";\n\n/**\n * A notice CARD's words (the web toast, Matrx 2's floating card): a card is ~22 rem at most and its\n * action shares the row, so a line is a few words (notice-stack.ts NOTICE_TEXT_BUDGET). The same\n * causes as the sentences above, said short enough to fit at the smallest window, never cut by \"…\".\n */\nexport const CARD_ERROR_LINE = {\n  OFFLINE: \"No connection\",\n  TIMEOUT: \"Took too long. Nothing was lost.\",\n  UNAUTHORIZED: \"Signed out. Sign in again.\",\n  FORBIDDEN: \"Not allowed for this account\",\n  NOT_FOUND: \"Not found. Refresh and retry.\",\n  RATE_LIMIT: \"Too many requests. Wait a moment.\",\n  SERVER: \"Server problem. Try again soon.\",\n  FALLBACK: \"Something went wrong\",\n} as const;\n\n/** True when an error, its code, or its sentence is the store's statement timeout. */\nexport function isTimedOutError(error: unknown, message?: string | null, code?: string | number): boolean {\n  if (code === \"57014\" || code === \"timed_out\") return true;\n  if (error && typeof error === \"object\") {\n    const o = error as { code?: unknown; sqlstate?: unknown };\n    if (o.code === \"57014\" || o.code === \"timed_out\" || o.sqlstate === \"57014\") return true;\n  }\n  const text = `${message ?? \"\"} ${errorSentenceOf(error)}`;\n  return /canceling statement due to statement timeout/i.test(text);\n}\n\n/** True when the call failed because the device is offline or the network never answered. */\nexport function isOfflineError(error: unknown, message?: string | null): boolean {\n  if (typeof navigator !== \"undefined\" && navigator.onLine === false) return true;\n  return offlineText(`${message ?? \"\"} ${errorSentenceOf(error)}`);\n}\n\nfunction offlineText(text: string): boolean {\n  const t = text.trim();\n  return t !== \"\" && (describeError(t).code === \"OFFLINE\" || /networkerror|network request failed|load failed/i.test(t));\n}\n\n/** describeError's causes that hold on every host (its process codes — ENOENT, EACCES, ports — are\n *  the desktop's words for a local program and would mislead on a database refusal). */\nconst ANY_HOST_CODES = new Set([\"OFFLINE\", \"TIMEOUT\", \"UNAUTHORIZED\", \"FORBIDDEN\", \"NOT_FOUND\", \"RATE_LIMIT\", \"SERVER\"]);\n\n/** A leading machine label: `sidebar_conversations: …`, `chat.rpc_name: …`, `[chat-sidebar] …`. */\nconst MACHINE_PREFIX = /^\\s*(?:\\[[\\w./-]+\\]\\s*|[a-z][\\w]*(?:[._][\\w]+)+:\\s+)/;\n/** Text no person should read: JS error class names, stack frames, source paths. */\nconst RAW_TEXT =\n  /\\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;\n\n/** True when a sentence carries raw error text or a code path (what the guard refuses on screen). */\nexport function isRawErrorText(text: string): boolean {\n  return MACHINE_PREFIX.test(text) || RAW_TEXT.test(text);\n}\n\n/**\n * `card: true` = the short CARD_ERROR_LINE words for a notice card. Otherwise:\n * the sentence for the screen: the timeout sentence for a statement timeout; a caller's plain\n * sentence as is; a machine label stripped from the front; anything raw or offline worded by\n * `describeError` (its table, else `fallback`).\n */\nexport function peopleErrorSentence(\n  error: unknown,\n  message?: string | null,\n  options: { code?: string | number | undefined; fallback?: string | undefined; card?: boolean | undefined } = {},\n): string {\n  const card = options.card === true;\n  if (isTimedOutError(error, message, options.code)) return card ? CARD_ERROR_LINE.TIMEOUT : TIMED_OUT_SENTENCE;\n  const fallback = options.fallback ?? (card ? CARD_ERROR_LINE.FALLBACK : FALLBACK_ERROR_SENTENCE);\n  const raw = message?.trim() || errorSentenceOf(error).trim();\n  if (!raw) return fallback;\n  let text = raw;\n  for (let i = 0; i < 3 && MACHINE_PREFIX.test(text); i++) text = text.replace(MACHINE_PREFIX, \"\").trim();\n  if (!text) return fallback;\n  if (offlineText(text) || RAW_TEXT.test(text) || text !== raw) {\n    const said = describeError(text, fallback);\n    if (!said.code || !ANY_HOST_CODES.has(said.code)) return fallback;\n    return card ? CARD_ERROR_LINE[said.code as keyof typeof CARD_ERROR_LINE] : said.cause;\n  }\n  return text;\n}\n","/**\n * THE error-wording layer. A failure is shown as a cause the person can act on (\"A program it\n * needs isn't installed\"), never as the raw text a process threw (\"spawn uv ENOENT\"). The raw text\n * is kept, whole, as `detail` — the banner offers it behind Copy details and a tooltip, for a bug\n * report or an agent. One table, so every screen and every service says the same thing.\n */\n\nexport interface DescribedError {\n  /** One plain sentence: what went wrong and, where it helps, what to do. */\n  cause: string;\n  /** The raw text, unedited (empty when it would only repeat `cause`). */\n  detail: string;\n  /** A short machine code when one was recognized (\"ENOENT\", \"TIMEOUT\"). */\n  code?: string;\n}\n\ninterface Rule {\n  code: string;\n  test: RegExp;\n  cause: string;\n}\n\n/** Ordered: the first rule whose pattern matches the raw text wins. */\nconst RULES: ReadonlyArray<Rule> = [\n  { 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.\" },\n  { 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 › Privacy & Security, then try again.\" },\n  { 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.\" },\n  { code: \"ECONNREFUSED\", test: /\\bECONNREFUSED\\b|connection refused/i, cause: \"The service isn't answering. It may have stopped; start it again.\" },\n  { 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.\" },\n  { code: \"TIMEOUT\", test: /\\bETIMEDOUT\\b|timed? ?out|\\bTIMEOUT\\b|deadline exceeded/i, cause: \"It took too long to answer. Try again in a moment.\" },\n  { code: \"ENOSPC\", test: /\\bENOSPC\\b|no space left/i, cause: \"The disk is full. Free some space, then try again.\" },\n  { code: \"ENOMEM\", test: /\\bENOMEM\\b|out of memory|cannot allocate memory/i, cause: \"The computer ran out of memory. Close something and try again.\" },\n  { 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.\" },\n  { code: \"FORBIDDEN\", test: /\\b403\\b|forbidden/i, cause: \"This account isn't allowed to do that.\" },\n  { code: \"NOT_FOUND\", test: /\\b404\\b|not found/i, cause: \"It isn't there any more. Refresh and try again.\" },\n  { code: \"RATE_LIMIT\", test: /\\b429\\b|rate.?limit|too many requests/i, cause: \"Too many requests just now. Wait a moment and try again.\" },\n  { 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.\" },\n  { 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.\" },\n];\n\nconst RAW = /\\b[A-Z]{2,}[A-Z_]*\\b|[\\\\/][\\w.-]+[\\\\/]|\\bat \\S+ \\(|\\{|\\}|errno|stack|undefined|null|\\bspawn\\b/;\n\nfunction rawText(error: unknown): string {\n  if (error instanceof Error) return error.message || error.name;\n  if (typeof error === \"string\") return error;\n  if (error && typeof error === \"object\" && \"message\" in error && typeof (error as { message: unknown }).message === \"string\") {\n    return (error as { message: string }).message;\n  }\n  return \"\";\n}\n\n/**\n * Turn any thrown or returned error into words a person can act on. Already-humane text (a full\n * sentence the app wrote itself, with no codes, paths or stack) passes through unchanged.\n */\nexport function describeError(error: unknown, fallback = \"Something went wrong. Try again.\"): DescribedError {\n  const detail = rawText(error).trim();\n  if (!detail) return { cause: fallback, detail: \"\" };\n  for (const rule of RULES) {\n    if (rule.test.test(detail)) return { cause: rule.cause, detail, code: rule.code };\n  }\n  if (!RAW.test(detail) && detail.length <= 160) return { cause: detail, detail: \"\" };\n  return { cause: fallback, detail };\n}\n"],"mappings":"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","names":[]}

package/dist/error-sentence.d.cts

@@ -0,0 +1,49 @@
+/**
+ * The sentence an error carries: its own message (string, Error, or any
+ * object with a `message`). Empty when it has none.
+ */
+declare function errorSentenceOf(error: unknown): string;
+/**
+ * What a person reads when the store cancelled a call at its statement timeout
+ * (SQLSTATE 57014). Postgres' own "canceling statement due to statement
+ * timeout" is about the database, not the person; the cancelled call rolled
+ * back, so nothing was written (lane AT-SLOW, 2026-10-19). The same sentence
+ * @ai-matrx/records' `TIMED_OUT_MESSAGE` gives.
+ */
+declare const TIMED_OUT_SENTENCE = "That took too long. Nothing was lost; try again.";
+/** What a person reads when an error says nothing a person can use. */
+declare const FALLBACK_ERROR_SENTENCE = "Something went wrong. Try again.";
+/**
+ * A notice CARD's words (the web toast, Matrx 2's floating card): a card is ~22 rem at most and its
+ * action shares the row, so a line is a few words (notice-stack.ts NOTICE_TEXT_BUDGET). The same
+ * causes as the sentences above, said short enough to fit at the smallest window, never cut by "…".
+ */
+declare const CARD_ERROR_LINE: {
+    readonly OFFLINE: "No connection";
+    readonly TIMEOUT: "Took too long. Nothing was lost.";
+    readonly UNAUTHORIZED: "Signed out. Sign in again.";
+    readonly FORBIDDEN: "Not allowed for this account";
+    readonly NOT_FOUND: "Not found. Refresh and retry.";
+    readonly RATE_LIMIT: "Too many requests. Wait a moment.";
+    readonly SERVER: "Server problem. Try again soon.";
+    readonly FALLBACK: "Something went wrong";
+};
+/** True when an error, its code, or its sentence is the store's statement timeout. */
+declare function isTimedOutError(error: unknown, message?: string | null, code?: string | number): boolean;
+/** True when the call failed because the device is offline or the network never answered. */
+declare function isOfflineError(error: unknown, message?: string | null): boolean;
+/** True when a sentence carries raw error text or a code path (what the guard refuses on screen). */
+declare function isRawErrorText(text: string): boolean;
+/**
+ * `card: true` = the short CARD_ERROR_LINE words for a notice card. Otherwise:
+ * the sentence for the screen: the timeout sentence for a statement timeout; a caller's plain
+ * sentence as is; a machine label stripped from the front; anything raw or offline worded by
+ * `describeError` (its table, else `fallback`).
+ */
+declare function peopleErrorSentence(error: unknown, message?: string | null, options?: {
+    code?: string | number | undefined;
+    fallback?: string | undefined;
+    card?: boolean | undefined;
+}): string;
+
+export { CARD_ERROR_LINE, FALLBACK_ERROR_SENTENCE, TIMED_OUT_SENTENCE, errorSentenceOf, isOfflineError, isRawErrorText, isTimedOutError, peopleErrorSentence };

package/dist/error-sentence.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The sentence an error carries: its own message (string, Error, or any
+ * object with a `message`). Empty when it has none.
+ */
+declare function errorSentenceOf(error: unknown): string;
+/**
+ * What a person reads when the store cancelled a call at its statement timeout
+ * (SQLSTATE 57014). Postgres' own "canceling statement due to statement
+ * timeout" is about the database, not the person; the cancelled call rolled
+ * back, so nothing was written (lane AT-SLOW, 2026-10-19). The same sentence
+ * @ai-matrx/records' `TIMED_OUT_MESSAGE` gives.
+ */
+declare const TIMED_OUT_SENTENCE = "That took too long. Nothing was lost; try again.";
+/** What a person reads when an error says nothing a person can use. */
+declare const FALLBACK_ERROR_SENTENCE = "Something went wrong. Try again.";
+/**
+ * A notice CARD's words (the web toast, Matrx 2's floating card): a card is ~22 rem at most and its
+ * action shares the row, so a line is a few words (notice-stack.ts NOTICE_TEXT_BUDGET). The same
+ * causes as the sentences above, said short enough to fit at the smallest window, never cut by "…".
+ */
+declare const CARD_ERROR_LINE: {
+    readonly OFFLINE: "No connection";
+    readonly TIMEOUT: "Took too long. Nothing was lost.";
+    readonly UNAUTHORIZED: "Signed out. Sign in again.";
+    readonly FORBIDDEN: "Not allowed for this account";
+    readonly NOT_FOUND: "Not found. Refresh and retry.";
+    readonly RATE_LIMIT: "Too many requests. Wait a moment.";
+    readonly SERVER: "Server problem. Try again soon.";
+    readonly FALLBACK: "Something went wrong";
+};
+/** True when an error, its code, or its sentence is the store's statement timeout. */
+declare function isTimedOutError(error: unknown, message?: string | null, code?: string | number): boolean;
+/** True when the call failed because the device is offline or the network never answered. */
+declare function isOfflineError(error: unknown, message?: string | null): boolean;
+/** True when a sentence carries raw error text or a code path (what the guard refuses on screen). */
+declare function isRawErrorText(text: string): boolean;
+/**
+ * `card: true` = the short CARD_ERROR_LINE words for a notice card. Otherwise:
+ * the sentence for the screen: the timeout sentence for a statement timeout; a caller's plain
+ * sentence as is; a machine label stripped from the front; anything raw or offline worded by
+ * `describeError` (its table, else `fallback`).
+ */
+declare function peopleErrorSentence(error: unknown, message?: string | null, options?: {
+    code?: string | number | undefined;
+    fallback?: string | undefined;
+    card?: boolean | undefined;
+}): string;
+
+export { CARD_ERROR_LINE, FALLBACK_ERROR_SENTENCE, TIMED_OUT_SENTENCE, errorSentenceOf, isOfflineError, isRawErrorText, isTimedOutError, peopleErrorSentence };

package/dist/error-sentence.js

@@ -0,0 +1,22 @@
+"use client";
+import {
+  CARD_ERROR_LINE,
+  FALLBACK_ERROR_SENTENCE,
+  TIMED_OUT_SENTENCE,
+  errorSentenceOf,
+  isOfflineError,
+  isRawErrorText,
+  isTimedOutError,
+  peopleErrorSentence
+} from "./chunk-HS6GMHKZ.js";
+export {
+  CARD_ERROR_LINE,
+  FALLBACK_ERROR_SENTENCE,
+  TIMED_OUT_SENTENCE,
+  errorSentenceOf,
+  isOfflineError,
+  isRawErrorText,
+  isTimedOutError,
+  peopleErrorSentence
+};
+//# sourceMappingURL=error-sentence.js.map

package/dist/error-sentence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.cjs

@@ -1377,8 +1377,9 @@ 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 card = options.card === true;
+  if (isTimedOutError(error, message, options.code)) return card ? CARD_ERROR_LINE.TIMEOUT : TIMED_OUT_SENTENCE;
+  const fallback = options.fallback ?? (card ? CARD_ERROR_LINE.FALLBACK : FALLBACK_ERROR_SENTENCE);
   const raw = message?.trim() || errorSentenceOf(error).trim();
   if (!raw) return fallback;
   let text = raw;
@@ -1386,17 +1387,28 @@ function peopleErrorSentence(error, message, options = {}) {
   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;
+    if (!said.code || !ANY_HOST_CODES.has(said.code)) return fallback;
+    return card ? CARD_ERROR_LINE[said.code] : said.cause;
   }
   return text;
 }
-var TIMED_OUT_SENTENCE, FALLBACK_ERROR_SENTENCE, ANY_HOST_CODES, MACHINE_PREFIX, RAW_TEXT;
+var TIMED_OUT_SENTENCE, FALLBACK_ERROR_SENTENCE, CARD_ERROR_LINE, 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.";
+    CARD_ERROR_LINE = {
+      OFFLINE: "No connection",
+      TIMEOUT: "Took too long. Nothing was lost.",
+      UNAUTHORIZED: "Signed out. Sign in again.",
+      FORBIDDEN: "Not allowed for this account",
+      NOT_FOUND: "Not found. Refresh and retry.",
+      RATE_LIMIT: "Too many requests. Wait a moment.",
+      SERVER: "Server problem. Try again soon.",
+      FALLBACK: "Something went wrong"
+    };
     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;
@@ -2732,18 +2744,20 @@ var init_dialog = __esm({
 });
 
 // src/dropdown-menu.tsx
-function readTopClearance() {
-  return readClearance("var(--matrx-floating-top-clearance, var(--shell-header-h, 0px))");
-}
-function readBottomClearance() {
-  return readClearance("var(--matrx-floating-clearance, 0px)");
-}
 function menuCollisionPadding(caller, top, bottom, fallback = 0) {
   const side = (key) => typeof caller === "number" ? caller : caller?.[key] ?? fallback;
   return { top: Math.max(side("top"), top), right: side("right"), bottom: Math.max(side("bottom"), bottom), left: side("left") };
 }
-function readClearance(height) {
+function readClearance(height, shared = false) {
   if (typeof document === "undefined") return 0;
+  const now = clock();
+  const held = shared ? clearanceCache.get(height) : void 0;
+  if (held && now - held.at < CLEARANCE_REUSE_MS) return held.px;
+  const px3 = measureClearance(height);
+  clearanceCache.set(height, { px: px3, at: now });
+  return px3;
+}
+function measureClearance(height) {
   const probe2 = document.createElement("div");
   probe2.style.cssText = `position:fixed;top:0;left:0;width:0;visibility:hidden;pointer-events:none;height:${height}`;
   document.body.appendChild(probe2);
@@ -2751,7 +2765,7 @@ function readClearance(height) {
   probe2.remove();
   return Number.isFinite(px3) ? Math.ceil(px3) : 0;
 }
-var DropdownMenuPrimitive, React27, import_jsx_runtime36, DropdownMenu, DropdownMenuTrigger, DropdownMenuGroup, DropdownMenuPortal, DropdownMenuSub, DropdownMenuRadioGroup, MENU_SURFACE_CLASS, MENU_ITEM_CLASS, MENU_INDICATOR_ITEM_CLASS, DropdownMenuSubTrigger, DropdownMenuSubContent, DropdownMenuContent, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut;
+var DropdownMenuPrimitive, React27, import_jsx_runtime36, DropdownMenu, DropdownMenuTrigger, DropdownMenuGroup, DropdownMenuPortal, DropdownMenuSub, DropdownMenuRadioGroup, MENU_SURFACE_CLASS, MENU_ITEM_CLASS, MENU_INDICATOR_ITEM_CLASS, DropdownMenuSubTrigger, DropdownMenuSubContent, CLEARANCE_REUSE_MS, clearanceCache, clock, TOP_CLEARANCE, BOTTOM_CLEARANCE, sharedTopClearance, sharedBottomClearance, DropdownMenuContent, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut;
 var init_dropdown_menu = __esm({
   "src/dropdown-menu.tsx"() {
     "use strict";
@@ -2797,7 +2811,7 @@ var init_dropdown_menu = __esm({
     DropdownMenuSubTrigger.displayName = DropdownMenuPrimitive.SubTrigger.displayName;
     DropdownMenuSubContent = React27.forwardRef(({ className, container, surface = "default", sideOffset = 2, alignOffset = -4, collisionPadding, onFocusOutside, children, ...props }, ref) => {
       const portalContainer = usePortalContainer(container);
-      const [bottomClearance] = React27.useState(readBottomClearance);
+      const [bottomClearance] = React27.useState(sharedBottomClearance);
       const padding = menuCollisionPadding(collisionPadding ?? 8, 0, bottomClearance);
       const nested = useNestedSubmenuPlacement(ref, padding);
       const keep = useSubmenuSurvivesParentPanelFocus(nested.ref, onFocusOutside);
@@ -2819,10 +2833,17 @@ var init_dropdown_menu = __esm({
       ) });
     });
     DropdownMenuSubContent.displayName = DropdownMenuPrimitive.SubContent.displayName;
+    CLEARANCE_REUSE_MS = 500;
+    clearanceCache = /* @__PURE__ */ new Map();
+    clock = () => typeof performance !== "undefined" ? performance.now() : Date.now();
+    TOP_CLEARANCE = "var(--matrx-floating-top-clearance, var(--shell-header-h, 0px))";
+    BOTTOM_CLEARANCE = "var(--matrx-floating-clearance, 0px)";
+    sharedTopClearance = () => readClearance(TOP_CLEARANCE, true);
+    sharedBottomClearance = () => readClearance(BOTTOM_CLEARANCE, true);
     DropdownMenuContent = React27.forwardRef(({ className, sideOffset = 4, container, surface = "default", children, onCloseAutoFocus, collisionPadding, ...props }, ref) => {
       const portalContainer = usePortalContainer(container);
-      const [topClearance] = React27.useState(readTopClearance);
-      const [bottomClearance] = React27.useState(readBottomClearance);
+      const [topClearance] = React27.useState(sharedTopClearance);
+      const [bottomClearance] = React27.useState(sharedBottomClearance);
       const edges = useMenuScrollEdges(ref);
       return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(DropdownMenuPrimitive.Portal, { container: portalContainer, children: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(
         DropdownMenuPrimitive.Content,
@@ -10303,13 +10324,14 @@ function useTableNotice() {
   const [message, setMessage] = (0, import_react10.useState)(null);
   const notify = (0, import_react10.useMemo)(
     () => ({
-      success(text) {
-        if (host.notify) host.notify.success(text);
-        else setMessage({ text, error: false });
+      // A card is a short title and an optional line (NOTICE_TEXT_BUDGET); the inline fallback joins them.
+      success(text, options) {
+        if (host.notify) host.notify.success(text, options);
+        else setMessage({ text: options?.description ? `${text}. ${options.description}` : text, error: false });
       },
-      error(text) {
-        if (host.notify) host.notify.error(text);
-        else setMessage({ text, error: true });
+      error(text, options) {
+        if (host.notify) host.notify.error(text, options);
+        else setMessage({ text: options?.description ? `${text}. ${options.description}` : text, error: true });
       }
     }),
     [host]
@@ -10344,6 +10366,7 @@ function displayId(id, show = "auto") {
 }
 
 // src/record-id.tsx
+init_error_sentence();
 var import_jsx_runtime71 = require("react/jsx-runtime");
 function RecordId({
   value,
@@ -10404,7 +10427,7 @@ function RecordId({
     e.preventDefault();
     void (0, import_clipboard.copyText)(value).then((ok) => {
       if (!ok) {
-        notify?.error(`Couldn't copy ${copyLabel}`);
+        notify?.error("Not copied", { description: copyLabel });
         return;
       }
       setCopied(true);
@@ -10420,12 +10443,10 @@ function RecordId({
     try {
       const result = await onOpen(value);
       if (result === "forbidden") {
-        notify?.error("You don't have access to open this record");
+        notify?.error("No access", { description: "This account can't open this record" });
       }
     } catch (err) {
-      notify?.error(
-        `Couldn't open: ${err instanceof Error ? err.message : String(err)}`
-      );
+      notify?.error("Not opened", { description: peopleErrorSentence(err, null, { card: true }) });
     } finally {
       setOpening(false);
     }