@arborium/arborium 2.8.0 → 2.11.0

package/dist/themes/rustdoc-ayu.css

@@ -5,22 +5,42 @@
 :root {
   --arb-at-dark: #e6e1cf;
   --arb-co-dark: #ff7733;
+  --arb-cb-dark: #ff7733;
   --arb-fb-dark: #69f2df;
   --arb-f-dark: #fdd687;
+  --arb-fm-dark: #fdd687;
   --arb-k-dark: #ff7733;
+  --arb-kc-dark: #ff7733;
+  --arb-ko-dark: #ff7733;
+  --arb-kd-dark: #ff7733;
+  --arb-ke-dark: #ff7733;
+  --arb-kf-dark: #ff7733;
+  --arb-ki-dark: #ff7733;
+  --arb-kp-dark: #ff7733;
+  --arb-kr-dark: #ff7733;
+  --arb-kt-dark: #ff7733;
+  --arb-ky-dark: #ff7733;
   --arb-o-dark: #ff7733;
   --arb-pr-dark: #69f2df;
   --arb-p-dark: #c5c5c5;
+  --arb-pb-dark: #c5c5c5;
+  --arb-pd-dark: #c5c5c5;
+  --arb-ps-dark: #ff9011;
   --arb-s-dark: #b8cc52;
+  --arb-ss-dark: #b8cc52;
   --arb-tg-dark: #a37acc;
-  --arb-err-dark: #a37acc;
+  --arb-td-dark: #a37acc;
+  --arb-te-dark: #a37acc;
   --arb-t-dark: #ffa0a5;
+  --arb-tb-dark: #69f2df;
+  --arb-tq-dark: #ffa0a5;
   --arb-v-dark: #c5c5c5;
+  --arb-vb-dark: #36a3d9;
+  --arb-vp-dark: #c5c5c5;
   --arb-c-dark: #788797;
+  --arb-cd-dark: #788797;
   --arb-m-dark: #a37acc;
   --arb-l-dark: #ff7733;
-  --arb-da-dark: #b8cc52;
-  --arb-dd-dark: #ff7733;
   --arb-n-dark: #b8cc52;
   --arb-tl-dark: #c5c5c5;
   --arb-em-dark-style: italic;
@@ -31,8 +51,21 @@
   --arb-se-dark: #ff7733;
   --arb-tt-dark: #ffa0a5;
   --arb-tt-dark-weight: bold;
-  --arb-ts-dark-decoration: line-through;
+  --arb-tx-dark-decoration: line-through;
+  --arb-sp-dark: #c5c5c5;
+  --arb-in-dark: #ff7733;
+  --arb-sc-dark: #ff7733;
+  --arb-rp-dark: #ff7733;
+  --arb-cn-dark: #ff7733;
+  --arb-ex-dark: #ff7733;
+  --arb-pp-dark: #ff7733;
   --arb-ch-dark: #b8cc52;
-  --arb-sr-dark: #b8cc52;
-  --arb-bo-dark: #ff7733;
+  --arb-cs-dark: #b8cc52;
+  --arb-vm-dark: #c5c5c5;
+  --arb-fd-dark: #fdd687;
+  --arb-tf-dark: #ffa0a5;
+  --arb-fc-dark: #fdd687;
+  --arb-km-dark: #ff7733;
+  --arb-dr-dark: #ff7733;
+  --arb-rx-dark: #b8cc52;
 }

package/dist/themes/rustdoc-dark.css

