forge-openclaw-plugin 0.2.24 → 0.2.26

package/dist/server/src/lib/snapshot-normalizer.js

@@ -0,0 +1,374 @@
+const EMPTY_CALENDAR_RULES = {
+    allowWorkBlockKinds: [],
+    blockWorkBlockKinds: [],
+    allowCalendarIds: [],
+    blockCalendarIds: [],
+    allowEventTypes: [],
+    blockEventTypes: [],
+    allowEventKeywords: [],
+    blockEventKeywords: [],
+    allowAvailability: [],
+    blockAvailability: []
+};
+function normalizeTask(task) {
+    return {
+        id: task?.id ?? "",
+        title: task?.title ?? "",
+        description: task?.description ?? "",
+        status: task?.status ?? "backlog",
+        priority: task?.priority ?? "medium",
+        owner: task?.owner ?? "Albert",
+        goalId: task?.goalId ?? null,
+        projectId: task?.projectId ?? null,
+        dueDate: task?.dueDate ?? null,
+        effort: task?.effort ?? "deep",
+        energy: task?.energy ?? "steady",
+        points: task?.points ?? 0,
+        plannedDurationSeconds: task?.plannedDurationSeconds ?? null,
+        schedulingRules: task?.schedulingRules ?? null,
+        sortOrder: task?.sortOrder ?? 0,
+        completedAt: task?.completedAt ?? null,
+        createdAt: task?.createdAt ?? new Date(0).toISOString(),
+        updatedAt: task?.updatedAt ?? new Date(0).toISOString(),
+        tagIds: task?.tagIds ?? [],
+        userId: task?.userId ?? null,
+        user: task?.user ?? null,
+        time: task?.time ?? {
+            totalTrackedSeconds: 0,
+            totalCreditedSeconds: 0,
+            liveTrackedSeconds: 0,
+            liveCreditedSeconds: 0,
+            manualAdjustedSeconds: 0,
+            activeRunCount: 0,
+            hasCurrentRun: false,
+            currentRunId: null
+        }
+    };
+}
+function normalizeGoal(goal) {
+    return {
+        id: goal?.id ?? "",
+        title: goal?.title ?? "",
+        description: goal?.description ?? "",
+        horizon: goal?.horizon === "quarter" || goal?.horizon === "lifetime"
+            ? goal.horizon
+            : "year",
+        status: goal?.status === "paused" || goal?.status === "completed"
+            ? goal.status
+            : "active",
+        targetPoints: goal?.targetPoints ?? 0,
+        themeColor: goal?.themeColor ?? "#c8a46b",
+        createdAt: goal?.createdAt ?? new Date(0).toISOString(),
+        updatedAt: goal?.updatedAt ?? new Date(0).toISOString(),
+        tagIds: goal?.tagIds ?? [],
+        userId: goal?.userId ?? null,
+        user: goal?.user ?? null
+    };
+}
+function normalizeTag(tag) {
+    return {
+        id: tag?.id ?? "",
+        name: tag?.name ?? "",
+        kind: tag?.kind === "value" || tag?.kind === "execution"
+            ? tag.kind
+            : "category",
+        color: tag?.color ?? "#71717a",
+        description: tag?.description ?? "",
+        userId: tag?.userId ?? null,
+        user: tag?.user ?? null
+    };
+}
+function normalizeProject(project) {
+    return {
+        id: project?.id ?? "",
+        goalId: project?.goalId ?? "",
+        title: project?.title ?? "",
+        description: project?.description ?? project?.summary ?? "",
+        status: project?.status === "paused" || project?.status === "completed"
+            ? project.status
+            : "active",
+        targetPoints: project?.targetPoints ?? project?.totalPoints ?? 0,
+        themeColor: project?.themeColor ?? "#c0c1ff",
+        schedulingRules: project?.schedulingRules ?? EMPTY_CALENDAR_RULES,
+        createdAt: project?.createdAt ?? new Date(0).toISOString(),
+        updatedAt: project?.updatedAt ?? new Date(0).toISOString(),
+        goalTitle: project?.goalTitle ?? "",
+        activeTaskCount: project?.activeTaskCount ?? 0,
+        completedTaskCount: project?.completedTaskCount ?? 0,
+        totalTasks: project?.totalTasks ?? 0,
+        earnedPoints: project?.earnedPoints ?? project?.totalPoints ?? 0,
+        progress: project?.progress ?? 0,
+        nextTaskId: project?.nextTaskId ?? null,
+        nextTaskTitle: project?.nextTaskTitle ?? null,
+        momentumLabel: project?.momentumLabel ?? "No momentum yet",
+        userId: project?.userId ?? null,
+        user: project?.user ?? null,
+        time: project?.time ?? {
+            totalTrackedSeconds: 0,
+            totalCreditedSeconds: 0,
+            liveTrackedSeconds: 0,
+            liveCreditedSeconds: 0,
+            manualAdjustedSeconds: 0,
+            activeRunCount: 0,
+            hasCurrentRun: false,
+            currentRunId: null
+        }
+    };
+}
+function normalizeHabit(habit) {
+    return {
+        id: habit?.id ?? "",
+        title: habit?.title ?? "",
+        description: habit?.description ?? "",
+        status: habit?.status ?? "active",
+        polarity: habit?.polarity ?? "positive",
+        frequency: habit?.frequency ?? "daily",
+        targetCount: habit?.targetCount ?? 1,
+        weekDays: habit?.weekDays ?? [],
+        linkedGoalIds: habit?.linkedGoalIds ?? [],
+        linkedProjectIds: habit?.linkedProjectIds ?? [],
+        linkedTaskIds: habit?.linkedTaskIds ?? [],
+        linkedValueIds: habit?.linkedValueIds ?? [],
+        linkedPatternIds: habit?.linkedPatternIds ?? [],
+        linkedBehaviorIds: habit?.linkedBehaviorIds ?? [],
+        linkedBeliefIds: habit?.linkedBeliefIds ?? [],
+        linkedModeIds: habit?.linkedModeIds ?? [],
+        linkedReportIds: habit?.linkedReportIds ?? [],
+        linkedBehaviorId: habit?.linkedBehaviorId ?? null,
+        linkedBehaviorTitle: habit?.linkedBehaviorTitle ?? null,
+        linkedBehaviorTitles: habit?.linkedBehaviorTitles ?? [],
+        rewardXp: habit?.rewardXp ?? 12,
+        penaltyXp: habit?.penaltyXp ?? 8,
+        generatedHealthEventTemplate: habit?.generatedHealthEventTemplate ?? {
+            enabled: false,
+            workoutType: "",
+            title: "",
+            durationMinutes: 60,
+            xpReward: 0,
+            tags: [],
+            links: [],
+            notesTemplate: ""
+        },
+        createdAt: habit?.createdAt ?? new Date(0).toISOString(),
+        updatedAt: habit?.updatedAt ?? new Date(0).toISOString(),
+        lastCheckInAt: habit?.lastCheckInAt ?? null,
+        lastCheckInStatus: habit?.lastCheckInStatus ?? null,
+        streakCount: habit?.streakCount ?? 0,
+        completionRate: habit?.completionRate ?? 0,
+        dueToday: habit?.dueToday ?? false,
+        userId: habit?.userId ?? null,
+        user: habit?.user ?? null,
+        checkIns: habit?.checkIns ?? []
+    };
+}
+function normalizeUser(user) {
+    return {
+        id: user?.id ?? "",
+        kind: user?.kind ?? "human",
+        handle: user?.handle ?? "",
+        displayName: user?.displayName ?? "",
+        description: user?.description ?? "",
+        accentColor: user?.accentColor ?? "#c0c1ff",
+        createdAt: user?.createdAt ?? new Date(0).toISOString(),
+        updatedAt: user?.updatedAt ?? new Date(0).toISOString()
+    };
+}
+function normalizeStrategy(strategy) {
+    return {
+        id: strategy?.id ?? "",
+        title: strategy?.title ?? "",
+        overview: strategy?.overview ?? "",
+        endStateDescription: strategy?.endStateDescription ?? "",
+        status: strategy?.status === "paused" || strategy?.status === "completed"
+            ? strategy.status
+            : "active",
+        targetGoalIds: strategy?.targetGoalIds ?? [],
+        targetProjectIds: strategy?.targetProjectIds ?? [],
+        linkedEntities: strategy?.linkedEntities ?? [],
+        graph: strategy?.graph ?? { nodes: [], edges: [] },
+        metrics: strategy?.metrics ?? {
+            alignmentScore: 0,
+            planCoverageScore: 0,
+            sequencingScore: 100,
+            scopeDisciplineScore: 100,
+            qualityScore: 0,
+            targetProgressScore: 0,
+            completedNodeCount: 0,
+            startedNodeCount: 0,
+            readyNodeCount: 0,
+            totalNodeCount: 1,
+            completedTargetCount: 0,
+            totalTargetCount: 0,
+            offPlanEntityCount: 0,
+            offPlanActiveEntityCount: 0,
+            offPlanCompletedEntityCount: 0,
+            activeNodeIds: [],
+            nextNodeIds: [],
+            blockedNodeIds: [],
+            outOfOrderNodeIds: []
+        },
+        isLocked: strategy?.isLocked ?? false,
+        lockedAt: strategy?.lockedAt ?? null,
+        lockedByUserId: strategy?.lockedByUserId ?? null,
+        lockedByUser: strategy?.lockedByUser ?? null,
+        createdAt: strategy?.createdAt ?? new Date(0).toISOString(),
+        updatedAt: strategy?.updatedAt ?? new Date(0).toISOString(),
+        userId: strategy?.userId ?? null,
+        user: strategy?.user ?? null
+    };
+}
+export function normalizeForgeSnapshot(raw) {
+    const legacy = raw;
+    const rootProjects = (legacy.projects ?? legacy.campaigns ?? []).map(normalizeProject);
+    const dashboardProjects = (legacy.dashboard?.projects ??
+        legacy.dashboard?.campaigns ??
+        rootProjects).map(normalizeProject);
+    const overviewProjects = (legacy.overview?.projects ??
+        legacy.overview?.campaigns ??
+        dashboardProjects).map(normalizeProject);
+    return {
+        ...raw,
+        meta: {
+            apiVersion: "v1",
+            transport: "rest+sse",
+            generatedAt: raw.meta?.generatedAt ?? new Date().toISOString(),
+            backend: raw.meta?.backend ?? "forge-node-runtime",
+            mode: raw.meta?.mode ?? "transitional-node"
+        },
+        metrics: {
+            totalXp: raw.metrics?.totalXp ?? 0,
+            level: raw.metrics?.level ?? 1,
+            currentLevelXp: raw.metrics?.currentLevelXp ?? 0,
+            nextLevelXp: raw.metrics?.nextLevelXp ?? 120,
+            weeklyXp: raw.metrics?.weeklyXp ?? 0,
+            streakDays: raw.metrics?.streakDays ?? 0,
+            comboMultiplier: raw.metrics?.comboMultiplier ?? 1,
+            momentumScore: raw.metrics?.momentumScore ?? 0,
+            topGoalId: raw.metrics?.topGoalId ?? null,
+            topGoalTitle: raw.metrics?.topGoalTitle ?? null
+        },
+        users: (raw.users ?? []).map(normalizeUser),
+        strategies: (raw.strategies ?? []).map(normalizeStrategy),
+        userScope: {
+            selectedUserIds: raw.userScope?.selectedUserIds ?? [],
+            selectedUsers: (raw.userScope?.selectedUsers ?? []).map(normalizeUser)
+        },
+        dashboard: {
+            stats: {
+                totalPoints: raw.dashboard?.stats?.totalPoints ?? 0,
+                completedThisWeek: raw.dashboard?.stats?.completedThisWeek ?? 0,
+                activeGoals: raw.dashboard?.stats?.activeGoals ?? 0,
+                alignmentScore: raw.dashboard?.stats?.alignmentScore ?? 0,
+                focusTasks: raw.dashboard?.stats?.focusTasks ?? 0,
+                overdueTasks: raw.dashboard?.stats?.overdueTasks ?? 0,
+                dueThisWeek: raw.dashboard?.stats?.dueThisWeek ?? 0
+            },
+            goals: (raw.dashboard?.goals ?? []).map((goal) => ({
+                ...goal,
+                ...normalizeGoal(goal)
+            })),
+            projects: dashboardProjects,
+            tasks: (raw.dashboard?.tasks ?? []).map(normalizeTask),
+            habits: (raw.dashboard?.habits ?? raw.habits ?? []).map(normalizeHabit),
+            tags: (raw.dashboard?.tags ?? []).map(normalizeTag),
+            suggestedTags: (raw.dashboard?.suggestedTags ?? []).map(normalizeTag),
+            owners: raw.dashboard?.owners ?? [],
+            executionBuckets: (raw.dashboard?.executionBuckets ?? []).map((bucket) => ({
+                ...bucket,
+                tasks: (bucket.tasks ?? []).map(normalizeTask)
+            })),
+            gamification: raw.dashboard?.gamification ?? {
+                totalXp: raw.metrics?.totalXp ?? 0,
+                level: raw.metrics?.level ?? 1,
+                currentLevelXp: raw.metrics?.currentLevelXp ?? 0,
+                nextLevelXp: raw.metrics?.nextLevelXp ?? 120,
+                weeklyXp: raw.metrics?.weeklyXp ?? 0,
+                streakDays: raw.metrics?.streakDays ?? 0,
+                comboMultiplier: raw.metrics?.comboMultiplier ?? 1,
+                momentumScore: raw.metrics?.momentumScore ?? 0,
+                topGoalId: raw.metrics?.topGoalId ?? null,
+                topGoalTitle: raw.metrics?.topGoalTitle ?? null
+            },
+            achievements: raw.dashboard?.achievements ?? [],
+            milestoneRewards: raw.dashboard?.milestoneRewards ?? [],
+            recentActivity: raw.dashboard?.recentActivity ?? [],
+            notesSummaryByEntity: raw.dashboard?.notesSummaryByEntity ?? {}
+        },
+        overview: {
+            generatedAt: raw.overview?.generatedAt ?? new Date().toISOString(),
+            strategicHeader: {
+                streakDays: raw.overview?.strategicHeader?.streakDays ??
+                    raw.metrics?.streakDays ??
+                    0,
+                level: raw.overview?.strategicHeader?.level ?? raw.metrics?.level ?? 1,
+                totalXp: raw.overview?.strategicHeader?.totalXp ?? raw.metrics?.totalXp ?? 0,
+                currentLevelXp: raw.overview?.strategicHeader?.currentLevelXp ??
+                    raw.metrics?.currentLevelXp ??
+                    0,
+                nextLevelXp: raw.overview?.strategicHeader?.nextLevelXp ??
+                    raw.metrics?.nextLevelXp ??
+                    120,
+                momentumScore: raw.overview?.strategicHeader?.momentumScore ??
+                    raw.metrics?.momentumScore ??
+                    0,
+                focusTasks: raw.overview?.strategicHeader?.focusTasks ?? 0,
+                overdueTasks: raw.overview?.strategicHeader?.overdueTasks ?? 0
+            },
+            projects: overviewProjects,
+            activeGoals: (raw.overview?.activeGoals ?? []).map((goal) => ({
+                ...goal,
+                ...normalizeGoal(goal)
+            })),
+            topTasks: (raw.overview?.topTasks ?? []).map(normalizeTask),
+            dueHabits: (raw.overview?.dueHabits ??
+                raw.today?.dueHabits ??
+                raw.dashboard?.habits ??
+                []).map(normalizeHabit),
+            recentEvidence: raw.overview?.recentEvidence ?? [],
+            achievements: raw.overview?.achievements ?? [],
+            domainBalance: raw.overview?.domainBalance ?? [],
+            neglectedGoals: raw.overview?.neglectedGoals ?? []
+        },
+        today: {
+            generatedAt: raw.today?.generatedAt ?? new Date().toISOString(),
+            directive: {
+                task: raw.today?.directive?.task
+                    ? normalizeTask(raw.today.directive.task)
+                    : null,
+                goalTitle: raw.today?.directive?.goalTitle ?? null,
+                rewardXp: raw.today?.directive?.rewardXp ?? 0,
+                sessionLabel: raw.today?.directive?.sessionLabel ?? "No active session"
+            },
+            timeline: (raw.today?.timeline ?? []).map((bucket) => ({
+                ...bucket,
+                tasks: (bucket.tasks ?? []).map(normalizeTask)
+            })),
+            dueHabits: (raw.today?.dueHabits ??
+                raw.overview?.dueHabits ??
+                raw.dashboard?.habits ??
+                []).map(normalizeHabit),
+            dailyQuests: raw.today?.dailyQuests ?? [],
+            milestoneRewards: raw.today?.milestoneRewards ?? [],
+            recentHabitRewards: raw.today?.recentHabitRewards ?? [],
+            momentum: {
+                streakDays: raw.today?.momentum?.streakDays ?? 0,
+                momentumScore: raw.today?.momentum?.momentumScore ?? 0,
+                recoveryHint: raw.today?.momentum?.recoveryHint ?? ""
+            }
+        },
+        risk: {
+            generatedAt: raw.risk?.generatedAt ?? new Date().toISOString(),
+            overdueTasks: (raw.risk?.overdueTasks ?? []).map(normalizeTask),
+            blockedTasks: (raw.risk?.blockedTasks ?? []).map(normalizeTask),
+            neglectedGoals: raw.risk?.neglectedGoals ?? [],
+            summary: raw.risk?.summary ?? ""
+        },
+        goals: (raw.goals ?? []).map(normalizeGoal),
+        projects: rootProjects,
+        tags: (raw.tags ?? []).map(normalizeTag),
+        tasks: (raw.tasks ?? []).map(normalizeTask),
+        habits: (raw.habits ?? raw.dashboard?.habits ?? []).map(normalizeHabit),
+        activity: raw.activity ?? [],
+        activeTaskRuns: raw.activeTaskRuns ?? []
+    };
+}

