@g3nomaly/g3n-mods 0.1.6 → 0.1.8

package/mods/agent-adventure/hooks/sprite.ts

@@ -0,0 +1,424 @@
+// packages/g3n-mods/mods/agent-adventure/hooks/sprite.ts
+
+/**
+ * The pixel sprites, shared by the hooks module, which draws them as an Svg on surfaces without the mod's view, and
+ * by the view in `view/view.ts`. Plain data and string building only, so both can import it.
+ */
+
+/** Each letter of a sprite row is a palette color; `.` is empty. */
+export const PALETTE: Readonly<Record<string, string>> = {
+  k: '#1b1b24', s: '#f2c9a0', S: '#d9a47a', h: '#6b4226', y: '#e8c46a',
+  r: '#c0392b', R: '#8e2a20', b: '#3a6ea5', B: '#24466e', g: '#3fa66b', G: '#2a7048',
+  w: '#f0f0f0', W: '#c9d1d9', m: '#a8b2bd', M: '#6b7480', o: '#8b5a2b', O: '#5c3a1a',
+  p: '#8e5bd0', P: '#5d3a91', t: '#d8c38f', T: '#a8935a', e: '#f2c14e', E: '#e0773a',
+  c: '#6fd3e0', C: '#3a9fb0', n: '#e8e2cf', N: '#b8b09a', l: '#7ad46a', L: '#4a9c45',
+  x: '#ff4a3d', z: '#cfe8ff', Z: '#9fb8d8', q: '#3b3f4a', Q: '#262932', v: '#b07ad8', a: '#ffe9a8',
+}
+
+/**
+ * Heroes, 12 by 14, facing right. Enemies face left; bosses are drawn bigger.
+ * `recruit` is a hooded figure for a hero still signing up.
+ */
+export const SPRITES: Readonly<Record<string, readonly string[]>> = {
+  fighter: [
+    '.....rr.....',
+    '....MMMM....',
+    '...MmmmmM...',
+    '...MsksksM..',
+    '...MssSssM..',
+    '....MMMM..m.',
+    '.MM.rrrr..m.',
+    'MmmMmrrmm.m.',
+    'MmemMrrrrsO.',
+    'MmmM.RRRR...',
+    '.MM..rrrr...',
+    '.....M..M...',
+    '.....M..M...',
+    '....OO..OO..',
+  ],
+  healer: [
+    '....wwww....',
+    '...wwyyyw...',
+    '...wysksk...',
+    '...wysssS...',
+    '....wsss.e..',
+    '...wwwwww.e.',
+    '..swwewwwwe.',
+    '...wweeww.o.',
+    '...wwweww.o.',
+    '...wwwwww.o.',
+    '...wwwwww.o.',
+    '..wwwwwwww..',
+    '...ww..ww...',
+    '...tt..tt...',
+  ],
+  monk: [
+    '............',
+    '....ssss....',
+    '...ssssss...',
+    '...sssksk...',
+    '...ssssss...',
+    '....SSSS....',
+    '..EEEEEEEE..',
+    '.sEEEOOEEEs.',
+    '.s.EEEEEE.s.',
+    '...OOOOOO...',
+    '...EEEEEE...',
+    '...EE..EE...',
+    '...ss..ss...',
+    '..ss....ss..',
+  ],
+  ranger: [
+    '...GGGG.....',
+    '..GGGGGG.o..',
+    '..GGsksk..o.',
+    '..GsssssS.o.',
+    '...Gsss...o.',
+    '..GGGGGGs.o.',
+    '.GGgggggGso.',
+    '.G.ggOgg..o.',
+    '.G.gggggg.o.',
+    '...OOOOO.o..',
+    '...gggggo...',
+    '...gg..gg...',
+    '...OO..OO...',
+    '..OOO..OOO..',
+  ],
+  mage: [
+    '.....P......',
+    '....PPP.....',
+    '...PPPPP....',
+    '..PPPPPPPP..',
+    '...sksksc...',
+    '...sssssc...',
+    '...wwwww.C..',
+    '..PppppPPo..',
+    '..PpppppPo..',
+    '..PppeppPo..',
+    '..PppppPPo..',
+    '..PpppppPo..',
+    '.PPpppppPP..',
+    '..PP...PP...',
+  ],
+  guardian: [
+    '....eeee....',
+    '...MmmmmM...',
+    '...MkmkmM...',
+    '...MmmmmM...',
+    '....MMMM....',
+    'bbb.mmmm....',
+    'bebbmbbmm...',
+    'beebmbbbmso.',
+    'bebbmbbbm.o.',
+    'bbb.MMMM..o.',
+    '.b..mmmm..o.',
+    '....M..M....',
+    '....M..M....',
+    '...MM..MM...',
+  ],
+  rogue: [
+    '............',
+    '...qqqq.....',
+    '..qqqqqq....',
+    '..qQQxQx....',
+    '..qQQQQQ....',
+    '...qqqq.....',
+    '..qqqqqq....',
+    '.qQqqqqqs.W.',
+    '.s.qqrqq.W..',
+    '...QQQQQ....',
+    '...qqqqq....',
+    '...qq..qq...',
+    '...QQ..QQ...',
+    '..QQ....QQ..',
+  ],
+  recruit: [
+    '............',
+    '....TTTT....',
+    '...TttttT...',
+    '..TtkkkktT..',
+    '..TtkkkktT..',
+    '...TttttT...',
+    '..TttttttT..',
+    '..TttttttT..',
+    '..TttttttT..',
+    '..TttttttT..',
+    '..TttttttT..',
+    '..TttttttT..',
+    '...TT..TT...',
+    '...OO..OO...',
+  ],
+  slime: [
+    '............',
+    '............',
+    '............',
+    '............',
+    '.....ll.....',
+    '....llll....',
+    '...llwlll...',
+    '..llwllllL..',
+    '..lkllklllL.',
+    '.lllllllllL.',
+    '.llLllllllL.',
+    'lllllllllllL',
+    'LLLLLLLLLLLL',
+    '............',
+  ],
+  wolf: [
+    '............',
+    '............',
+    '............',
+    '.MM.........',
+    'MMMM........',
+    'MxMMM.......',
+    'MMMMMMMMMM..',
+    '.WW.MMMMMMM.',
+    '....MMMMMMMM',
+    '....MMMMMM.M',
+    '....M.M.M.M.',
+    '....M.M.M.M.',
+    '...MM.M.MM.M',
+    '............',
+  ],
+  goblin: [
+    '............',
+    '............',
+    '.g......g...',
+    '.gg.ggggg...',
+    '..ggkgkgg...',
+    '...ggggg....',
+    '....GGG.....',
+    '.o.ttttt....',
+    '.o.gtttgg...',
+    '.ogTTTTT....',
+    '.o..ttt.....',
+    '....g..g....',
+    '....g..g....',
+    '...GG..GG...',
+  ],
+  shaman: [
+    '....e..e....',
+    '.g.eeeee.g..',
+    '.gggggggggg.',
+    '...gxggxg...',
+    '...ggggg....',
+    '....GGG.....',
+    '.c.PPPPP....',
+    '.o.PvPvPg...',
+    '.o.PPPPP....',
+    '.o.PvPvP....',
+    '.o.PPPPP....',
+    '..PPPPPPP...',
+    '....g..g....',
+    '...GG..GG...',
+  ],
+  bat: [
+    '............',
+    '............',
+    '............',
+    'P.........P.',
+    'PP..P.P..PP.',
+    'PPP.PPP.PPP.',
+    'PPPPPxPxPPPP',
+    '.PPPPPPPPPP.',
+    '..PP.PPP.PP.',
+    '.P....w....P',
+    '............',
+    '............',
+    '............',
+    '............',
+  ],
+  spider: [
+    '............',
+    '............',
+    '............',
+    '............',
+    '....hhhh....',
+    '..hhhhhhhh..',
+    '.hhxhxhhhhh.',
+    'h.hhhhhhhh.h',
+    'h.hhhhhhhh.h',
+    '.h.h.hh.h.h.',
+    '.h.h.hh.h.h.',
+    'h..h....h..h',
+    '...h....h...',
+    '............',
+  ],
+  golem: [
+    '............',
+    '....MMMM....',
+    '...MmmmmM...',
+    '...McmcmM...',
+    '...MmmmmM...',
+    '.MMMMMMMMMM.',
+    'MmmMmmmmMmmM',
+    'MmmMmmcmMmmM',
+    'MmmMmmmmMmmM',
+    '.MM.MMMM.MM.',
+    '....Mm.mM...',
+    '...MMm.mMM..',
+    '...MMM.MMM..',
+    '............',
+  ],
+  skeleton: [
+    '............',
+    '....nnnn....',
+    '...nnnnnn...',
+    '...nknnkn...',
+    '...nnnnnn...',
+    '....nNnN....',
+    '.M...nn.....',
+    '.M.nnnnnn...',
+    '.MnnNnNnnn..',
+    '.M..nnnn....',
+    '....N..N....',
+    '....n..n....',
+    '....n..n....',
+    '...nn..nn...',
+  ],
+  ghost: [
+    '............',
+    '....zzzz....',
+    '...zzzzzz...',
+    '..zzkzzkzz..',
+    '..zzkzzkzz..',
+    '..zzzzzzzz..',
+    '.zzzzkkzzzz.',
+    '.zzzzzzzzzz.',
+    '.zzzzzzzzzZ.',
+    '.zzzzzzzzzZ.',
+    '..zzzzzzzZ..',
+    '..zZ.zZ.zZ..',
+    '..Z..Z..Z...',
+    '............',
+  ],
+  cultist: [
+    '....RRRR....',
+    '...RRRRRR...',
+    '..RRkkkkRR..',
+    '..RkxkkxkR..',
+    '..RkkkkkkR..',
+    '...RRRRRR...',
+    '.E.RRRRRR...',
+    '.ERRrRRrRR..',
+    '.o.RRRRRR...',
+    '.o.RrRRrR...',
+    '.o.RRRRRR...',
+    '..RRRRRRRR..',
+    '..RR....RR..',
+    '............',
+  ],
+  knight: [
+    '....nnnn....',
+    '...MMMMMM...',
+    '...MkxkxM...',
+    '...MMMMMM...',
+    '....nNnN....',
+    'm..MMMMMM...',
+    'm.MmMMMMmM..',
+    'mmMmmnnmmM..',
+    'm.MmMnnMmM..',
+    'm..MMMMMM...',
+    '...MmmmmM...',
+    '....M..M....',
+    '....n..n....',
+    '...MM..MM...',
+  ],
+  goblinKing: [
+    '..e.e.e.e...',
+    '..eeeeeee...',
+    '.g.ggggg.g..',
+    '.gggxggxgg..',
+    '..ggggggg...',
+    '...gwwwg....',
+    '.rrrGGGrrr..',
+    'rrreeeeerrr.',
+    'r.geeeeegr.o',
+    'r.gTTTTTg.oo',
+    'r..ttttt..o.',
+    '...gg.gg....',
+    '...gg.gg....',
+    '..GGG.GGG...',
+  ],
+  wyrm: [
+    '............',
+    '..c.........',
+    '.ccC........',
+    'cCxCC.......',
+    'CCCCCc......',
+    '.wCCCCc..c..',
+    '...CCCCc.cC.',
+    '...cCCCCcCCC',
+    '..cCCcCCCCC.',
+    '..CCccCCCCC.',
+    '.CC.cCCCCCC.',
+    '.C..CC.CC.CC',
+    '....C..C...C',
+    '...CC.CC....',
+  ],
+  lich: [
+    '..e.e.e.....',
+    '..eeeee.....',
+    '..nnnnn..p..',
+    '..nxnxn.ppp.',
+    '..nnnnn..p..',
+    '...nNn...o..',
+    '.PPPPPPP.o..',
+    'PPpPPPpPPn..',
+    'P.PPPPPP.o..',
+    'n.PpPPpP.o..',
+    '..PPPPPP.o..',
+    '.PPpPPpPP...',
+    '.PPPPPPPP...',
+    'PPP.PP.PPP..',
+  ],
+}
+
+/** Size of one sprite pixel, in CSS pixels. */
+export const PIXEL = 4
+export const SPRITE_COLUMNS = 12
+export const SPRITE_ROWS = 14
+
+/** How big each rank is drawn, in sprite pixels per pixel. */
+export const RANK_SCALE: Readonly<Record<'normal' | 'elite' | 'boss', number>> = { normal: 1, elite: 1.25, boss: 1.75 }
+
+/** Elites keep their kind's look with a gold tint over it. */
+const ELITE_TINT = '#f2c14e'
+
+/**
+ * @brief Draws a sprite as one SVG, one rect per row run of a color.
+ *
+ * @param look - A class id, an enemy kind or a boss key; an unknown look draws the recruit.
+ * @param options - `flip` mirrors it to face left; `pixel` sets the size of a pixel; `tint` washes it in a color
+ *   (an elite's gold); `isDown` greys it and lays it on its side.
+ * @returns The SVG markup as a string.
+ */
+export function spriteSvg(look: string, options: { flip?: boolean; pixel?: number; tint?: string; isDown?: boolean } = {}): string {
+  const rows = SPRITES[look] ?? SPRITES.recruit ?? []
+  const size = options.pixel ?? PIXEL
+  const width = SPRITE_COLUMNS * size
+  const height = SPRITE_ROWS * size
+  const rects: string[] = []
+  rows.forEach((row, y) => {
+    let x = 0
+    while (x < row.length) {
+      const letter = row.charAt(x)
+      let run = 1
+      while (x + run < row.length && row.charAt(x + run) === letter) run++
+      const color = PALETTE[letter]
+      if (color !== undefined) {
+        const left = options.flip === true ? SPRITE_COLUMNS - x - run : x
+        rects.push(`<rect x="${left * size}" y="${y * size}" width="${run * size}" height="${size}" fill="${color}"/>`)
+      }
+      x += run
+    }
+  })
+  const tint = options.tint === undefined ? '' : `<rect width="${width}" height="${height}" fill="${options.tint}" opacity="0.18" style="mix-blend-mode:overlay"/>`
+  const down = options.isDown === true ? ` opacity="0.45" style="filter:grayscale(1)"` : ''
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" shape-rendering="crispEdges"${down}>${rects.join('')}${tint}</svg>`
+}
+
+/** The tint an elite of any kind gets. */
+export function eliteTint(rank: 'normal' | 'elite' | 'boss'): string | undefined {
+  return rank === 'elite' ? ELITE_TINT : undefined
+}

