Commit Graph

10 Commits

Author SHA1 Message Date
b30140ddcb docs(10-07): 讲清 state 获取方式
- data-state-overview 用平实语言解释主对象 state(总目录比喻)
- 新增「state 从哪来」小节:框架参数传入(useEffect/插件/env.state)、handler.state、this.state
- 说明示例假设 state 已在作用域中;保留对象表与 L0-L3 分组
2026-10-17 20:56:52 +08:00
2266c15595 docs(10-05): write events, replay-commands, and data-plugins docs
- events: BuiltInFunction, IBlockEventEnv, createEventRegistrations, setFlag/healHero examples
- replay-commands: core principle, Active/Passive, @shouldReplay/@ignoreReplay (no example)
- data-plugins: IDataPluginDefine lifecycle, dataPlugins registration, placeholder example
2026-10-17 18:59:50 +08:00
0868650847 docs(10-04): write map damage, combat script, and status hook docs
- document map damage views, converters, reducers, and code mapping caveat
- add combat script selection table and before/after examples
- explain multi-hook status handling and calculator integration
2026-10-17 18:45:48 +08:00
e13ebf71ed docs(10-04): write query, final, and calculator docs
- document query effects as new, not built into the engine
- add final effect comparison and attack-copy example
- explain damage formula, critical conventions, and arithmetic example
2026-10-17 18:44:16 +08:00
5528edc70d docs(10-04): write combat overview, specials, and aura docs
- add combat flow overview with mermaid and doc map
- document special attribute definitions and implementation locations
- document aura priority, built-in auras, and custom examples
2026-10-17 18:43:06 +08:00
a3f55112b7 docs(10-03): write map-tiles and flags
- 地图图块:getBlock/setBlock/removeBlock/putMapData/getMapData/iterateBlocks
- Flag 变量:全部接口(含 occupied/getOrInsertComputed)与使用建议
2026-10-17 18:02:07 +08:00
0d14d32a48 docs(10-03): write hero-equipment, hero-location, map-structure
- 勇士装备:装备槽与实例仓库、装备加成即修饰器、compareEquip
- 勇士位置:坐标、朝向与楼层的获取
- 地图结构:楼层集合、楼层激活、楼层与图层(含事件层)
2026-10-17 18:01:19 +08:00
627a40bc4b docs(10-03): write data-state-overview, hero-attribute, hero-items
- 数据端总览:state 入口、常用对象表与 L0-L3 分层标注
- 勇士属性:基础/最终属性、修饰器、save 语义、只读与试算
- 勇士道具:四种类别区分与 addItem/useItem/iterateItems 等接口
2026-10-17 18:00:04 +08:00
c47aa5269b docs(10-02): write code-basics and hooks concept docs
- code-basics: concise syntax, modules/imports, types intro (generics as
  'functions of types'), interface/implements convention, approved external link
- hooks: what hooks are, common hook families, need-to-hook table, addHook/
  removeHook usage, async hooks
2026-10-17 17:49:49 +08:00
2ea8cb33f5 docs(10-02): write data-vs-render and src-tour concept docs
- data-vs-render: dual-end split (compute vs draw), src/data vs src/client,
  mermaid diagram, replay verification runs data side only
- src-tour: tour src/data, src/client, src/content, src/constant.ts plus a
  should-you-edit table
2026-10-17 17:48:28 +08:00