[{"_1":2,"_175":-5,"_176":-5},"loaderData",{"_3":4,"_92":93},"root",{"_5":6,"_35":36,"_65":66},"ctx",{"_7":8,"_23":-5,"_24":25,"_26":27,"_28":20,"_29":20,"_30":20,"_31":32,"_33":20,"_34":20},"auth",{"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5,"_19":20,"_21":22},"sessionClaims","sessionId","sessionStatus","userId","actor","orgId","orgRole","orgSlug","orgPermissions","factorVerificationAge","isAuthenticated",false,"tokenType","session_token","user","preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","notificationCount",0,"flagDenols","isTeamOrgMember","ENV",{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":56,"_57":58,"_59":60,"_61":62,"_63":64},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","VAL_RUNTIME_NAME","prod","RENDER_GIT_COMMIT","48807a73dfb4c250ae0af97d07e94d04aadb2cac","RENDER_GIT_BRANCH","main","CLERK_PUBLISHABLE_KEY","pk_live_Y2xlcmsudmFsLnRvd24k","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","API_URL","https://api.val.town","clerkState",{"_67":68},"__internal_clerk_state",{"_69":70,"_71":46,"_72":73,"_74":73,"_75":20,"_76":73,"_77":73,"_78":73,"_79":73,"_80":81,"_90":20,"_91":20},"__clerk_ssr_state",{"_21":22,"_9":-5,"_10":-5,"_11":-5,"_12":-5,"_13":-5,"_14":-5,"_15":-5,"_16":-5,"_17":-5,"_18":-5,"_19":20},"__publishableKey","__proxyUrl","","__domain","__isSatellite","__signInUrl","__signUpUrl","__afterSignInUrl","__afterSignUpUrl","__clerk_debug",{"_82":20,"_19":20,"_83":73,"_84":85,"_86":73,"_87":46,"_88":20,"_89":73},"isSignedIn","proxyUrl","reason","session-token-and-uat-missing","message","publishableKey","isSatellite","domain","__telemetryDisabled","__telemetryDebug","routes/embed.x.$handle.$name.$",{"_94":95,"_96":97,"_98":99,"_100":101,"_154":155,"_172":173,"_174":-5},"handle","axiom","name","the-playbook-hono-react","path","utils.ts","project",{"_102":103,"_96":97,"_104":105,"_106":-5,"_107":20,"_108":109,"_110":111,"_112":-5,"_12":113,"_114":115,"_116":117,"_118":-5,"_119":-5,"_120":32,"_14":121,"_122":123,"_124":123,"_125":126,"_127":126,"_128":126,"_129":123,"_130":123,"_23":131,"_134":135,"_137":138,"_153":20},"id","95d89656-d488-11f0-820e-42dde27851f2","createdAt",["D",1765234354304],"deletedAt","legacyEnvVars","privacy","public","description","open-source demo by Banks (jabanks@gmail.com)","imageUrl","019af6f6-fda3-778e-a508-5639a1468e03","pinnedFileId","019b002a-a8a5-767b-b671-60880fd87a03","pinPreview",true,"pinMigrated","screenshotVersion","likeCount","019af6f6-fda3-778e-a508-5b6cc66d79d5","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm",{"_94":95,"_132":133},"profileImageUrl","https://img.clerk.com/eyJ0eXBlIjoiZGVmYXVsdCIsImlpZCI6Imluc18yTm10cGhQUklwU0tqZHNiOHNnNGd2ZjJURFUiLCJyaWQiOiJ1c2VyXzM2VjdZZnVOblV5ZUFaZlRaS3RQdVVHbzhYTiJ9","org",{"_94":95,"_136":133,"_12":113},"avatar","branch",{"_139":140,"_96":44,"_102":141,"_142":103,"_143":144,"_145":146,"_147":109,"_148":149,"_150":121,"_151":97,"_152":95},"version",23,"95db7fa6-d488-11f0-820e-42dde27851f2","projectId","forkedBranchId","7da38c7c-d464-11f0-a05c-42dde27851f2","forkedBranchVersion",37,"forkedProjectPrivacy","forkedProjectId","7da33fa6-d464-11f0-a05c-42dde27851f2","forkedProjectOrgId","projectName","userHandle","isOwned","file",{"_102":156,"_96":99,"_157":158,"_159":-5,"_160":141,"_161":162,"_163":117,"_104":164,"_139":32,"_165":166,"_167":168,"_169":20,"_170":-5,"_98":171},"95e049d2-d488-11f0-820e-42dde27851f2","fileId","019b002a-a8a5-767b-b671-6f35032e236c","parentId","branchId","branchVersion",1,"latest",["D",1765234354304],"fileType","script","content","/**\n * @fileoverview Utility functions for The Playbook.\n * Contains shared helpers used across the application.\n *\n * @author The Playbook Team\n * @version 3.0.0\n */\n\nimport { TIERS } from \"./config.ts\";\nimport type { TierId } from \"./types.ts\";\n\n// =============================================================================\n// STRING UTILITIES\n// =============================================================================\n\n/**\n * Truncates a string to a maximum length with ellipsis.\n *\n * @param str - The string to truncate\n * @param maxLength - Maximum length including ellipsis\n * @returns Truncated string\n */\nexport function truncate(str: string, maxLength: number): string {\n if (str.length <= maxLength) return str;\n return str.slice(0, maxLength - 3) + \"...\";\n}\n\n/**\n * Converts a string to title case.\n *\n * @param str - The string to convert\n * @returns Title-cased string\n */\nexport function toTitleCase(str: string): string {\n return str\n .toLowerCase()\n .split(\" \")\n .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n .join(\" \");\n}\n\n/**\n * Slugifies a string for use in URLs.\n *\n * @param str - The string to slugify\n * @returns URL-safe slug\n */\nexport function slugify(str: string): string {\n return str\n .toLowerCase()\n .trim()\n .replace(/[^\\w\\s-]/g, \"\")\n .replace(/[\\s_-]+/g, \"-\")\n .replace(/^-+|-+$/g, \"\");\n}\n\n/**\n * Escapes HTML entities in a string.\n *\n * @param str - The string to escape\n * @returns HTML-escaped string\n */\nexport function escapeHtml(str: string): string {\n const htmlEntities: Record = {\n \"&\": \"&\",\n \"<\": \"<\",\n \">\": \">\",\n '\"': \""\",\n \"'\": \"'\",\n };\n return str.replace(/[&<>\"']/g, (char) => htmlEntities[char] || char);\n}\n\n// =============================================================================\n// NUMBER UTILITIES\n// =============================================================================\n\n/**\n * Formats a number as currency.\n *\n * @param cents - Amount in cents\n * @param currency - Currency code (default: USD)\n * @returns Formatted currency string\n */\nexport function formatCurrency(\n cents: number,\n currency: string = \"USD\",\n): string {\n return (cents / 100).toLocaleString(\"en-US\", {\n style: \"currency\",\n currency,\n minimumFractionDigits: 0,\n maximumFractionDigits: 0,\n });\n}\n\n/**\n * Formats a number with commas.\n *\n * @param num - The number to format\n * @returns Formatted number string\n */\nexport function formatNumber(num: number): string {\n return num.toLocaleString(\"en-US\");\n}\n\n/**\n * Clamps a number between min and max values.\n *\n * @param num - The number to clamp\n * @param min - Minimum value\n * @param max - Maximum value\n * @returns Clamped number\n */\nexport function clamp(num: number, min: number, max: number): number {\n return Math.min(Math.max(num, min), max);\n}\n\n/**\n * Calculates percentage.\n *\n * @param value - Current value\n * @param total - Total value\n * @param decimals - Decimal places (default: 0)\n * @returns Percentage value\n */\nexport function percentage(\n value: number,\n total: number,\n decimals: number = 0,\n): number {\n if (total === 0) return 0;\n const pct = (value / total) * 100;\n return Number(pct.toFixed(decimals));\n}\n\n// =============================================================================\n// DATE UTILITIES\n// =============================================================================\n\n/**\n * Formats a date as a human-readable string.\n *\n * @param date - Date to format (ISO string or Date object)\n * @returns Formatted date string\n */\nexport function formatDate(date: string | Date): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n return d.toLocaleDateString(\"en-US\", {\n year: \"numeric\",\n month: \"short\",\n day: \"numeric\",\n });\n}\n\n/**\n * Formats a date as a relative time string.\n *\n * @param date - Date to format\n * @returns Relative time string (e.g., \"2 hours ago\")\n */\nexport function formatRelativeTime(date: string | Date): string {\n const d = typeof date === \"string\" ? new Date(date) : date;\n const now = new Date();\n const diffMs = now.getTime() - d.getTime();\n const diffSecs = Math.floor(diffMs / 1000);\n const diffMins = Math.floor(diffSecs / 60);\n const diffHours = Math.floor(diffMins / 60);\n const diffDays = Math.floor(diffHours / 24);\n\n if (diffSecs < 60) return \"just now\";\n if (diffMins < 60) {\n return `${diffMins} minute${diffMins === 1 ? \"\" : \"s\"} ago`;\n }\n if (diffHours < 24) {\n return `${diffHours} hour${diffHours === 1 ? \"\" : \"s\"} ago`;\n }\n if (diffDays < 7) return `${diffDays} day${diffDays === 1 ? \"\" : \"s\"} ago`;\n\n return formatDate(d);\n}\n\n/**\n * Checks if a date is within the last N days.\n *\n * @param date - Date to check\n * @param days - Number of days\n * @returns true if date is within the period\n */\nexport function isWithinDays(date: string | Date, days: number): boolean {\n const d = typeof date === \"string\" ? new Date(date) : date;\n const now = new Date();\n const diffMs = now.getTime() - d.getTime();\n const diffDays = diffMs / (1000 * 60 * 60 * 24);\n return diffDays <= days;\n}\n\n// =============================================================================\n// TIER UTILITIES\n// =============================================================================\n\n/**\n * Gets tier display name from tier ID.\n *\n * @param tierId - The tier ID\n * @returns Tier display name\n */\nexport function getTierName(tierId: TierId): string {\n const tier = Object.values(TIERS).find((t) => t.id === tierId);\n return tier?.name || \"Unknown\";\n}\n\n/**\n * Gets tier badge emoji from tier ID.\n *\n * @param tierId - The tier ID\n * @returns Tier badge emoji\n */\nexport function getTierBadge(tierId: TierId): string {\n const tier = Object.values(TIERS).find((t) => t.id === tierId);\n return tier?.badge || \"❓\";\n}\n\n/**\n * Compares two tiers and returns which is higher.\n *\n * @param tierA - First tier ID\n * @param tierB - Second tier ID\n * @returns -1 if A < B, 0 if equal, 1 if A > B\n */\nexport function compareTiers(tierA: TierId, tierB: TierId): -1 | 0 | 1 {\n const order: TierId[] = [\"tier_rookie\", \"tier_starter\", \"tier_mvp\"];\n const indexA = order.indexOf(tierA);\n const indexB = order.indexOf(tierB);\n\n if (indexA < indexB) return -1;\n if (indexA > indexB) return 1;\n return 0;\n}\n\n// =============================================================================\n// WORD COUNT UTILITIES\n// =============================================================================\n\n/**\n * Counts words in a string.\n *\n * @param text - Text to count words in\n * @returns Word count\n */\nexport function countWords(text: string): number {\n return text\n .trim()\n .split(/\\s+/)\n .filter((word) => word.length > 0).length;\n}\n\n/**\n * Estimates reading time for text.\n *\n * @param text - Text to estimate\n * @param wordsPerMinute - Reading speed (default: 200)\n * @returns Reading time in minutes\n */\nexport function estimateReadingTime(\n text: string,\n wordsPerMinute: number = 200,\n): number {\n const words = countWords(text);\n return Math.ceil(words / wordsPerMinute);\n}\n\n// =============================================================================\n// SCORE UTILITIES\n// =============================================================================\n\n/**\n * Gets a color class based on score value.\n *\n * @param score - Score value (0-100)\n * @returns CSS color class name\n */\nexport function getScoreColorClass(score: number): string {\n if (score >= 80) return \"score-excellent\";\n if (score >= 60) return \"score-good\";\n if (score >= 40) return \"score-fair\";\n return \"score-poor\";\n}\n\n/**\n * Gets a label based on score value.\n *\n * @param score - Score value (0-100)\n * @returns Score label\n */\nexport function getScoreLabel(score: number): string {\n if (score >= 90) return \"Elite\";\n if (score >= 80) return \"Excellent\";\n if (score >= 70) return \"Strong\";\n if (score >= 60) return \"Good\";\n if (score >= 50) return \"Fair\";\n if (score >= 40) return \"Needs Work\";\n if (score >= 30) return \"Weak\";\n return \"Critical\";\n}\n\n/**\n * Formats a score for display with optional label.\n *\n * @param score - Score value\n * @param showLabel - Whether to include label\n * @returns Formatted score string\n */\nexport function formatScore(score: number, showLabel: boolean = false): string {\n const formatted = `${Math.round(score)}/100`;\n if (showLabel) {\n return `${formatted} (${getScoreLabel(score)})`;\n }\n return formatted;\n}\n\n// =============================================================================\n// JSON UTILITIES\n// =============================================================================\n\n/**\n * Safely parses JSON with a default fallback.\n *\n * @param json - JSON string to parse\n * @param fallback - Default value if parsing fails\n * @returns Parsed value or fallback\n */\nexport function safeJsonParse(json: string, fallback: T): T {\n try {\n return JSON.parse(json) as T;\n } catch {\n return fallback;\n }\n}\n\n/**\n * Safely stringifies a value to JSON.\n *\n * @param value - Value to stringify\n * @param fallback - Default string if stringify fails\n * @returns JSON string or fallback\n */\nexport function safeJsonStringify(\n value: unknown,\n fallback: string = \"{}\",\n): string {\n try {\n return JSON.stringify(value);\n } catch {\n return fallback;\n }\n}\n\n// =============================================================================\n// VALIDATION UTILITIES\n// =============================================================================\n\n/**\n * Validates an email address format.\n *\n * @param email - Email to validate\n * @returns true if valid email format\n */\nexport function isValidEmail(email: string): boolean {\n const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n return emailRegex.test(email);\n}\n\n/**\n * Checks if a string is empty or whitespace only.\n *\n * @param str - String to check\n * @returns true if empty or whitespace\n */\nexport function isEmpty(str: string | null | undefined): boolean {\n return !str || str.trim().length === 0;\n}\n\n/**\n * Generates a simple hash for cache busting.\n *\n * @param str - String to hash\n * @returns Hash string\n */\nexport function simpleHash(str: string): string {\n let hash = 0;\n for (let i = 0; i < str.length; i++) {\n const char = str.charCodeAt(i);\n hash = (hash << 5) - hash + char;\n hash = hash & hash;\n }\n return Math.abs(hash).toString(36);\n}","deleted","label",[99],"permalink","https://www.val.town/x/axiom/the-playbook-hono-react/code/utils.ts","extension","actionData","errors"]