@@ -5,22 +5,42 @@
 :root {
   --arb-at-dark: #ee6868;
   --arb-co-dark: #ee6868;
+  --arb-cb-dark: #ee6868;
   --arb-fb-dark: #769acb;
   --arb-f-dark: #2bab63;
+  --arb-fm-dark: #2bab63;
   --arb-k-dark: #ab8ac1;
+  --arb-kc-dark: #ab8ac1;
+  --arb-ko-dark: #ab8ac1;
+  --arb-kd-dark: #ab8ac1;
+  --arb-ke-dark: #ab8ac1;
+  --arb-kf-dark: #ab8ac1;
+  --arb-ki-dark: #ab8ac1;
+  --arb-kp-dark: #ab8ac1;
+  --arb-kr-dark: #ab8ac1;
+  --arb-kt-dark: #ab8ac1;
+  --arb-ky-dark: #ab8ac1;
   --arb-o-dark: #ab8ac1;
   --arb-pr-dark: #769acb;
   --arb-p-dark: #dddddd;
+  --arb-pb-dark: #dddddd;
+  --arb-pd-dark: #dddddd;
+  --arb-ps-dark: #ff9011;
   --arb-s-dark: #83a300;
+  --arb-ss-dark: #83a300;
   --arb-tg-dark: #3e999f;
-  --arb-err-dark: #3e999f;
+  --arb-td-dark: #3e999f;
+  --arb-te-dark: #3e999f;
   --arb-t-dark: #2dbfb8;
+  --arb-tb-dark: #769acb;
+  --arb-tq-dark: #2dbfb8;
   --arb-v-dark: #dddddd;
+  --arb-vb-dark: #ee6868;
+  --arb-vp-dark: #dddddd;
   --arb-c-dark: #8d8d8b;
+  --arb-cd-dark: #8d8d8b;
   --arb-m-dark: #3e999f;
   --arb-l-dark: #d97f26;
-  --arb-da-dark: #83a300;
-  --arb-dd-dark: #ee6868;
   --arb-n-dark: #83a300;
   --arb-tl-dark: #dddddd;
   --arb-em-dark-style: italic;
@@ -31,8 +51,21 @@
   --arb-se-dark: #d97f26;
   --arb-tt-dark: #2dbfb8;
   --arb-tt-dark-weight: bold;
-  --arb-ts-dark-decoration: line-through;
+  --arb-tx-dark-decoration: line-through;
+  --arb-sp-dark: #dddddd;
+  --arb-in-dark: #ab8ac1;
+  --arb-sc-dark: #ab8ac1;
+  --arb-rp-dark: #ab8ac1;
+  --arb-cn-dark: #ab8ac1;
+  --arb-ex-dark: #ab8ac1;
+  --arb-pp-dark: #ab8ac1;
   --arb-ch-dark: #83a300;
-  --arb-sr-dark: #83a300;
-  --arb-bo-dark: #ee6868;
+  --arb-cs-dark: #83a300;
+  --arb-vm-dark: #dddddd;
+  --arb-fd-dark: #2bab63;
+  --arb-tf-dark: #2dbfb8;
+  --arb-fc-dark: #2bab63;
+  --arb-km-dark: #ab8ac1;
+  --arb-dr-dark: #ab8ac1;
+  --arb-rx-dark: #83a300;
 }

package/dist/themes/rustdoc-light.css

