@orakl/shared 0.1.0

package/dist/constants/lobby.constants.js

@@ -0,0 +1,438 @@
+export const ADJECTIVES = [
+    // battle / strength
+    "iron",
+    "bold",
+    "grim",
+    "dire",
+    "fell",
+    "gale",
+    "war",
+    "wild",
+    "swift",
+    "keen",
+    "raw",
+    "dread",
+    "true",
+    "lone",
+    "blind",
+    "bright",
+    "cold",
+    "deep",
+    "far",
+    "last",
+    "old",
+    "pale",
+    "red",
+    "salt",
+    "dry",
+    "dark",
+    "dead",
+    // nature / elements
+    "ash",
+    "frost",
+    "gold",
+    "jade",
+    "oak",
+    "stone",
+    "wolf",
+    "crow",
+    "hawk",
+    "fog",
+    "ice",
+    "ember",
+    "dusk",
+    "dawn",
+    "moon",
+    "sun",
+    "storm",
+    "blood",
+    "bone",
+    "thorn",
+    "mud",
+    "dust",
+    "sand",
+    "clay",
+    "steel",
+    "smoke",
+    "snow",
+    "rain",
+    "wind",
+    "fire",
+    "earth",
+    "sea",
+    "sky",
+    "star",
+    "haze",
+    "mist",
+    // arcane / mythic
+    "sage",
+    "myth",
+    "rune",
+    "lost",
+    "cursed",
+    "fated",
+    "divine",
+    "hollow",
+    "elder",
+    "ever",
+    "vale",
+    "silver",
+    "ever",
+    "bright",
+    "dusk",
+    "night",
+    "veiled",
+    "cursed",
+    "sunken",
+    "ruined",
+    "broken",
+    "silent",
+    "risen",
+    "fallen",
+    "sealed",
+    "bound",
+    "unbound",
+    "woven",
+    "blessed",
+    "damned",
+    "marked",
+    "scorned",
+    "chosen",
+    "exiled",
+    "hidden",
+    "ancient",
+    "eternal",
+    "mortal",
+    "sacred",
+    "hollow",
+    "ashen",
+    "gilded",
+    "sundered",
+    "twisted",
+    "spectral",
+    "forsaken",
+    "hallowed",
+    "forlorn",
+    "withered",
+    "undying",
+    "blazing",
+    "frozen",
+    "thirsting",
+    "wandering",
+    "burning",
+    "howling",
+    "gleaming",
+    "shattered",
+    "crumbling",
+    "haunted",
+    "dreaded",
+    "crimson",
+    "verdant",
+    "obsidian",
+    "ivory",
+    "scarlet",
+    "amber",
+    "violet",
+    "golden",
+    "silver",
+    "cobalt",
+    "onyx",
+    "sapphire",
+    "jade",
+    "pearl",
+    "copper",
+    // oracle / fate
+    "veiled",
+    "fated",
+    "omen",
+    "unseen",
+    "dreaming",
+    "waking",
+    "knowing",
+    "seeking",
+    "watching",
+    "wandering",
+    "waiting",
+    "silent",
+    "echoing",
+];
+export const NOUNS = [
+    // places
+    "den",
+    "gate",
+    "ridge",
+    "peak",
+    "vale",
+    "isle",
+    "keep",
+    "bridge",
+    "cliff",
+    "grove",
+    "cairn",
+    "citadel",
+    "crypt",
+    "spire",
+    "tower",
+    "lair",
+    "hollow",
+    "nexus",
+    "path",
+    "rift",
+    "root",
+    "way",
+    "edge",
+    "fall",
+    "rise",
+    "mound",
+    "barrow",
+    "ford",
+    "pass",
+    "shore",
+    "strand",
+    "heath",
+    "moor",
+    "marsh",
+    "delta",
+    "crater",
+    "basin",
+    "canyon",
+    "ravine",
+    "gorge",
+    "chasm",
+    "inlet",
+    "haven",
+    "harbor",
+    "port",
+    "reef",
+    "shoal",
+    "bluff",
+    "mesa",
+    // objects / relics
+    "forge",
+    "crown",
+    "vault",
+    "rune",
+    "mark",
+    "seal",
+    "crest",
+    "ward",
+    "flame",
+    "glyph",
+    "lore",
+    "oath",
+    "relic",
+    "shard",
+    "altar",
+    "anvil",
+    "ark",
+    "axe",
+    "bell",
+    "blade",
+    "chain",
+    "cipher",
+    "coil",
+    "dirge",
+    "echo",
+    "effigy",
+    "exile",
+    "eye",
+    "fang",
+    "fate",
+    "foe",
+    "gaze",
+    "grave",
+    "grief",
+    "helm",
+    "herald",
+    "horn",
+    "hymn",
+    "idol",
+    "key",
+    "lantern",
+    "law",
+    "omen",
+    "oracle",
+    "pyre",
+    "quest",
+    "ruin",
+    "saga",
+    "scar",
+    "scribe",
+    "sigil",
+    "skull",
+    "soul",
+    "star",
+    "stone",
+    "storm",
+    "throne",
+    "tomb",
+    "torch",
+    "veil",
+    "vigil",
+    "vow",
+    "wrath",
+    "wisp",
+    "warden",
+    "wolf",
+    "iron",
+    "urn",
+    "mist",
+    "tide",
+    "nexus",
+    "shard",
+    "arrow",
+    "bow",
+    "coin",
+    "compass",
+    "crown",
+    "cup",
+    "dagger",
+    "drum",
+    "dust",
+    "feather",
+    "gem",
+    "hook",
+    "ink",
+    "lens",
+    "map",
+    "mask",
+    "mirror",
+    "needle",
+    "net",
+    "pillar",
+    "plume",
+    "ring",
+    "rod",
+    "rope",
+    "scroll",
+    "shield",
+    "spark",
+    "spear",
+    "staff",
+    "standard",
+    "stone",
+    "sword",
+    "talisman",
+    "thread",
+    "tooth",
+    "vial",
+    "wand",
+    "wheel",
+    "wing",
+    // mythic / abstract
+    "age",
+    "abyss",
+    "arc",
+    "ash",
+    "augur",
+    "bane",
+    "beacon",
+    "blood",
+    "call",
+    "chronicle",
+    "covenant",
+    "curse",
+    "dawn",
+    "decree",
+    "dominion",
+    "doom",
+    "dusk",
+    "dynasty",
+    "eclipse",
+    "epoch",
+    "edict",
+    "ember",
+    "end",
+    "fall",
+    "fire",
+    "fracture",
+    "fury",
+    "gale",
+    "glory",
+    "grace",
+    "herald",
+    "horizon",
+    "hunger",
+    "hymn",
+    "legacy",
+    "legend",
+    "light",
+    "lore",
+    "mantle",
+    "memory",
+    "mercy",
+    "moon",
+    "myth",
+    "night",
+    "oath",
+    "order",
+    "origin",
+    "pact",
+    "passage",
+    "peace",
+    "plague",
+    "pride",
+    "prophecy",
+    "realm",
+    "rebirth",
+    "requiem",
+    "rise",
+    "rite",
+    "sanctum",
+    "shadow",
+    "silence",
+    "sin",
+    "sky",
+    "song",
+    "sorrow",
+    "soul",
+    "sovereignty",
+    "sun",
+    "tempest",
+    "tide",
+    "truth",
+    "twilight",
+    "undoing",
+    "union",
+    "void",
+    "war",
+    "watch",
+    "wave",
+    "wisdom",
+    "world",
+    "wound",
+    "zenith",
+    "zeal",
+    // creatures
+    "asp",
+    "basilisk",
+    "bear",
+    "boar",
+    "bull",
+    "cobra",
+    "crane",
+    "crow",
+    "dragon",
+    "eagle",
+    "falcon",
+    "fox",
+    "hound",
+    "hydra",
+    "kraken",
+    "lion",
+    "lynx",
+    "manticore",
+    "moth",
+    "owl",
+    "phoenix",
+    "raven",
+    "serpent",
+    "sphinx",
+    "stag",
+    "swan",
+    "tiger",
+    "viper",
+    "vulture",
+    "whale",
+    "wyvern",
+];

