@ai-matrx/content-ir 0.19.25 → 0.19.27

package/dist/text-case.cjs

@@ -0,0 +1,322 @@
+'use strict';
+
+// 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;
+  }
+  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: {} });
+var IDENTIFIER_ACRONYMS = [
+  "ID",
+  "URL",
+  "PDF",
+  "HTML",
+  "JSON",
+  "API",
+  "AI",
+  "UI",
+  "CSV",
+  "SMS",
+  "SEO",
+  "LLM",
+  "MCP",
+  "UUID",
+  "ISO"
+];
+var IDENTIFIER_ACRONYM_SET = new Set(IDENTIFIER_ACRONYMS.map((a) => a.toLowerCase()));
+function humanizeIdentifier(identifier) {
+  return identifier.replace(/([a-z\d])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").split(/[_\-.\s]+/).filter((part) => part.length > 0).map(
+    (part) => IDENTIFIER_ACRONYM_SET.has(part.toLowerCase()) ? part.toUpperCase() : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()
+  ).join(" ");
+}
+function displayLabel(label, identifier) {
+  const own = (label ?? "").trim();
+  if (own !== "") return own;
+  return humanizeIdentifier(identifier) || identifier;
+}
+
+exports.DEFAULT_WORD_REPLACEMENTS = DEFAULT_WORD_REPLACEMENTS;
+exports.IDENTIFIER_ACRONYMS = IDENTIFIER_ACRONYMS;
+exports.createFormatter = createFormatter;
+exports.displayLabel = displayLabel;
+exports.formatLowerCase = formatLowerCase;
+exports.formatNormalCase = formatNormalCase;
+exports.formatSentenceCase = formatSentenceCase;
+exports.formatText = formatText;
+exports.formatTitleCase = formatTitleCase;
+exports.formatUpperCase = formatUpperCase;
+exports.formatWithoutReplacements = formatWithoutReplacements;
+exports.humanizeIdentifier = humanizeIdentifier;
+//# sourceMappingURL=text-case.cjs.map
+//# sourceMappingURL=text-case.cjs.map

package/dist/text-case.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../text-case.ts"],"names":[],"mappings":"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","file":"text-case.cjs","sourcesContent":["/**\n * `@ai-matrx/content-ir/text-case` — THE text-case and identifier-label rules.\n *\n * Pure TS. Public face for apps: `@ai-matrx/kit/text-case` (re-exports this). Lives\n * here, the lowest pure layer, because both content-ir (`formatBlockLabel`) and kit\n * need it and kit already depends on content-ir.\n */\n/**\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\n// ── humanizeIdentifier — THE one identifier-to-words rule ────────────────────\n//\n// A screen never shows a machine identifier (`normal_text`, `note_id`,\n// `workflowCatalog`). It shows the thing's own label; when the thing carries no\n// label, it shows the identifier through this function — the ONE humanizer every\n// app and package uses (matrx-frontend, records-ui, diff, chat, agents). The\n// Python twin is aidream `humanize_context_key`; both run the parity corpus\n// `humanize_cases` in `@ai-matrx/agents` `context/rules-corpus.json`.\n\n/** Words always written in capitals when they are a whole word of an identifier. */\nexport const IDENTIFIER_ACRONYMS: readonly string[] = [\n  \"ID\", \"URL\", \"PDF\", \"HTML\", \"JSON\", \"API\", \"AI\", \"UI\", \"CSV\", \"SMS\", \"SEO\", \"LLM\", \"MCP\", \"UUID\", \"ISO\",\n];\nconst IDENTIFIER_ACRONYM_SET = new Set(IDENTIFIER_ACRONYMS.map((a) => a.toLowerCase()));\n\n/**\n * An identifier in words — the label of a thing nobody named.\n *\n * 1. split camelCase (`myValue` → `my Value`, `HTMLParser` → `HTML Parser`);\n * 2. split on runs of `_`, `-`, `.` and whitespace; drop empty parts;\n * 3. a part that is, case-insensitively, one of `IDENTIFIER_ACRONYMS` is\n *    upper-cased; any other part gets its first character upper-cased and the\n *    rest lower-cased (acronyms are whole parts only: `url2pdf` → `Url2pdf`);\n * 4. join with single spaces.\n *\n * `note_id` → `Note ID`, `normal_text` → `Normal Text`, `myValue_ID` → `My Value ID`.\n * An identifier with no word characters returns `\"\"` — callers fall back.\n */\nexport function humanizeIdentifier(identifier: string): string {\n  return identifier\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1 $2\")\n    .split(/[_\\-.\\s]+/)\n    .filter((part) => part.length > 0)\n    .map((part) =>\n      IDENTIFIER_ACRONYM_SET.has(part.toLowerCase())\n        ? part.toUpperCase()\n        : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase(),\n    )\n    .join(\" \");\n}\n\n/**\n * What a screen shows for a thing: its own label when it has one, else its\n * identifier through `humanizeIdentifier`, else the identifier itself.\n */\nexport function displayLabel(label: string | null | undefined, identifier: string): string {\n  const own = (label ?? \"\").trim();\n  if (own !== \"\") return own;\n  return humanizeIdentifier(identifier) || identifier;\n}\n"]}