@@ -5,22 +5,42 @@
 :root {
   --arb-at-light: #c82829;
   --arb-co-light: #c82829;
+  --arb-cb-light: #c82829;
   --arb-fb-light: #4271ae;
   --arb-f-light: #ad7c37;
+  --arb-fm-light: #ad7c37;
   --arb-k-light: #8959a8;
+  --arb-kc-light: #8959a8;
+  --arb-ko-light: #8959a8;
+  --arb-kd-light: #8959a8;
+  --arb-ke-light: #8959a8;
+  --arb-kf-light: #8959a8;
+  --arb-ki-light: #8959a8;
+  --arb-kp-light: #8959a8;
+  --arb-kr-light: #8959a8;
+  --arb-kt-light: #8959a8;
+  --arb-ky-light: #8959a8;
   --arb-o-light: #8959a8;
   --arb-pr-light: #4271ae;
   --arb-p-light: #24292e;
+  --arb-pb-light: #24292e;
+  --arb-pd-light: #24292e;
+  --arb-ps-light: #ff9011;
   --arb-s-light: #718c00;
+  --arb-ss-light: #718c00;
   --arb-tg-light: #3e999f;
-  --arb-err-light: #3e999f;
+  --arb-td-light: #3e999f;
+  --arb-te-light: #3e999f;
   --arb-t-light: #ad378a;
+  --arb-tb-light: #4271ae;
+  --arb-tq-light: #ad378a;
   --arb-v-light: #24292e;
+  --arb-vb-light: #c82829;
+  --arb-vp-light: #24292e;
   --arb-c-light: #8e908c;
+  --arb-cd-light: #8e908c;
   --arb-m-light: #3e999f;
   --arb-l-light: #b76514;
-  --arb-da-light: #718c00;
-  --arb-dd-light: #c82829;
   --arb-n-light: #718c00;
   --arb-tl-light: #24292e;
   --arb-em-light-style: italic;
@@ -31,8 +51,21 @@
   --arb-se-light: #b76514;
   --arb-tt-light: #ad378a;
   --arb-tt-light-weight: bold;
-  --arb-ts-light-decoration: line-through;
+  --arb-tx-light-decoration: line-through;
+  --arb-sp-light: #24292e;
+  --arb-in-light: #8959a8;
+  --arb-sc-light: #8959a8;
+  --arb-rp-light: #8959a8;
+  --arb-cn-light: #8959a8;
+  --arb-ex-light: #8959a8;
+  --arb-pp-light: #8959a8;
   --arb-ch-light: #718c00;
-  --arb-sr-light: #718c00;
-  --arb-bo-light: #c82829;
+  --arb-cs-light: #718c00;
+  --arb-vm-light: #24292e;
+  --arb-fd-light: #ad7c37;
+  --arb-tf-light: #ad378a;
+  --arb-fc-light: #ad7c37;
+  --arb-km-light: #8959a8;
+  --arb-dr-light: #8959a8;
+  --arb-rx-light: #718c00;
 }

package/dist/themes/solarized-dark.css

@@ -5,23 +5,44 @@
 :root {
   --arb-at-dark: #b58900;
   --arb-co-dark: #2aa198;
+  --arb-cb-dark: #2aa198;
   --arb-fb-dark: #268bd2;
   --arb-f-dark: #268bd2;
+  --arb-fm-dark: #268bd2;
   --arb-k-dark: #859900;
-  --arb-o-dark: #859900;
+  --arb-kc-dark: #859900;
+  --arb-ko-dark: #859900;
+  --arb-kd-dark: #859900;
+  --arb-ke-dark: #859900;
+  --arb-kf-dark: #859900;
+  --arb-ki-dark: #859900;
+  --arb-kp-dark: #859900;
+  --arb-kr-dark: #859900;
+  --arb-kt-dark: #859900;
+  --arb-ky-dark: #859900;
+  --arb-o-dark: #93a1a1;
   --arb-pr-dark: #268bd2;
   --arb-p-dark: #93a1a1;
+  --arb-pb-dark: #93a1a1;
+  --arb-pd-dark: #93a1a1;
+  --arb-ps-dark: #dc322f;
   --arb-s-dark: #2aa198;
+  --arb-ss-dark: #cb4b16;
   --arb-tg-dark: #268bd2;
-  --arb-err-dark: #268bd2;
+  --arb-td-dark: #268bd2;
+  --arb-te-dark: #268bd2;
   --arb-t-dark: #b58900;
+  --arb-tb-dark: #b58900;
+  --arb-tq-dark: #b58900;
   --arb-v-dark: #839496;
+  --arb-vb-dark: #d33682;
+  --arb-vp-dark: #839496;
   --arb-c-dark: #586e75;
   --arb-c-dark-style: italic;
+  --arb-cd-dark: #586e75;
+  --arb-cd-dark-style: italic;
   --arb-m-dark: #cb4b16;
   --arb-l-dark: #6c71c4;
-  --arb-da-dark: #859900;
-  --arb-dd-dark: #dc322f;
   --arb-n-dark: #d33682;
   --arb-tl-dark: #839496;
   --arb-em-dark-style: italic;
@@ -32,8 +53,21 @@
   --arb-se-dark: #cb4b16;
   --arb-tt-dark: #b58900;
   --arb-tt-dark-weight: bold;
-  --arb-ts-dark-decoration: line-through;
-  --arb-ch-dark: #cb4b16;
-  --arb-sr-dark: #cb4b16;
-  --arb-bo-dark: #2aa198;
+  --arb-tx-dark-decoration: line-through;
+  --arb-sp-dark: #839496;
+  --arb-in-dark: #859900;
+  --arb-sc-dark: #859900;
+  --arb-rp-dark: #859900;
+  --arb-cn-dark: #859900;
+  --arb-ex-dark: #859900;
+  --arb-pp-dark: #859900;
+  --arb-ch-dark: #2aa198;
+  --arb-cs-dark: #2aa198;
+  --arb-vm-dark: #839496;
+  --arb-fd-dark: #268bd2;
+  --arb-tf-dark: #b58900;
+  --arb-fc-dark: #268bd2;
+  --arb-km-dark: #859900;
+  --arb-dr-dark: #859900;
+  --arb-rx-dark: #2aa198;
 }