package/dist/constants/patterns.constants.d.ts

@@ -0,0 +1,4 @@
+/** Hex color: #RGB, #RGBA, #RRGGBB, #RRGGBBAA */
+export declare const HEX_COLOR_RE: RegExp;
+/** Matches all HTML tags, including unclosed ones */
+export declare const HTML_TAGS_RE: RegExp;

package/dist/constants/patterns.constants.js

@@ -0,0 +1,4 @@
+/** Hex color: #RGB, #RGBA, #RRGGBB, #RRGGBBAA */
+export const HEX_COLOR_RE = /^#([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+/** Matches all HTML tags, including unclosed ones */
+export const HTML_TAGS_RE = /<[^>]*>|<[^\s>]*/g;

package/dist/constants/theme.constants.d.ts

@@ -0,0 +1,24 @@
+import type { SkyPhase, ThemeMode } from "../theme.ts";
+export declare const THEME_COOKIE = "orakl-theme";
+export declare const SYSTEM_PREF_COOKIE = "orakl-system-pref";
+export declare const DEFAULT_THEME: ThemeMode;
+export declare const SKY_SCHEDULE: Record<SkyPhase, [number, number]>;
+export declare const LOGO_SCHEDULE: Record<SkyPhase, "dark" | "light">;
+/** Per-phase background element configuration — single source of truth. */
+export declare const PHASE_CONFIG: Record<SkyPhase, {
+    /** Canvas opacity for the stars layer (0 = hidden). */
+    starOpacity: number;
+    /** Number of fireflies (0 = none). Component halves this on mobile. */
+    fireflyCount: number;
+    /** Canvas opacity for the birds layer (0 = hidden). */
+    birdOpacity: number;
+    /** Whether to render the sky gradient (false = solid night). */
+    showSky: boolean;
+}>;
+export declare const SKY_PHASES: SkyPhase[];
+/** Human-readable labels. */
+export declare const THEME_LABELS: Record<ThemeMode, string>;
+/** Time ranges for the UI. */
+export declare const PHASE_TIMES: Record<SkyPhase, string>;
+/** Representative gradient colours [top, bottom] for phase swatches. */
+export declare const PHASE_COLORS: Record<SkyPhase, [string, string]>;

