@meycult/core 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 MeyCult
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# @meycult/core
+
+Shared core for the MeyCult monorepo — single source of truth for theme, brand,
+Supabase/auth factories, and lib helpers. **Source-only, no build step.**
+Consumers compile it in-process (`transpilePackages` in web, direct Vite import in app).
+
+## Consume
+
+```ts
+import { Sigil, Logo, BrandName, LaunchButton, CornerGlow } from '@meycult/core'
+import { COLORS } from '@meycult/core/tokens'
+import { cn } from '@meycult/core/cn'
+```
+
+```css
+/* app entry CSS (web/src/app/globals.css, app/src/index.css) */
+@import "@meycult/core/styles/theme.css";
+@source "../../../core/src"; /* Tailwind v4 class detection — path relative to the CSS file */
+```
+
+```ts
+// next.config.ts (web only)
+transpilePackages: ['@meycult/core']
+```
+
+## What's inside
+
+| Path | Owns |
+|---|---|
+| `styles/theme.css` | Full yellow theme: `@theme` tokens, base, utilities, `.brand-cult`, corner glows, sections, cards. Self-hosts New Rocker via `@font-face` (`--font-cult`) — identical in Next.js and Vite |
+| `fonts/` | `NewRocker-Regular.woff2` (self-hosted, no Google Fonts request) |
+| `tokens.ts` | TS mirror (`COLORS`, `GLOW`, `FONTS`) for canvas/tests |
+| `brand/` | `Sigil`, `Logo`, `BrandName`, `TokenIcons` (`basePath` prop, default `/products`), `LaunchButton`, `CornerGlow`, `GodEmperorBrand` |
+| `ui/` | `card`, `shimmer-button`, `animated-shiny-text`, `Callout` (react/cn/lucide only — no motion/cva/radix) |
+| `shell/types.ts` | `NavLink`, injectable `LinkComponent` (next/link vs react-router) |
+| `supabase/` | `browser` (chunked cross-subdomain cookies), `server` + `proxy` + `callback` (Next.js) |
+| `auth/` | `SessionProfile`, framework-free `RequireAuth` gate |
+| `lib/` | `formatPrice(cents, currency)`, `isAbsoluteUrl`/`resolveImage`, `createPersistStore` (zustand) |
+
+## Conventions (match @meygod/core, @meybuddy/core)
+
+- `main`/`types` point at `./src/index.ts` — never build, never publish.
+- Every new module must be re-exported from `src/index.ts`.
+- Brand PNGs (`influence.png`, `fate.png`) stay in each host's `public/products/`.
+- `pnpm --filter @meycult/core typecheck`

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@meycult/core",
+  "version": "0.1.0",
+  "private": false,
+  "description": "MeyCult shared core — yellow theme, brand, supabase/auth factories, lib. Source-only, no build.",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/meyvoid/meycult/core-ts.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public",
+    "provenance": true
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "files": [
+    "src"
+  ],
+  "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",
+    "./styles/theme.css": "./src/styles/theme.css"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "release": "bash scripts/release.sh"
+  },
+  "dependencies": {
+    "@meyvoid/core": "^0.1.0",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.6.0",
+    "zustand": "^5.0.14"
+  },
+  "peerDependencies": {
+    "@supabase/ssr": "^0.5.0",
+    "@supabase/supabase-js": "^2.110.0",
+    "lucide-react": "^1.23.0",
+    "react": "19.2.8",
+    "react-dom": "19.2.8"
+  },
+  "peerDependenciesMeta": {
+    "@supabase/ssr": {
+      "optional": true
+    },
+    "lucide-react": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@supabase/ssr": "^0.5.0",
+    "@supabase/supabase-js": "^2.110.0",
+    "@types/node": "^24.13.2",
+    "@types/qrcode": "^1.5.6",
+    "@types/react": "^19.2.3",
+    "@types/react-dom": "^19.2.3",
+    "next": "^15.4.0",
+    "typescript": "~6.0.2"
+  }
+}

package/src/auth/Gate.tsx

@@ -0,0 +1,14 @@
+import type { RequireAuthProps } from './types'
+
+/** Framework-free auth gate — host passes user/loading from its own auth wiring. */
+export function RequireAuth({
+  user,
+  loading,
+  loadingFallback = null,
+  loginFallback = null,
+  children,
+}: RequireAuthProps) {
+  if (loading) return <>{loadingFallback}</>
+  if (!user) return <>{loginFallback}</>
+  return <>{children}</>
+}

package/src/auth/types.ts

