#moon-hutool

# moon.mod —— 本库的 import 段有且仅有下面这一条，它就是那条例外的全部形状
import { "moonbitlang/async@0.22.4" }

#文档索引

本表里的仓内链接一律写成 GitHub 绝对地址：发布包根是模块目录，相对路径在 mooncakes 页面上是死链（这条由门禁 G10 盯着，索引不许漂成死链）。

#状态

#零依赖是可验的，不是形容词

1. moon tree --json 的 modules[] 里除本仓与 moonbitlang/core 之外只许出现 moonbitlang/async 一个节点，且 moon.mod 的 import 段有且仅有那一条；除此之外任何 registry 依赖（官方的 moonbitlang/x 也在内）都判红。这条腿自己带阳性对照（塞一个假第三方必须被抓）与"一个节点都没读到就判红"——它 10-09 之前就在走一种 moon tree 根本不输出的嵌套形状，于是一直空转报绿；
2. 全仓 grep 'extern "' 命中 0 —— 不写任何 JS/C/WASI 绑定；
3. 除 sched 之外全库同步、无 async ⇒ 其余每个包的同一份 API 在 wasm / wasm-gc / js / native 四档都能编译；sched 因为要事件循环只承诺三档，第四档由包级 supported_targets 摘掉（实测：moon check --target wasm-gc 编得过，但 moon run/moon test 在该档报 [4021] Value run_async_main not found——"编得过"不等于"跑得动"）；
4. OS 能力只走 core 给的三扇窗：@env.now()（epoch 毫秒）、@env.rand(n)、@env.get_env_var(k)（10-07 第五批加，宿主时区只能从 TZ 拿）；三扇窗都必须可覆盖或可注入——时钟走 date.clock_fixed，默认区走 date.set_default_zone。read_file、网络、宿主 API 仍在禁令里。

#为什么不复用生态里已有的包

#能力对照与不承诺清单

• 对照表：docs/spec/00-hutool-map.md —— 四列：hutool 类.方法 ｜ core 直接可用（打哪条）｜ 本库补（哪类）｜ 不做
• 明确不做：BeanUtil/ReflectUtil/MapProxy/aop/script（MoonBit 无运行时反射与动态代理，Bean 拷贝请走内置 derive(ToJson)/derive(FromJson) 或手写映射）；FileUtil/IoUtil/NetUtil/ThreadUtil（需 FFI）；http/db/socket/poi/captcha；DateUtil 的智能无格式解析与 java.text 全套 pattern；Unicode 大小写；完整 BigDecimal。cron 的表达式面在第 19 行 cron，触发面在第 24 行 sched（全仓唯一依赖官方 moonbitlang/async 的包，只承诺三档）
• 时区那一档已翻案：date 内置 IANA 段表（现读 date/zone_table.mbt，603 区、窗口 [1970,2050)），偏移承诺到整分钟——窗口内只有 Africa/Monrovia 一区两年不是整分钟，已在 spec 里作分岔双栏读数。这里从前写过一句"不支持"，那句过期了，现在由门禁 G14 拿 zone_names/zone_offset_minutes 现读反查拦住
• 移植来源声明：本项目移植的是 hutool 的能力与语义，实现按外部规范（RFC / FIPS）或独立设计重写，未复制 Java 源码。hutool 本体为 MulanPSL-2.0；少数类（CharSequenceUtil、date/format/*、ComparatorChain、AntPathMatcher）自带 Apache Commons / Spring 上游署名，本库对应格子按 Apache 系处理（见各 spec 的"血统"列）。

#用法

moon add mldong/moon-hutool/text
moon add mldong/moon-hutool/digest

[deps]
"mldong/moon-hutool/text" = "0.1.0"
"mldong/moon-hutool/digest" = "0.1.0"

版本号一律现读：moon.mod 里的 version 是当前待发布的代次，装哪一代请以注册表索引为准 （$MOON_HOME/registry/index/user/mldong/moon-hutool.index），别照抄本文档。发版通道见 .github/workflows/publish.yml， 版本变化记在 CHANGELOG.md。 包与包之间的依赖（typex→num/text/valid、cron→date、codec/id→digest、bloom→hash） 都在同一模块内，引用其中一个包即可自动带上其余。

// moon.pkg —— 只带需要的包
import {
  "mldong/moon-hutool/text" @text,
  "mldong/moon-hutool/digest" @digest,
}

fn demo() {
  assert @text.is_blank("  \t ")
  assert @text.format("id={} name={}", ["7"]) == "id=7 name={}" // 参数不足则原样留
  assert @digest.md5_hex("abc") == "900150983cd24fb0d6963f7d28e17f72" // RFC 1321
}

#开发

export MOON_HOME=<moon 工具链目录>   # Git Bash 下用 /g/ 之类 POSIX 盘符写法
moon check --target wasm && moon test --target wasm
moon info && moon fmt                # .mbti 是公开接口，diff 即 API 变更评审面
scripts/contract_gate.sh             # G1~G19 十九条判据

#许可