package/dist/themes/solarized-light.css

@@ -5,23 +5,44 @@
 :root {
   --arb-at-light: #b58900;
   --arb-co-light: #2aa198;
+  --arb-cb-light: #2aa198;
   --arb-fb-light: #268bd2;
   --arb-f-light: #268bd2;
+  --arb-fm-light: #268bd2;
   --arb-k-light: #859900;
-  --arb-o-light: #859900;
+  --arb-kc-light: #859900;
+  --arb-ko-light: #859900;
+  --arb-kd-light: #859900;
+  --arb-ke-light: #859900;
+  --arb-kf-light: #859900;
+  --arb-ki-light: #859900;
+  --arb-kp-light: #859900;
+  --arb-kr-light: #859900;
+  --arb-kt-light: #859900;
+  --arb-ky-light: #859900;
+  --arb-o-light: #586e75;
   --arb-pr-light: #268bd2;
   --arb-p-light: #586e75;
+  --arb-pb-light: #586e75;
+  --arb-pd-light: #586e75;
+  --arb-ps-light: #dc322f;
   --arb-s-light: #2aa198;
+  --arb-ss-light: #cb4b16;
   --arb-tg-light: #268bd2;
-  --arb-err-light: #268bd2;
+  --arb-td-light: #268bd2;
+  --arb-te-light: #268bd2;
   --arb-t-light: #b58900;
+  --arb-tb-light: #b58900;
+  --arb-tq-light: #b58900;
   --arb-v-light: #657b83;
+  --arb-vb-light: #d33682;
+  --arb-vp-light: #657b83;
   --arb-c-light: #93a1a1;
   --arb-c-light-style: italic;
+  --arb-cd-light: #93a1a1;
+  --arb-cd-light-style: italic;
   --arb-m-light: #cb4b16;
   --arb-l-light: #6c71c4;
-  --arb-da-light: #859900;
-  --arb-dd-light: #dc322f;
   --arb-n-light: #d33682;
   --arb-tl-light: #657b83;
   --arb-em-light-style: italic;
@@ -32,8 +53,21 @@
   --arb-se-light: #cb4b16;
   --arb-tt-light: #b58900;
   --arb-tt-light-weight: bold;
-  --arb-ts-light-decoration: line-through;
-  --arb-ch-light: #cb4b16;
-  --arb-sr-light: #cb4b16;
-  --arb-bo-light: #2aa198;
+  --arb-tx-light-decoration: line-through;
+  --arb-sp-light: #657b83;
+  --arb-in-light: #859900;
+  --arb-sc-light: #859900;
+  --arb-rp-light: #859900;
+  --arb-cn-light: #859900;
+  --arb-ex-light: #859900;
+  --arb-pp-light: #859900;
+  --arb-ch-light: #2aa198;
+  --arb-cs-light: #2aa198;
+  --arb-vm-light: #657b83;
+  --arb-fd-light: #268bd2;
+  --arb-tf-light: #b58900;
+  --arb-fc-light: #268bd2;
+  --arb-km-light: #859900;
+  --arb-dr-light: #859900;
+  --arb-rx-light: #2aa198;
 }

package/dist/themes/tokyo-night.css