package/dist/constants/theme.constants.js

@@ -0,0 +1,69 @@
+export const THEME_COOKIE = "orakl-theme";
+export const SYSTEM_PREF_COOKIE = "orakl-system-pref";
+export const DEFAULT_THEME = "dark";
+// Configurable schedule: [startHour, endHour) in 24h local time.
+// Night wraps around midnight: start > end means [start, 24) ∪ [0, end).
+export const SKY_SCHEDULE = {
+    dawn: [5, 7],
+    morning: [7, 11],
+    noon: [11, 14],
+    evening: [14, 17],
+    sunset: [17, 19],
+    dusk: [19, 22],
+    night: [22, 5],
+};
+// Show dark or light logo variant depending on the phase, for better contrast.
+export const LOGO_SCHEDULE = {
+    night: "light",
+    dawn: "light",
+    dusk: "light",
+    sunset: "dark",
+    morning: "dark",
+    noon: "dark",
+    evening: "dark",
+};
+/** Per-phase background element configuration — single source of truth. */
+export const PHASE_CONFIG = {
+    night: { starOpacity: 1.0, fireflyCount: 0, birdOpacity: 0, showSky: false },
+    dawn: { starOpacity: 0.85, fireflyCount: 0, birdOpacity: 0, showSky: true },
+    morning: { starOpacity: 0, fireflyCount: 0, birdOpacity: 1, showSky: true },
+    noon: { starOpacity: 0, fireflyCount: 0, birdOpacity: 1, showSky: true },
+    evening: { starOpacity: 0, fireflyCount: 0, birdOpacity: 1, showSky: true },
+    sunset: { starOpacity: 0, fireflyCount: 0, birdOpacity: 0, showSky: true },
+    dusk: { starOpacity: 0.6, fireflyCount: 20, birdOpacity: 0, showSky: true },
+};
+export const SKY_PHASES = Object.keys(SKY_SCHEDULE);
+/** Human-readable labels. */
+export const THEME_LABELS = {
+    dark: "Dark",
+    light: "Light",
+    system: "System",
+    dynamic: "Dynamic",
+    night: "Night",
+    dawn: "Dawn",
+    morning: "Morning",
+    noon: "Noon",
+    evening: "Evening",
+    sunset: "Sunset",
+    dusk: "Dusk",
+};
+/** Time ranges for the UI. */
+export const PHASE_TIMES = {
+    night: "10pm–5am",
+    dawn: "5am–7am",
+    morning: "7am–11am",
+    noon: "11am–2pm",
+    evening: "2pm–5pm",
+    sunset: "5pm–7pm",
+    dusk: "7pm–10pm",
+};
+/** Representative gradient colours [top, bottom] for phase swatches. */
+export const PHASE_COLORS = {
+    night: ["#07080f", "#0E0D18"],
+    dawn: ["#1e2d4e", "#f4b393"],
+    morning: ["#c9d6e3", "#dde8f0"],
+    noon: ["#1a80c4", "#87ceeb"],
+    evening: ["#4a7fa5", "#f9c06a"],
+    sunset: ["#6b2d2d", "#f8dbd8"],
+    dusk: ["#1a2240", "#c9a0a0"],
+};

