@ai-matrx/kit 0.5.0

package/dist/text-case.js

@@ -0,0 +1,292 @@
+// src/text-case.ts
+var DEFAULT_WORD_REPLACEMENTS = {
+  // Acronyms & initialisms
+  "api": "API",
+  "apis": "APIs",
+  "ui": "UI",
+  "ux": "UX",
+  "id": "ID",
+  "ids": "IDs",
+  "qr": "QR",
+  "ssr": "SSR",
+  "csr": "CSR",
+  "ssg": "SSG",
+  "isr": "ISR",
+  "spa": "SPA",
+  "pwa": "PWA",
+  "sdk": "SDK",
+  "sdks": "SDKs",
+  "cli": "CLI",
+  "tty": "TTY",
+  "repl": "REPL",
+  "ci": "CI",
+  "cd": "CD",
+  "cpu": "CPU",
+  "cpus": "CPUs",
+  "gpu": "GPU",
+  "gpus": "GPUs",
+  "ram": "RAM",
+  "rom": "ROM",
+  "ssd": "SSD",
+  "ssds": "SSDs",
+  "hdd": "HDD",
+  "hdds": "HDDs",
+  "kpi": "KPI",
+  "kpis": "KPIs",
+  "sla": "SLA",
+  "slas": "SLAs",
+  "slo": "SLO",
+  "slos": "SLOs",
+  "sli": "SLI",
+  "slis": "SLIs",
+  "dom": "DOM",
+  // Web, formats, protocols
+  "url": "URL",
+  "urls": "URLs",
+  "uri": "URI",
+  "uris": "URIs",
+  "http": "HTTP",
+  "https": "HTTPS",
+  "html": "HTML",
+  "css": "CSS",
+  "json": "JSON",
+  "yaml": "YAML",
+  "yml": "YML",
+  "toml": "TOML",
+  "csv": "CSV",
+  "pdf": "PDF",
+  "tsv": "TSV",
+  "jpg": "JPG",
+  "jpeg": "JPEG",
+  "png": "PNG",
+  "gif": "GIF",
+  "webp": "WebP",
+  "heic": "HEIC",
+  "heif": "HEIF",
+  "bmp": "BMP",
+  "tiff": "TIFF",
+  "ico": "ICO",
+  "xml": "XML",
+  "sql": "SQL",
+  "db": "DB",
+  "dbs": "DBs",
+  "nosql": "NoSQL",
+  "graphql": "GraphQL",
+  "grpc": "gRPC",
+  "rest": "REST",
+  "restful": "RESTful",
+  "websocket": "WebSocket",
+  "websockets": "WebSockets",
+  "webrtc": "WebRTC",
+  // Networking
+  "ip": "IP",
+  "ipv4": "IPv4",
+  "ipv6": "IPv6",
+  "dns": "DNS",
+  "dhcp": "DHCP",
+  "nat": "NAT",
+  "tcp": "TCP",
+  "udp": "UDP",
+  "icmp": "ICMP",
+  "ttl": "TTL",
+  "lan": "LAN",
+  "wan": "WAN",
+  "vlan": "VLAN",
+  "cdn": "CDN",
+  "ftp": "FTP",
+  "ssh": "SSH",
+  "tls": "TLS",
+  "ssl": "SSL",
+  // Security & crypto
+  "jwt": "JWT",
+  "jws": "JWS",
+  "jwe": "JWE",
+  "hmac": "HMAC",
+  "rsa": "RSA",
+  "ecdsa": "ECDSA",
+  "aes": "AES",
+  "pbkdf2": "PBKDF2",
+  "argon2": "Argon2",
+  "scrypt": "scrypt",
+  "totp": "TOTP",
+  "hotp": "HOTP",
+  "mfa": "MFA",
+  "2fa": "2FA",
+  "csrf": "CSRF",
+  "xss": "XSS",
+  "ssrf": "SSRF",
+  "rce": "RCE",
+  "dos": "DoS",
+  "ddos": "DDoS",
+  "mitm": "MITM",
+  "csp": "CSP",
+  "cors": "CORS",
+  "pii": "PII",
+  "phi": "PHI",
+  "gdpr": "GDPR",
+  "ccpa": "CCPA",
+  "hipaa": "HIPAA",
+  "rfc": "RFC",
+  // Platforms, langs, tools (single-token)
+  "javascript": "JavaScript",
+  "typescript": "TypeScript",
+  "jsx": "JSX",
+  "tsx": "TSX",
+  "node": "Node",
+  // (used when tokenized alone)
+  "deno": "Deno",
+  "bun": "Bun",
+  "react": "React",
+  "nextjs": "Next.js",
+  // if your tokenizer drops dots, keep this
+  "nodejs": "Node.js",
+  "postgresql": "PostgreSQL",
+  "postgres": "Postgres",
+  "mysql": "MySQL",
+  "sqlite": "SQLite",
+  "redis": "Redis",
+  "supabase": "Supabase",
+  "docker": "Docker",
+  "kubernetes": "Kubernetes",
+  "k8s": "Kubernetes",
+  "helm": "Helm",
+  "npm": "npm",
+  "pnpm": "pnpm",
+  "yarn": "Yarn",
+  "eslint": "ESLint",
+  "prettier": "Prettier",
+  "vite": "Vite",
+  "webpack": "Webpack",
+  "babel": "Babel",
+  // OS & vendors
+  "macos": "macOS",
+  "ios": "iOS",
+  "ipados": "iPadOS",
+  "watchos": "watchOS",
+  "tvos": "tvOS",
+  "windows": "Windows",
+  "linux": "Linux",
+  "ubuntu": "Ubuntu",
+  "github": "GitHub",
+  "gitlab": "GitLab",
+  "bitbucket": "Bitbucket",
+  // Data & analytics
+  "etl": "ETL",
+  "elt": "ELT",
+  "olap": "OLAP",
+  "oltp": "OLTP",
+  "bi": "BI",
+  // Time & locales
+  "utc": "UTC",
+  "gmt": "GMT",
+  "pst": "PST",
+  "pdt": "PDT",
+  "pt": "PT",
+  // Common “small words” to keep lowercase (unless first/last word)
+  "or": "or",
+  "and": "and",
+  "the": "the",
+  "of": "of",
+  "in": "in",
+  "to": "to",
+  "with": "with",
+  "as": "as",
+  "by": "by",
+  "for": "for",
+  "on": "on",
+  "at": "at",
+  "up": "up",
+  "a": "a",
+  "an": "an",
+  "is": "is",
+  "are": "are",
+  "was": "was",
+  "were": "were",
+  "be": "be",
+  "but": "but",
+  "nor": "nor",
+  "so": "so",
+  "yet": "yet",
+  "per": "per",
+  "via": "via",
+  // Latin abbreviations (tokenized as words in some pipelines)
+  "eg": "e.g.",
+  "ie": "i.e.",
+  "etc": "etc.",
+  "aka": "aka",
+  "vs": "vs.",
+  "v": "v.",
+  // Client abbreviations
+  "CIC": "CIC",
+  "AGR": "AGR",
+  "AGER": "AGER",
+  "DD": "DD",
+  "TS": "TS",
+  "TM": "TM",
+  "arman": "Arman"
+};
+var DEFAULT_OPTIONS = {
+  textCase: "title",
+  wordReplacements: DEFAULT_WORD_REPLACEMENTS,
+  trim: true
+};
+function formatText(text, options = {}) {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  if (!text) return "";
+  let normalized = text.replace(/_/g, " ").replace(/-/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").replace(/\s+/g, " ");
+  if (opts.trim) {
+    normalized = normalized.trim();
+  }
+  let caseTransformed = normalized;
+  switch (opts.textCase) {
+    case "title":
+      caseTransformed = normalized.replace(
+        /\w\S*/g,
+        (word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
+      );
+      break;
+    case "sentence":
+      if (normalized.length > 0) {
+        caseTransformed = normalized.charAt(0).toUpperCase() + normalized.slice(1).toLowerCase();
+      }
+      break;
+    case "lower":
+      caseTransformed = normalized.toLowerCase();
+      break;
+    case "upper":
+      caseTransformed = normalized.toUpperCase();
+      break;
+    case "normal":
+    default:
+      break;
+  }
+  let result = caseTransformed;
+  if (opts.wordReplacements) {
+    Object.entries(opts.wordReplacements).forEach(([key, value]) => {
+      const regex = new RegExp(`\\b${key}\\b`, "gi");
+      result = result.replace(regex, value);
+    });
+  }
+  return result;
+}
+function createFormatter(defaultOptions = {}) {
+  return (text, overrideOptions = {}) => formatText(text, { ...defaultOptions, ...overrideOptions });
+}
+var formatTitleCase = createFormatter({ textCase: "title" });
+var formatSentenceCase = createFormatter({ textCase: "sentence" });
+var formatNormalCase = createFormatter({ textCase: "normal" });
+var formatUpperCase = createFormatter({ textCase: "upper" });
+var formatLowerCase = createFormatter({ textCase: "lower" });
+var formatWithoutReplacements = createFormatter({ wordReplacements: {} });
+export {
+  DEFAULT_WORD_REPLACEMENTS,
+  createFormatter,
+  formatLowerCase,
+  formatNormalCase,
+  formatSentenceCase,
+  formatText,
+  formatTitleCase,
+  formatUpperCase,
+  formatWithoutReplacements
+};
+//# sourceMappingURL=text-case.js.map

package/dist/text-case.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/text-case.ts"],"sourcesContent":["/**\n * Text formatting options\n */\nexport type TextCaseOption = 'title' | 'sentence' | 'normal' | 'lower' | 'upper';\n\nexport interface TextFormatterOptions {\n  /**\n   * Text case to apply after normalization\n   * - title: First Letter Of Each Word Capitalized\n   * - sentence: First letter of first word capitalized\n   * - normal: No case transformation after normalization\n   * - lower: all text lowercase\n   * - upper: ALL TEXT UPPERCASE\n   */\n  textCase?: TextCaseOption;\n  \n  /**\n   * Map of words to replace with specific formatting\n   * Example: { 'api': 'API', 'ui': 'UI' }\n   */\n  wordReplacements?: Record<string, string>;\n  \n  /**\n   * Whether to trim the result\n   */\n  trim?: boolean;\n}\n\n/**\n * Default word replacements for common acronyms and terms\n */\nexport type ReplacementMap = Readonly<Record<string, string>>;\n\nexport const DEFAULT_WORD_REPLACEMENTS: ReplacementMap = {\n  // Acronyms & initialisms\n  'api': 'API',\n  'apis': 'APIs',\n  'ui': 'UI',\n  'ux': 'UX',\n  'id': 'ID',\n  'ids': 'IDs',\n  'qr': 'QR',\n  'ssr': 'SSR',\n  'csr': 'CSR',\n  'ssg': 'SSG',\n  'isr': 'ISR',\n  'spa': 'SPA',\n  'pwa': 'PWA',\n  'sdk': 'SDK',\n  'sdks': 'SDKs',\n  'cli': 'CLI',\n  'tty': 'TTY',\n  'repl': 'REPL',\n  'ci': 'CI',\n  'cd': 'CD',\n  'cpu': 'CPU',\n  'cpus': 'CPUs',\n  'gpu': 'GPU',\n  'gpus': 'GPUs',\n  'ram': 'RAM',\n  'rom': 'ROM',\n  'ssd': 'SSD',\n  'ssds': 'SSDs',\n  'hdd': 'HDD',\n  'hdds': 'HDDs',\n  'kpi': 'KPI',\n  'kpis': 'KPIs',\n  'sla': 'SLA',\n  'slas': 'SLAs',\n  'slo': 'SLO',\n  'slos': 'SLOs',\n  'sli': 'SLI',\n  'slis': 'SLIs',\n  'dom': 'DOM',\n\n  // Web, formats, protocols\n  'url': 'URL',\n  'urls': 'URLs',\n  'uri': 'URI',\n  'uris': 'URIs',\n  'http': 'HTTP',\n  'https': 'HTTPS',\n  'html': 'HTML',\n  'css': 'CSS',\n  'json': 'JSON',\n  'yaml': 'YAML',\n  'yml': 'YML',\n  'toml': 'TOML',\n  'csv': 'CSV',\n  'pdf': 'PDF',\n  'tsv': 'TSV',\n  'jpg': 'JPG',\n  'jpeg': 'JPEG',\n  'png': 'PNG',\n  'gif': 'GIF',\n  'webp': 'WebP',\n  'heic': 'HEIC',\n  'heif': 'HEIF',\n  'bmp': 'BMP',\n  'tiff': 'TIFF',\n  'ico': 'ICO',\n  'xml': 'XML',\n  'sql': 'SQL',\n  'db': 'DB',\n  'dbs': 'DBs',\n  'nosql': 'NoSQL',\n  'graphql': 'GraphQL',\n  'grpc': 'gRPC',\n  'rest': 'REST',\n  'restful': 'RESTful',\n  'websocket': 'WebSocket',\n  'websockets': 'WebSockets',\n  'webrtc': 'WebRTC',\n\n  // Networking\n  'ip': 'IP',\n  'ipv4': 'IPv4',\n  'ipv6': 'IPv6',\n  'dns': 'DNS',\n  'dhcp': 'DHCP',\n  'nat': 'NAT',\n  'tcp': 'TCP',\n  'udp': 'UDP',\n  'icmp': 'ICMP',\n  'ttl': 'TTL',\n  'lan': 'LAN',\n  'wan': 'WAN',\n  'vlan': 'VLAN',\n  'cdn': 'CDN',\n  'ftp': 'FTP',\n  'ssh': 'SSH',\n  'tls': 'TLS',\n  'ssl': 'SSL',\n\n  // Security & crypto\n  'jwt': 'JWT',\n  'jws': 'JWS',\n  'jwe': 'JWE',\n  'hmac': 'HMAC',\n  'rsa': 'RSA',\n  'ecdsa': 'ECDSA',\n  'aes': 'AES',\n  'pbkdf2': 'PBKDF2',\n  'argon2': 'Argon2',\n  'scrypt': 'scrypt',\n  'totp': 'TOTP',\n  'hotp': 'HOTP',\n  'mfa': 'MFA',\n  '2fa': '2FA',\n  'csrf': 'CSRF',\n  'xss': 'XSS',\n  'ssrf': 'SSRF',\n  'rce': 'RCE',\n  'dos': 'DoS',\n  'ddos': 'DDoS',\n  'mitm': 'MITM',\n  'csp': 'CSP',\n  'cors': 'CORS',\n  'pii': 'PII',\n  'phi': 'PHI',\n  'gdpr': 'GDPR',\n  'ccpa': 'CCPA',\n  'hipaa': 'HIPAA',\n  'rfc': 'RFC',\n\n  // Platforms, langs, tools (single-token)\n  'javascript': 'JavaScript',\n  'typescript': 'TypeScript',\n  'jsx': 'JSX',\n  'tsx': 'TSX',\n  'node': 'Node',           // (used when tokenized alone)\n  'deno': 'Deno',\n  'bun': 'Bun',\n  'react': 'React',\n  'nextjs': 'Next.js',      // if your tokenizer drops dots, keep this\n  'nodejs': 'Node.js',\n  'postgresql': 'PostgreSQL',\n  'postgres': 'Postgres',\n  'mysql': 'MySQL',\n  'sqlite': 'SQLite',\n  'redis': 'Redis',\n  'supabase': 'Supabase',\n  'docker': 'Docker',\n  'kubernetes': 'Kubernetes',\n  'k8s': 'Kubernetes',\n  'helm': 'Helm',\n  'npm': 'npm',\n  'pnpm': 'pnpm',\n  'yarn': 'Yarn',\n  'eslint': 'ESLint',\n  'prettier': 'Prettier',\n  'vite': 'Vite',\n  'webpack': 'Webpack',\n  'babel': 'Babel',\n\n  // OS & vendors\n  'macos': 'macOS',\n  'ios': 'iOS',\n  'ipados': 'iPadOS',\n  'watchos': 'watchOS',\n  'tvos': 'tvOS',\n  'windows': 'Windows',\n  'linux': 'Linux',\n  'ubuntu': 'Ubuntu',\n  'github': 'GitHub',\n  'gitlab': 'GitLab',\n  'bitbucket': 'Bitbucket',\n\n  // Data & analytics\n  'etl': 'ETL',\n  'elt': 'ELT',\n  'olap': 'OLAP',\n  'oltp': 'OLTP',\n  'bi': 'BI',\n\n  // Time & locales\n  'utc': 'UTC',\n  'gmt': 'GMT',\n  'pst': 'PST',\n  'pdt': 'PDT',\n  'pt': 'PT',\n\n  // Common “small words” to keep lowercase (unless first/last word)\n  'or': 'or',\n  'and': 'and',\n  'the': 'the',\n  'of': 'of',\n  'in': 'in',\n  'to': 'to',\n  'with': 'with',\n  'as': 'as',\n  'by': 'by',\n  'for': 'for',\n  'on': 'on',\n  'at': 'at',\n  'up': 'up',\n  'a': 'a',\n  'an': 'an',\n  'is': 'is',\n  'are': 'are',\n  'was': 'was',\n  'were': 'were',\n  'be': 'be',\n  'but': 'but',\n  'nor': 'nor',\n  'so': 'so',\n  'yet': 'yet',\n  'per': 'per',\n  'via': 'via',\n\n  // Latin abbreviations (tokenized as words in some pipelines)\n  'eg': 'e.g.',\n  'ie': 'i.e.',\n  'etc': 'etc.',\n  'aka': 'aka',\n  'vs': 'vs.',\n  'v': 'v.',\n\n  // Client abbreviations\n  'CIC': 'CIC',\n  'AGR': 'AGR',\n  'AGER': 'AGER',\n  'DD': 'DD',\n  'TS': 'TS',\n  'TM': 'TM',\n  'arman': \"Arman\",\n};\n\n/**\n * Default options for text formatting\n */\nconst DEFAULT_OPTIONS: TextFormatterOptions = {\n  textCase: 'title',\n  wordReplacements: DEFAULT_WORD_REPLACEMENTS,\n  trim: true,\n};\n\n/**\n * Formats text by normalizing case styles, applying case transformations,\n * and replacing specific words with custom formatting.\n * \n * @param text The input text to format\n * @param options Formatting options\n * @returns Formatted text\n */\nexport function formatText(text: string, options: TextFormatterOptions = {}): string {\n  // Merge provided options with defaults\n  const opts = { ...DEFAULT_OPTIONS, ...options };\n  \n  // Handle empty text\n  if (!text) return '';\n  \n  // Step 1: Normalize various case styles to space-separated words\n  let normalized = text\n    // Convert snake_case to space-separated\n    .replace(/_/g, ' ')\n    // Convert kebab-case to space-separated\n    .replace(/-/g, ' ')\n    // Convert camelCase and PascalCase to space-separated\n    .replace(/([a-z])([A-Z])/g, '$1 $2')\n    // Replace multiple spaces with a single space\n    .replace(/\\s+/g, ' ');\n  \n  // Step 2: Apply trim if needed\n  if (opts.trim) {\n    normalized = normalized.trim();\n  }\n  \n  // Step 3: Apply the specified text case\n  let caseTransformed = normalized;\n  switch (opts.textCase) {\n    case 'title':\n      caseTransformed = normalized.replace(/\\w\\S*/g, (word) => \n        word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()\n      );\n      break;\n    case 'sentence':\n      if (normalized.length > 0) {\n        caseTransformed = normalized.charAt(0).toUpperCase() + normalized.slice(1).toLowerCase();\n      }\n      break;\n    case 'lower':\n      caseTransformed = normalized.toLowerCase();\n      break;\n    case 'upper':\n      caseTransformed = normalized.toUpperCase();\n      break;\n    case 'normal':\n    default:\n      // No case transformation\n      break;\n  }\n  \n  // Step 4: Apply word replacements if provided\n  let result = caseTransformed;\n  if (opts.wordReplacements) {\n    Object.entries(opts.wordReplacements).forEach(([key, value]) => {\n      // Create a regex that matches the key as a whole word (case insensitive)\n      const regex = new RegExp(`\\\\b${key}\\\\b`, 'gi');\n      result = result.replace(regex, value);\n    });\n  }\n  \n  return result;\n}\n\n/**\n * Creates a pre-configured formatter function with specific options\n * \n * @param defaultOptions Default options for the formatter\n * @returns A formatter function with the specified default options\n */\nexport function createFormatter(defaultOptions: TextFormatterOptions = {}) {\n  return (text: string, overrideOptions: TextFormatterOptions = {}) => \n    formatText(text, { ...defaultOptions, ...overrideOptions });\n}\n\n// Some pre-configured formatters for common use cases\nexport const formatTitleCase = createFormatter({ textCase: 'title' });\nexport const formatSentenceCase = createFormatter({ textCase: 'sentence' });\nexport const formatNormalCase = createFormatter({ textCase: 'normal' });\nexport const formatUpperCase = createFormatter({ textCase: 'upper' });\nexport const formatLowerCase = createFormatter({ textCase: 'lower' });\nexport const formatWithoutReplacements = createFormatter({ wordReplacements: {} });\n"],"mappings":";AAiCO,IAAM,4BAA4C;AAAA;AAAA,EAEvD,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA;AAAA,EAGP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AAAA,EACP,SAAS;AAAA,EACT,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,aAAa;AAAA,EACb,cAAc;AAAA,EACd,UAAU;AAAA;AAAA,EAGV,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA;AAAA,EAGP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,SAAS;AAAA,EACT,OAAO;AAAA,EACP,UAAU;AAAA,EACV,UAAU;AAAA,EACV,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,OAAO;AAAA;AAAA,EAGP,cAAc;AAAA,EACd,cAAc;AAAA,EACd,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,SAAS;AAAA,EACT,UAAU;AAAA;AAAA,EACV,UAAU;AAAA,EACV,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,cAAc;AAAA,EACd,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,SAAS;AAAA;AAAA,EAGT,SAAS;AAAA,EACT,OAAO;AAAA,EACP,UAAU;AAAA,EACV,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,SAAS;AAAA,EACT,UAAU;AAAA,EACV,UAAU;AAAA,EACV,UAAU;AAAA,EACV,aAAa;AAAA;AAAA,EAGb,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,MAAM;AAAA;AAAA,EAGN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA;AAAA,EAGN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA;AAAA,EAGP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,KAAK;AAAA;AAAA,EAGL,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,SAAS;AACX;AAKA,IAAM,kBAAwC;AAAA,EAC5C,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,MAAM;AACR;AAUO,SAAS,WAAW,MAAc,UAAgC,CAAC,GAAW;AAEnF,QAAM,OAAO,EAAE,GAAG,iBAAiB,GAAG,QAAQ;AAG9C,MAAI,CAAC,KAAM,QAAO;AAGlB,MAAI,aAAa,KAEd,QAAQ,MAAM,GAAG,EAEjB,QAAQ,MAAM,GAAG,EAEjB,QAAQ,mBAAmB,OAAO,EAElC,QAAQ,QAAQ,GAAG;AAGtB,MAAI,KAAK,MAAM;AACb,iBAAa,WAAW,KAAK;AAAA,EAC/B;AAGA,MAAI,kBAAkB;AACtB,UAAQ,KAAK,UAAU;AAAA,IACrB,KAAK;AACH,wBAAkB,WAAW;AAAA,QAAQ;AAAA,QAAU,CAAC,SAC9C,KAAK,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC,EAAE,YAAY;AAAA,MAC3D;AACA;AAAA,IACF,KAAK;AACH,UAAI,WAAW,SAAS,GAAG;AACzB,0BAAkB,WAAW,OAAO,CAAC,EAAE,YAAY,IAAI,WAAW,MAAM,CAAC,EAAE,YAAY;AAAA,MACzF;AACA;AAAA,IACF,KAAK;AACH,wBAAkB,WAAW,YAAY;AACzC;AAAA,IACF,KAAK;AACH,wBAAkB,WAAW,YAAY;AACzC;AAAA,IACF,KAAK;AAAA,IACL;AAEE;AAAA,EACJ;AAGA,MAAI,SAAS;AACb,MAAI,KAAK,kBAAkB;AACzB,WAAO,QAAQ,KAAK,gBAAgB,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAE9D,YAAM,QAAQ,IAAI,OAAO,MAAM,GAAG,OAAO,IAAI;AAC7C,eAAS,OAAO,QAAQ,OAAO,KAAK;AAAA,IACtC,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAQO,SAAS,gBAAgB,iBAAuC,CAAC,GAAG;AACzE,SAAO,CAAC,MAAc,kBAAwC,CAAC,MAC7D,WAAW,MAAM,EAAE,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAC9D;AAGO,IAAM,kBAAkB,gBAAgB,EAAE,UAAU,QAAQ,CAAC;AAC7D,IAAM,qBAAqB,gBAAgB,EAAE,UAAU,WAAW,CAAC;AACnE,IAAM,mBAAmB,gBAAgB,EAAE,UAAU,SAAS,CAAC;AAC/D,IAAM,kBAAkB,gBAAgB,EAAE,UAAU,QAAQ,CAAC;AAC7D,IAAM,kBAAkB,gBAAgB,EAAE,UAAU,QAAQ,CAAC;AAC7D,IAAM,4BAA4B,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,CAAC;","names":[]}

package/dist/toast.cjs

@@ -0,0 +1,74 @@
+"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/toast.ts
+var toast_exports = {};
+__export(toast_exports, {
+  createMatrxToast: () => createMatrxToast
+});
+module.exports = __toCommonJS(toast_exports);
+function messageText(message, data) {
+  const description = data && typeof data.description === "string" ? data.description : "";
+  const title = typeof message === "string" ? message : "";
+  return [title, description].filter(Boolean).join(" \u2014 ") || "Error toast";
+}
+function createMatrxToast({
+  toast: hostToast,
+  capture
+}) {
+  if (typeof hostToast !== "function") {
+    throw new Error(
+      "createMatrxToast: options.toast must be the sonner `toast` object (or a structural equivalent) \u2014 got " + typeof hostToast
+    );
+  }
+  function captureToast(kind, message, data) {
+    if (!capture) return;
+    try {
+      capture({
+        source: "user-toast",
+        message: `${kind === "warning" ? "[warning] " : ""}${messageText(message, data)}`,
+        userMessage: messageText(message, data),
+        raw: {
+          kind,
+          message: typeof message === "string" ? message : void 0,
+          data
+        }
+      });
+    } catch {
+    }
+  }
+  const error = (message, data) => {
+    captureToast("error", message, data);
+    return hostToast.error(message, data);
+  };
+  const warning = (message, data) => {
+    captureToast("warning", message, data);
+    return hostToast.warning(message, data);
+  };
+  const forward = hostToast;
+  const toast = Object.assign(
+    ((...args) => forward(...args)),
+    hostToast,
+    { error, warning }
+  );
+  const toastErrorAlreadyCaptured = ((message, data) => hostToast.error(message, data));
+  return { toast, toastErrorAlreadyCaptured };
+}
+//# sourceMappingURL=toast.cjs.map

package/dist/toast.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toast.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/toast — the captured sonner wrapper, as a factory.\n *\n * A bare `toast.error(...)` from \"sonner\" is INVISIBLE to any error-capture\n * sink — every modern sonner call site silently bypasses error capture (the\n * exact hole matrx-frontend found in its marketing feature, 2026-07-20).\n * `createMatrxToast` returns a drop-in `toast` whose API is identical to the\n * one you pass in — `error` and `warning` additionally feed the injected\n * capture sink. A user seeing the failure is not evidence that it is minor,\n * so error toasts stay red unless a specific downgrade rule says otherwise.\n * Success/info/etc. pass straight through untouched.\n *\n * Ported from matrx-frontend `lib/toast.ts` with the two seams inverted:\n *\n * - `sonner` is NOT imported: the host passes its own `toast` object into the\n *   factory (`createMatrxToast({ toast })`). That removes the peer-resolution\n *   problem entirely — this module has zero dependencies — and the input is\n *   typed STRUCTURALLY (callable + `.error` + `.warning`) so the returned\n *   `toast` keeps the host's full sonner type, and no `.d.ts` in this package\n *   references \"sonner\". The `sonner` entry in `peerDependencies` is\n *   advisory-only (optional; nothing resolves it at runtime).\n * - `captureError` from the app's diagnostics store becomes the injected\n *   `capture?: (info) => void`. Omitted, capture is a no-op and every call\n *   forwards identically (the original's payload shape is preserved exactly:\n *   `source: \"user-toast\"`, the `[warning] ` prefix, the \"Error toast\"\n *   fallback, `raw: { kind, message?, data }`). A throwing `capture` never\n *   breaks the toast.\n *\n * Usage (once, in the host app):\n *   import { toast as sonnerToast } from \"sonner\";\n *   export const { toast, toastErrorAlreadyCaptured } =\n *     createMatrxToast({ toast: sonnerToast, capture: captureError });\n */\n\nimport type { ReactNode } from \"react\";\n\n/** What sonner accepts as a toast title (structural: sonner's `titleT`). */\nexport type ToastMessage = ReactNode | (() => ReactNode);\n\n/** Structural stand-in for sonner's `ExternalToast` options bag. */\nexport interface ToastData {\n  description?: unknown;\n  [key: string]: unknown;\n}\n\n/**\n * The structural surface this factory needs from the injected toast object:\n * callable, with `error` and `warning` methods. sonner's `toast` satisfies\n * this for every version this package targets. Deliberate typing choices so\n * the REAL sonner object is assignable without a cast under\n * `strictFunctionTypes`: the call signature uses `never[]` (accepts any\n * function — consumers call through their own `T`, never this signature),\n * and `error`/`warning` use METHOD syntax for bivariant parameter checks\n * against sonner's `ExternalToast`.\n */\nexport interface SonnerLikeToast {\n  (...args: never[]): string | number;\n  error(message: ToastMessage, data?: ToastData): string | number;\n  warning(message: ToastMessage, data?: ToastData): string | number;\n}\n\n/** The payload handed to the injected capture sink — the original's shape. */\nexport interface CapturedToastInfo {\n  source: \"user-toast\";\n  message: string;\n  userMessage: string;\n  raw: {\n    kind: \"error\" | \"warning\";\n    message: string | undefined;\n    data: ToastData | undefined;\n  };\n}\n\nexport interface CreateMatrxToastOptions<T extends SonnerLikeToast> {\n  /** The host's sonner `toast` object (or any structural equivalent). */\n  toast: T;\n  /**\n   * Error-capture sink fed by `.error` / `.warning`. Omitted: no-op.\n   * Must never be load-bearing — a throw here is swallowed.\n   */\n  capture?: (info: CapturedToastInfo) => void;\n}\n\nexport interface MatrxToast<T extends SonnerLikeToast> {\n  /** Drop-in replacement for the injected `toast`, with error/warning capture. */\n  toast: T;\n  /**\n   * Render an error toast when the originating failure was already captured\n   * at its canonical boundary. Only for aggregate/derived UI notices; the\n   * caller must be able to name the upstream capture seam.\n   */\n  toastErrorAlreadyCaptured: T[\"error\"];\n}\n\nfunction messageText(message: ToastMessage, data?: ToastData): string {\n  const description =\n    data && typeof data.description === \"string\" ? data.description : \"\";\n  const title = typeof message === \"string\" ? message : \"\";\n  return [title, description].filter(Boolean).join(\" — \") || \"Error toast\";\n}\n\n/** Build the captured toast pair around the host's sonner `toast` object. */\nexport function createMatrxToast<T extends SonnerLikeToast>({\n  toast: hostToast,\n  capture,\n}: CreateMatrxToastOptions<T>): MatrxToast<T> {\n  if (typeof hostToast !== \"function\") {\n    throw new Error(\n      \"createMatrxToast: options.toast must be the sonner `toast` object (or a structural equivalent) — got \" +\n        typeof hostToast,\n    );\n  }\n\n  function captureToast(\n    kind: \"error\" | \"warning\",\n    message: ToastMessage,\n    data?: ToastData,\n  ): void {\n    if (!capture) return;\n    try {\n      capture({\n        source: \"user-toast\",\n        message: `${kind === \"warning\" ? \"[warning] \" : \"\"}${messageText(message, data)}`,\n        userMessage: messageText(message, data),\n        raw: {\n          kind,\n          message: typeof message === \"string\" ? message : undefined,\n          data,\n        },\n      });\n    } catch {\n      /* capture must never break the toast */\n    }\n  }\n\n  const error: SonnerLikeToast[\"error\"] = (message, data) => {\n    captureToast(\"error\", message, data);\n    return hostToast.error(message, data);\n  };\n\n  const warning: SonnerLikeToast[\"warning\"] = (message, data) => {\n    captureToast(\"warning\", message, data);\n    return hostToast.warning(message, data);\n  };\n\n  // The constraint's call signature is `never[]` (see SonnerLikeToast), so\n  // forwarding the base call goes through a widened alias of the host object.\n  const forward = hostToast as unknown as (\n    ...args: Parameters<T>\n  ) => ReturnType<T>;\n  const toast: T = Object.assign(\n    ((...args: Parameters<T>) => forward(...args)) as unknown as T,\n    hostToast,\n    { error, warning },\n  );\n\n  const toastErrorAlreadyCaptured = ((\n    message: ToastMessage,\n    data?: ToastData,\n  ) => hostToast.error(message, data)) as unknown as T[\"error\"];\n\n  return { toast, toastErrorAlreadyCaptured };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA8FA,SAAS,YAAY,SAAuB,MAA0B;AACpE,QAAM,cACJ,QAAQ,OAAO,KAAK,gBAAgB,WAAW,KAAK,cAAc;AACpE,QAAM,QAAQ,OAAO,YAAY,WAAW,UAAU;AACtD,SAAO,CAAC,OAAO,WAAW,EAAE,OAAO,OAAO,EAAE,KAAK,UAAK,KAAK;AAC7D;AAGO,SAAS,iBAA4C;AAAA,EAC1D,OAAO;AAAA,EACP;AACF,GAA8C;AAC5C,MAAI,OAAO,cAAc,YAAY;AACnC,UAAM,IAAI;AAAA,MACR,+GACE,OAAO;AAAA,IACX;AAAA,EACF;AAEA,WAAS,aACP,MACA,SACA,MACM;AACN,QAAI,CAAC,QAAS;AACd,QAAI;AACF,cAAQ;AAAA,QACN,QAAQ;AAAA,QACR,SAAS,GAAG,SAAS,YAAY,eAAe,EAAE,GAAG,YAAY,SAAS,IAAI,CAAC;AAAA,QAC/E,aAAa,YAAY,SAAS,IAAI;AAAA,QACtC,KAAK;AAAA,UACH;AAAA,UACA,SAAS,OAAO,YAAY,WAAW,UAAU;AAAA,UACjD;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,QAAM,QAAkC,CAAC,SAAS,SAAS;AACzD,iBAAa,SAAS,SAAS,IAAI;AACnC,WAAO,UAAU,MAAM,SAAS,IAAI;AAAA,EACtC;AAEA,QAAM,UAAsC,CAAC,SAAS,SAAS;AAC7D,iBAAa,WAAW,SAAS,IAAI;AACrC,WAAO,UAAU,QAAQ,SAAS,IAAI;AAAA,EACxC;AAIA,QAAM,UAAU;AAGhB,QAAM,QAAW,OAAO;AAAA,KACrB,IAAI,SAAwB,QAAQ,GAAG,IAAI;AAAA,IAC5C;AAAA,IACA,EAAE,OAAO,QAAQ;AAAA,EACnB;AAEA,QAAM,6BAA6B,CACjC,SACA,SACG,UAAU,MAAM,SAAS,IAAI;AAElC,SAAO,EAAE,OAAO,0BAA0B;AAC5C;","names":[]}

package/dist/toast.d.cts

@@ -0,0 +1,92 @@
+import { ReactNode } from 'react';
+
+/**
+ * @ai-matrx/kit/toast — the captured sonner wrapper, as a factory.
+ *
+ * A bare `toast.error(...)` from "sonner" is INVISIBLE to any error-capture
+ * sink — every modern sonner call site silently bypasses error capture (the
+ * exact hole matrx-frontend found in its marketing feature, 2026-07-20).
+ * `createMatrxToast` returns a drop-in `toast` whose API is identical to the
+ * one you pass in — `error` and `warning` additionally feed the injected
+ * capture sink. A user seeing the failure is not evidence that it is minor,
+ * so error toasts stay red unless a specific downgrade rule says otherwise.
+ * Success/info/etc. pass straight through untouched.
+ *
+ * Ported from matrx-frontend `lib/toast.ts` with the two seams inverted:
+ *
+ * - `sonner` is NOT imported: the host passes its own `toast` object into the
+ *   factory (`createMatrxToast({ toast })`). That removes the peer-resolution
+ *   problem entirely — this module has zero dependencies — and the input is
+ *   typed STRUCTURALLY (callable + `.error` + `.warning`) so the returned
+ *   `toast` keeps the host's full sonner type, and no `.d.ts` in this package
+ *   references "sonner". The `sonner` entry in `peerDependencies` is
+ *   advisory-only (optional; nothing resolves it at runtime).
+ * - `captureError` from the app's diagnostics store becomes the injected
+ *   `capture?: (info) => void`. Omitted, capture is a no-op and every call
+ *   forwards identically (the original's payload shape is preserved exactly:
+ *   `source: "user-toast"`, the `[warning] ` prefix, the "Error toast"
+ *   fallback, `raw: { kind, message?, data }`). A throwing `capture` never
+ *   breaks the toast.
+ *
+ * Usage (once, in the host app):
+ *   import { toast as sonnerToast } from "sonner";
+ *   export const { toast, toastErrorAlreadyCaptured } =
+ *     createMatrxToast({ toast: sonnerToast, capture: captureError });
+ */
+
+/** What sonner accepts as a toast title (structural: sonner's `titleT`). */
+type ToastMessage = ReactNode | (() => ReactNode);
+/** Structural stand-in for sonner's `ExternalToast` options bag. */
+interface ToastData {
+    description?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * The structural surface this factory needs from the injected toast object:
+ * callable, with `error` and `warning` methods. sonner's `toast` satisfies
+ * this for every version this package targets. Deliberate typing choices so
+ * the REAL sonner object is assignable without a cast under
+ * `strictFunctionTypes`: the call signature uses `never[]` (accepts any
+ * function — consumers call through their own `T`, never this signature),
+ * and `error`/`warning` use METHOD syntax for bivariant parameter checks
+ * against sonner's `ExternalToast`.
+ */
+interface SonnerLikeToast {
+    (...args: never[]): string | number;
+    error(message: ToastMessage, data?: ToastData): string | number;
+    warning(message: ToastMessage, data?: ToastData): string | number;
+}
+/** The payload handed to the injected capture sink — the original's shape. */
+interface CapturedToastInfo {
+    source: "user-toast";
+    message: string;
+    userMessage: string;
+    raw: {
+        kind: "error" | "warning";
+        message: string | undefined;
+        data: ToastData | undefined;
+    };
+}
+interface CreateMatrxToastOptions<T extends SonnerLikeToast> {
+    /** The host's sonner `toast` object (or any structural equivalent). */
+    toast: T;
+    /**
+     * Error-capture sink fed by `.error` / `.warning`. Omitted: no-op.
+     * Must never be load-bearing — a throw here is swallowed.
+     */
+    capture?: (info: CapturedToastInfo) => void;
+}
+interface MatrxToast<T extends SonnerLikeToast> {
+    /** Drop-in replacement for the injected `toast`, with error/warning capture. */
+    toast: T;
+    /**
+     * Render an error toast when the originating failure was already captured
+     * at its canonical boundary. Only for aggregate/derived UI notices; the
+     * caller must be able to name the upstream capture seam.
+     */
+    toastErrorAlreadyCaptured: T["error"];
+}
+/** Build the captured toast pair around the host's sonner `toast` object. */
+declare function createMatrxToast<T extends SonnerLikeToast>({ toast: hostToast, capture, }: CreateMatrxToastOptions<T>): MatrxToast<T>;
+
+export { type CapturedToastInfo, type CreateMatrxToastOptions, type MatrxToast, type SonnerLikeToast, type ToastData, type ToastMessage, createMatrxToast };

package/dist/toast.d.ts

@@ -0,0 +1,92 @@
+import { ReactNode } from 'react';
+
+/**
+ * @ai-matrx/kit/toast — the captured sonner wrapper, as a factory.
+ *
+ * A bare `toast.error(...)` from "sonner" is INVISIBLE to any error-capture
+ * sink — every modern sonner call site silently bypasses error capture (the
+ * exact hole matrx-frontend found in its marketing feature, 2026-07-20).
+ * `createMatrxToast` returns a drop-in `toast` whose API is identical to the
+ * one you pass in — `error` and `warning` additionally feed the injected
+ * capture sink. A user seeing the failure is not evidence that it is minor,
+ * so error toasts stay red unless a specific downgrade rule says otherwise.
+ * Success/info/etc. pass straight through untouched.
+ *
+ * Ported from matrx-frontend `lib/toast.ts` with the two seams inverted:
+ *
+ * - `sonner` is NOT imported: the host passes its own `toast` object into the
+ *   factory (`createMatrxToast({ toast })`). That removes the peer-resolution
+ *   problem entirely — this module has zero dependencies — and the input is
+ *   typed STRUCTURALLY (callable + `.error` + `.warning`) so the returned
+ *   `toast` keeps the host's full sonner type, and no `.d.ts` in this package
+ *   references "sonner". The `sonner` entry in `peerDependencies` is
+ *   advisory-only (optional; nothing resolves it at runtime).
+ * - `captureError` from the app's diagnostics store becomes the injected
+ *   `capture?: (info) => void`. Omitted, capture is a no-op and every call
+ *   forwards identically (the original's payload shape is preserved exactly:
+ *   `source: "user-toast"`, the `[warning] ` prefix, the "Error toast"
+ *   fallback, `raw: { kind, message?, data }`). A throwing `capture` never
+ *   breaks the toast.
+ *
+ * Usage (once, in the host app):
+ *   import { toast as sonnerToast } from "sonner";
+ *   export const { toast, toastErrorAlreadyCaptured } =
+ *     createMatrxToast({ toast: sonnerToast, capture: captureError });
+ */
+
+/** What sonner accepts as a toast title (structural: sonner's `titleT`). */
+type ToastMessage = ReactNode | (() => ReactNode);
+/** Structural stand-in for sonner's `ExternalToast` options bag. */
+interface ToastData {
+    description?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * The structural surface this factory needs from the injected toast object:
+ * callable, with `error` and `warning` methods. sonner's `toast` satisfies
+ * this for every version this package targets. Deliberate typing choices so
+ * the REAL sonner object is assignable without a cast under
+ * `strictFunctionTypes`: the call signature uses `never[]` (accepts any
+ * function — consumers call through their own `T`, never this signature),
+ * and `error`/`warning` use METHOD syntax for bivariant parameter checks
+ * against sonner's `ExternalToast`.
+ */
+interface SonnerLikeToast {
+    (...args: never[]): string | number;
+    error(message: ToastMessage, data?: ToastData): string | number;
+    warning(message: ToastMessage, data?: ToastData): string | number;
+}
+/** The payload handed to the injected capture sink — the original's shape. */
+interface CapturedToastInfo {
+    source: "user-toast";
+    message: string;
+    userMessage: string;
+    raw: {
+        kind: "error" | "warning";
+        message: string | undefined;
+        data: ToastData | undefined;
+    };
+}
+interface CreateMatrxToastOptions<T extends SonnerLikeToast> {
+    /** The host's sonner `toast` object (or any structural equivalent). */
+    toast: T;
+    /**
+     * Error-capture sink fed by `.error` / `.warning`. Omitted: no-op.
+     * Must never be load-bearing — a throw here is swallowed.
+     */
+    capture?: (info: CapturedToastInfo) => void;
+}
+interface MatrxToast<T extends SonnerLikeToast> {
+    /** Drop-in replacement for the injected `toast`, with error/warning capture. */
+    toast: T;
+    /**
+     * Render an error toast when the originating failure was already captured
+     * at its canonical boundary. Only for aggregate/derived UI notices; the
+     * caller must be able to name the upstream capture seam.
+     */
+    toastErrorAlreadyCaptured: T["error"];
+}
+/** Build the captured toast pair around the host's sonner `toast` object. */
+declare function createMatrxToast<T extends SonnerLikeToast>({ toast: hostToast, capture, }: CreateMatrxToastOptions<T>): MatrxToast<T>;
+
+export { type CapturedToastInfo, type CreateMatrxToastOptions, type MatrxToast, type SonnerLikeToast, type ToastData, type ToastMessage, createMatrxToast };

package/dist/toast.js

@@ -0,0 +1,54 @@
+"use client";
+
+// src/toast.ts
+function messageText(message, data) {
+  const description = data && typeof data.description === "string" ? data.description : "";
+  const title = typeof message === "string" ? message : "";
+  return [title, description].filter(Boolean).join(" \u2014 ") || "Error toast";
+}
+function createMatrxToast({
+  toast: hostToast,
+  capture
+}) {
+  if (typeof hostToast !== "function") {
+    throw new Error(
+      "createMatrxToast: options.toast must be the sonner `toast` object (or a structural equivalent) \u2014 got " + typeof hostToast
+    );
+  }
+  function captureToast(kind, message, data) {
+    if (!capture) return;
+    try {
+      capture({
+        source: "user-toast",
+        message: `${kind === "warning" ? "[warning] " : ""}${messageText(message, data)}`,
+        userMessage: messageText(message, data),
+        raw: {
+          kind,
+          message: typeof message === "string" ? message : void 0,
+          data
+        }
+      });
+    } catch {
+    }
+  }
+  const error = (message, data) => {
+    captureToast("error", message, data);
+    return hostToast.error(message, data);
+  };
+  const warning = (message, data) => {
+    captureToast("warning", message, data);
+    return hostToast.warning(message, data);
+  };
+  const forward = hostToast;
+  const toast = Object.assign(
+    ((...args) => forward(...args)),
+    hostToast,
+    { error, warning }
+  );
+  const toastErrorAlreadyCaptured = ((message, data) => hostToast.error(message, data));
+  return { toast, toastErrorAlreadyCaptured };
+}
+export {
+  createMatrxToast
+};
+//# sourceMappingURL=toast.js.map