@@ -0,0 +1,12 @@
+export interface SessionProfile {
+  id: string
+  email?: string | null
+}
+
+export interface RequireAuthProps {
+  user: SessionProfile | null
+  loading: boolean
+  loadingFallback?: React.ReactNode
+  loginFallback?: React.ReactNode
+  children: React.ReactNode
+}

package/src/brand/BrandName.tsx

@@ -0,0 +1,12 @@
+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)',
+      }}>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)',
+      }}>Cult</span>
+    </span>
+  )
+}

package/src/brand/CornerGlow.tsx

@@ -0,0 +1,14 @@
+'use client'
+
+export default function CornerGlow() {
+  return (
+    <>
+      <div className="corner-glow corner-glow--tl" />
+      <div className="corner-glow corner-glow--tr" />
+      <div className="corner-glow corner-glow--bl" />
+      <div className="corner-glow corner-glow--br" />
+      <div className="corner-glow corner-glow--ct" />
+      <div className="corner-glow corner-glow--cb" />
+    </>
+  )
+}

package/src/brand/CultEye.tsx

@@ -0,0 +1,14 @@
+'use client'
+
+/**
+ * CultEye — MeyCult hero eye. Thin preset over MeyEye (variant="cult");
+ * tracking math, blink, and positions come from @meyvoid/core geometry.
+ */
+import { MeyEye, type MeyEyeProps } from '@meyvoid/core/eye'
+
+export default function CultEye(props: Omit<MeyEyeProps, 'variant'>) {
+  return <MeyEye variant="cult" label="MeyCult watchful eye" {...props} />
+}
+
+export { GazeProvider, useGaze } from '@meyvoid/core/eye'
+export type { EyeVariant } from '@meyvoid/core/eye'

package/src/brand/GodEmperor.tsx

@@ -0,0 +1,8 @@
+export default function GodEmperorBrand() {
+  return (
+    <span style={{ fontFamily: 'var(--font-logo)', fontWeight: 700, textTransform: 'none' }}>
+      <span style={{ color: '#ffffff' }}>God</span>
+      <span style={{ color: 'var(--color-premium-400)' }}>Emperor</span>
+    </span>
+  )
+}

package/src/brand/LaunchButton.tsx

@@ -0,0 +1,27 @@
+interface LaunchButtonProps {
+  label?: string
+  href?: string
+  className?: string
+  small?: boolean
+}
+
+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)' }}>
+      <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)',
+          color: '#ffffff',
+          boxShadow: '0 0 80px rgba(255,230,0,0.08), 0 0 120px rgba(255,230,0,0.05)',
+        }}
+      >
+        <span style={{ fontFamily: 'var(--font-logo)', fontWeight: 700 }}>{label} </span>
+        <span className="brand-mey" style={{ textTransform: 'none', color: '#ffffff' }}>Mey</span>
+        <span className="brand-cult" style={{ fontWeight: 700 }}>Cult</span>
+      </a>
+    </span>
+  )
+}

package/src/brand/Logo.tsx

@@ -0,0 +1,24 @@
+import Sigil from './Sigil'
+
+export default function Logo({ size = 24, className }: { size?: number; className?: string }) {
+  return (
+    <a 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>
+        </div>
+        <div
+          className="text-[10px] uppercase tracking-widest mt-0.5"
+          style={{ color: 'var(--color-text-muted)', fontFamily: 'var(--font-logo)' }}
+        >
+          Wager &amp; Join
+        </div>
+      </div>
+    </a>
+  )
+}

package/src/brand/Sigil.tsx