package/dist/text-case.d.cts

@@ -0,0 +1,81 @@
+/**
+ * `@ai-matrx/content-ir/text-case` — THE text-case and identifier-label rules.
+ *
+ * Pure TS. Public face for apps: `@ai-matrx/kit/text-case` (re-exports this). Lives
+ * here, the lowest pure layer, because both content-ir (`formatBlockLabel`) and kit
+ * need it and kit already depends on content-ir.
+ */
+/**
+ * Text formatting options
+ */
+type TextCaseOption = 'title' | 'sentence' | 'normal' | 'lower' | 'upper';
+interface TextFormatterOptions {
+    /**
+     * Text case to apply after normalization
+     * - title: First Letter Of Each Word Capitalized
+     * - sentence: First letter of first word capitalized
+     * - normal: No case transformation after normalization
+     * - lower: all text lowercase
+     * - upper: ALL TEXT UPPERCASE
+     */
+    textCase?: TextCaseOption;
+    /**
+     * Map of words to replace with specific formatting
+     * Example: { 'api': 'API', 'ui': 'UI' }
+     */
+    wordReplacements?: Record<string, string>;
+    /**
+     * Whether to trim the result
+     */
+    trim?: boolean;
+}
+/**
+ * Default word replacements for common acronyms and terms
+ */
+type ReplacementMap = Readonly<Record<string, string>>;
+declare const DEFAULT_WORD_REPLACEMENTS: ReplacementMap;
+/**
+ * Formats text by normalizing case styles, applying case transformations,
+ * and replacing specific words with custom formatting.
+ *
+ * @param text The input text to format
+ * @param options Formatting options
+ * @returns Formatted text
+ */
+declare function formatText(text: string, options?: TextFormatterOptions): string;
+/**
+ * Creates a pre-configured formatter function with specific options
+ *
+ * @param defaultOptions Default options for the formatter
+ * @returns A formatter function with the specified default options
+ */
+declare function createFormatter(defaultOptions?: TextFormatterOptions): (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatTitleCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatSentenceCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatNormalCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatUpperCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatLowerCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatWithoutReplacements: (text: string, overrideOptions?: TextFormatterOptions) => string;
+/** Words always written in capitals when they are a whole word of an identifier. */
+declare const IDENTIFIER_ACRONYMS: readonly string[];
+/**
+ * An identifier in words — the label of a thing nobody named.
+ *
+ * 1. split camelCase (`myValue` → `my Value`, `HTMLParser` → `HTML Parser`);
+ * 2. split on runs of `_`, `-`, `.` and whitespace; drop empty parts;
+ * 3. a part that is, case-insensitively, one of `IDENTIFIER_ACRONYMS` is
+ *    upper-cased; any other part gets its first character upper-cased and the
+ *    rest lower-cased (acronyms are whole parts only: `url2pdf` → `Url2pdf`);
+ * 4. join with single spaces.
+ *
+ * `note_id` → `Note ID`, `normal_text` → `Normal Text`, `myValue_ID` → `My Value ID`.
+ * An identifier with no word characters returns `""` — callers fall back.
+ */
+declare function humanizeIdentifier(identifier: string): string;
+/**
+ * What a screen shows for a thing: its own label when it has one, else its
+ * identifier through `humanizeIdentifier`, else the identifier itself.
+ */
+declare function displayLabel(label: string | null | undefined, identifier: string): string;
+
+export { DEFAULT_WORD_REPLACEMENTS, IDENTIFIER_ACRONYMS, type ReplacementMap, type TextCaseOption, type TextFormatterOptions, createFormatter, displayLabel, formatLowerCase, formatNormalCase, formatSentenceCase, formatText, formatTitleCase, formatUpperCase, formatWithoutReplacements, humanizeIdentifier };

package/dist/text-case.d.ts

@@ -0,0 +1,81 @@
+/**
+ * `@ai-matrx/content-ir/text-case` — THE text-case and identifier-label rules.
+ *
+ * Pure TS. Public face for apps: `@ai-matrx/kit/text-case` (re-exports this). Lives
+ * here, the lowest pure layer, because both content-ir (`formatBlockLabel`) and kit
+ * need it and kit already depends on content-ir.
+ */
+/**
+ * Text formatting options
+ */
+type TextCaseOption = 'title' | 'sentence' | 'normal' | 'lower' | 'upper';
+interface TextFormatterOptions {
+    /**
+     * Text case to apply after normalization
+     * - title: First Letter Of Each Word Capitalized
+     * - sentence: First letter of first word capitalized
+     * - normal: No case transformation after normalization
+     * - lower: all text lowercase
+     * - upper: ALL TEXT UPPERCASE
+     */
+    textCase?: TextCaseOption;
+    /**
+     * Map of words to replace with specific formatting
+     * Example: { 'api': 'API', 'ui': 'UI' }
+     */
+    wordReplacements?: Record<string, string>;
+    /**
+     * Whether to trim the result
+     */
+    trim?: boolean;
+}
+/**
+ * Default word replacements for common acronyms and terms
+ */
+type ReplacementMap = Readonly<Record<string, string>>;
+declare const DEFAULT_WORD_REPLACEMENTS: ReplacementMap;
+/**
+ * Formats text by normalizing case styles, applying case transformations,
+ * and replacing specific words with custom formatting.
+ *
+ * @param text The input text to format
+ * @param options Formatting options
+ * @returns Formatted text
+ */
+declare function formatText(text: string, options?: TextFormatterOptions): string;
+/**
+ * Creates a pre-configured formatter function with specific options
+ *
+ * @param defaultOptions Default options for the formatter
+ * @returns A formatter function with the specified default options
+ */
+declare function createFormatter(defaultOptions?: TextFormatterOptions): (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatTitleCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatSentenceCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatNormalCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatUpperCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatLowerCase: (text: string, overrideOptions?: TextFormatterOptions) => string;
+declare const formatWithoutReplacements: (text: string, overrideOptions?: TextFormatterOptions) => string;
+/** Words always written in capitals when they are a whole word of an identifier. */
+declare const IDENTIFIER_ACRONYMS: readonly string[];
+/**
+ * An identifier in words — the label of a thing nobody named.
+ *
+ * 1. split camelCase (`myValue` → `my Value`, `HTMLParser` → `HTML Parser`);
+ * 2. split on runs of `_`, `-`, `.` and whitespace; drop empty parts;
+ * 3. a part that is, case-insensitively, one of `IDENTIFIER_ACRONYMS` is
+ *    upper-cased; any other part gets its first character upper-cased and the
+ *    rest lower-cased (acronyms are whole parts only: `url2pdf` → `Url2pdf`);
+ * 4. join with single spaces.
+ *
+ * `note_id` → `Note ID`, `normal_text` → `Normal Text`, `myValue_ID` → `My Value ID`.
+ * An identifier with no word characters returns `""` — callers fall back.
+ */
+declare function humanizeIdentifier(identifier: string): string;
+/**
+ * What a screen shows for a thing: its own label when it has one, else its
+ * identifier through `humanizeIdentifier`, else the identifier itself.
+ */
+declare function displayLabel(label: string | null | undefined, identifier: string): string;
+
+export { DEFAULT_WORD_REPLACEMENTS, IDENTIFIER_ACRONYMS, type ReplacementMap, type TextCaseOption, type TextFormatterOptions, createFormatter, displayLabel, formatLowerCase, formatNormalCase, formatSentenceCase, formatText, formatTitleCase, formatUpperCase, formatWithoutReplacements, humanizeIdentifier };