package/dist/server/src/lib/theme-system.js

@@ -0,0 +1,319 @@
+import { z } from "zod";
+export const forgeThemePreferenceValues = [
+    "obsidian",
+    "solar",
+    "aurora",
+    "ember",
+    "paper",
+    "dawn",
+    "atelier",
+    "custom",
+    "system"
+];
+export const forgeThemePreferenceSchema = z.enum(forgeThemePreferenceValues);
+const hexColorSchema = z
+    .string()
+    .trim()
+    .regex(/^#[0-9a-fA-F]{6}$/, "Use a 6-digit hex color");
+export const forgeCustomThemeSchema = z.object({
+    label: z.string().trim().min(1, "Theme name is required").max(40),
+    primary: hexColorSchema,
+    secondary: hexColorSchema,
+    tertiary: hexColorSchema,
+    canvas: hexColorSchema,
+    panel: hexColorSchema,
+    panelHigh: hexColorSchema,
+    panelLow: hexColorSchema,
+    ink: hexColorSchema
+});
+const CUSTOM_THEME_STORAGE_KEYS = [
+    "--primary",
+    "--secondary",
+    "--tertiary",
+    "--surface",
+    "--surface-low",
+    "--surface-panel",
+    "--surface-high",
+    "--surface-glass",
+    "--surface-psyche",
+    "--surface-psyche-high",
+    "--hero-gradient",
+    "--card-gradient",
+    "--card-shadow",
+    "--card-shadow-hover",
+    "--forge-body-ambient-primary",
+    "--forge-body-ambient-secondary",
+    "--forge-body-gradient-start",
+    "--forge-body-gradient-end",
+    "--forge-body-text"
+];
+export const defaultCustomTheme = {
+    label: "Custom Forge",
+    primary: "#7cc7ff",
+    secondary: "#4edea3",
+    tertiary: "#ffb95f",
+    canvas: "#0b1326",
+    panel: "#171f33",
+    panelHigh: "#222a3d",
+    panelLow: "#131b2e",
+    ink: "#eef2ff"
+};
+export const forgeThemeCatalog = {
+    obsidian: {
+        label: "Obsidian",
+        description: "Deep indigo with cool neon edges. This is the current default.",
+        mode: "dark",
+        preview: {
+            label: "Obsidian",
+            primary: "#c0c1ff",
+            secondary: "#4edea3",
+            tertiary: "#ffb95f",
+            canvas: "#0b1326",
+            panel: "#171f33",
+            panelHigh: "#222a3d",
+            panelLow: "#131b2e",
+            ink: "#eef2ff"
+        }
+    },
+    solar: {
+        label: "Catppuccin",
+        description: "Pastel mocha surfaces inspired by the widely adopted Catppuccin palette.",
+        mode: "dark",
+        preview: {
+            label: "Catppuccin",
+            primary: "#cba6f7",
+            secondary: "#94e2d5",
+            tertiary: "#fab387",
+            canvas: "#1e1e2e",
+            panel: "#313244",
+            panelHigh: "#45475a",
+            panelLow: "#181825",
+            ink: "#cdd6f4"
+        }
+    },
+    aurora: {
+        label: "Nord",
+        description: "Arctic blue-grey surfaces based on Nord's clean and uncluttered palette.",
+        mode: "dark",
+        preview: {
+            label: "Nord",
+            primary: "#88c0d0",
+            secondary: "#a3be8c",
+            tertiary: "#ebcb8b",
+            canvas: "#2e3440",
+            panel: "#3b4252",
+            panelHigh: "#434c5e",
+            panelLow: "#242933",
+            ink: "#eceff4"
+        }
+    },
+    ember: {
+        label: "Dracula",
+        description: "High-contrast purple and pink accents drawn from the official Dracula specification.",
+        mode: "dark",
+        preview: {
+            label: "Dracula",
+            primary: "#bd93f9",
+            secondary: "#8be9fd",
+            tertiary: "#ff79c6",
+            canvas: "#282a36",
+            panel: "#343746",
+            panelHigh: "#424450",
+            panelLow: "#21222c",
+            ink: "#f8f8f2"
+        }
+    },
+    paper: {
+        label: "Paper",
+        description: "Warm ivory surfaces with navy ink and restrained blue-green accents for a crisp daytime workspace.",
+        mode: "light",
+        preview: {
+            label: "Paper",
+            primary: "#2f6fed",
+            secondary: "#1d8f6b",
+            tertiary: "#c9772b",
+            canvas: "#f4efe6",
+            panel: "#fbf7f1",
+            panelHigh: "#ffffff",
+            panelLow: "#e5ddd0",
+            ink: "#182235"
+        }
+    },
+    dawn: {
+        label: "Dawn",
+        description: "Rosy morning tones with plum-blue ink and enough contrast to stay readable across dense settings screens.",
+        mode: "light",
+        preview: {
+            label: "Dawn",
+            primary: "#8b5cf6",
+            secondary: "#ec7a6b",
+            tertiary: "#d0a12b",
+            canvas: "#f8eef1",
+            panel: "#fff7f8",
+            panelHigh: "#ffffff",
+            panelLow: "#ead9df",
+            ink: "#2d1834"
+        }
+    },
+    atelier: {
+        label: "Atelier",
+        description: "Cool drafting-table neutrals with slate ink and modern cobalt accents for a brighter, studio-like shell.",
+        mode: "light",
+        preview: {
+            label: "Atelier",
+            primary: "#2563eb",
+            secondary: "#0f8b6d",
+            tertiary: "#b85c38",
+            canvas: "#edf3f7",
+            panel: "#f8fbfd",
+            panelHigh: "#ffffff",
+            panelLow: "#dbe5ec",
+            ink: "#162334"
+        }
+    }
+};
+export const forgeThemeOptions = [
+    {
+        value: "obsidian",
+        label: forgeThemeCatalog.obsidian.label,
+        description: forgeThemeCatalog.obsidian.description
+    },
+    {
+        value: "solar",
+        label: forgeThemeCatalog.solar.label,
+        description: forgeThemeCatalog.solar.description
+    },
+    {
+        value: "aurora",
+        label: forgeThemeCatalog.aurora.label,
+        description: forgeThemeCatalog.aurora.description
+    },
+    {
+        value: "ember",
+        label: forgeThemeCatalog.ember.label,
+        description: forgeThemeCatalog.ember.description
+    },
+    {
+        value: "paper",
+        label: forgeThemeCatalog.paper.label,
+        description: forgeThemeCatalog.paper.description
+    },
+    {
+        value: "dawn",
+        label: forgeThemeCatalog.dawn.label,
+        description: forgeThemeCatalog.dawn.description
+    },
+    {
+        value: "atelier",
+        label: forgeThemeCatalog.atelier.label,
+        description: forgeThemeCatalog.atelier.description
+    },
+    {
+        value: "custom",
+        label: "Custom",
+        description: "Use your own Forge token set through the guided editor or direct JSON import."
+    },
+    {
+        value: "system",
+        label: "System",
+        description: "Follow the device preference. Forge maps dark mode to Obsidian and light mode to Paper."
+    }
+];
+function hexToRgb(value) {
+    const normalized = value.replace("#", "");
+    return {
+        r: Number.parseInt(normalized.slice(0, 2), 16),
+        g: Number.parseInt(normalized.slice(2, 4), 16),
+        b: Number.parseInt(normalized.slice(4, 6), 16)
+    };
+}
+function rgbToHex({ r, g, b }) {
+    return `#${[r, g, b]
+        .map((channel) => Math.max(0, Math.min(255, Math.round(channel)))
+        .toString(16)
+        .padStart(2, "0"))
+        .join("")}`;
+}
+function mixHex(base, overlay, weight) {
+    const baseRgb = hexToRgb(base);
+    const overlayRgb = hexToRgb(overlay);
+    return rgbToHex({
+        r: baseRgb.r + (overlayRgb.r - baseRgb.r) * weight,
+        g: baseRgb.g + (overlayRgb.g - baseRgb.g) * weight,
+        b: baseRgb.b + (overlayRgb.b - baseRgb.b) * weight
+    });
+}
+function alpha(hex, opacity) {
+    const { r, g, b } = hexToRgb(hex);
+    return `rgba(${r}, ${g}, ${b}, ${opacity})`;
+}
+export function resolveForgeThemePreference(preference, prefersDark) {
+    if (preference === "system") {
+        return prefersDark ? "obsidian" : "paper";
+    }
+    return preference;
+}
+export function getForgeThemePreview(preference, customTheme) {
+    if (preference === "custom") {
+        return customTheme ?? defaultCustomTheme;
+    }
+    if (preference === "system") {
+        return forgeThemeCatalog.obsidian.preview;
+    }
+    return forgeThemeCatalog[preference].preview;
+}
+export function buildForgeThemeVariables(theme) {
+    const cardTop = mixHex(theme.panelHigh, theme.primary, 0.08);
+    const heroTop = mixHex(theme.panelHigh, theme.primary, 0.16);
+    const heroBottom = mixHex(theme.canvas, theme.secondary, 0.06);
+    return {
+        "--primary": theme.primary,
+        "--secondary": theme.secondary,
+        "--tertiary": theme.tertiary,
+        "--surface": theme.canvas,
+        "--surface-low": theme.panelLow,
+        "--surface-panel": theme.panel,
+        "--surface-high": theme.panelHigh,
+        "--surface-glass": alpha(theme.canvas, 0.82),
+        "--surface-psyche": alpha(mixHex(theme.canvas, theme.secondary, 0.12), 0.94),
+        "--surface-psyche-high": alpha(mixHex(theme.panelHigh, theme.secondary, 0.1), 0.96),
+        "--hero-gradient": `linear-gradient(180deg, ${alpha(heroTop, 0.95)}, ${alpha(heroBottom, 0.95)})`,
+        "--card-gradient": `linear-gradient(180deg, ${alpha(cardTop, 0.96)}, ${alpha(theme.panelLow, 0.94)})`,
+        "--card-shadow": `0 24px 60px ${alpha(theme.canvas, 0.3)}`,
+        "--card-shadow-hover": `0 32px 80px ${alpha(theme.canvas, 0.38)}`,
+        "--forge-body-ambient-primary": alpha(theme.primary, 0.2),
+        "--forge-body-ambient-secondary": alpha(theme.secondary, 0.14),
+        "--forge-body-gradient-start": mixHex(theme.panel, theme.primary, 0.08),
+        "--forge-body-gradient-end": mixHex(theme.canvas, "#000000", 0.16),
+        "--forge-body-text": theme.ink
+    };
+}
+export function applyForgeThemeToDocument(preference, customTheme) {
+    if (typeof document === "undefined") {
+        return;
+    }
+    const prefersDark = typeof window !== "undefined" &&
+        typeof window.matchMedia === "function" &&
+        window.matchMedia("(prefers-color-scheme: dark)").matches;
+    const resolved = resolveForgeThemePreference(preference, prefersDark);
+    const body = document.body;
+    const root = document.documentElement;
+    body.classList.remove("theme-forge-dark", "theme-forge-light", "theme-forge-obsidian", "theme-forge-solar", "theme-forge-aurora", "theme-forge-ember", "theme-forge-paper", "theme-forge-dawn", "theme-forge-atelier", "theme-forge-custom");
+    if (resolved === "custom") {
+        const theme = customTheme ?? defaultCustomTheme;
+        const variables = buildForgeThemeVariables(theme);
+        body.classList.add("theme-forge-custom");
+        body.classList.add("theme-forge-dark");
+        for (const [name, value] of Object.entries(variables)) {
+            root.style.setProperty(name, value);
+        }
+        root.dataset.forgeTheme = theme.label;
+        return;
+    }
+    for (const name of CUSTOM_THEME_STORAGE_KEYS) {
+        root.style.removeProperty(name);
+    }
+    delete root.dataset.forgeTheme;
+    body.classList.add(forgeThemeCatalog[resolved].mode === "light" ? "theme-forge-light" : "theme-forge-dark");
+    body.classList.add(`theme-forge-${resolved}`);
+}

package/dist/server/src/lib/types.js

@@ -0,0 +1 @@
+export {};