@@ -0,0 +1,28 @@
+export default function Sigil({ size = 24 }: { size?: number }) {
+  const s = size * 1.5
+
+  return (
+    <svg
+      width={s}
+      viewBox="0 0 200.56923 175.72475"
+      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"
+          />
+        </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"
+        />
+        <path
+          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

@@ -0,0 +1,48 @@
+export interface TokenIconProps {
+  size?: number
+  /** Asset base — host's public dir mount. Defaults to '/products'. */
+  basePath?: string
+  className?: string
+}
+
+export function InfluenceIcon({ size = 14, basePath = '/products', className }: TokenIconProps) {
+  return (
+    <img
+      src={`${basePath}/influence.png`}
+      alt=""
+      className={className ? `inline-block align-middle ${className}` : 'inline-block align-middle'}
+      style={{ width: size, height: size }}
+    />
+  )
+}
+
+export function FateIcon({ size = 14, basePath = '/products', className }: TokenIconProps) {
+  return (
+    <img
+      src={`${basePath}/fate.png`}
+      alt=""
+      className={className ? `inline-block align-middle ${className}` : 'inline-block align-middle'}
+      style={{ width: size, height: size }}
+    />
+  )
+}
+
+export function InfluenceText({ size = 13, basePath = '/products' }: TokenIconProps) {
+  return (
+    <span style={{ fontFamily: 'var(--font-logo)', fontWeight: 700, whiteSpace: 'nowrap' }}>
+      <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) {
+  return (
+    <span style={{ fontFamily: 'var(--font-logo)', fontWeight: 700, whiteSpace: 'nowrap' }}>
+      <FateIcon size={size} basePath={basePath} />{' '}
+      <span className="brand-mey">Mey</span>
+      <span style={{ color: 'var(--color-accent)' }}>Fate</span>
+    </span>
+  )
+}

package/src/brand.ts

@@ -0,0 +1,7 @@
+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

package/src/cn.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]): string {
+  return twMerge(clsx(...inputs))
+}

package/src/components/CultCountdown.tsx

@@ -0,0 +1,119 @@
+'use client'
+
+/**
+ * CultCountdown — ticking DD:HH:MM:SS to UNVEIL_AT.
+ * 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 { angelRuns } from '@meyvoid/core/angel'
+import { cn } from '../cn'
+import {
+  UNVEIL_AT,
+  diffParts,
+  unveilDayLabel,
+  pad2,
+  type CountdownParts,
+} from '../unveil'
+
+export interface CultCountdownProps {
+  target?: number
+  className?: string
+  doneLabel?: string
+}
+
+export function CultCountdown({
+  target,
+  className,
+  doneLabel = 'THE VEIL LIFTS',
+}: CultCountdownProps) {
+  const resolved = target ?? UNVEIL_AT
+  const [parts, setParts] = useState<CountdownParts | null>(null)
+
+  useEffect(() => {
+    setParts(diffParts(resolved))
+    const id = setInterval(() => setParts(diffParts(resolved)), 1000)
+    const onVis = () => {
+      if (!document.hidden) setParts(diffParts(resolved))
+    }
+    document.addEventListener('visibilitychange', onVis)
+    return () => {
+      clearInterval(id)
+      document.removeEventListener('visibilitychange', onVis)
+    }
+  }, [resolved])
+
+  const [srMinute, setSrMinute] = useState('')
+  const day = parts?.days ?? -1
+  const hour = parts?.hours ?? -1
+  const minute = parts?.minutes ?? -1
+  useEffect(() => {
+    if (!parts || parts.done) return
+    setSrMinute(
+      `${parts.days} days, ${parts.hours} hours, ${parts.minutes} minutes until the Unveil`,
+    )
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [day, hour, minute])
+
+  if (!parts) {
+    return (
+      <div aria-hidden="true" className={cn('animate-pulse', className)}>
+        <div className="text-5xl tracking-widest text-accent/40" style={{ fontFamily: 'var(--font-cult)' }}>00:00:00:00</div>
+      </div>
+    )
+  }
+
+  if (parts.done) {
+    return (
+      <div role="alert" className={cn('text-center', className)}>
+        <p className="text-5xl tracking-widest text-accent" style={{ fontFamily: 'var(--font-cult)' }}>{doneLabel}</p>
+      </div>
+    )
+  }
+
+  const cells: Array<[string, string]> = [
+    [pad2(parts.days), 'days'],
+    [pad2(parts.hours), 'hrs'],
+    [pad2(parts.minutes), 'min'],
+    [pad2(parts.seconds), 'sec'],
+  ]
+  // angel numbers glow yellow; everything else stays white
+  const angels = angelRuns([parts.days, parts.hours, parts.minutes, parts.seconds])
+  const digitStyle = (angelic: boolean): CSSProperties =>
+    angelic
+      ? {
+          fontFamily: 'var(--font-cult)',
+          color: 'var(--color-accent)',
+          textShadow: '0 0 24px rgba(255,230,0,0.45)',
+        }
+      : { fontFamily: 'var(--font-cult)', color: '#ffffff' }
+
+  return (
+    <div className={cn('text-center', className)}>
+      <div
+        role="timer"
+        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"
+      >
+        {cells.map(([v, l], i) => (
+          <div key={l} className="flex items-start gap-2 sm:gap-4">
+            <div>
+              <div aria-hidden="true" className="text-5xl sm:text-7xl font-bold tracking-wider" style={digitStyle(angels[i])}>
+                {v}
+              </div>
+              <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>
+        ))}
+      </div>
+      <span role="status" aria-live="polite" className="sr-only">
+        {srMinute}
+      </span>
+    </div>
+  )
+}

package/src/index.ts

@@ -0,0 +1,61 @@
+export { cn } from './cn'
+export { COLORS, GLOW, FONTS } from './tokens'
+export { BRAND } from './brand'
+
+export { default as Sigil } from './brand/Sigil'
+export { default as CultEye, GazeProvider, useGaze } from './brand/CultEye'
+export { default as Logo } from './brand/Logo'
+export { default as BrandName } from './brand/BrandName'
+export {
+  InfluenceIcon,
+  FateIcon,
+  InfluenceText,
+  FateText,
+} from './brand/TokenIcons'
+export { default as LaunchButton } from './brand/LaunchButton'
+export { default as CornerGlow } from './brand/CornerGlow'
+export { default as GodEmperorBrand } from './brand/GodEmperor'
+
+export { Card } from './ui/card'
+export { CultCountdown } from './components/CultCountdown'
+export {
+  UNVEIL_AT,
+  UNVEIL_TZ,
+  LIVE_WINDOW_MS,
+  unveilPhase,
+  unveilDayLabel,
+  unveilLocalLabel,
+  diffParts,
+} from './unveil'
+export type { UnveilPhase, CountdownParts } from './unveil'
+export { LaunchStage } from './unveil/LaunchStage'
+export {
+  UnveilHero,
+  WhereWhen,
+  CardGrid,
+  HypeRow,
+  NotifyPanel,
+} from './unveil/blocks'
+export type { WhereWhenProps, UnveilCard } from './unveil/blocks'
+export { TabletPanel } from './unveil/Tablet'
+export { useUnveilBg, BG_EFFECTS, BG_DEFAULTS, parseBgQuery } from './unveil/bg'
+export type { BgEffect } from './unveil/bg'
+export { ShimmerButton } from './ui/shimmer-button'
+export { AnimatedShinyText } from './ui/animated-shiny-text'
+export { Callout } from './ui/Callout'
+
+export type { NavLink, LinkComponent } from './shell/types'
+
+export { createSupabaseBrowser, chunkedCookieStorage } from './supabase/browser'
+// NOTE: server-only helpers (next/headers, next/server) are intentionally
+// NOT re-exported here — the barrel ships to client components. Deep-import:
+//   import { createSupabaseServerClient } from '@meycult/core/supabase/server'
+//   import { updateSession } from '@meycult/core/supabase/proxy'
+//   import { exchangeCodeForSession } from '@meycult/core/supabase/callback'
+
+export type { SessionProfile } from './auth/types'
+export { RequireAuth } from './auth/Gate'
+
+export { formatPrice } from './lib/money'
+export { isAbsoluteUrl, resolveImage } from './lib/images'
+export { createPersistStore } from './lib/store'

package/src/lib/images.ts

@@ -0,0 +1,10 @@
+export function isAbsoluteUrl(src: string): boolean {
+  return /^https?:\/\//.test(src) || src.startsWith('data:') || src.startsWith('blob:')
+}
+
+/** Resolve a product/asset src against an optional storage base. */
+export function resolveImage(src: string, base?: string): string {
+  if (!src) return src
+  if (isAbsoluteUrl(src) || !base) return src
+  return `${base.replace(/\/$/, '')}/${src.replace(/^\//, '')}`
+}

package/src/lib/money.ts

@@ -0,0 +1,12 @@
+const SYMBOLS: Record<string, string> = {
+  USD: '$',
+  ZAR: 'R',
+  EUR: '€',
+  GBP: '£',
+}
+
+/** Format integer minor units (cents) — e.g. formatPrice(1999) → '$19.99'. */
+export function formatPrice(cents: number, currency = 'USD'): string {
+  const symbol = SYMBOLS[currency] ?? `${currency} `
+  return `${symbol}${(cents / 100).toFixed(2)}`
+}

package/src/lib/store.ts

@@ -0,0 +1,19 @@
+import { create, type StateCreator } from 'zustand'
+import { persist, type PersistOptions } from 'zustand/middleware'
+
+/** Persisted zustand store with a stable shape — mirrors the meybuddy store pattern. */
+export function createPersistStore<T>(
+  name: string,
+  version: number,
+  initializer: StateCreator<T, [], []>,
+  options?: Partial<PersistOptions<T, T>>,
+) {
+  return create<T>()(
+    persist(initializer, {
+      name,
+      version,
+      skipHydration: true,
+      ...options,
+    }),
+  )
+}

package/src/shell/types.ts

@@ -0,0 +1,13 @@
+import type { ComponentType, AnchorHTMLAttributes } from 'react'
+
+export interface NavLink {
+  label: string
+  href: string
+  external?: boolean
+  branded?: boolean
+}
+
+/** Injectable link — host passes next/link (web) or react-router Link (app). Defaults to <a>. */
+export type LinkComponent = ComponentType<
+  AnchorHTMLAttributes<HTMLAnchorElement> & { href: string }
+>