add artifact types and add artifact field to GridCharacter

src/lib/types/api/artifact.ts

@@ -0,0 +1,288 @@
+// Artifact types based on Rails blueprints
+// These define artifact reference data and instance types
+
+import type { LocalizedName } from './entities'
+
+// ============================================
+// Reference Types (canonical game data)
+// ============================================
+
+/** Artifact rarity type */
+export type ArtifactRarity = 'standard' | 'quirk'
+
+/** Artifact skill group - determines which slot(s) can use the skill */
+export type ArtifactSkillGroup = 'group_i' | 'group_ii' | 'group_iii'
+
+/** Artifact skill polarity - positive or negative modifier */
+export type ArtifactSkillPolarity = 'positive' | 'negative'
+
+/** Grade letter for artifact grading */
+export type ArtifactGradeLetter = 'S' | 'A' | 'B' | 'C' | 'D' | 'F'
+
+/** Recommendation action from grader */
+export type ArtifactRecommendationAction = 'keep' | 'reroll' | 'scrap'
+
+/**
+ * Artifact reference data (ArtifactBlueprint)
+ * Represents the canonical artifact type from the game
+ */
+export interface Artifact {
+	id: string
+	granblueId: string
+	name: LocalizedName
+	/** Fixed proficiency for standard artifacts, null for quirk */
+	proficiency: number | null
+	/** Artifact type: standard has skills, quirk does not */
+	rarity: ArtifactRarity
+	/** Release date if available */
+	releaseDate?: string
+}
+
+/**
+ * Artifact skill reference data (ArtifactSkillBlueprint)
+ * Represents a skill modifier that can be applied to artifact slots
+ */
+export interface ArtifactSkill {
+	id: string
+	name: LocalizedName
+	/** Which skill group this belongs to (determines valid slots) */
+	skillGroup: ArtifactSkillGroup
+	/** Numeric modifier identifier */
+	modifier: number
+	/** Whether this is a positive or negative modifier */
+	polarity: ArtifactSkillPolarity
+	/** Available strength values at each level (index 0-4 for levels 1-5) */
+	baseValues: (number | null)[]
+	/** Per-level scaling factor */
+	growth?: number
+	/** Display suffix for the value (e.g., "%", "ATK") */
+	suffix: LocalizedName
+}
+
+// ============================================
+// Instance Types (user-owned data)
+// ============================================
+
+/**
+ * Skill instance on an artifact
+ * Represents a specific skill configuration with modifier, strength, and level
+ */
+export interface ArtifactSkillInstance {
+	/** The skill modifier id */
+	modifier: number
+	/** The strength value (must be one of the skill's baseValues) */
+	strength: number
+	/** The skill level (1-5, affects total allocation) */
+	level: number
+}
+
+/**
+ * Per-skill grade breakdown from the grader
+ */
+export interface ArtifactGradeLine {
+	slot: number
+	group: ArtifactSkillGroup
+	modifier: number
+	tier: 'ideal' | 'good' | 'neutral' | 'bad'
+	tierScore: number
+	strengthScore: number
+	combinedScore: number
+	level: number
+}
+
+/**
+ * Recommendation from the artifact grader
+ */
+export interface ArtifactRecommendation {
+	action: ArtifactRecommendationAction
+	reason: string
+	/** Which slot to target for reroll */
+	slot?: number
+	/** Current skill name in target slot */
+	currentSkill?: string
+	/** Current tier of target slot */
+	currentTier?: string
+	/** Potential score gain from reroll */
+	potentialGain?: number
+	/** Priority level for the recommendation */
+	priority?: 'high' | 'medium' | 'low'
+	/** Suggested replacement skills */
+	targetSkills?: Array<{ modifier: number; nameEn: string; nameJp: string }>
+	/** Detailed breakdown of skill quality */
+	details?: {
+		badSkills?: string[]
+		neutralSkills?: string[]
+		idealSkills?: string[]
+		goodSkills?: string[]
+	}
+}
+
+/**
+ * Artifact grade result from ArtifactGrader
+ */
+export interface ArtifactGrade {
+	/** Letter grade (null for quirk artifacts) */
+	letter: ArtifactGradeLetter | null
+	/** Numeric score 0-100 (null for quirk artifacts) */
+	score: number | null
+	/** Score breakdown by category */
+	breakdown: {
+		skillSelection: number
+		baseStrength: number
+		synergy: number
+	} | null
+	/** Per-skill grade details */
+	lines: ArtifactGradeLine[] | null
+	/** Recommendation for what to do with this artifact */
+	recommendation: ArtifactRecommendation | null
+	/** Note explaining why grade is null (e.g., "Quirk artifacts cannot be graded") */
+	note?: string
+}
+
+/**
+ * Collection artifact instance (CollectionArtifactBlueprint)
+ * Represents an artifact in the user's inventory
+ */
+export interface CollectionArtifact {
+	id: string
+	/** Element (1-6: wind, fire, water, earth, dark, light) */
+	element: number
+	/** Artifact level (1-5 for standard, always 1 for quirk) */
+	level: number
+	/** User-assigned nickname (max 50 chars) */
+	nickname?: string
+	/** Which slot the user is targeting for rerolls (1-4) */
+	rerollSlot?: number
+	/** Proficiency (only set for quirk artifacts) */
+	proficiency?: number
+	/** Skills array (4 items for standard, empty for quirk) */
+	skills: (ArtifactSkillInstance | null)[]
+	/** Calculated grade from the grader */
+	grade: ArtifactGrade
+	/** Reference to the base artifact */
+	artifact: Artifact
+	createdAt: string
+	updatedAt: string
+}
+
+/**
+ * Grid artifact instance (GridArtifactBlueprint)
+ * Represents an artifact equipped on a character in a party
+ */
+export interface GridArtifact {
+	id: string
+	/** Element (1-6: wind, fire, water, earth, dark, light) */
+	element: number
+	/** Artifact level (1-5 for standard, always 1 for quirk) */
+	level: number
+	/** Which slot the user is targeting for rerolls (1-4) */
+	rerollSlot?: number
+	/** Proficiency (only set for quirk artifacts) */
+	proficiency?: number
+	/** Skills array (4 items for standard, empty for quirk) */
+	skills: (ArtifactSkillInstance | null)[]
+	/** Calculated grade from the grader */
+	grade: ArtifactGrade
+	/** Reference to the base artifact */
+	artifact: Artifact
+}
+
+// ============================================
+// Input Types (for API requests)
+// ============================================
+
+/**
+ * Input for creating/updating a collection artifact
+ */
+export interface CollectionArtifactInput {
+	artifactId: string
+	element: number
+	level?: number
+	nickname?: string
+	rerollSlot?: number
+	/** Only for quirk artifacts */
+	proficiency?: number
+	skill1?: ArtifactSkillInstance
+	skill2?: ArtifactSkillInstance
+	skill3?: ArtifactSkillInstance
+	skill4?: ArtifactSkillInstance
+}
+
+/**
+ * Input for creating a grid artifact
+ */
+export interface GridArtifactInput {
+	partyId: string
+	gridCharacterId: string
+	artifactId: string
+	element: number
+	level?: number
+	rerollSlot?: number
+	/** Only for quirk artifacts */
+	proficiency?: number
+	skill1?: ArtifactSkillInstance
+	skill2?: ArtifactSkillInstance
+	skill3?: ArtifactSkillInstance
+	skill4?: ArtifactSkillInstance
+}
+
+/**
+ * Input for updating a grid artifact
+ */
+export interface GridArtifactUpdateInput {
+	element?: number
+	level?: number
+	rerollSlot?: number
+	/** Only for quirk artifacts */
+	proficiency?: number
+	skill1?: ArtifactSkillInstance
+	skill2?: ArtifactSkillInstance
+	skill3?: ArtifactSkillInstance
+	skill4?: ArtifactSkillInstance
+}
+
+/**
+ * Input for grading artifact skills (stateless)
+ */
+export interface ArtifactGradeInput {
+	artifactId?: string
+	skill1?: ArtifactSkillInstance
+	skill2?: ArtifactSkillInstance
+	skill3?: ArtifactSkillInstance
+	skill4?: ArtifactSkillInstance
+}
+
+// ============================================
+// Helper Types
+// ============================================
+
+/**
+ * Union type for any artifact instance (collection or grid)
+ */
+export type ArtifactInstance = CollectionArtifact | GridArtifact
+
+/**
+ * Check if an artifact is a quirk type
+ */
+export function isQuirkArtifact(artifact: Artifact): boolean {
+	return artifact.rarity === 'quirk'
+}
+
+/**
+ * Check if an artifact instance is a collection artifact
+ */
+export function isCollectionArtifact(
+	instance: ArtifactInstance
+): instance is CollectionArtifact {
+	return 'createdAt' in instance
+}
+
+/**
+ * Get the skill group for a given slot number (1-4)
+ * Slots 1-2 use group_i, slot 3 uses group_ii, slot 4 uses group_iii
+ */
+export function getSkillGroupForSlot(slot: number): ArtifactSkillGroup {
+	if (slot <= 2) return 'group_i'
+	if (slot === 3) return 'group_ii'
+	return 'group_iii'
+}

src/lib/types/api/party.ts

@@ -15,6 +15,7 @@ import type {
   WeaponKey,
   SimpleAxSkill
 } from './entities'
+import type { GridArtifact, CollectionArtifact } from './artifact'
 
 // Grid item types - these are the junction tables between Party and entities
 
@@ -49,6 +50,8 @@ export interface GridCharacter {
   }
   aetherialMastery?: { modifier: number; strength: number }
   overMastery?: Array<{ modifier: number; strength: number }>
+  /** Equipped artifact (can be grid or collection artifact) */
+  artifact?: GridArtifact | CollectionArtifact
 }
 
 // GridSummon from GridSummonBlueprint