package/dist/env.d.ts

@@ -0,0 +1,3 @@
+/** True when NODE_ENV is "production", read at call time (not memoised: some
+ *  callers set the env var before this is first called). */
+export declare function isProduction(): boolean;

package/dist/env.js

@@ -0,0 +1,5 @@
+/** True when NODE_ENV is "production", read at call time (not memoised: some
+ *  callers set the env var before this is first called). */
+export function isProduction() {
+    return process.env.NODE_ENV === "production";
+}

package/dist/font.d.ts

@@ -0,0 +1,4 @@
+export { DEFAULT_FONT, FONT_COOKIE, FONT_DESCRIPTIONS, FONT_LABELS, FONT_PREFERENCES, } from "./constants/font.constants.ts";
+/** Reader typeface preference. `dyslexic` swaps every family for OpenDyslexic. */
+export type FontPreference = "default" | "dyslexic";
+export declare function parseFont(value: string | undefined): FontPreference;

package/dist/font.js

@@ -0,0 +1,8 @@
+import { DEFAULT_FONT, FONT_PREFERENCES } from "./constants/font.constants.js";
+export { DEFAULT_FONT, FONT_COOKIE, FONT_DESCRIPTIONS, FONT_LABELS, FONT_PREFERENCES, } from "./constants/font.constants.js";
+const VALID_FONTS = new Set(FONT_PREFERENCES);
+export function parseFont(value) {
+    if (value && VALID_FONTS.has(value))
+        return value;
+    return DEFAULT_FONT;
+}

package/dist/history-range.d.ts

@@ -0,0 +1,13 @@
+export declare const HISTORY_RANGES: readonly ["all", "30d", "7d"];
+export type HistoryRange = (typeof HISTORY_RANGES)[number];
+/** `rangeParam` if it names a known range, else "all" (the default). */
+export declare function parseHistoryRange(rangeParam: string | null): HistoryRange;
+/**
+ * Date floor for `range`, in the shape each port's date column needs:
+ * `gamesSince` for game_sessions.started_at, `soloSince` for
+ * solo_sessions.completed_at. Both absent for "all" (no floor).
+ */
+export declare function rangeFloor(range: HistoryRange, now: number): {
+    gamesSince?: string;
+    soloSince?: number;
+};

package/dist/history-range.js