@@ -5,22 +5,42 @@
 :root {
   --arb-at-dark: #e0af68;
   --arb-co-dark: #ff9e64;
+  --arb-cb-dark: #ff9e64;
   --arb-fb-dark: #7dcfff;
   --arb-f-dark: #7aa2f7;
+  --arb-fm-dark: #7aa2f7;
   --arb-k-dark: #bb9af7;
-  --arb-o-dark: #bb9af7;
+  --arb-kc-dark: #bb9af7;
+  --arb-ko-dark: #bb9af7;
+  --arb-kd-dark: #bb9af7;
+  --arb-ke-dark: #bb9af7;
+  --arb-kf-dark: #bb9af7;
+  --arb-ki-dark: #bb9af7;
+  --arb-kp-dark: #bb9af7;
+  --arb-kr-dark: #bb9af7;
+  --arb-kt-dark: #bb9af7;
+  --arb-ky-dark: #bb9af7;
+  --arb-o-dark: #89ddff;
   --arb-pr-dark: #7aa2f7;
   --arb-p-dark: #a9b1d6;
+  --arb-pb-dark: #a9b1d6;
+  --arb-pd-dark: #a9b1d6;
+  --arb-ps-dark: #89ddff;
   --arb-s-dark: #9ece6a;
+  --arb-ss-dark: #f7768e;
   --arb-tg-dark: #f7768e;
-  --arb-err-dark: #f7768e;
+  --arb-td-dark: #f7768e;
+  --arb-te-dark: #f7768e;
   --arb-t-dark: #2ac3de;
+  --arb-tb-dark: #2ac3de;
+  --arb-tq-dark: #2ac3de;
   --arb-v-dark: #c0caf5;
+  --arb-vb-dark: #f7768e;
+  --arb-vp-dark: #e0af68;
   --arb-c-dark: #565f89;
+  --arb-cd-dark: #565f89;
   --arb-m-dark: #7dcfff;
   --arb-l-dark: #ff9e64;
-  --arb-da-dark: #9ece6a;
-  --arb-dd-dark: #f7768e;
   --arb-n-dark: #ff9e64;
   --arb-tl-dark: #a9b1d6;
   --arb-em-dark-style: italic;
@@ -31,8 +51,21 @@
   --arb-se-dark: #89ddff;
   --arb-tt-dark: #bb9af7;
   --arb-tt-dark-weight: bold;
-  --arb-ts-dark-decoration: line-through;
-  --arb-ch-dark: #f7768e;
-  --arb-sr-dark: #f7768e;
-  --arb-bo-dark: #ff9e64;
+  --arb-tx-dark-decoration: line-through;
+  --arb-sp-dark: #a9b1d6;
+  --arb-in-dark: #bb9af7;
+  --arb-sc-dark: #bb9af7;
+  --arb-rp-dark: #bb9af7;
+  --arb-cn-dark: #bb9af7;
+  --arb-ex-dark: #bb9af7;
+  --arb-pp-dark: #bb9af7;
+  --arb-ch-dark: #9ece6a;
+  --arb-cs-dark: #9ece6a;
+  --arb-vm-dark: #c0caf5;
+  --arb-fd-dark: #7aa2f7;
+  --arb-tf-dark: #2ac3de;
+  --arb-fc-dark: #7aa2f7;
+  --arb-km-dark: #bb9af7;
+  --arb-dr-dark: #bb9af7;
+  --arb-rx-dark: #9ece6a;
 }

package/dist/themes/zenburn.css

