@meycult/core 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meycult/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "description": "MeyCult shared core — yellow theme, brand, supabase/auth factories, lib. Source-only, no build.",
   "license": "ISC",
@@ -24,11 +24,8 @@
   "exports": {
     ".": "./src/index.ts",
     "./tokens": "./src/tokens.ts",
-    "./cn": "./src/cn.ts",
     "./brand": "./src/brand.ts",
-    "./supabase/server": "./src/supabase/server.ts",
-    "./supabase/proxy": "./src/supabase/proxy.ts",
-    "./supabase/callback": "./src/supabase/callback.ts",
+    "./product": "./src/product.ts",
     "./styles/theme.css": "./src/styles/theme.css"
   },
   "scripts": {
@@ -36,7 +33,7 @@
     "release": "bash scripts/release.sh"
   },
   "dependencies": {
-    "@meyvoid/core": "^0.1.0",
+    "@meyvoid/core": "^0.2.0",
     "clsx": "^2.1.1",
     "tailwind-merge": "^3.6.0",
     "zustand": "^5.0.14"

package/src/brand/BrandName.tsx

@@ -1,11 +1,13 @@
+import { GLOW } from '../tokens'
+
 export default function BrandName({ className }: { className?: string }) {
   return (
     <span className={className} style={{ fontFamily: 'var(--font-logo)', fontWeight: 700, textTransform: 'none' }}>
       <span className="brand-mey" style={{
-        textShadow: '0 0 40px rgba(255,255,255,0.35), 0 0 80px rgba(255,255,255,0.15), 0 0 120px rgba(255,255,255,0.08)',
+        textShadow: GLOW.brandMey,
       }}>Mey</span>
       <span className="brand-cult" style={{
-        textShadow: '0 0 40px rgba(255,230,0,0.35), 0 0 80px rgba(255,230,0,0.18), 0 0 120px rgba(255,230,0,0.08)',
+        textShadow: GLOW.brandCult,
       }}>Cult</span>
     </span>
   )

package/src/brand/LaunchButton.tsx

@@ -1,3 +1,5 @@
+import { GRADIENTS, GLOW } from '../tokens'
+
 interface LaunchButtonProps {
   label?: string
   href?: string
@@ -8,14 +10,14 @@ interface LaunchButtonProps {
 export default function LaunchButton({ label = 'Launch', href = 'https://app.meycult.com', className = '', small }: LaunchButtonProps) {
   return (
     <span className={`inline-block rounded-lg p-[2px] hover:scale-[1.02] transition-all ${className}`}
-      style={{ background: 'linear-gradient(135deg, #FFE600, #FFF7A1)' }}>
+      style={{ background: GRADIENTS.launch }}>
       <a
         href={href}
         className={`block font-bold tracking-wider rounded-[6px] hover:opacity-90 transition-all whitespace-nowrap ${small ? 'px-3 py-1.5 text-[10px]' : 'px-8 py-2.5 text-sm'}`}
         style={{
-          background: 'linear-gradient(135deg, #0B0A02, #4A3D00)',
+          background: GRADIENTS.launchBody,
           color: '#ffffff',
-          boxShadow: '0 0 80px rgba(255,230,0,0.08), 0 0 120px rgba(255,230,0,0.05)',
+          boxShadow: GLOW.text,
         }}
       >
         <span style={{ fontFamily: 'var(--font-logo)', fontWeight: 700 }}>{label} </span>

package/src/brand/Logo.tsx

@@ -1,24 +1,43 @@
+import type { LinkComponent } from '@meyvoid/core'
+import { BRAND } from '../brand'
 import Sigil from './Sigil'
 
-export default function Logo({ size = 24, className }: { size?: number; className?: string }) {
+export default function Logo({
+  size = 24,
+  className,
+  href = '/',
+  tagline = BRAND.tagline,
+  product,
+  Link,
+}: {
+  size?: number
+  className?: string
+  href?: string
+  tagline?: string
+  /** Product lockup (e.g. <PyramidName/>) — replaces the tagline line when set. */
+  product?: React.ReactNode
+  /** Injectable link — host passes react-router Link (app) or next/link (web). Defaults to <a>. */
+  Link?: LinkComponent
+}) {
+  const Cmp = (Link ?? 'a') as LinkComponent
   return (
-    <a href="/" className={`flex items-center gap-3 ${className || ''}`}>
+    <Cmp href={href} className={`flex items-center gap-3 ${className || ''}`}>
       <Sigil size={size} />
       <div>
         <div
           className="text-lg font-bold tracking-wider leading-none"
           style={{ fontFamily: 'var(--font-logo)' }}
         >
-          <span className="brand-mey">Mey</span>
-          <span className="brand-cult" style={{ textShadow: '0 0 12px rgba(255,255,255,0.5), 0 0 30px rgba(255,255,255,0.2)' }}>Cult</span>
+          <span className="brand-mey">{BRAND.first}</span>
+          <span className="brand-cult" style={{ textShadow: '0 0 12px rgba(255,255,255,0.5), 0 0 30px rgba(255,255,255,0.2)' }}>{BRAND.second}</span>
         </div>
         <div
           className="text-[10px] uppercase tracking-widest mt-0.5"
           style={{ color: 'var(--color-text-muted)', fontFamily: 'var(--font-logo)' }}
         >
-          Wager &amp; Join
+          {product ?? tagline}
         </div>
       </div>
-    </a>
+    </Cmp>
   )
 }

package/src/brand/PyramidName.tsx

@@ -0,0 +1,10 @@
+import { PRODUCT } from '../product'
+
+/** Pyramid wordmark — the game product. Pair with BrandName (MeyCult) above it. */
+export default function PyramidName({ className }: { className?: string }) {
+  return (
+    <span className={`brand-pyramid ${className ?? ''}`}>
+      {PRODUCT.name}
+    </span>
+  )
+}

package/src/brand/Sigil.tsx

@@ -1,26 +1,31 @@
+import { cult as cultSigil } from '@meyvoid/core/sigils'
+
+/** Cult mark — geometry is canonical in @meyvoid/core/sigils, styling (accent fill, glow) is cult. */
 export default function Sigil({ size = 24 }: { size?: number }) {
   const s = size * 1.5
 
   return (
     <svg
       width={s}
-      viewBox="0 0 200.56923 175.72475"
+      viewBox={cultSigil.VIEW_BOX}
       style={{ filter: 'drop-shadow(var(--glow))' }}
     >
       <g transform="translate(-341.95552,-53.816747)">
         <g transform="translate(15.212189,33.321951)" style={{ fill: 'var(--color-accent)' }}>
           <path
             style={{ fill: 'var(--color-accent)', fillOpacity: 1 }}
-            d="m 426.49541,20.513477 c -2.53292,0.177108 -4.81223,1.601364 -6.0818,3.800284 l -52.93268,91.681229 -39.703,68.76789 c -2.93967,5.09188 0.73505,11.45661 6.61458,11.45667 h 105.86485 79.40601 c 5.87953,-6e-5 9.55425,-6.36479 6.61458,-11.45667 l -52.93217,-91.681223 -39.703,-68.767896 c -1.46009,-2.528918 -4.23433,-4.003991 -7.14737,-3.800284 z"
+            d={cultSigil.SURROUND_D}
           />
         </g>
         <path
           style={{ fill: '#ffffff', fillOpacity: 1 }}
-          d="m 442.44151,112.59785 c 10.89456,-0.0294 21.77374,0.33291 24.9048,1.10024 18.16066,4.45082 35.71071,13.53969 47.98578,24.85243 8.87021,8.17481 15.22133,14.18661 16.21657,15.34937 2.27217,2.65448 3.21391,6.04251 2.29265,8.24739 -0.487,1.16559 -8.37889,9.64325 -17.45502,18.75132 -6.49799,6.52082 -11.77836,9.84655 -23.09636,14.5445 -2.43619,1.01128 -8.55868,3.59204 -13.60505,5.73526 -5.04636,2.14322 -10.71996,4.40195 -12.60866,5.0198 l -13.80921,3.00538 c -3.83618,0.48165 -13.15749,0.64819 -17.24367,0.30803 -7.65437,-0.63718 -17.39937,-2.6625 -24.94182,-5.1824 -14.40439,-4.81246 -26.96098,-11.29515 -36.43673,-18.81095 -2.63565,-2.09048 -13.55541,-12.206 -19.18402,-17.77121 -2.76668,-2.73554 -4.34874,-5.49272 -4.61149,-8.03873 -0.231,-2.2383 0.26498,-3.06562 3.73616,-6.23205 1.59134,-1.45165 4.70534,-4.84775 6.91952,-7.54642 6.74191,-8.21714 9.10658,-10.11388 20.73231,-16.62942 18.29568,-10.25362 23.48708,-12.53282 35.20639,-15.45595 3.19292,-0.79635 14.10326,-1.21717 24.99785,-1.24659 z"
+          d={cultSigil.EYE_D}
         />
-        <path
+        <circle
+          cx={cultSigil.PUPIL.cx}
+          cy={cultSigil.PUPIL.cy}
+          r={cultSigil.PUPIL.r}
           style={{ fill: 'var(--color-bg)' }}
-          d="m 442.49623,120.3747 c -22.51598,-4e-5 -40.76826,18.25286 -40.76822,40.76884 -10e-6,22.51597 18.25225,40.76887 40.76822,40.76883 22.51558,-5.3e-4 40.76824,-18.25326 40.76823,-40.76883 3e-5,-22.51557 -18.25265,-40.76832 -40.76823,-40.76884 z"
         />
       </g>
     </svg>

package/src/brand/TokenIcons.tsx

@@ -3,6 +3,8 @@ export interface TokenIconProps {
   /** Asset base — host's public dir mount. Defaults to '/products'. */
   basePath?: string
   className?: string
+  /** Render icon only (no wordmark) — app ergonomics. */
+  icon?: boolean
 }
 
 export function InfluenceIcon({ size = 14, basePath = '/products', className }: TokenIconProps) {
@@ -27,22 +29,26 @@ export function FateIcon({ size = 14, basePath = '/products', className }: Token
   )
 }
 
-export function InfluenceText({ size = 13, basePath = '/products' }: TokenIconProps) {
+export function InfluenceText({ size = 13, basePath = '/products', icon = true, className }: TokenIconProps) {
   return (
-    <span style={{ fontFamily: 'var(--font-logo)', fontWeight: 700, whiteSpace: 'nowrap' }}>
-      <InfluenceIcon size={size} basePath={basePath} />{' '}
+    <span style={{ fontFamily: 'var(--font-logo)', fontWeight: 700, whiteSpace: 'nowrap' }} className={className}>
+      {icon && <><InfluenceIcon size={size} basePath={basePath} />{' '}</>}
       <span className="brand-mey">Mey</span>
       <span style={{ color: 'var(--color-accent)' }}>Influence</span>
     </span>
   )
 }
 
-export function FateText({ size = 13, basePath = '/products' }: TokenIconProps) {
+export function FateText({ size = 13, basePath = '/products', icon = true, className }: TokenIconProps) {
   return (
-    <span style={{ fontFamily: 'var(--font-logo)', fontWeight: 700, whiteSpace: 'nowrap' }}>
-      <FateIcon size={size} basePath={basePath} />{' '}
+    <span style={{ fontFamily: 'var(--font-logo)', fontWeight: 700, whiteSpace: 'nowrap' }} className={className}>
+      {icon && <><FateIcon size={size} basePath={basePath} />{' '}</>}
       <span className="brand-mey">Mey</span>
       <span style={{ color: 'var(--color-accent)' }}>Fate</span>
     </span>
   )
 }
+
+/** App-ergonomic aliases. */
+export const MeyInfluence = InfluenceText
+export const MeyFate = FateText

package/src/brand.ts

@@ -1,7 +1,10 @@
+import type { Brand } from '@meyvoid/core/brand'
+
 export const BRAND = {
   name: 'MeyCult',
   first: 'Mey',
   second: 'Cult',
   tagline: 'Wager & Join',
   description: 'Where Foresight Becomes Fortune. Gamified prediction market on Base L2.',
-} as const
+  domain: 'meycult.com',
+} as const satisfies Brand

package/src/components/CultCountdown.tsx

@@ -5,15 +5,13 @@
  * SSR-safe (skeleton until mount, no hydration mismatch), screen-reader
  * friendly (role=timer stays silent; separate polite status per minute).
  */
-import { useEffect, useState, type CSSProperties } from 'react'
+import { useEffect, useRef, useState, type CSSProperties } from 'react'
 import { angelRuns } from '@meyvoid/core/angel'
-import { cn } from '../cn'
+import { diffParts, pad2, type CountdownParts } from '@meyvoid/core'
+import { cn } from '@meyvoid/core/cn'
 import {
   UNVEIL_AT,
-  diffParts,
   unveilDayLabel,
-  pad2,
-  type CountdownParts,
 } from '../unveil'
 
 export interface CultCountdownProps {
@@ -55,6 +53,52 @@ export function CultCountdown({
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [day, hour, minute])
 
+  // tier holds: landing in an angel tier freezes that exact display, then
+  // the real countdown resumes — pair 2s, trio 10s, all-equal full house
+  // 60s. Tier-4 non-matching never holds (glow only). Cooldown stops
+  // slow cells (11:11 for a minute) refreezing every hold; a higher live
+  // tier mid-hold upgrades (trio never swallows a full-house second).
+  // NOTE: hooks live above the early returns — hook order must never change.
+  const HOLD_MS: Record<number, number> = { 2: 2000, 3: 10000, 4: 60000 }
+  const [frozen, setFrozen] = useState<string[] | null>(null)
+  const [frozenMask, setFrozenMask] = useState<boolean[] | null>(null)
+  const freezing = useRef(false)
+  const cooldownTier = useRef(0)
+  const holdTimer = useRef<ReturnType<typeof setTimeout> | null>(null)
+  useEffect(() => () => {
+    if (holdTimer.current) clearTimeout(holdTimer.current)
+  }, [])
+  const startHold = (tier: number, disp: string[], mask: boolean[]) => {
+    if (holdTimer.current) clearTimeout(holdTimer.current)
+    freezing.current = true
+    setFrozen(disp)
+    setFrozenMask(mask)
+    holdTimer.current = setTimeout(() => {
+      freezing.current = false
+      cooldownTier.current = tier
+      setFrozen(null)
+      setFrozenMask(null)
+      holdTimer.current = null
+    }, HOLD_MS[tier])
+  }
+  useEffect(() => {
+    if (!parts || parts.done) return
+    const vals = [parts.days, parts.hours, parts.minutes, parts.seconds]
+    const disp = vals.map(pad2)
+    const mask = angelRuns(vals)
+    const liveTier = mask.filter(Boolean).length
+    const liveEqual = disp.every((d) => d === disp[0])
+    const holdable = liveTier >= 2 && (liveTier <= 3 || liveEqual)
+    if (liveTier < cooldownTier.current) cooldownTier.current = 0
+    if (freezing.current) {
+      const heldTier = (frozenMask ?? mask).filter(Boolean).length
+      if (liveTier > heldTier && holdable) startHold(liveTier, disp, mask)
+      return
+    }
+    if (holdable && liveTier > cooldownTier.current) startHold(liveTier, disp, mask)
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [parts])
+
   if (!parts) {
     return (
       <div aria-hidden="true" className={cn('animate-pulse', className)}>
@@ -71,22 +115,49 @@ export function CultCountdown({
     )
   }
 
+  const shown: string[] = frozen ?? [
+    pad2(parts.days),
+    pad2(parts.hours),
+    pad2(parts.minutes),
+    pad2(parts.seconds),
+  ]
+  const angels: boolean[] = frozenMask ?? angelRuns([parts.days, parts.hours, parts.minutes, parts.seconds])
   const cells: Array<[string, string]> = [
-    [pad2(parts.days), 'days'],
-    [pad2(parts.hours), 'hrs'],
-    [pad2(parts.minutes), 'min'],
-    [pad2(parts.seconds), 'sec'],
+    [shown[0], 'days'],
+    [shown[1], 'hrs'],
+    [shown[2], 'min'],
+    [shown[3], 'sec'],
   ]
-  // angel numbers glow yellow; everything else stays white
-  const angels = angelRuns([parts.days, parts.hours, parts.minutes, parts.seconds])
+  // angel numbers glow yellow; everything else stays white.
+  // a linking ':' glows only when both sides are angelic AND match (22:22, never 22:11).
+  // progressive tiers: pair glows, trio blazes, full house burns.
+  const tier = angels.filter(Boolean).length
+  const GLOW_PAIR = '0 0 24px rgba(255,230,0,0.45)'
+  const GLOW_TRIO =
+    '0 0 24px rgba(255,230,0,0.6), 0 0 64px rgba(255,230,0,0.35), 0 0 120px rgba(255,230,0,0.2)'
+  const GLOW_FULL =
+    '0 0 32px rgba(255,230,0,0.8), 0 0 90px rgba(255,230,0,0.45), 0 0 160px rgba(255,230,0,0.25)'
+  // NOTE: pair/trio/full intensities stay literal — GLOW.brandCult is the ambient
+  // brand glow; these are brighter presentation tiers for the countdown moment.
+  const tierGlow = tier >= 4 ? GLOW_FULL : tier === 3 ? GLOW_TRIO : GLOW_PAIR
   const digitStyle = (angelic: boolean): CSSProperties =>
     angelic
       ? {
           fontFamily: 'var(--font-cult)',
           color: 'var(--color-accent)',
-          textShadow: '0 0 24px rgba(255,230,0,0.45)',
+          textShadow: tierGlow,
         }
       : { fontFamily: 'var(--font-cult)', color: '#ffffff' }
+  const sepLinked = (i: number): boolean =>
+    angels[i] && angels[i + 1] && cells[i][0] === cells[i + 1][0]
+  const sepStyle = (linked: boolean): CSSProperties =>
+    linked
+      ? {
+          fontFamily: 'var(--font-cult)',
+          color: 'var(--color-accent)',
+          textShadow: tierGlow,
+        }
+      : { fontFamily: 'var(--font-cult)' }
 
   return (
     <div className={cn('text-center', className)}>
@@ -95,7 +166,11 @@ export function CultCountdown({
         aria-label={`Time until MeyCult Unveil, ${unveilDayLabel(resolved)}`}
         aria-live="off"
         aria-atomic="true"
-        className="flex items-start justify-center gap-2 sm:gap-4"
+        className={
+          tier >= 3
+            ? 'countdown-bob flex items-start justify-center gap-2 sm:gap-4'
+            : 'flex items-start justify-center gap-2 sm:gap-4'
+        }
       >
         {cells.map(([v, l], i) => (
           <div key={l} className="flex items-start gap-2 sm:gap-4">
@@ -106,7 +181,7 @@ export function CultCountdown({
               <div aria-hidden="true" className="ui-label text-text-muted mt-1">{l}</div>
             </div>
             {i < cells.length - 1 && (
-              <div aria-hidden="true" className="text-5xl sm:text-7xl text-accent/40" style={{ fontFamily: 'var(--font-cult)' }}>:</div>
+              <div aria-hidden="true" className="text-5xl sm:text-7xl text-accent/40" style={sepStyle(sepLinked(i))}>:</div>
             )}
           </div>
         ))}

package/src/game/categories.ts

@@ -0,0 +1,23 @@
+import { User, Globe, Trophy, Bitcoin, Building2, Landmark } from 'lucide-react'
+import type { Category, HeroType } from './types'
+
+/** Quest taxonomy — single source (was duplicated in Temple/QuestDetail).
+ * Hexes stay literal: no theme tokens exist for categories (P0 lock). */
+export const CATEGORY_COLORS: Record<Category, string> = {
+  POLITICS: '#3b82f6', TECH: '#8b5cf6', CRYPTO: '#f59e0b', SPORTS: '#22c55e', CULTURE: '#ec4899',
+  WORLD: '#dc2626', FINANCE: '#06b6d4', SCIENCE: '#6366f1', AI: '#d946ef', GAMING: '#84cc16', ENTERTAINMENT: '#f97316',
+}
+
+export const CATEGORY_LABELS: Record<Category, string> = {
+  POLITICS: 'Politics', TECH: 'Tech', CRYPTO: 'Crypto', SPORTS: 'Sports', CULTURE: 'Culture',
+  WORLD: 'World', FINANCE: 'Finance', SCIENCE: 'Science', AI: 'AI', GAMING: 'Gaming', ENTERTAINMENT: 'Entertainment',
+}
+
+export const HERO_TYPE_LABELS: Record<HeroType, { label: string; icon: typeof User }> = {
+  person: { label: 'People', icon: User },
+  nation: { label: 'Nations', icon: Globe },
+  sports_team: { label: 'Sports', icon: Trophy },
+  crypto: { label: 'Crypto', icon: Bitcoin },
+  corporation: { label: 'Corps', icon: Building2 },
+  organization: { label: 'Orgs', icon: Landmark },
+}

package/src/game/cults.ts

@@ -0,0 +1,88 @@
+import { COLORS } from '../tokens'
+import type { CultId, VirtueName } from './types'
+
+/** The four cults — single source. Merged from 5 page-local copies
+ * (Temple/QuestDetail/HeroProfile/Profile/Onboarding). Colors double as the
+ * canonical virtue palette (each cult is element-bound to one virtue). */
+export interface CultMeta {
+  id: CultId
+  name: string
+  element: string
+  description: string
+  color: string
+  virtue: VirtueName
+  virtueLabel: string
+  bonus: string
+}
+
+export const CULT_META: Record<CultId, CultMeta> = {
+  driftless: {
+    id: 'driftless',
+    name: 'The Driftless',
+    element: 'Air',
+    description: 'Empty, yet inexhaustible. Masters of detachment who see through the fog.',
+    color: '#06b6d4',
+    virtue: 'clarity',
+    virtueLabel: 'Clarity',
+    bonus: '+10% when holding positions untouched for a cycle',
+  },
+  leviathan: {
+    id: 'leviathan',
+    name: 'Leviathan',
+    element: 'Water',
+    description: 'Grace flows downward. The lowest place is the highest.',
+    color: '#3b82f6',
+    virtue: 'humility',
+    virtueLabel: 'Humility',
+    bonus: 'Grace Pool: tithe winnings for mercy on ruin',
+  },
+  masonry: {
+    id: 'masonry',
+    name: 'The Masonry',
+    element: 'Earth',
+    description: 'Bear and forbear. The ground does not flee the storm.',
+    color: '#f59e0b',
+    virtue: 'endurance',
+    virtueLabel: 'Endurance',
+    bonus: 'Grounding Lock: outcome-independent returns',
+  },
+  recurrence: {
+    id: 'recurrence',
+    name: 'The Recurrence',
+    element: 'Fire',
+    description: 'Burn, and become. Loss is the only fuel that matters.',
+    color: '#ef4444',
+    virtue: 'overcoming',
+    virtueLabel: 'Overcoming',
+    bonus: 'Will-to-Power: losses multiply future payout',
+  },
+}
+
+export const CULT_ORDER: CultId[] = ['driftless', 'leviathan', 'masonry', 'recurrence']
+
+export const VIRTUE_ORDER: VirtueName[] = ['clarity', 'humility', 'endurance', 'overcoming']
+
+/** Flat id→color map (Temple/HeroProfile shape). */
+export const CULT_COLORS: Record<CultId, string> = {
+  driftless: CULT_META.driftless.color,
+  leviathan: CULT_META.leviathan.color,
+  masonry: CULT_META.masonry.color,
+  recurrence: CULT_META.recurrence.color,
+}
+
+/** Fallback for unknown/uninitiated cult ids (was '#666'/'#6b7280' literals). */
+export const FALLBACK_CULT: CultMeta = {
+  id: 'driftless',
+  name: 'Uninitiated',
+  element: '',
+  description: 'Join a cult to unlock your powers.',
+  color: COLORS.textMuted,
+  virtue: 'clarity',
+  virtueLabel: '',
+  bonus: '',
+}
+
+/** Safe lookup — never undefined. */
+export function getCult(id: string): CultMeta {
+  return (CULT_META as Record<string, CultMeta>)[id] ?? FALLBACK_CULT
+}

package/src/game/quests.ts

@@ -0,0 +1,62 @@
+/** Shared quest-display formatters — single source (Temple impls win).
+ *
+ * Rarity language note — three separate tracks, do NOT merge:
+ * - Rarity (common/uncommon/rare/mythic): ITEM rarity (relics, loot).
+ * - rarityTier() (Common…Mythic + Refined/Shifting): QUEST density scale.
+ * - VirtueTierLabel (shifting/refined/uncommon/rare/mythic): VIRTUE tier names.
+ * Same words, different axes. The overlap is game lore, not a bug. */
+
+export interface DensityTier {
+  label: string
+  color: string
+}
+
+/** Quest density → tier (thresholds 85/60/40/25/15). Colors stay literal (P0 lock). */
+export function rarityTier(d: number): DensityTier {
+  if (d >= 85) return { label: 'Mythic', color: '#ef4444' }
+  if (d >= 60) return { label: 'Rare', color: '#f0c040' }
+  if (d >= 40) return { label: 'Uncommon', color: '#8b5cf6' }
+  if (d >= 25) return { label: 'Refined', color: '#3b82f6' }
+  if (d >= 15) return { label: 'Shifting', color: '#22c55e' }
+  return { label: 'Common', color: '#9ca3af' }
+}
+
+export function formatVolume(v: number): string {
+  if (v >= 1000000) return `${(v / 1000000).toFixed(1)}M`
+  if (v >= 1000) return `${(v / 1000).toFixed(0)}K`
+  return `${v}`
+}
+
+export interface Deadline {
+  text: string
+  urgent: boolean
+}
+
+/** Rich deadline (Temple impl): needs `now` for live ticking. */
+export function formatDeadline(closesIn: string, now: number): Deadline {
+  if (!closesIn) return { text: '', urgent: false }
+  const d = new Date(closesIn)
+  if (isNaN(d.getTime())) return { text: '', urgent: false }
+  const diff = d.getTime() - now
+  if (diff < 0) return { text: 'Closed', urgent: true }
+  const days = Math.floor(diff / 86400000)
+  const hours = Math.floor((diff % 86400000) / 3600000)
+  const mins = Math.floor((diff % 3600000) / 60000)
+  const secs = Math.floor((diff % 60000) / 1000)
+  if (days >= 2) return { text: `Closes ${d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })}`, urgent: false }
+  if (days >= 1) return { text: `Ends in ${days}d ${hours}h`, urgent: true }
+  if (hours >= 1) return { text: `Ends in ${hours}h ${mins}m`, urgent: true }
+  return { text: `Ends in ${mins}m ${secs}s`, urgent: true }
+}
+
+/** Short deadline string (QuestDetail impl): no `now` needed. */
+export function formatDeadlineShort(closesIn: string): string {
+  const d = new Date(closesIn)
+  if (isNaN(d.getTime())) return closesIn
+  const diff = d.getTime() - Date.now()
+  if (diff < 0) return 'Closed'
+  const days = Math.floor(diff / 86400000)
+  if (days > 0) return `${days}d remaining`
+  const hours = Math.floor(diff / 3600000)
+  return `${hours}h remaining`
+}

package/src/game/types.ts

@@ -0,0 +1,27 @@
+/** Shared Cult game types. App re-exports these from @/types (compat) —
+ * the game-specific remainder (Quest, Hero, Player, Wager, …) stays app-owned
+ * until a second brand needs it. */
+
+export type VirtueName = 'clarity' | 'humility' | 'endurance' | 'overcoming'
+
+export type Virtues = Record<VirtueName, number>
+
+export type VirtueXP = Record<VirtueName, number>
+
+export type VirtueTierLevel = 0 | 1 | 2 | 3
+
+export type VirtueTierLabel = 'shifting' | 'refined' | 'uncommon' | 'rare' | 'mythic'
+
+export type CultId = 'driftless' | 'leviathan' | 'masonry' | 'recurrence'
+
+export type Category = 'POLITICS' | 'TECH' | 'CRYPTO' | 'SPORTS' | 'CULTURE' | 'WORLD' | 'FINANCE' | 'SCIENCE' | 'AI' | 'GAMING' | 'ENTERTAINMENT'
+
+export type HeroType = 'person' | 'nation' | 'sports_team' | 'crypto' | 'corporation' | 'organization'
+
+export type PredictionResult = 'PENDING' | 'WON' | 'LOST'
+
+export type Rarity = 'common' | 'uncommon' | 'rare' | 'mythic'
+
+export type BadgeTier = 'bronze' | 'silver' | 'gold' | 'platinum'
+
+export type BadgeCategory = 'VIRTUE' | 'LOYALTY' | 'COLLECTION' | 'MARKET'