package/mods/agent-adventure/types/index.d.ts

@@ -0,0 +1,248 @@
+// packages/g3n-mods/mods/agent-adventure/types/index.d.ts
+
+/** A hero's class: picks its look, its stats, its basic action and the pool its skills come from. */
+export type ClassId = 'fighter' | 'healer' | 'monk' | 'ranger' | 'mage' | 'guardian' | 'rogue'
+
+/** A dungeon's theme: its enemies, its boss and its colors. */
+export type RegionId = 'woods' | 'caves' | 'crypt'
+
+/** What a skill does when used; `passive` skills are never used, they raise a stat. */
+export type SkillKind =
+  | 'strike' | 'multi' | 'cleave' | 'stun' | 'burn' | 'drain'
+  | 'heal' | 'healSelf' | 'healAll' | 'revive' | 'mend'
+  | 'shield' | 'taunt' | 'rally' | 'passive'
+
+/** A stat a passive skill or a relic raises. */
+export type StatId = 'hp' | 'atk' | 'def' | 'spd' | 'crit' | 'evade'
+
+/** One skill, a basic action, or an enemy's special. */
+export type SkillDef = {
+  id: string
+  name: string
+  kind: SkillKind
+  /** Damage multiplier, healed share of max HP, or the effect's strength, by kind */
+  power: number
+  /** Own turns to wait after use; 0 for a basic action */
+  cd: number
+  /** Turns an effect lasts (shield, taunt, rally, burn) */
+  turns?: number
+  /** Hits of a `multi` skill */
+  hits?: number
+  /** The stat a `passive` skill raises, by `power` as a share (0.2 is +20%) or flat for crit and evade */
+  stat?: StatId
+  blurb: string
+}
+
+/** A hero, kept across sessions in the mod's store under `hero:<id>`. Times are milliseconds since the epoch. */
+export type Hero = {
+  id: string
+  name: string
+  cls: ClassId
+  level: number
+  /** XP toward the next level */
+  xp: number
+  /** Highest level reached; reaching a new multiple of 10 above it offers a skill choice */
+  bestLevel: number
+  /** Learned skill ids, oldest first, at most 3 */
+  skills: string[]
+  /** The agent kind this hero turns up for: `main` for the main thread, else a subagent type such as `Explore` */
+  calling: string
+  motto?: string
+  /** How this hero feels about others, by hero id, from -2 to 2. Set by its agent through the mod's tool */
+  feelings: Record<string, number>
+  /** Who picked the name: the game's name list, the model, or the hero's own agent */
+  namedBy: 'game' | 'model' | 'agent'
+  /** Still waiting for the model to christen it; it does not fight yet */
+  isRecruit: boolean
+  /** Two skill ids offered at a milestone, waiting on a pick */
+  choice?: [string, string]
+  /** Boss names this hero has beaten; permanent trophies */
+  trophies: string[]
+  record: { runs: number; wins: number; wipes: number; kills: number }
+  createdAt: number
+}
+
+/** An effect on a fighter, counted down at the start of its own turns. */
+export type Effect = {
+  kind: 'shield' | 'taunt' | 'burn' | 'stun' | 'rally' | 'enrage'
+  turns: number
+  power: number
+}
+
+/** A hero or an enemy in a fight. */
+export type Fighter = {
+  /** The hero's id, or `e<n>` for an enemy */
+  id: string
+  side: 'hero' | 'enemy'
+  name: string
+  /** Sprite: a class id or an enemy kind */
+  look: string
+  level: number
+  hp: number
+  maxHp: number
+  atk: number
+  def: number
+  spd: number
+  crit: number
+  evade: number
+  /** Readiness; the fighter acts once it holds the most and at least `READY` */
+  gauge: number
+  basic: SkillDef
+  skills: SkillDef[]
+  cooldowns: Record<string, number>
+  effects: Effect[]
+  /** HP restored at the start of each own turn, a share of max HP (a relic's) */
+  regen: number
+  rank: 'normal' | 'elite' | 'boss'
+  /** A boss's phase: 1, then 2 once below half HP */
+  phase: number
+}
+
+/** One stop of a run's path. A `fork` sets the kind of the stop after it. */
+export type StopKind = 'fight' | 'elite' | 'fork' | 'camp' | 'boss'
+
+/** One adventure through a generated dungeon. Heroes keep their levels; this and its loot do not outlive it. */
+export type Run = {
+  number: number
+  region: RegionId
+  path: StopKind[]
+  /** Index of the stop the party is at */
+  at: number
+  /** Encounters fought so far this run; raises the tier of the next */
+  fought: number
+  relics: string[]
+  potions: number
+  /** HP each hero carries between fights, by hero id; a hero not listed starts full */
+  hp: Record<string, number>
+  /** A phoenix feather was used this run */
+  isFeatherUsed: boolean
+  /** Doubled XP on the next fight: the party took the dangerous route */
+  isDaring: boolean
+}
+
+/** What the party is doing. `wait` counts ticks left in the scene. */
+export type Scene =
+  | { kind: 'tavern' }
+  | { kind: 'travel'; wait: number }
+  | { kind: 'fight' }
+  | { kind: 'victory'; wait: number }
+  | { kind: 'fork'; wait: number; id: number; route?: 'safe' | 'danger'; why?: string; by?: string }
+  | { kind: 'camp'; wait: number }
+  | { kind: 'wipe'; wait: number }
+  | { kind: 'cleared'; wait: number }
+
+/** A running agent and the hero it plays. */
+export type Binding = {
+  /** `main`, or the subagent's id */
+  agent: string
+  heroId: string
+  /** Tick the agent's turn ended; it stays in the party a short while after */
+  leftAt?: number
+}
+
+/** A line of the adventure's log. */
+export type LogLine = { id: number; text: string; tone: 'info' | 'good' | 'bad' | 'loot' | 'level' }
+
+/** A visual event the view animates once, by id. */
+export type Fx = {
+  id: number
+  kind: 'act' | 'hit' | 'miss' | 'heal' | 'down' | 'buff' | 'level' | 'learn' | 'phase' | 'say'
+  /** The fighter or hero it happens to */
+  at: string
+  /** The fighter who acted, for `act` */
+  from?: string
+  amount?: number
+  isCrit?: boolean
+  text?: string
+}
+
+/** The whole game, held in session state and drawn by the pane. */
+export type World = {
+  heroes: Hero[]
+  bindings: Binding[]
+  run: Run | null
+  scene: Scene
+  /** The fight in progress */
+  fighters: Fighter[]
+  /** Actions taken in the fight in progress */
+  turns: number
+  log: LogLine[]
+  fx: Fx[]
+  /** Next id for a log line, an fx or a fork */
+  seq: number
+  tick: number
+  /** Random state; every roll comes from it, so a world steps the same way twice */
+  rng: number
+  runs: number
+  /** Multiplier on enemy HP and attack: rises while the party wins easily, falls after close fights and wipes */
+  threat: number
+  /** Show calmer animations */
+  isCalm: boolean
+}
+
+/** One hero or fighter as the view draws it. */
+export type UnitView = {
+  id: string
+  name: string
+  look: string
+  side: 'hero' | 'enemy'
+  level: number
+  hp: number
+  maxHp: number
+  rank: 'normal' | 'elite' | 'boss'
+  isDown: boolean
+  /** Short tags: `stunned`, `shielded`, `burning`, `taunting`, `rallied`, `enraged` */
+  tags: string[]
+  /** Class or enemy name, e.g. `Healer` */
+  title: string
+  /** The hero plays an agent right now */
+  isActive?: boolean
+  xpShare?: number
+  skills?: string[]
+  motto?: string
+  trophies?: number
+}
+
+/** A hero of the guild as the roster lists it. */
+export type RosterEntry = {
+  id: string
+  name: string
+  look: string
+  title: string
+  level: number
+  xpShare: number
+  skills: string[]
+  motto?: string
+  trophies: number
+  isActive: boolean
+  /** How many runs, wins and wipes, e.g. `12 runs · 9 cleared · 1 wipe` */
+  record: string
+}
+
+/** What the view gets. */
+export type ViewData = {
+  scene: Scene['kind']
+  region: { id: RegionId; name: string } | null
+  runNumber: number
+  stops: Array<{ kind: StopKind; state: 'done' | 'here' | 'ahead' }>
+  heroes: UnitView[]
+  enemies: UnitView[]
+  log: LogLine[]
+  fx: Fx[]
+  relics: Array<{ name: string; icon: string; blurb: string }>
+  potions: number
+  /** Scene caption, e.g. `The party argues about the route…` */
+  caption: string
+  isCalm: boolean
+  trophies: number
+  /** Every christened hero, highest level first */
+  roster: RosterEntry[]
+  /** The threat as a percentage of normal, e.g. 130 */
+  threat: number
+}
+
+declare module 'claude-code' {
+  interface PluginState {
+    'agent-adventure': { world: World | null }
+  }
+}

package/mods/agent-adventure/view/panes.json

@@ -0,0 +1,8 @@
+{
+  "panes": [
+    {
+      "id": "agent-adventure",
+      "title": "Agent Adventure"
+    }
+  ]
+}