@@ -0,0 +1,29 @@
+export const HISTORY_RANGES = ["all", "30d", "7d"];
+/** `rangeParam` if it names a known range, else "all" (the default). */
+export function parseHistoryRange(rangeParam) {
+    return HISTORY_RANGES.includes(rangeParam ?? "")
+        ? rangeParam
+        : "all";
+}
+const DAY_MS = 24 * 60 * 60 * 1000;
+/** Days back from `now` for each non-"all" range. */
+const RANGE_DAYS = {
+    "30d": 30,
+    "7d": 7,
+};
+/** `now` (epoch ms) as a SQLite `datetime('now')`-shaped UTC string, matching
+ *  game_sessions.started_at so the two can compare with `>=`. */
+function toGamesSince(now) {
+    return new Date(now).toISOString().slice(0, 19).replace("T", " ");
+}
+/**
+ * Date floor for `range`, in the shape each port's date column needs:
+ * `gamesSince` for game_sessions.started_at, `soloSince` for
+ * solo_sessions.completed_at. Both absent for "all" (no floor).
+ */
+export function rangeFloor(range, now) {
+    if (range === "all")
+        return {};
+    const floor = now - RANGE_DAYS[range] * DAY_MS;
+    return { gamesSince: toGamesSince(floor), soloSince: floor };
+}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export * from "./analytics.ts";
+export * from "./avatar-helpers.ts";
+export * from "./avatars.ts";
+export * from "./badges.ts";
+export * from "./constants/feature-flags.constants.ts";
+export * from "./constants/lobby.constants.ts";
+export * from "./constants/patterns.constants.ts";
+export * from "./env.ts";
+export * from "./font.ts";
+export * from "./history-range.ts";
+export * from "./lobby.ts";
+export * from "./manage-questions.ts";
+export * from "./math.ts";
+export { murmurhash } from "./murmurhash.ts";
+export * from "./pricing.ts";
+export * from "./profile-tabs.ts";
+export * from "./quiz-routes.ts";
+export * from "./sanitize.ts";
+export * from "./schemas/question.schema.ts";
+export * from "./solo-entitlements.ts";
+export * from "./theme.ts";
+export * from "./types/auth.ts";
+export * from "./utils.ts";

package/dist/index.js

@@ -0,0 +1,26 @@
+export * from "./analytics.js";
+export * from "./avatar-helpers.js";
+export * from "./avatars.js";
+export * from "./badges.js";
+export * from "./constants/feature-flags.constants.js";
+export * from "./constants/lobby.constants.js";
+export * from "./constants/patterns.constants.js";
+export * from "./env.js";
+// font.ts re-exports every constants/font.constants.ts symbol.
+export * from "./font.js";
+export * from "./history-range.js";
+export * from "./lobby.js";
+export * from "./manage-questions.js";
+export * from "./math.js";
+export { murmurhash } from "./murmurhash.js";
+export * from "./pricing.js";
+export * from "./profile-tabs.js";
+export * from "./quiz-routes.js";
+export * from "./sanitize.js";
+export * from "./schemas/question.schema.js";
+export * from "./solo-entitlements.js";
+// theme.ts re-exports every constants/theme.constants.ts symbol.
+export * from "./theme.js";
+// types/auth.ts re-exports every constants/auth.constants.ts symbol.
+export * from "./types/auth.js";
+export * from "./utils.js";

package/dist/lobby.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Deterministic lobby code from quiz name + category IDs.
+ * Same name + same categories always produces the same adj-noun code.
+ */
+export declare function generateLobbyCode(name: string, categoryIds: readonly string[]): string;
+/**
+ * Finds the player with the given id in a player list.
+ * Returns the first match, or undefined when no player has that id.
+ */
+export declare function findPlayer<T extends {
+    id: string;
+}>(players: readonly T[], id: string | null): T | undefined;
+/**
+ * Random lobby code for tests / fallback when no quiz meta is available.
+ */
+export declare function generateRandomLobbyCode(existingCodes?: Set<string>): string;