@@ -5,22 +5,42 @@
 :root {
   --arb-at-dark: #dfaf8f;
   --arb-co-dark: #dca3a3;
+  --arb-cb-dark: #dca3a3;
   --arb-fb-dark: #efef8f;
   --arb-f-dark: #efef8f;
+  --arb-fm-dark: #efef8f;
   --arb-k-dark: #f0dfaf;
-  --arb-o-dark: #f0dfaf;
+  --arb-kc-dark: #f0dfaf;
+  --arb-ko-dark: #f0dfaf;
+  --arb-kd-dark: #f0dfaf;
+  --arb-ke-dark: #f0dfaf;
+  --arb-kf-dark: #f0dfaf;
+  --arb-ki-dark: #f0dfaf;
+  --arb-kp-dark: #f0dfaf;
+  --arb-kr-dark: #f0dfaf;
+  --arb-kt-dark: #f0dfaf;
+  --arb-ky-dark: #f0dfaf;
+  --arb-o-dark: #dcdccc;
   --arb-pr-dark: #dcdccc;
   --arb-p-dark: #dcdccc;
+  --arb-pb-dark: #dcdccc;
+  --arb-pd-dark: #dcdccc;
+  --arb-ps-dark: #dca3a3;
   --arb-s-dark: #cc9393;
+  --arb-ss-dark: #dca3a3;
   --arb-tg-dark: #efef8f;
-  --arb-err-dark: #efef8f;
+  --arb-td-dark: #efef8f;
+  --arb-te-dark: #efef8f;
   --arb-t-dark: #dfdfbf;
+  --arb-tb-dark: #dfdfbf;
+  --arb-tq-dark: #dfdfbf;
   --arb-v-dark: #dcdccc;
+  --arb-vb-dark: #dca3a3;
+  --arb-vp-dark: #dcdccc;
   --arb-c-dark: #7f9f7f;
+  --arb-cd-dark: #7f9f7f;
   --arb-m-dark: #dfaf8f;
   --arb-l-dark: #8cd0d3;
-  --arb-da-dark: #7f9f7f;
-  --arb-dd-dark: #cc9393;
   --arb-n-dark: #8cd0d3;
   --arb-tl-dark: #dcdccc;
   --arb-em-dark-style: italic;
@@ -31,8 +51,21 @@
   --arb-se-dark: #dca3a3;
   --arb-tt-dark: #efef8f;
   --arb-tt-dark-weight: bold;
-  --arb-ts-dark-decoration: line-through;
-  --arb-ch-dark: #dca3a3;
-  --arb-sr-dark: #dca3a3;
-  --arb-bo-dark: #dca3a3;
+  --arb-tx-dark-decoration: line-through;
+  --arb-sp-dark: #dcdccc;
+  --arb-in-dark: #f0dfaf;
+  --arb-sc-dark: #f0dfaf;
+  --arb-rp-dark: #f0dfaf;
+  --arb-cn-dark: #f0dfaf;
+  --arb-ex-dark: #f0dfaf;
+  --arb-pp-dark: #f0dfaf;
+  --arb-ch-dark: #cc9393;
+  --arb-cs-dark: #cc9393;
+  --arb-vm-dark: #dcdccc;
+  --arb-fd-dark: #efef8f;
+  --arb-tf-dark: #dfdfbf;
+  --arb-fc-dark: #efef8f;
+  --arb-km-dark: #f0dfaf;
+  --arb-dr-dark: #f0dfaf;
+  --arb-rx-dark: #cc9393;
 }

package/dist/types.d.ts

@@ -1,11 +1,59 @@
 /**
- * A span of highlighted text.
+ * A span of highlighted text with UTF-8 byte offsets.
  *
- * The `start` and `end` fields are UTF-16 code unit indices, compatible with
- * JavaScript string APIs like `String.prototype.slice()`, `substring()`, and
- * DOM `Range`.
+ * This is the native format from tree-sitter. Use this when working with
+ * Rust code that needs to slice strings with `&source[start..end]`.
+ *
+ * For JavaScript string operations, use {@link Utf16Span} instead.
+ *
+ * @internal
+ */
+export interface Utf8Span {
+    /** UTF-8 byte offset where the span starts (inclusive) */
+    start: number;
+    /** UTF-8 byte offset where the span ends (exclusive) */
+    end: number;
+    /** The capture name (e.g., "keyword", "string", "comment") */
+    capture: string;
+}
+/**
+ * A language injection with UTF-8 byte offsets.
+ *
+ * @internal
+ */
+export interface Utf8Injection {
+    /** UTF-8 byte offset where the injection starts (inclusive) */
+    start: number;
+    /** UTF-8 byte offset where the injection ends (exclusive) */
+    end: number;
+    language: string;
+    includeChildren: boolean;
+}
+/**
+ * Result of parsing source code, with UTF-8 byte offsets.
+ *
+ * @internal
  */
