@alloy-js/core 0.24.0-dev.1 → 0.24.0-dev.6

package/src/render/get-string-width.ts

@@ -0,0 +1,201 @@
+/**
+ * Vendored from prettier@3.6.2 — `src/utils/get-string-width.js` plus the
+ * `emoji-regex` and `get-east-asian-width` data tables it depends on.
+ *
+ * Extracted verbatim from `node_modules/prettier/doc.js` (lines 688–727)
+ * so that the alloy fused printer can produce byte-identical output to
+ * Prettier's `printDocToString` without taking on a runtime dependency
+ * on Prettier's internals.
+ *
+ * Sources:
+ *   - https://github.com/mathiasbynens/emoji-regex (MIT)
+ *   - https://github.com/sindresorhus/get-east-asian-width (MIT)
+ *   - https://github.com/prettier/prettier (MIT)
+ *
+ * Do not edit by hand. Re-extract from prettier when bumping versions.
+ */
+
+/* eslint-disable */
+// @ts-nocheck
+// node_modules/emoji-regex/index.mjs
+var emoji_regex_default = () => {
+  return /[#*0-9]\uFE0F?\u20E3|[\xA9\xAE\u203C\u2049\u2122\u2139\u2194-\u2199\u21A9\u21AA\u231A\u231B\u2328\u23CF\u23ED-\u23EF\u23F1\u23F2\u23F8-\u23FA\u24C2\u25AA\u25AB\u25B6\u25C0\u25FB\u25FC\u25FE\u2600-\u2604\u260E\u2611\u2614\u2615\u2618\u2620\u2622\u2623\u2626\u262A\u262E\u262F\u2638-\u263A\u2640\u2642\u2648-\u2653\u265F\u2660\u2663\u2665\u2666\u2668\u267B\u267E\u267F\u2692\u2694-\u2697\u2699\u269B\u269C\u26A0\u26A7\u26AA\u26B0\u26B1\u26BD\u26BE\u26C4\u26C8\u26CF\u26D1\u26E9\u26F0-\u26F5\u26F7\u26F8\u26FA\u2702\u2708\u2709\u270F\u2712\u2714\u2716\u271D\u2721\u2733\u2734\u2744\u2747\u2757\u2763\u27A1\u2934\u2935\u2B05-\u2B07\u2B1B\u2B1C\u2B55\u3030\u303D\u3297\u3299]\uFE0F?|[\u261D\u270C\u270D](?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?|[\u270A\u270B](?:\uD83C[\uDFFB-\uDFFF])?|[\u23E9-\u23EC\u23F0\u23F3\u25FD\u2693\u26A1\u26AB\u26C5\u26CE\u26D4\u26EA\u26FD\u2705\u2728\u274C\u274E\u2753-\u2755\u2795-\u2797\u27B0\u27BF\u2B50]|\u26D3\uFE0F?(?:\u200D\uD83D\uDCA5)?|\u26F9(?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?(?:\u200D[\u2640\u2642]\uFE0F?)?|\u2764\uFE0F?(?:\u200D(?:\uD83D\uDD25|\uD83E\uDE79))?|\uD83C(?:[\uDC04\uDD70\uDD71\uDD7E\uDD7F\uDE02\uDE37\uDF21\uDF24-\uDF2C\uDF36\uDF7D\uDF96\uDF97\uDF99-\uDF9B\uDF9E\uDF9F\uDFCD\uDFCE\uDFD4-\uDFDF\uDFF5\uDFF7]\uFE0F?|[\uDF85\uDFC2\uDFC7](?:\uD83C[\uDFFB-\uDFFF])?|[\uDFC4\uDFCA](?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDFCB\uDFCC](?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?(?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDCCF\uDD8E\uDD91-\uDD9A\uDE01\uDE1A\uDE2F\uDE32-\uDE36\uDE38-\uDE3A\uDE50\uDE51\uDF00-\uDF20\uDF2D-\uDF35\uDF37-\uDF43\uDF45-\uDF4A\uDF4C-\uDF7C\uDF7E-\uDF84\uDF86-\uDF93\uDFA0-\uDFC1\uDFC5\uDFC6\uDFC8\uDFC9\uDFCF-\uDFD3\uDFE0-\uDFF0\uDFF8-\uDFFF]|\uDDE6\uD83C[\uDDE8-\uDDEC\uDDEE\uDDF1\uDDF2\uDDF4\uDDF6-\uDDFA\uDDFC\uDDFD\uDDFF]|\uDDE7\uD83C[\uDDE6\uDDE7\uDDE9-\uDDEF\uDDF1-\uDDF4\uDDF6-\uDDF9\uDDFB\uDDFC\uDDFE\uDDFF]|\uDDE8\uD83C[\uDDE6\uDDE8\uDDE9\uDDEB-\uDDEE\uDDF0-\uDDF7\uDDFA-\uDDFF]|\uDDE9\uD83C[\uDDEA\uDDEC\uDDEF\uDDF0\uDDF2\uDDF4\uDDFF]|\uDDEA\uD83C[\uDDE6\uDDE8\uDDEA\uDDEC\uDDED\uDDF7-\uDDFA]|\uDDEB\uD83C[\uDDEE-\uDDF0\uDDF2\uDDF4\uDDF7]|\uDDEC\uD83C[\uDDE6\uDDE7\uDDE9-\uDDEE\uDDF1-\uDDF3\uDDF5-\uDDFA\uDDFC\uDDFE]|\uDDED\uD83C[\uDDF0\uDDF2\uDDF3\uDDF7\uDDF9\uDDFA]|\uDDEE\uD83C[\uDDE8-\uDDEA\uDDF1-\uDDF4\uDDF6-\uDDF9]|\uDDEF\uD83C[\uDDEA\uDDF2\uDDF4\uDDF5]|\uDDF0\uD83C[\uDDEA\uDDEC-\uDDEE\uDDF2\uDDF3\uDDF5\uDDF7\uDDFC\uDDFE\uDDFF]|\uDDF1\uD83C[\uDDE6-\uDDE8\uDDEE\uDDF0\uDDF7-\uDDFB\uDDFE]|\uDDF2\uD83C[\uDDE6\uDDE8-\uDDED\uDDF0-\uDDFF]|\uDDF3\uD83C[\uDDE6\uDDE8\uDDEA-\uDDEC\uDDEE\uDDF1\uDDF4\uDDF5\uDDF7\uDDFA\uDDFF]|\uDDF4\uD83C\uDDF2|\uDDF5\uD83C[\uDDE6\uDDEA-\uDDED\uDDF0-\uDDF3\uDDF7-\uDDF9\uDDFC\uDDFE]|\uDDF6\uD83C\uDDE6|\uDDF7\uD83C[\uDDEA\uDDF4\uDDF8\uDDFA\uDDFC]|\uDDF8\uD83C[\uDDE6-\uDDEA\uDDEC-\uDDF4\uDDF7-\uDDF9\uDDFB\uDDFD-\uDDFF]|\uDDF9\uD83C[\uDDE6\uDDE8\uDDE9\uDDEB-\uDDED\uDDEF-\uDDF4\uDDF7\uDDF9\uDDFB\uDDFC\uDDFF]|\uDDFA\uD83C[\uDDE6\uDDEC\uDDF2\uDDF3\uDDF8\uDDFE\uDDFF]|\uDDFB\uD83C[\uDDE6\uDDE8\uDDEA\uDDEC\uDDEE\uDDF3\uDDFA]|\uDDFC\uD83C[\uDDEB\uDDF8]|\uDDFD\uD83C\uDDF0|\uDDFE\uD83C[\uDDEA\uDDF9]|\uDDFF\uD83C[\uDDE6\uDDF2\uDDFC]|\uDF44(?:\u200D\uD83D\uDFEB)?|\uDF4B(?:\u200D\uD83D\uDFE9)?|\uDFC3(?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D(?:[\u2640\u2642]\uFE0F?(?:\u200D\u27A1\uFE0F?)?|\u27A1\uFE0F?))?|\uDFF3\uFE0F?(?:\u200D(?:\u26A7\uFE0F?|\uD83C\uDF08))?|\uDFF4(?:\u200D\u2620\uFE0F?|\uDB40\uDC67\uDB40\uDC62\uDB40(?:\uDC65\uDB40\uDC6E\uDB40\uDC67|\uDC73\uDB40\uDC63\uDB40\uDC74|\uDC77\uDB40\uDC6C\uDB40\uDC73)\uDB40\uDC7F)?)|\uD83D(?:[\uDC3F\uDCFD\uDD49\uDD4A\uDD6F\uDD70\uDD73\uDD76-\uDD79\uDD87\uDD8A-\uDD8D\uDDA5\uDDA8\uDDB1\uDDB2\uDDBC\uDDC2-\uDDC4\uDDD1-\uDDD3\uDDDC-\uDDDE\uDDE1\uDDE3\uDDE8\uDDEF\uDDF3\uDDFA\uDECB\uDECD-\uDECF\uDEE0-\uDEE5\uDEE9\uDEF0\uDEF3]\uFE0F?|[\uDC42\uDC43\uDC46-\uDC50\uDC66\uDC67\uDC6B-\uDC6D\uDC72\uDC74-\uDC76\uDC78\uDC7C\uDC83\uDC85\uDC8F\uDC91\uDCAA\uDD7A\uDD95\uDD96\uDE4C\uDE4F\uDEC0\uDECC](?:\uD83C[\uDFFB-\uDFFF])?|[\uDC6E\uDC70\uDC71\uDC73\uDC77\uDC81\uDC82\uDC86\uDC87\uDE45-\uDE47\uDE4B\uDE4D\uDE4E\uDEA3\uDEB4\uDEB5](?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDD74\uDD90](?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?|[\uDC00-\uDC07\uDC09-\uDC14\uDC16-\uDC25\uDC27-\uDC3A\uDC3C-\uDC3E\uDC40\uDC44\uDC45\uDC51-\uDC65\uDC6A\uDC79-\uDC7B\uDC7D-\uDC80\uDC84\uDC88-\uDC8E\uDC90\uDC92-\uDCA9\uDCAB-\uDCFC\uDCFF-\uDD3D\uDD4B-\uDD4E\uDD50-\uDD67\uDDA4\uDDFB-\uDE2D\uDE2F-\uDE34\uDE37-\uDE41\uDE43\uDE44\uDE48-\uDE4A\uDE80-\uDEA2\uDEA4-\uDEB3\uDEB7-\uDEBF\uDEC1-\uDEC5\uDED0-\uDED2\uDED5-\uDED7\uDEDC-\uDEDF\uDEEB\uDEEC\uDEF4-\uDEFC\uDFE0-\uDFEB\uDFF0]|\uDC08(?:\u200D\u2B1B)?|\uDC15(?:\u200D\uD83E\uDDBA)?|\uDC26(?:\u200D(?:\u2B1B|\uD83D\uDD25))?|\uDC3B(?:\u200D\u2744\uFE0F?)?|\uDC41\uFE0F?(?:\u200D\uD83D\uDDE8\uFE0F?)?|\uDC68(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDC68\uDC69]\u200D\uD83D(?:\uDC66(?:\u200D\uD83D\uDC66)?|\uDC67(?:\u200D\uD83D[\uDC66\uDC67])?)|[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC66(?:\u200D\uD83D\uDC66)?|\uDC67(?:\u200D\uD83D[\uDC66\uDC67])?)|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]))|\uD83C(?:\uDFFB(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D\uDC68\uD83C[\uDFFC-\uDFFF])))?|\uDFFC(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D\uDC68\uD83C[\uDFFB\uDFFD-\uDFFF])))?|\uDFFD(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D\uDC68\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF])))?|\uDFFE(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D\uDC68\uD83C[\uDFFB-\uDFFD\uDFFF])))?|\uDFFF(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?\uDC68\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D\uDC68\uD83C[\uDFFB-\uDFFE])))?))?|\uDC69(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:\uDC8B\u200D\uD83D)?[\uDC68\uDC69]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D(?:[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uDC66(?:\u200D\uD83D\uDC66)?|\uDC67(?:\u200D\uD83D[\uDC66\uDC67])?|\uDC69\u200D\uD83D(?:\uDC66(?:\u200D\uD83D\uDC66)?|\uDC67(?:\u200D\uD83D[\uDC66\uDC67])?))|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]))|\uD83C(?:\uDFFB(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFC-\uDFFF])))?|\uDFFC(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFB\uDFFD-\uDFFF])))?|\uDFFD(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF])))?|\uDFFE(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFB-\uDFFD\uDFFF])))?|\uDFFF(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D\uD83D(?:[\uDC68\uDC69]|\uDC8B\u200D\uD83D[\uDC68\uDC69])\uD83C[\uDFFB-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83D[\uDC68\uDC69]\uD83C[\uDFFB-\uDFFE])))?))?|\uDC6F(?:\u200D[\u2640\u2642]\uFE0F?)?|\uDD75(?:\uD83C[\uDFFB-\uDFFF]|\uFE0F)?(?:\u200D[\u2640\u2642]\uFE0F?)?|\uDE2E(?:\u200D\uD83D\uDCA8)?|\uDE35(?:\u200D\uD83D\uDCAB)?|\uDE36(?:\u200D\uD83C\uDF2B\uFE0F?)?|\uDE42(?:\u200D[\u2194\u2195]\uFE0F?)?|\uDEB6(?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D(?:[\u2640\u2642]\uFE0F?(?:\u200D\u27A1\uFE0F?)?|\u27A1\uFE0F?))?)|\uD83E(?:[\uDD0C\uDD0F\uDD18-\uDD1F\uDD30-\uDD34\uDD36\uDD77\uDDB5\uDDB6\uDDBB\uDDD2\uDDD3\uDDD5\uDEC3-\uDEC5\uDEF0\uDEF2-\uDEF8](?:\uD83C[\uDFFB-\uDFFF])?|[\uDD26\uDD35\uDD37-\uDD39\uDD3D\uDD3E\uDDB8\uDDB9\uDDCD\uDDCF\uDDD4\uDDD6-\uDDDD](?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDDDE\uDDDF](?:\u200D[\u2640\u2642]\uFE0F?)?|[\uDD0D\uDD0E\uDD10-\uDD17\uDD20-\uDD25\uDD27-\uDD2F\uDD3A\uDD3F-\uDD45\uDD47-\uDD76\uDD78-\uDDB4\uDDB7\uDDBA\uDDBC-\uDDCC\uDDD0\uDDE0-\uDDFF\uDE70-\uDE7C\uDE80-\uDE89\uDE8F-\uDEC2\uDEC6\uDECE-\uDEDC\uDEDF-\uDEE9]|\uDD3C(?:\u200D[\u2640\u2642]\uFE0F?|\uD83C[\uDFFB-\uDFFF])?|\uDDCE(?:\uD83C[\uDFFB-\uDFFF])?(?:\u200D(?:[\u2640\u2642]\uFE0F?(?:\u200D\u27A1\uFE0F?)?|\u27A1\uFE0F?))?|\uDDD1(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83E\uDDD1|\uDDD1\u200D\uD83E\uDDD2(?:\u200D\uD83E\uDDD2)?|\uDDD2(?:\u200D\uD83E\uDDD2)?))|\uD83C(?:\uDFFB(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFC-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF])))?|\uDFFC(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFB\uDFFD-\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF])))?|\uDFFD(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF])))?|\uDFFE(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFB-\uDFFD\uDFFF]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF])))?|\uDFFF(?:\u200D(?:[\u2695\u2696\u2708]\uFE0F?|\u2764\uFE0F?\u200D(?:\uD83D\uDC8B\u200D)?\uD83E\uDDD1\uD83C[\uDFFB-\uDFFE]|\uD83C[\uDF3E\uDF73\uDF7C\uDF84\uDF93\uDFA4\uDFA8\uDFEB\uDFED]|\uD83D[\uDCBB\uDCBC\uDD27\uDD2C\uDE80\uDE92]|\uD83E(?:[\uDDAF\uDDBC\uDDBD](?:\u200D\u27A1\uFE0F?)?|[\uDDB0-\uDDB3]|\uDD1D\u200D\uD83E\uDDD1\uD83C[\uDFFB-\uDFFF])))?))?|\uDEF1(?:\uD83C(?:\uDFFB(?:\u200D\uD83E\uDEF2\uD83C[\uDFFC-\uDFFF])?|\uDFFC(?:\u200D\uD83E\uDEF2\uD83C[\uDFFB\uDFFD-\uDFFF])?|\uDFFD(?:\u200D\uD83E\uDEF2\uD83C[\uDFFB\uDFFC\uDFFE\uDFFF])?|\uDFFE(?:\u200D\uD83E\uDEF2\uD83C[\uDFFB-\uDFFD\uDFFF])?|\uDFFF(?:\u200D\uD83E\uDEF2\uD83C[\uDFFB-\uDFFE])?))?)/g;
+};
+
+// node_modules/get-east-asian-width/lookup.js
+function isFullWidth(x) {
+  return (
+    x === 12288 || (x >= 65281 && x <= 65376) || (x >= 65504 && x <= 65510)
+  );
+}
+function isWide(x) {
+  return (
+    (x >= 4352 && x <= 4447) ||
+    x === 8986 ||
+    x === 8987 ||
+    x === 9001 ||
+    x === 9002 ||
+    (x >= 9193 && x <= 9196) ||
+    x === 9200 ||
+    x === 9203 ||
+    x === 9725 ||
+    x === 9726 ||
+    x === 9748 ||
+    x === 9749 ||
+    (x >= 9776 && x <= 9783) ||
+    (x >= 9800 && x <= 9811) ||
+    x === 9855 ||
+    (x >= 9866 && x <= 9871) ||
+    x === 9875 ||
+    x === 9889 ||
+    x === 9898 ||
+    x === 9899 ||
+    x === 9917 ||
+    x === 9918 ||
+    x === 9924 ||
+    x === 9925 ||
+    x === 9934 ||
+    x === 9940 ||
+    x === 9962 ||
+    x === 9970 ||
+    x === 9971 ||
+    x === 9973 ||
+    x === 9978 ||
+    x === 9981 ||
+    x === 9989 ||
+    x === 9994 ||
+    x === 9995 ||
+    x === 10024 ||
+    x === 10060 ||
+    x === 10062 ||
+    (x >= 10067 && x <= 10069) ||
+    x === 10071 ||
+    (x >= 10133 && x <= 10135) ||
+    x === 10160 ||
+    x === 10175 ||
+    x === 11035 ||
+    x === 11036 ||
+    x === 11088 ||
+    x === 11093 ||
+    (x >= 11904 && x <= 11929) ||
+    (x >= 11931 && x <= 12019) ||
+    (x >= 12032 && x <= 12245) ||
+    (x >= 12272 && x <= 12287) ||
+    (x >= 12289 && x <= 12350) ||
+    (x >= 12353 && x <= 12438) ||
+    (x >= 12441 && x <= 12543) ||
+    (x >= 12549 && x <= 12591) ||
+    (x >= 12593 && x <= 12686) ||
+    (x >= 12688 && x <= 12773) ||
+    (x >= 12783 && x <= 12830) ||
+    (x >= 12832 && x <= 12871) ||
+    (x >= 12880 && x <= 42124) ||
+    (x >= 42128 && x <= 42182) ||
+    (x >= 43360 && x <= 43388) ||
+    (x >= 44032 && x <= 55203) ||
+    (x >= 63744 && x <= 64255) ||
+    (x >= 65040 && x <= 65049) ||
+    (x >= 65072 && x <= 65106) ||
+    (x >= 65108 && x <= 65126) ||
+    (x >= 65128 && x <= 65131) ||
+    (x >= 94176 && x <= 94180) ||
+    x === 94192 ||
+    x === 94193 ||
+    (x >= 94208 && x <= 100343) ||
+    (x >= 100352 && x <= 101589) ||
+    (x >= 101631 && x <= 101640) ||
+    (x >= 110576 && x <= 110579) ||
+    (x >= 110581 && x <= 110587) ||
+    x === 110589 ||
+    x === 110590 ||
+    (x >= 110592 && x <= 110882) ||
+    x === 110898 ||
+    (x >= 110928 && x <= 110930) ||
+    x === 110933 ||
+    (x >= 110948 && x <= 110951) ||
+    (x >= 110960 && x <= 111355) ||
+    (x >= 119552 && x <= 119638) ||
+    (x >= 119648 && x <= 119670) ||
+    x === 126980 ||
+    x === 127183 ||
+    x === 127374 ||
+    (x >= 127377 && x <= 127386) ||
+    (x >= 127488 && x <= 127490) ||
+    (x >= 127504 && x <= 127547) ||
+    (x >= 127552 && x <= 127560) ||
+    x === 127568 ||
+    x === 127569 ||
+    (x >= 127584 && x <= 127589) ||
+    (x >= 127744 && x <= 127776) ||
+    (x >= 127789 && x <= 127797) ||
+    (x >= 127799 && x <= 127868) ||
+    (x >= 127870 && x <= 127891) ||
+    (x >= 127904 && x <= 127946) ||
+    (x >= 127951 && x <= 127955) ||
+    (x >= 127968 && x <= 127984) ||
+    x === 127988 ||
+    (x >= 127992 && x <= 128062) ||
+    x === 128064 ||
+    (x >= 128066 && x <= 128252) ||
+    (x >= 128255 && x <= 128317) ||
+    (x >= 128331 && x <= 128334) ||
+    (x >= 128336 && x <= 128359) ||
+    x === 128378 ||
+    x === 128405 ||
+    x === 128406 ||
+    x === 128420 ||
+    (x >= 128507 && x <= 128591) ||
+    (x >= 128640 && x <= 128709) ||
+    x === 128716 ||
+    (x >= 128720 && x <= 128722) ||
+    (x >= 128725 && x <= 128727) ||
+    (x >= 128732 && x <= 128735) ||
+    x === 128747 ||
+    x === 128748 ||
+    (x >= 128756 && x <= 128764) ||
+    (x >= 128992 && x <= 129003) ||
+    x === 129008 ||
+    (x >= 129292 && x <= 129338) ||
+    (x >= 129340 && x <= 129349) ||
+    (x >= 129351 && x <= 129535) ||
+    (x >= 129648 && x <= 129660) ||
+    (x >= 129664 && x <= 129673) ||
+    (x >= 129679 && x <= 129734) ||
+    (x >= 129742 && x <= 129756) ||
+    (x >= 129759 && x <= 129769) ||
+    (x >= 129776 && x <= 129784) ||
+    (x >= 131072 && x <= 196605) ||
+    (x >= 196608 && x <= 262141)
+  );
+}
+
+// node_modules/get-east-asian-width/index.js
+var _isNarrowWidth = (codePoint) =>
+  !(isFullWidth(codePoint) || isWide(codePoint));
+
+// src/utils/get-string-width.js
+var notAsciiRegex = /[^\x20-\x7F]/u;
+function getStringWidth(text) {
+  if (!text) {
+    return 0;
+  }
+  if (!notAsciiRegex.test(text)) {
+    return text.length;
+  }
+  text = text.replace(emoji_regex_default(), "  ");
+  let width = 0;
+  for (const character of text) {
+    const codePoint = character.codePointAt(0);
+    if (codePoint <= 31 || (codePoint >= 127 && codePoint <= 159)) {
+      continue;
+    }
+    if (codePoint >= 768 && codePoint <= 879) {
+      continue;
+    }
+    width += _isNarrowWidth(codePoint) ? 1 : 2;
+  }
+  return width;
+}
+var get_string_width_default = getStringWidth;
+
+export { getStringWidth };

package/src/render/index.ts

@@ -0,0 +1 @@
+export * from "./node.js";

package/src/render/node-context.ts

@@ -0,0 +1,14 @@
+import type { Context } from "../reactivity.js";
+import type { AlloyNode } from "./node.js";
+
+interface ContextNode extends AlloyNode {
+  __alloyCtx?: Context;
+}
+
+export function getContextForNode(node: AlloyNode): Context | undefined {
+  return (node as ContextNode).__alloyCtx;
+}
+
+export function setContextForNode(node: AlloyNode, context: Context): void {
+  (node as ContextNode).__alloyCtx = context;
+}

package/src/render/node.ts

@@ -0,0 +1,442 @@
+/**
+ * AlloyNode tree — a DOM-aligned in-memory representation of rendered
+ * output.
+ *
+ * Components return AlloyNodes (or values that get inserted into them)
+ * via `runtime/insert.ts`; the resulting tree is consumed by the direct
+ * printer and `render-output.ts` output-directory walker.
+ *
+ * Naming and semantics follow the modern DOM where there is meaningful
+ * overlap. Only modern DOM mutation methods are exposed
+ * (`append`/`prepend`/`before`/`after`/`replaceWith`/`remove`/`text.data`/
+ * `moveBefore`). Legacy methods (`appendChild`, `insertBefore`,
+ * `removeChild`, `replaceChild`, the `nodeValue` setter) are intentionally
+ * NOT provided.
+ */
+
+// #region nodeType constants
+
+export const ELEMENT_NODE = 1 as const;
+export const TEXT_NODE = 3 as const;
+export const COMMENT_NODE = 8 as const;
+export const FRAGMENT_NODE = 11 as const;
+
+export type NodeType = 1 | 3 | 8 | 11;
+
+/**
+ * Anything that can be inserted: a Node, a string (auto-wrapped as Text),
+ * or a number (auto-wrapped as Text).
+ */
+export type Insertable = AlloyNode | string | number;
+
+// #endregion
+
+// #region Base Node
+
+export abstract class AlloyNode {
+  abstract readonly nodeType: NodeType;
+
+  parentNode: AlloyNode | null = null;
+  firstChild: AlloyNode | null = null;
+  lastChild: AlloyNode | null = null;
+  previousSibling: AlloyNode | null = null;
+  nextSibling: AlloyNode | null = null;
+
+  /**
+   * Empty-state propagation. `false` for Text/Element with content,
+   * `true` for empty regions. Mutated by reactive bindings; read by
+   * joiner/ender logic. Direct field — no Vue effect.
+   */
+  isEmpty = true;
+
+  // #region Modern DOM mutation API
+
+  /** Append nodes (or strings) to the end of children. */
+  append(...nodes: Insertable[]): void {
+    for (let i = 0, len = nodes.length; i < len; i++) {
+      insertBefore(this, normalize(nodes[i]), null);
+    }
+  }
+
+  /** Prepend nodes (or strings) to the beginning of children. */
+  prepend(...nodes: Insertable[]): void {
+    const first = this.firstChild;
+    for (let i = 0, len = nodes.length; i < len; i++) {
+      insertBefore(this, normalize(nodes[i]), first);
+    }
+  }
+
+  /** Insert nodes immediately before `this` in the parent's child list. */
+  before(...nodes: Insertable[]): void {
+    const parent = this.parentNode;
+    if (parent === null) return;
+    for (let i = 0, len = nodes.length; i < len; i++) {
+      insertBefore(parent, normalize(nodes[i]), this);
+    }
+  }
+
+  /** Insert nodes immediately after `this` in the parent's child list. */
+  after(...nodes: Insertable[]): void {
+    const parent = this.parentNode;
+    if (parent === null) return;
+    const ref = this.nextSibling;
+    for (let i = 0, len = nodes.length; i < len; i++) {
+      insertBefore(parent, normalize(nodes[i]), ref);
+    }
+  }
+
+  /** Replace `this` with the given nodes in the parent's child list. */
+  replaceWith(...nodes: Insertable[]): void {
+    const parent = this.parentNode;
+    if (parent === null) return;
+    const ref = this.nextSibling;
+    detach(this);
+    for (let i = 0, len = nodes.length; i < len; i++) {
+      insertBefore(parent, normalize(nodes[i]), ref);
+    }
+  }
+
+  /** Remove `this` from its parent. */
+  remove(): void {
+    if (this.parentNode !== null) detach(this);
+  }
+
+  /**
+   * Atomic move: relocate `node` to be a child of `this` immediately
+   * before `ref` (or at the end if `ref` is null), without disconnecting
+   * any state on the moved subtree. Used by `<For>` reorder paths so
+   * keyed-item bindings stay live.
+   *
+   * Mirrors the 2024 DOM `Element.moveBefore(node, child)` proposal.
+   */
+  moveBefore(node: AlloyNode, ref: AlloyNode | null): void {
+    if (node.parentNode === this && node.nextSibling === ref) return;
+    detach(node);
+    insertBefore(this, node, ref);
+  }
+
+  /**
+   * Deep-clone this node and its subtree. The clone has no parent and
+   * its children are themselves clones. Used when a node value would
+   * otherwise be inserted into two parents (e.g. a shared joiner element
+   * produced by mapJoin) — Alloy intrinsic nodes are stateless so a
+   * fresh tree is semantically equivalent.
+   */
+  cloneNode(): AlloyNode {
+    const copy = this.cloneShallow();
+    for (let c = this.firstChild; c !== null; c = c.nextSibling) {
+      insertBefore(copy, c.cloneNode(), null);
+    }
+    return copy;
+  }
+
+  protected abstract cloneShallow(): AlloyNode;
+}
+
+// #endregion
+
+// #endregion
+
+// #region Concrete Node types
+
+/** Text node — analog of DOM Text / CharacterData. */
+export class TextNode extends AlloyNode {
+  readonly nodeType = TEXT_NODE;
+  data: string;
+
+  // Cached during construction — text data is set once and never mutated
+  // (insert.ts replaces TextNode instances rather than reassigning .data).
+  // Reading these in the printer's hot path is much cheaper than rerunning
+  // getStringWidth / two indexOf scans on every print.
+  /** Display width (Prettier-compatible). Lazily filled on first read. */
+  _w: number = -1;
+  /** 1 if `data` contains a newline, 0 if not, -1 if not yet computed. */
+  _nl: number = -1;
+
+  constructor(data: string) {
+    super();
+    this.data = data;
+    this.isEmpty = data.length === 0;
+  }
+
+  protected cloneShallow(): TextNode {
+    return new TextNode(this.data);
+  }
+}
+
+/**
+ * Comment node — used as a slot anchor (start/end markers) bracketing
+ * dynamic regions. Solid uses the same pattern.
+ */
+export class CommentNode extends AlloyNode {
+  readonly nodeType = COMMENT_NODE;
+  data: string;
+  /** Comments don't contribute output, always empty. */
+  isEmpty = true;
+
+  constructor(data: string = "") {
+    super();
+    this.data = data;
+  }
+
+  protected cloneShallow(): CommentNode {
+    return new CommentNode(this.data);
+  }
+}
+
+/**
+ * Element node — Alloy hook node. `localName` carries the hook kind
+ * ("group", "indent", "line", "softline", "ifBreak", etc).
+ *
+ * `data` carries hook-specific config (e.g. `{ shouldBreak: false }` for
+ * a group). Kept as a single bag rather than a parallel hierarchy of
+ * subclasses to avoid V8 hidden-class fan-out.
+ */
+export class ElementNode extends AlloyNode {
+  readonly nodeType = ELEMENT_NODE;
+  localName: string;
+  data: unknown;
+
+  /**
+   * Count of unabsorbed break-leaves in this subtree. Maintained by
+   * `insertBefore` / `detach` so the printer can decide whether a
+   * `group` is broken in O(1) without a prepass walk.
+   *
+   * `breakParent` / `hardline` / `hbr` / `literalline` / `lbr` elements
+   * and TextNodes containing `\n`/`\r` count as break-leaves; a `group`
+   * element absorbs the count from its own subtree (does not propagate
+   * outward).
+   *
+   * For `ifBreak` elements the count includes contributions from
+   * `data.flatNode` (the alternate branch is not in the regular tree).
+   */
+  _breakCount: number = 0;
+
+  constructor(localName: string, data?: unknown) {
+    super();
+    this.localName = localName;
+    this.data = data;
+  }
+
+  protected cloneShallow(): ElementNode {
+    return new ElementNode(this.localName, this.data);
+  }
+}
+
+/**
+ * Fragment node — transient batch container. Inserting a Fragment splices
+ * its children into the target (mirroring DOM DocumentFragment semantics)
+ * and the Fragment itself becomes empty.
+ */
+export class FragmentNode extends AlloyNode {
+  readonly nodeType = FRAGMENT_NODE;
+
+  protected cloneShallow(): FragmentNode {
+    return new FragmentNode();
+  }
+}
+
+// #endregion
+
+// #region Constructors
+
+export function createTextNode(data: string): TextNode {
+  return new TextNode(data);
+}
+
+export function createComment(data: string = ""): CommentNode {
+  return new CommentNode(data);
+}
+
+export function createElement(localName: string, data?: unknown): ElementNode {
+  return new ElementNode(localName, data);
+}
+
+export function createFragment(): FragmentNode {
+  return new FragmentNode();
+}
+
+// #endregion
+
+// #region Eager break propagation
+
+/**
+ * Element local-names whose mere presence forces the innermost enclosing
+ * `group` to break (= count as one "break leaf"). Mirrors the cases
+ * Prettier's `propagateBreaks` triggers on.
+ */
+function isBreakLeafElement(localName: string): boolean {
+  return (
+    localName === "breakParent" ||
+    localName === "hardline" ||
+    localName === "hbr" ||
+    localName === "literalline" ||
+    localName === "lbr"
+  );
+}
+
+/**
+ * How many break-leaves does inserting/removing `n` add to its parent's
+ * subtree? `group` absorbs internal breaks → contributes 0 outward.
+ * `ifBreak` includes its `flatNode` count too (the alternate branch is
+ * stored on `data`, not in the regular tree).
+ */
+function effectiveBreakCount(n: AlloyNode): number {
+  const nt = n.nodeType;
+  if (nt === TEXT_NODE) {
+    const t = n as TextNode;
+    // Inline (and cache) the textHasNewline check to avoid a cross-module
+    // call on the hot insert path.
+    let nl = t._nl;
+    if (nl < 0) {
+      const s = t.data;
+      nl =
+        s.length > 0 && (s.indexOf("\n") !== -1 || s.indexOf("\r") !== -1) ?
+          1
+        : 0;
+      t._nl = nl;
+    }
+    return nl;
+  }
+  if (nt === ELEMENT_NODE) {
+    const el = n as ElementNode;
+    const ln = el.localName;
+    if (isBreakLeafElement(ln)) return 1;
+    if (ln === "group") {
+      const broken =
+        el._breakCount > 0 ||
+        (el.data as { shouldBreak?: boolean } | undefined)?.shouldBreak ===
+          true;
+      return broken ? 1 : 0;
+    }
+    if (ln === "ifBreak") {
+      const flat = (el.data as { flatNode?: ElementNode } | undefined)
+        ?.flatNode;
+      return el._breakCount + (flat ? flat._breakCount : 0);
+    }
+    return el._breakCount;
+  }
+  return 0;
+}
+
+/**
+ * Walk up from `start` adjusting `_breakCount` by `delta`. When the walk
+ * crosses a `group` element, the group itself absorbs the inner breaks,
+ * but if its own broken state transitions (0 ↔ >0) it must propagate ±1
+ * outward so that ancestor groups also become broken (matches Prettier's
+ * `propagateBreaks` cascade through groupStack).
+ */
+function propagateBreakDelta(start: AlloyNode | null, delta: number): void {
+  if (delta === 0) return;
+  let d = delta;
+  for (let n: AlloyNode | null = start; n !== null; n = n.parentNode) {
+    if (n.nodeType !== ELEMENT_NODE) continue;
+    const el = n as ElementNode;
+    const before = el._breakCount;
+    el._breakCount = before + d;
+    if (el.localName === "group") {
+      const wasBroken =
+        before > 0 ||
+        (el.data as { shouldBreak?: boolean } | undefined)?.shouldBreak ===
+          true;
+      const nowBroken =
+        el._breakCount > 0 ||
+        (el.data as { shouldBreak?: boolean } | undefined)?.shouldBreak ===
+          true;
+      if (wasBroken === nowBroken) return;
+      d = nowBroken ? 1 : -1;
+    }
+  }
+}
+
+// #endregion
+
+// #region Core mutation primitives
+
+function normalize(input: Insertable): AlloyNode {
+  if (typeof input === "string") return new TextNode(input);
+  if (typeof input === "number") return new TextNode(String(input));
+  return input;
+}
+
+/**
+ * Splice `node` (or its children, if Fragment) into `parent` immediately
+ * before `ref` (or at end if `ref` is null). Detaches `node` from any
+ * existing parent first.
+ */
+/** Mutation listener — set by `debug/render.ts`. */
+export interface MutationListener {
+  attached(node: AlloyNode, parent: AlloyNode): void;
+  detached(node: AlloyNode, formerParent: AlloyNode): void;
+}
+let mutationListener: MutationListener | null = null;
+export function setMutationListener(l: MutationListener | null): void {
+  mutationListener = l;
+}
+
+function insertBefore(
+  parent: AlloyNode,
+  node: AlloyNode,
+  ref: AlloyNode | null,
+): void {
+  // Fragment: splice its children, leaving the fragment itself empty.
+  if (node.nodeType === FRAGMENT_NODE) {
+    let child = node.firstChild;
+    node.firstChild = null;
+    node.lastChild = null;
+    while (child !== null) {
+      const next = child.nextSibling;
+      child.parentNode = null;
+      child.previousSibling = null;
+      child.nextSibling = null;
+      insertBefore(parent, child, ref);
+      child = next;
+    }
+    return;
+  }
+
+  if (node.parentNode !== null) detach(node);
+
+  node.parentNode = parent;
+  if (ref === null) {
+    // append
+    const last = parent.lastChild;
+    node.previousSibling = last;
+    node.nextSibling = null;
+    if (last !== null) last.nextSibling = node;
+    else parent.firstChild = node;
+    parent.lastChild = node;
+  } else {
+    // insert before ref
+    const prev = ref.previousSibling;
+    node.previousSibling = prev;
+    node.nextSibling = ref;
+    ref.previousSibling = node;
+    if (prev !== null) prev.nextSibling = node;
+    else parent.firstChild = node;
+  }
+  // Eager break propagation — keeps groups' `_breakCount` accurate so
+  // the printer can skip its `propagateBreaks` prepass.
+  propagateBreakDelta(parent, effectiveBreakCount(node));
+  if (mutationListener !== null) mutationListener.attached(node, parent);
+}
+
+function detach(node: AlloyNode): void {
+  const parent = node.parentNode;
+  if (parent === null) return;
+  // Subtract this subtree's break contribution from ancestors before
+  // unlinking, so `_breakCount` stays in sync.
+  propagateBreakDelta(parent, -effectiveBreakCount(node));
+  const prev = node.previousSibling;
+  const next = node.nextSibling;
+  if (prev !== null) prev.nextSibling = next;
+  else parent.firstChild = next;
+  if (next !== null) next.previousSibling = prev;
+  else parent.lastChild = prev;
+  node.parentNode = null;
+  node.previousSibling = null;
+  node.nextSibling = null;
+  if (mutationListener !== null) mutationListener.detached(node, parent);
+}
+
+// #endregion