#moon-weblink

• Module: 15614376790/moon-weblink (version 0.1.0)
• Targets: wasm-gc, js, native
• License: Apache-2.0
• Repository: https://github.com/15614376790/moon-weblink

#Features

• RFC 8288 Link header parsing and serialization — link-values, target attributes (anchor, hreflang, media, title, title*, type), extension parameters, first-wins duplicate handling, and a deterministic canonical form.
• RFC 8187 extended values — title* and name* parameters, full charset/language/percent-decoding, plus a pure function serializer.
• RFC 3986 URI-reference support — a minimal but strict parser and reference resolution (Section 5.2.2), used for targets, anchors and resolving relative links.
• RFC 9264 Linkset — both application/linkset (multiline text) and application/linkset+json, with semantics-preserving conversion at the model level between the header, text and JSON forms for the supported RFC 8288 / RFC 9264 scope.
• Offline IANA registry — 134 relation types bundled as a generated snapshot (see testdata/iana/); membership checks never touch the network.
• Query API — find and filter links by relation type, media type and hreflang; next / prev / canonical / alternate helpers.
• Deterministic audit — flags the deprecated rev, relation types that look registered but are not, title/title* coexistence, duplicates, relative anchors and out-of-limits values.
• Resource limits — default, strict and permissive presets bounded by input size, link count, parameter count, name/value sizes and more.
• Structured errors — LinkError with a stable (stage, kind) pair, a UTF-8 byte offset into the input, and a context excerpt capped at 80 bytes.
• CLI — weblink-tool subcommands to parse, validate, canonicalize, query, convert, look up relations and audit.
• Safety — truncation-safe (every byte-prefix of any input never panics) and malformed-input-safe; 147 named tests pass on all three targets.

#Layout

moon.mod                 module manifest (15614376790/moon-weblink 0.1.0)
lib source (.mbt)        parser, serializer, model, linkset, audit, query, ...
cmd/weblink-tool/        command-line tool
examples/                five runnable example programs
testdata/iana/           offline IANA registry snapshot (CSV + SOURCE.json)
scripts/                 verification and generation helpers
docs/                    design and process documentation

#Quick start

moon check --target native
moon test --target native
moon run cmd/weblink-tool -- parse --input '<https://example.com/page/2>; rel="next"'
moon run examples/pagination

powershell -ExecutionPolicy Bypass -File scripts\verify_all.ps1

#Library usage

fn main {
  // Parse a Link header field value into a shared model.
  let links = @weblink.parse_link_header(
    "</users?page=2>; rel=\"next\", </users?page=1>; rel=\"prev\"",
    @weblink.Limits::default(),
  )

  match links {
    Err(e) => println("error: \{e.to_display()}")
    Ok(links) => {
      // Query helpers: find next/prev, filter by relation or media type.
      match @weblink.find_next(links) {
        Some(next) => println("next: \{next.target()}")
        None => println("no next link")
      }
      // Convert the whole collection to application/linkset+json and back.
      let json = @weblink.serialize_linkset_json(
        @weblink.LinkSet::from_links(links),
      )
      println(json)
    }
  }
}

#CLI

weblink-tool parse            parse a Link header and print each link
weblink-tool validate         report valid / invalid
weblink-tool canonicalize     emit the canonical Link header form
weblink-tool query            find links by --rel / --type / --hreflang
weblink-tool to-linkset-json  convert a Link header to application/linkset+json
weblink-tool from-linkset-json convert application/linkset+json to a Link header
weblink-tool to-linkset-text  convert to application/linkset text
weblink-tool relation         query the offline IANA relation registry
weblink-tool audit            audit a Link header for issues
weblink-tool stats            library and registry statistics
weblink-tool version | help

#Examples

#Documentation

• Architecture — modules, data model, error model, determinism.
• Specification map — every RFC requirement and where it is implemented.
• Testing — the 147 tests, property and truncation corpora, targets.
• Reproduction — how to reproduce every number in this README.
• Security — parser safety, resource limits, no network, no secrets.
• Limitations — what this toolkit deliberately does not do.
• Renaming — record of the completed localdev/moon-weblink → 15614376790/moon-weblink namespace rename, and how to rename again.
• CHANGELOG — release history.
• CONTRIBUTING — how to build, test and contribute.
• THIRD_PARTY_NOTICES — IANA registry data provenance.

#Measured numbers

• 147 named tests (140 library blackbox tests + 7 CLI argument-handling tests), all passing on wasm-gc, js and native.
• 1200 deterministic property-test cases (fixed seeds) + 2504 truncation (prefix, parser) cases — every byte-prefix of the complex inputs parses without panicking.
• Code lines (blank and comment lines excluded): core 3403, CLI + examples 872, tests 1958, total 6233.
• 134 relation types in the offline IANA snapshot; the checked-in generated_relations.mbt matches the snapshot byte-for-byte.

#License