-export interface Span {
+export interface Utf8ParseResult {
+    spans: Utf8Span[];
+    injections: Utf8Injection[];
+}
+/**
+ * A span of highlighted text with UTF-16 code unit indices.
+ *
+ * The `start` and `end` fields are compatible with JavaScript string APIs
+ * like `String.prototype.slice()`, `substring()`, and DOM `Range`.
+ *
+ * @example
+ * ```ts
+ * const result = grammar.parse(source);
+ * for (const span of result.spans) {
+ *   const text = source.slice(span.start, span.end);
+ *   console.log(`${span.capture}: ${text}`);
+ * }
+ * ```
+ */
+export interface Utf16Span {
     /** UTF-16 code unit index where the span starts (inclusive) */
     start: number;
     /** UTF-16 code unit index where the span ends (exclusive) */
@@ -14,9 +62,9 @@ export interface Span {
     capture: string;
 }
 /**
- * A language injection (e.g., JS inside HTML).
+ * A language injection (e.g., JS inside HTML) with UTF-16 code unit indices.
  */
-export interface Injection {
+export interface Utf16Injection {
     /** UTF-16 code unit index where the injection starts (inclusive) */
     start: number;
     /** UTF-16 code unit index where the injection ends (exclusive) */
@@ -24,11 +72,28 @@ export interface Injection {
     language: string;
     includeChildren: boolean;
 }
-/** Result of parsing source code */
-export interface ParseResult {
-    spans: Span[];
-    injections: Injection[];
+/**
+ * Result of parsing source code, with UTF-16 code unit indices.
+ *
+ * This is the format returned by the public API (`grammar.parse()`,
+ * `session.parse()`). Offsets are compatible with JavaScript string operations.
+ */
+export interface Utf16ParseResult {
+    spans: Utf16Span[];
+    injections: Utf16Injection[];
 }
+/**
+ * @deprecated Use {@link Utf16Span} for JavaScript or {@link Utf8Span} for Rust interop.
+ */
+export type Span = Utf16Span;
+/**
+ * @deprecated Use {@link Utf16Injection} for JavaScript or {@link Utf8Injection} for Rust interop.
+ */
+export type Injection = Utf16Injection;
+/**
+ * @deprecated Use {@link Utf16ParseResult} for JavaScript or {@link Utf8ParseResult} for Rust interop.
+ */
+export type ParseResult = Utf16ParseResult;
 /**
  * A parsing session for incremental highlighting.
  *
@@ -54,8 +119,8 @@ export interface ParseResult {
 export interface Session {
     /** Set the text to parse */
     setText(text: string): void;
-    /** Parse the current text and return spans/injections */
-    parse(): ParseResult;
+    /** Parse the current text and return spans/injections with UTF-16 offsets */
+    parse(): Utf16ParseResult;
     /** Cancel any in-progress parsing */
     cancel(): void;
     /**
@@ -72,8 +137,8 @@ export interface Grammar {
     injectionLanguages(): string[];
     /** Highlight source code, returning HTML string */
     highlight(source: string): string | Promise<string>;
-    /** Parse source code, returning raw spans (creates a one-shot session internally) */
-    parse(source: string): ParseResult;
+    /** Parse source code, returning spans with UTF-16 offsets (creates a one-shot session internally) */
+    parse(source: string): Utf16ParseResult;
     /** Create a session for incremental parsing */
     createSession(): Session;
     /** Dispose of resources */

package/dist/utils.d.ts

@@ -1,5 +1,2 @@
-import { Span } from './types.js';
-/** Convert spans to HTML */
-export declare function spansToHtml(source: string, spans: Span[]): string;
 /** Escape HTML special characters */
 export declare function escapeHtml(text: string): string;

package/package.json

@@ -89,5 +89,5 @@
   },
   "type": "module",
   "types": "./dist/arborium.d.ts",
-  "version": "2.8.0"
+  "version": "2.11.0"
 }