[hast] Add content maps

[wooorm]

Similar to #54421, and #52375, this implements a map for the parents defined by hast. One specific example use case is to add raw nodes to the AST. Raw nodes are added by mdast-util-to-hast and either handled by hast-util-raw or serialized untouched by hast-util-to-html.

Note for the reviewers: xast uses ChildMaps. mdast uses a ContentMaps. Preference?

Please fill in this template.

• Use a meaningful title for the pull request. Include the name of the package modified.
• Test the change in your own code. (Compile and run.)
• Add or edit tests to reflect the change.
• Follow the advice from the readme.
• Avoid common mistakes.
• Run npm test <package to test>.

Select one of these and delete the others:

If changing an existing definition:

• Provide a URL to documentation or source code which provides context for the suggested changes: https://github.com/syntax-tree/mdast-util-to-hast#optionsallowdangeroushtml
• If this PR brings the type definitions up to date with a new version of the JS library, update the version number in the header.

[typescript-bot]

@wooorm Thank you for submitting this PR!

This is a live comment which I will keep updated.

1 package in this PR

• hast — on npm, on unpkg
  • owner-approval: @ChristianMurphy

Code Reviews

Because this is a widely-used package, a DT maintainer will need to review it before it can be merged.

You can test the changes of this PR in the Playground.

Status

• ✅ No merge conflicts
• ✅ Continuous integration tests have passed
• ✅ Most recent commit is approved by a DT maintainer

All of the items on the list are green. To merge, you need to post a comment including the string "Ready to merge" to bring in your changes.

---

Diagnostic Information: What the bot saw about this PR

{
  "type": "info",
  "now": "-",
  "pr_number": 55187,
  "author": "wooorm",
  "headCommitOid": "b93cf3902def233e35cc704c070bfdefa473eb48",
  "lastPushDate": "2021-08-17T09:04:17.000Z",
  "lastActivityDate": "2021-08-22T06:18:00.000Z",
  "mergeOfferDate": "2021-08-21T21:25:49.000Z",
  "mergeRequestDate": "2021-08-22T06:18:00.000Z",
  "mergeRequestUser": "wooorm",
  "hasMergeConflict": false,
  "isFirstContribution": false,
  "tooManyFiles": false,
  "popularityLevel": "Critical",
  "pkgInfo": [
    {
      "name": "hast",
      "kind": "edit",
      "files": [
        {
          "path": "types/hast/hast-tests.ts",
          "kind": "test"
        },
        {
          "path": "types/hast/index.d.ts",
          "kind": "definition"
        }
      ],
      "owners": [
        "lukeggchapman",
        "rokt33r",
        "ChristianMurphy"
      ],
      "addedOwners": [],
      "deletedOwners": [],
      "popularityLevel": "Critical"
    }
  ],
  "reviews": [
    {
      "type": "approved",
      "reviewer": "rbuckton",
      "date": "2021-08-21T21:25:08.000Z",
      "isMaintainer": true
    },
    {
      "type": "approved",
      "reviewer": "ChristianMurphy",
      "date": "2021-08-17T14:07:55.000Z",
      "isMaintainer": false
    },
    {
      "type": "approved",
      "reviewer": "remcohaszing",
      "date": "2021-08-17T09:13:24.000Z",
      "isMaintainer": false
    }
  ],
  "mainBotCommentID": 900125964,
  "ciResult": "pass"
}

[typescript-bot]

🔔 @lukeggchapman @Rokt33r @ChristianMurphy — please review this PR in the next few days. Be sure to explicitly select Approve or Request Changes in the GitHub UI so I know what's going on.

[wooorm]

/cc @remcohaszing

[typescript-bot]

@wooorm: Everything looks good here. I am ready to merge this PR (at b93cf39) on your behalf whenever you think it's ready.

If you'd like that to happen, please post a comment saying:

Ready to merge

and I'll merge this PR almost instantly. Thanks for helping out! ❤️

(@lukeggchapman, @Rokt33r, @ChristianMurphy: you can do this too.)

[wooorm]

Ready to merge

[typescript-bot]

I just published @types/hast@2.3.4 to npm.