@mapmap/maps 0.5.0 → 0.5.2

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import maplibregl, { CustomLayerInterface, Map, StyleSpecification, MapOptions, ExpressionSpecification } from 'maplibre-gl';
+export { DirectionIconName, DirectionIconStep, directionIconSvg, directionIcons, iconNameForManeuver, iconNameForStep } from './direction-icons.js';
 
 /**
  * Shared public types for @mapmap/maps.
@@ -280,7 +281,7 @@ interface LogoOptions {
  * line-art route mark plus the dark wordmark — over a white halo stroke
  * so it stays legible on any base map.
  */
-declare const LOGO_SVG: string;
+declare const LOGO_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"85\" height=\"20\" viewBox=\"0 0 156 37\" fill=\"none\" role=\"img\" aria-label=\"MapMap\"><g stroke=\"#ffffff\" stroke-linejoin=\"round\" stroke-linecap=\"round\"><path d=\"M138.576 33.2887V11.4951H142.24V14.1161H142.456C142.649 13.7308 142.92 13.3215 143.269 12.8881C143.619 12.4479 144.093 12.0729 144.69 11.7634C145.287 11.4469 146.048 11.2887 146.975 11.2887C148.196 11.2887 149.297 11.6017 150.279 12.2277C151.267 12.8469 152.049 13.7652 152.625 14.9829C153.209 16.1936 153.5 17.6796 153.5 19.4407C153.5 21.1811 153.215 22.6602 152.646 23.8778C152.076 25.0955 151.301 26.0242 150.32 26.6639C149.339 27.3037 148.227 27.6236 146.985 27.6236C146.079 27.6236 145.328 27.4722 144.731 27.1696C144.134 26.8669 143.654 26.5023 143.29 26.0757C142.933 25.6424 142.655 25.233 142.456 24.8478H142.302V33.2887H138.576ZM142.23 19.42C142.23 20.445 142.374 21.3428 142.662 22.1133C142.957 22.8838 143.379 23.4857 143.928 23.9191C144.484 24.3456 145.156 24.5589 145.946 24.5589C146.769 24.5589 147.458 24.3387 148.014 23.8985C148.57 23.4513 148.989 22.8425 149.27 22.072C149.558 21.2946 149.702 20.4106 149.702 19.42C149.702 18.4363 149.562 17.5626 149.28 16.799C148.999 16.0354 148.58 15.4369 148.025 15.0035C147.469 14.5701 146.776 14.3534 145.946 14.3534C145.15 14.3534 144.474 14.5632 143.918 14.9829C143.362 15.4025 142.94 15.9907 142.652 16.7474C142.371 17.5041 142.23 18.395 142.23 19.42Z\" fill=\"#ffffff\" stroke-width=\"3\" paint-order=\"stroke\"/><path d=\"M127.352 27.6649C126.35 27.6649 125.448 27.486 124.645 27.1283C123.849 26.7637 123.218 26.2271 122.751 25.5185C122.291 24.81 122.062 23.9363 122.062 22.8975C122.062 22.0032 122.226 21.2637 122.556 20.6789C122.885 20.0942 123.334 19.6264 123.904 19.2756C124.473 18.9247 125.115 18.6599 125.829 18.481C126.549 18.2953 127.293 18.1611 128.062 18.0786C128.988 17.9823 129.74 17.8963 130.316 17.8206C130.892 17.738 131.311 17.6142 131.572 17.4491C131.839 17.2771 131.973 17.0123 131.973 16.6545V16.5926C131.973 15.8153 131.743 15.2133 131.284 14.7868C130.824 14.3603 130.162 14.147 129.297 14.147C128.384 14.147 127.661 14.3465 127.125 14.7455C126.597 15.1445 126.24 15.6158 126.055 16.1592L122.576 15.6639C122.851 14.7008 123.303 13.896 123.935 13.2493C124.566 12.5958 125.338 12.1073 126.251 11.784C127.163 11.4538 128.172 11.2887 129.276 11.2887C130.038 11.2887 130.796 11.3781 131.551 11.557C132.306 11.7359 132.995 12.0317 133.62 12.4444C134.244 12.8503 134.745 13.4041 135.123 14.1058C135.507 14.8075 135.699 15.6846 135.699 16.7371V27.345H132.117V25.1677H131.994C131.767 25.608 131.448 26.0207 131.036 26.406C130.632 26.7843 130.12 27.0904 129.503 27.3243C128.892 27.5514 128.175 27.6649 127.352 27.6649ZM128.319 24.92C129.067 24.92 129.716 24.7721 130.265 24.4763C130.813 24.1736 131.235 23.7746 131.531 23.2793C131.832 22.784 131.983 22.244 131.983 21.6592V19.7915C131.867 19.8878 131.668 19.9773 131.386 20.0598C131.112 20.1424 130.803 20.2146 130.46 20.2765C130.117 20.3384 129.777 20.3934 129.441 20.4416C129.105 20.4898 128.813 20.531 128.566 20.5654C128.011 20.6411 127.513 20.7649 127.074 20.9369C126.635 21.1089 126.288 21.3497 126.034 21.6592C125.781 21.9619 125.654 22.354 125.654 22.8356C125.654 23.5235 125.904 24.0429 126.405 24.3938C126.906 24.7446 127.544 24.92 128.319 24.92Z\" fill=\"#ffffff\" stroke-width=\"3\" paint-order=\"stroke\"/><path d=\"M97.6602 27.345V11.4951H101.221V14.1883H101.407C101.736 13.2803 102.281 12.5717 103.043 12.0626C103.805 11.5467 104.714 11.2887 105.771 11.2887C106.841 11.2887 107.743 11.5501 108.477 12.0729C109.219 12.5889 109.74 13.294 110.042 14.1883H110.207C110.557 13.3078 111.147 12.6061 111.977 12.0833C112.814 11.5535 113.805 11.2887 114.951 11.2887C116.406 11.2887 117.593 11.7496 118.513 12.6714C119.432 13.5933 119.892 14.9382 119.892 16.7061V27.345H116.156V17.284C116.156 16.3003 115.895 15.5814 115.373 15.1273C114.852 14.6664 114.214 14.436 113.459 14.436C112.56 14.436 111.857 14.718 111.349 15.2821C110.848 15.8394 110.598 16.5651 110.598 17.4594V27.345H106.944V17.1292C106.944 16.3106 106.697 15.6571 106.203 15.1686C105.716 14.6802 105.078 14.436 104.288 14.436C103.753 14.436 103.266 14.5736 102.827 14.8487C102.388 15.117 102.038 15.4988 101.777 15.9941C101.516 16.4826 101.386 17.0535 101.386 17.7071V27.345H97.6602Z\" fill=\"#ffffff\" stroke-width=\"3\" paint-order=\"stroke\"/><path d=\"M80.416 33.2887V11.4951H84.0801V14.1161H84.2962C84.4884 13.7308 84.7594 13.3215 85.1093 12.8881C85.4593 12.4479 85.9327 12.0729 86.5297 11.7634C87.1267 11.4469 87.8883 11.2887 88.8146 11.2887C90.036 11.2887 91.1373 11.6017 92.1185 12.2277C93.1065 12.8469 93.8888 13.7652 94.4651 14.9829C95.0484 16.1936 95.34 17.6796 95.34 19.4407C95.34 21.1811 95.0552 22.6602 94.4857 23.8778C93.9162 25.0955 93.1408 26.0242 92.1596 26.6639C91.1784 27.3037 90.0668 27.6236 88.8249 27.6236C87.9192 27.6236 87.1678 27.4722 86.5709 27.1696C85.9739 26.8669 85.4936 26.5023 85.1299 26.0757C84.7731 25.6424 84.4952 25.233 84.2962 24.8478H84.1419V33.2887H80.416ZM84.0698 19.42C84.0698 20.445 84.2139 21.3428 84.5021 22.1133C84.7971 22.8838 85.2191 23.4857 85.7681 23.9191C86.3238 24.3456 86.9963 24.5589 87.7854 24.5589C88.6088 24.5589 89.2983 24.3387 89.8541 23.8985C90.4099 23.4513 90.8285 22.8425 91.1098 22.072C91.398 21.2946 91.5421 20.4106 91.5421 19.42C91.5421 18.4363 91.4014 17.5626 91.1201 16.799C90.8388 16.0354 90.4202 15.4369 89.8644 15.0035C89.3086 14.5701 88.6156 14.3534 87.7854 14.3534C86.9894 14.3534 86.3136 14.5632 85.7578 14.9829C85.202 15.4025 84.78 15.9907 84.4918 16.7474C84.2105 17.5041 84.0698 18.395 84.0698 19.42Z\" fill=\"#ffffff\" stroke-width=\"3\" paint-order=\"stroke\"/><path d=\"M69.1921 27.6649C68.1904 27.6649 67.2881 27.486 66.4852 27.1283C65.6893 26.7637 65.058 26.2271 64.5914 25.5185C64.1317 24.81 63.9019 23.9363 63.9019 22.8975C63.9019 22.0032 64.0665 21.2637 64.3959 20.6789C64.7252 20.0942 65.1747 19.6264 65.7442 19.2756C66.3137 18.9247 66.9553 18.6599 67.6689 18.481C68.3893 18.2953 69.1338 18.1611 69.9023 18.0786C70.8286 17.9823 71.58 17.8963 72.1564 17.8206C72.7327 17.738 73.1513 17.6142 73.412 17.4491C73.6796 17.2771 73.8134 17.0123 73.8134 16.6545V16.5926C73.8134 15.8153 73.5836 15.2133 73.1238 14.7868C72.6641 14.3603 72.002 14.147 71.1374 14.147C70.2248 14.147 69.5009 14.3465 68.9657 14.7455C68.4374 15.1445 68.0806 15.6158 67.8953 16.1592L64.4165 15.6639C64.6909 14.7008 65.1438 13.896 65.7751 13.2493C66.4063 12.5958 67.1783 12.1073 68.0909 11.784C69.0034 11.4538 70.0121 11.2887 71.1168 11.2887C71.8785 11.2887 72.6367 11.3781 73.3914 11.557C74.1462 11.7359 74.8358 12.0317 75.4602 12.4444C76.0846 12.8503 76.5855 13.4041 76.9629 14.1058C77.3471 14.8075 77.5393 15.6846 77.5393 16.7371V27.345H73.9575V25.1677H73.834C73.6076 25.608 73.2885 26.0207 72.8768 26.406C72.472 26.7843 71.9608 27.0904 71.3433 27.3243C70.7326 27.5514 70.0155 27.6649 69.1921 27.6649ZM70.1596 24.92C70.9075 24.92 71.556 24.7721 72.1049 24.4763C72.6538 24.1736 73.0758 23.7746 73.3709 23.2793C73.6728 22.784 73.8237 22.244 73.8237 21.6592V19.7915C73.7071 19.8878 73.5081 19.9773 73.2268 20.0598C72.9523 20.1424 72.6435 20.2146 72.3004 20.2765C71.9574 20.3384 71.6177 20.3934 71.2815 20.4416C70.9453 20.4898 70.6537 20.531 70.4066 20.5654C69.8509 20.6411 69.3534 20.7649 68.9143 20.9369C68.4751 21.1089 68.1286 21.3497 67.8747 21.6592C67.6208 21.9619 67.4939 22.354 67.4939 22.8356C67.4939 23.5235 67.7443 24.0429 68.2452 24.3938C68.7461 24.7446 69.3843 24.92 70.1596 24.92Z\" fill=\"#ffffff\" stroke-width=\"3\" paint-order=\"stroke\"/><path d=\"M39.5 27.345V11.4951H43.0612V14.1883H43.2464C43.5758 13.2803 44.1213 12.5717 44.8829 12.0626C45.6446 11.5467 46.5537 11.2887 47.6104 11.2887C48.6808 11.2887 49.5831 11.5501 50.3173 12.0729C51.0584 12.5889 51.5798 13.294 51.8817 14.1883H52.0464C52.3964 13.3078 52.9865 12.6061 53.8167 12.0833C54.6538 11.5535 55.6453 11.2887 56.7912 11.2887C58.2459 11.2887 59.4329 11.7496 60.3524 12.6714C61.2718 13.5933 61.7316 14.9382 61.7316 16.7061V27.345H57.9954V17.284C57.9954 16.3003 57.7347 15.5814 57.2132 15.1273C56.6917 14.6664 56.0536 14.436 55.2988 14.436C54.3999 14.436 53.6966 14.718 53.1889 15.2821C52.688 15.8394 52.4375 16.5651 52.4375 17.4594V27.345H48.7837V17.1292C48.7837 16.3106 48.5367 15.6571 48.0427 15.1686C47.5555 14.6802 46.9174 14.436 46.1283 14.436C45.5931 14.436 45.1059 14.5736 44.6668 14.8487C44.2276 15.117 43.8777 15.4988 43.617 15.9941C43.3562 16.4826 43.2258 17.0535 43.2258 17.7071V27.345H39.5Z\" fill=\"#ffffff\" stroke-width=\"3\" paint-order=\"stroke\"/><path d=\"M27.3847 25.9178C28.8081 23.5868 30.5287 21.3029 30.9562 18.5589C31.9911 11.9172 26.9381 5.71447 19.956 5.30338C17.4904 5.15838 13.6449 5.12507 11.1992 5.30299C10.0552 5.38607 8.94122 5.89121 8.16887 6.70868C7.71694 7.18718 5.28183 11.1346 5.20651 11.6441C5.02777 12.8495 5.83228 13.8426 7.09035 13.9645C9.18143 14.1667 11.8763 13.9253 14.0309 13.9264C15.8964 13.9272 17.9989 13.8097 19.8339 13.9253C25.9341 14.3093 29.7128 20.5446 27.3249 25.9319L27.3847 25.9178Z\" stroke-width=\"4.96\"/><path d=\"M14.0302 13.9258L10.6029 19.6599C9.96327 20.8096 10.6737 22.3059 12.0613 22.4638C14.1002 22.6962 17.0133 22.4493 19.1606 22.4689C21.213 22.4877 23.197 22.146 24.8203 23.6246C26.1443 24.8308 26.5555 26.7091 25.9192 28.3472L27.3849 25.9175C29.7728 20.5302 25.9338 14.3083 19.8336 13.9246C17.9986 13.809 15.8961 13.927 14.0306 13.9258H14.0302Z\" stroke-width=\"4.96\"/><path d=\"M19.1603 22.469L15.6471 28.3947C15.2098 29.3278 15.7183 30.5509 16.7183 30.9134C17.4381 31.174 21.8747 31.1148 22.7354 30.9463C24.1038 30.6786 25.4299 29.6056 25.9188 28.3477C26.5548 26.7096 26.1436 24.8313 24.82 23.6251C23.1967 22.1461 21.1733 22.5542 19.1209 22.5354L19.1603 22.469Z\" stroke-width=\"4.96\"/></g><path d=\"M138.576 33.2887V11.4951H142.24V14.1161H142.456C142.649 13.7308 142.92 13.3215 143.269 12.8881C143.619 12.4479 144.093 12.0729 144.69 11.7634C145.287 11.4469 146.048 11.2887 146.975 11.2887C148.196 11.2887 149.297 11.6017 150.279 12.2277C151.267 12.8469 152.049 13.7652 152.625 14.9829C153.209 16.1936 153.5 17.6796 153.5 19.4407C153.5 21.1811 153.215 22.6602 152.646 23.8778C152.076 25.0955 151.301 26.0242 150.32 26.6639C149.339 27.3037 148.227 27.6236 146.985 27.6236C146.079 27.6236 145.328 27.4722 144.731 27.1696C144.134 26.8669 143.654 26.5023 143.29 26.0757C142.933 25.6424 142.655 25.233 142.456 24.8478H142.302V33.2887H138.576ZM142.23 19.42C142.23 20.445 142.374 21.3428 142.662 22.1133C142.957 22.8838 143.379 23.4857 143.928 23.9191C144.484 24.3456 145.156 24.5589 145.946 24.5589C146.769 24.5589 147.458 24.3387 148.014 23.8985C148.57 23.4513 148.989 22.8425 149.27 22.072C149.558 21.2946 149.702 20.4106 149.702 19.42C149.702 18.4363 149.562 17.5626 149.28 16.799C148.999 16.0354 148.58 15.4369 148.025 15.0035C147.469 14.5701 146.776 14.3534 145.946 14.3534C145.15 14.3534 144.474 14.5632 143.918 14.9829C143.362 15.4025 142.94 15.9907 142.652 16.7474C142.371 17.5041 142.23 18.395 142.23 19.42Z\" fill=\"#26282A\"/><path d=\"M127.352 27.6649C126.35 27.6649 125.448 27.486 124.645 27.1283C123.849 26.7637 123.218 26.2271 122.751 25.5185C122.291 24.81 122.062 23.9363 122.062 22.8975C122.062 22.0032 122.226 21.2637 122.556 20.6789C122.885 20.0942 123.334 19.6264 123.904 19.2756C124.473 18.9247 125.115 18.6599 125.829 18.481C126.549 18.2953 127.293 18.1611 128.062 18.0786C128.988 17.9823 129.74 17.8963 130.316 17.8206C130.892 17.738 131.311 17.6142 131.572 17.4491C131.839 17.2771 131.973 17.0123 131.973 16.6545V16.5926C131.973 15.8153 131.743 15.2133 131.284 14.7868C130.824 14.3603 130.162 14.147 129.297 14.147C128.384 14.147 127.661 14.3465 127.125 14.7455C126.597 15.1445 126.24 15.6158 126.055 16.1592L122.576 15.6639C122.851 14.7008 123.303 13.896 123.935 13.2493C124.566 12.5958 125.338 12.1073 126.251 11.784C127.163 11.4538 128.172 11.2887 129.276 11.2887C130.038 11.2887 130.796 11.3781 131.551 11.557C132.306 11.7359 132.995 12.0317 133.62 12.4444C134.244 12.8503 134.745 13.4041 135.123 14.1058C135.507 14.8075 135.699 15.6846 135.699 16.7371V27.345H132.117V25.1677H131.994C131.767 25.608 131.448 26.0207 131.036 26.406C130.632 26.7843 130.12 27.0904 129.503 27.3243C128.892 27.5514 128.175 27.6649 127.352 27.6649ZM128.319 24.92C129.067 24.92 129.716 24.7721 130.265 24.4763C130.813 24.1736 131.235 23.7746 131.531 23.2793C131.832 22.784 131.983 22.244 131.983 21.6592V19.7915C131.867 19.8878 131.668 19.9773 131.386 20.0598C131.112 20.1424 130.803 20.2146 130.46 20.2765C130.117 20.3384 129.777 20.3934 129.441 20.4416C129.105 20.4898 128.813 20.531 128.566 20.5654C128.011 20.6411 127.513 20.7649 127.074 20.9369C126.635 21.1089 126.288 21.3497 126.034 21.6592C125.781 21.9619 125.654 22.354 125.654 22.8356C125.654 23.5235 125.904 24.0429 126.405 24.3938C126.906 24.7446 127.544 24.92 128.319 24.92Z\" fill=\"#26282A\"/><path d=\"M97.6602 27.345V11.4951H101.221V14.1883H101.407C101.736 13.2803 102.281 12.5717 103.043 12.0626C103.805 11.5467 104.714 11.2887 105.771 11.2887C106.841 11.2887 107.743 11.5501 108.477 12.0729C109.219 12.5889 109.74 13.294 110.042 14.1883H110.207C110.557 13.3078 111.147 12.6061 111.977 12.0833C112.814 11.5535 113.805 11.2887 114.951 11.2887C116.406 11.2887 117.593 11.7496 118.513 12.6714C119.432 13.5933 119.892 14.9382 119.892 16.7061V27.345H116.156V17.284C116.156 16.3003 115.895 15.5814 115.373 15.1273C114.852 14.6664 114.214 14.436 113.459 14.436C112.56 14.436 111.857 14.718 111.349 15.2821C110.848 15.8394 110.598 16.5651 110.598 17.4594V27.345H106.944V17.1292C106.944 16.3106 106.697 15.6571 106.203 15.1686C105.716 14.6802 105.078 14.436 104.288 14.436C103.753 14.436 103.266 14.5736 102.827 14.8487C102.388 15.117 102.038 15.4988 101.777 15.9941C101.516 16.4826 101.386 17.0535 101.386 17.7071V27.345H97.6602Z\" fill=\"#26282A\"/><path d=\"M80.416 33.2887V11.4951H84.0801V14.1161H84.2962C84.4884 13.7308 84.7594 13.3215 85.1093 12.8881C85.4593 12.4479 85.9327 12.0729 86.5297 11.7634C87.1267 11.4469 87.8883 11.2887 88.8146 11.2887C90.036 11.2887 91.1373 11.6017 92.1185 12.2277C93.1065 12.8469 93.8888 13.7652 94.4651 14.9829C95.0484 16.1936 95.34 17.6796 95.34 19.4407C95.34 21.1811 95.0552 22.6602 94.4857 23.8778C93.9162 25.0955 93.1408 26.0242 92.1596 26.6639C91.1784 27.3037 90.0668 27.6236 88.8249 27.6236C87.9192 27.6236 87.1678 27.4722 86.5709 27.1696C85.9739 26.8669 85.4936 26.5023 85.1299 26.0757C84.7731 25.6424 84.4952 25.233 84.2962 24.8478H84.1419V33.2887H80.416ZM84.0698 19.42C84.0698 20.445 84.2139 21.3428 84.5021 22.1133C84.7971 22.8838 85.2191 23.4857 85.7681 23.9191C86.3238 24.3456 86.9963 24.5589 87.7854 24.5589C88.6088 24.5589 89.2983 24.3387 89.8541 23.8985C90.4099 23.4513 90.8285 22.8425 91.1098 22.072C91.398 21.2946 91.5421 20.4106 91.5421 19.42C91.5421 18.4363 91.4014 17.5626 91.1201 16.799C90.8388 16.0354 90.4202 15.4369 89.8644 15.0035C89.3086 14.5701 88.6156 14.3534 87.7854 14.3534C86.9894 14.3534 86.3136 14.5632 85.7578 14.9829C85.202 15.4025 84.78 15.9907 84.4918 16.7474C84.2105 17.5041 84.0698 18.395 84.0698 19.42Z\" fill=\"#26282A\"/><path d=\"M69.1921 27.6649C68.1904 27.6649 67.2881 27.486 66.4852 27.1283C65.6893 26.7637 65.058 26.2271 64.5914 25.5185C64.1317 24.81 63.9019 23.9363 63.9019 22.8975C63.9019 22.0032 64.0665 21.2637 64.3959 20.6789C64.7252 20.0942 65.1747 19.6264 65.7442 19.2756C66.3137 18.9247 66.9553 18.6599 67.6689 18.481C68.3893 18.2953 69.1338 18.1611 69.9023 18.0786C70.8286 17.9823 71.58 17.8963 72.1564 17.8206C72.7327 17.738 73.1513 17.6142 73.412 17.4491C73.6796 17.2771 73.8134 17.0123 73.8134 16.6545V16.5926C73.8134 15.8153 73.5836 15.2133 73.1238 14.7868C72.6641 14.3603 72.002 14.147 71.1374 14.147C70.2248 14.147 69.5009 14.3465 68.9657 14.7455C68.4374 15.1445 68.0806 15.6158 67.8953 16.1592L64.4165 15.6639C64.6909 14.7008 65.1438 13.896 65.7751 13.2493C66.4063 12.5958 67.1783 12.1073 68.0909 11.784C69.0034 11.4538 70.0121 11.2887 71.1168 11.2887C71.8785 11.2887 72.6367 11.3781 73.3914 11.557C74.1462 11.7359 74.8358 12.0317 75.4602 12.4444C76.0846 12.8503 76.5855 13.4041 76.9629 14.1058C77.3471 14.8075 77.5393 15.6846 77.5393 16.7371V27.345H73.9575V25.1677H73.834C73.6076 25.608 73.2885 26.0207 72.8768 26.406C72.472 26.7843 71.9608 27.0904 71.3433 27.3243C70.7326 27.5514 70.0155 27.6649 69.1921 27.6649ZM70.1596 24.92C70.9075 24.92 71.556 24.7721 72.1049 24.4763C72.6538 24.1736 73.0758 23.7746 73.3709 23.2793C73.6728 22.784 73.8237 22.244 73.8237 21.6592V19.7915C73.7071 19.8878 73.5081 19.9773 73.2268 20.0598C72.9523 20.1424 72.6435 20.2146 72.3004 20.2765C71.9574 20.3384 71.6177 20.3934 71.2815 20.4416C70.9453 20.4898 70.6537 20.531 70.4066 20.5654C69.8509 20.6411 69.3534 20.7649 68.9143 20.9369C68.4751 21.1089 68.1286 21.3497 67.8747 21.6592C67.6208 21.9619 67.4939 22.354 67.4939 22.8356C67.4939 23.5235 67.7443 24.0429 68.2452 24.3938C68.7461 24.7446 69.3843 24.92 70.1596 24.92Z\" fill=\"#26282A\"/><path d=\"M39.5 27.345V11.4951H43.0612V14.1883H43.2464C43.5758 13.2803 44.1213 12.5717 44.8829 12.0626C45.6446 11.5467 46.5537 11.2887 47.6104 11.2887C48.6808 11.2887 49.5831 11.5501 50.3173 12.0729C51.0584 12.5889 51.5798 13.294 51.8817 14.1883H52.0464C52.3964 13.3078 52.9865 12.6061 53.8167 12.0833C54.6538 11.5535 55.6453 11.2887 56.7912 11.2887C58.2459 11.2887 59.4329 11.7496 60.3524 12.6714C61.2718 13.5933 61.7316 14.9382 61.7316 16.7061V27.345H57.9954V17.284C57.9954 16.3003 57.7347 15.5814 57.2132 15.1273C56.6917 14.6664 56.0536 14.436 55.2988 14.436C54.3999 14.436 53.6966 14.718 53.1889 15.2821C52.688 15.8394 52.4375 16.5651 52.4375 17.4594V27.345H48.7837V17.1292C48.7837 16.3106 48.5367 15.6571 48.0427 15.1686C47.5555 14.6802 46.9174 14.436 46.1283 14.436C45.5931 14.436 45.1059 14.5736 44.6668 14.8487C44.2276 15.117 43.8777 15.4988 43.617 15.9941C43.3562 16.4826 43.2258 17.0535 43.2258 17.7071V27.345H39.5Z\" fill=\"#26282A\"/><path d=\"M27.3847 25.9178C28.8081 23.5868 30.5287 21.3029 30.9562 18.5589C31.9911 11.9172 26.9381 5.71447 19.956 5.30338C17.4904 5.15838 13.6449 5.12507 11.1992 5.30299C10.0552 5.38607 8.94122 5.89121 8.16887 6.70868C7.71694 7.18718 5.28183 11.1346 5.20651 11.6441C5.02777 12.8495 5.83228 13.8426 7.09035 13.9645C9.18143 14.1667 11.8763 13.9253 14.0309 13.9264C15.8964 13.9272 17.9989 13.8097 19.8339 13.9253C25.9341 14.3093 29.7128 20.5446 27.3249 25.9319L27.3847 25.9178Z\" stroke=\"#3A3838\" stroke-width=\"1.95943\" stroke-miterlimit=\"10\"/><path d=\"M14.0302 13.9258L10.6029 19.6599C9.96327 20.8096 10.6737 22.3059 12.0613 22.4638C14.1002 22.6962 17.0133 22.4493 19.1606 22.4689C21.213 22.4877 23.197 22.146 24.8203 23.6246C26.1443 24.8308 26.5555 26.7091 25.9192 28.3472L27.3849 25.9175C29.7728 20.5302 25.9338 14.3083 19.8336 13.9246C17.9986 13.809 15.8961 13.927 14.0306 13.9258H14.0302Z\" stroke=\"#3A3838\" stroke-width=\"1.95943\" stroke-miterlimit=\"10\"/><path d=\"M19.1603 22.469L15.6471 28.3947C15.2098 29.3278 15.7183 30.5509 16.7183 30.9134C17.4381 31.174 21.8747 31.1148 22.7354 30.9463C24.1038 30.6786 25.4299 29.6056 25.9188 28.3477C26.5548 26.7096 26.1436 24.8313 24.82 23.6251C23.1967 22.1461 21.1733 22.5542 19.1209 22.5354L19.1603 22.469Z\" stroke=\"#3A3838\" stroke-width=\"1.95943\" stroke-miterlimit=\"10\"/></svg>";
 /**
  * A MapLibre `IControl` rendering the MapMap wordmark. Typed structurally
  * (`onAdd`/`onRemove`) so it needs no maplibre-gl import and works with
@@ -330,7 +331,7 @@ declare const FULL_ATTRIBUTION = "\u00A9 OpenStreetMap contributors \u00A9 OpenM
 /** Default glyph endpoint (PBF fontstacks), mirroring `sn_style::DEFAULT_GLYPHS_URL`. */
 declare const DEFAULT_GLYPHS_URL = "https://fonts.mapmap.ai/{fontstack}/{range}.pbf";
 /** A sensible default territory tiles URL (overridable per map). */
-declare const DEFAULT_TERRITORY_TILES_URL = "pmtiles://https://tiles.mapmap.ai/territories/planet.pmtiles";
+declare const DEFAULT_TERRITORY_TILES_URL = "pmtiles://https://tiles.mapmap.ai/planet.pmtiles";
 /**
  * Every source-layer the Planetiler (OpenMapTiles-schema) tiles emit.
  * The style skeleton covers all of them; extra layers referencing anything
@@ -403,7 +404,7 @@ interface Theme {
     buildings_3d?: boolean;
     /**
      * Label fonts. Every fontstack must exist on the glyph server; until that
-     * ships (P2), leave this at its default (`"Noto Sans Regular"`).
+     * ships (P2), leave this at its default (`"MapMap Sans Regular"`).
      */
     fonts?: {
         regular?: string;
@@ -581,6 +582,224 @@ declare const NAV_CAMERA_DEFAULTS: {
     readonly zoom: 17.5;
     readonly speedMps: 12;
 };
+/**
+ * Safety-camera kinds a design can style, matching the kind the data model
+ * already carries per camera. LOCKSTEP: mirrors `NAV_CAMERA_KINDS` in
+ * `website/lib/studio-nav.ts`.
+ *
+ * WIRE NOTE: the gateway serialises `sn_safety::CameraKind` lowercase
+ * (`fixed` / `average` / `redlight` / `unknown`); `mobile_site` is a
+ * product-level kind a host may classify itself (the sidecar deliberately
+ * leaves an OSM `speed_camera=mobile` node as `unknown` rather than
+ * overclaiming a fixed installation). Normalise a wire value with
+ * {@link navCameraKind} before indexing a design.
+ */
+declare const NAV_CAMERA_KINDS: readonly ["fixed", "average", "red_light", "mobile_site", "unknown"];
+/** One safety-camera kind. */
+type NavCameraKind = (typeof NAV_CAMERA_KINDS)[number];
+/**
+ * Normalises a camera kind from the wire (or any host classifier) onto a
+ * {@link NavCameraKind}. Unrecognised values become `"unknown"`, never a
+ * guess: a mislabelled camera would alert a driver about the wrong thing.
+ */
+declare function navCameraKind(value: unknown): NavCameraKind;
+/** Curated icon sets a design can pick for the alert chip and map pins. */
+declare const NAV_ALERT_ICON_SETS: readonly ["european", "us", "minimal", "brand"];
+/** One curated icon set. `"brand"` means "use my `iconUrlOverrides`". */
+type NavAlertIconSet = (typeof NAV_ALERT_ICON_SETS)[number];
+/**
+ * When a kind alerts AUDIBLY while driving.
+ *
+ * The visual chip is governed by `alertWhileDriving` and is deliberately
+ * unconditional and calm; audio is the escalation channel (the shipping
+ * model: the pop-up always appears, the sound only when the driver is over
+ * the limit). UI labels must describe the behaviour - "Always alert",
+ * "Warn if speeding", "Never alert" - and must never say "Auto", which
+ * Organic Maps relabelled after users could not tell what it did.
+ */
+declare const NAV_ALERT_MODES: readonly ["always", "whenSpeeding", "never"];
+/** One alert mode. */
+type NavAlertMode = (typeof NAV_ALERT_MODES)[number];
+/**
+ * Audio channel for a kind: silent, a non-verbal earcon, or an earcon
+ * followed by speech naming the kind. Kind is carried in the ICON and in
+ * SPEECH, never in the earcon's identity - urgency lives in timbre, so the
+ * escalated state is the same motif made more insistent, not a new sound.
+ */
+declare const NAV_ALERT_AUDIO_MODES: readonly ["off", "earcon", "earcon_and_speech"];
+/** One audio mode. */
+type NavAlertAudioMode = (typeof NAV_ALERT_AUDIO_MODES)[number];
+/**
+ * The built-in earcon library, as a curated enum rather than a free URL.
+ *
+ * A design picks ONE sound for the calm alert and ONE for its escalated
+ * variant - never one per camera kind. Kind is carried by the icon and by
+ * speech; urgency is carried by timbre, so the escalated state is the same
+ * motif made more insistent. Per-kind sounds would ask a driver to learn
+ * five timbres at 70 mph, which no shipping product does.
+ *
+ * `zoneEnter` / `zoneClear` are the average-speed corridor pair a host
+ * plays at the entry and exit of a corridor. They are offered here too so
+ * a design can borrow their timbre, but the corridor itself always uses
+ * the pair - it is a boundary crossing, not a point alert.
+ */
+declare const NAV_ALERT_SOUNDS: readonly ["cameraCalm", "cameraUrgent", "overspeedSoft", "zoneEnter", "zoneClear"];
+/** One built-in earcon. */
+type NavAlertSound = (typeof NAV_ALERT_SOUNDS)[number];
+/**
+ * File name of each built-in earcon, relative to
+ * {@link NAV_ALERT_SOUND_BASE_URL}. Mono, ~0.5-0.9 s, mixed dry with no
+ * reverb tail so they stay crisp over road noise and never trail into the
+ * spoken instruction that follows.
+ */
+declare const NAV_ALERT_SOUND_FILES: Record<NavAlertSound, string>;
+/**
+ * Where the built-in earcons are hosted. Public, unmetered and immutable
+ * (the files are content-stable; a new sound gets a new name). Pass your
+ * own base to {@link navAlertSoundUrl} to self-host them - the SDK bundles
+ * no audio, exactly like `VoiceGuidance`'s earcon URLs.
+ */
+declare const NAV_ALERT_SOUND_BASE_URL = "https://mapmap.ai/earcons/";
+/**
+ * Absolute URL for a built-in earcon. An unrecognised value falls back to
+ * `cameraCalm` rather than returning nothing: a missing alert sound is a
+ * silent failure a driver cannot see.
+ */
+declare function navAlertSoundUrl(sound: unknown, baseUrl?: string): string;
+/** Lead-distance presets. Not a free number: see {@link NAV_ALERT_LEAD_DISTANCE_M}. */
+declare const NAV_ALERT_LEAD_DISTANCES: readonly ["short", "standard", "long"];
+/** One lead-distance preset. */
+type NavAlertLeadDistance = (typeof NAV_ALERT_LEAD_DISTANCES)[number];
+/**
+ * Metres before the camera at which the alert may first appear, per preset.
+ * These are FLOORS, not targets: a host may announce earlier (a motorway
+ * closing speed eats 400 m in nine seconds) but never later. Exposed as an
+ * enum rather than a numeric field precisely so no design can set a lead
+ * below the safety floor.
+ */
+declare const NAV_ALERT_LEAD_DISTANCE_M: Record<NavAlertLeadDistance, number>;
+/** Metres of lead for a preset (garbage falls back to `standard`). */
+declare function navAlertLeadDistanceM(preset: unknown): number;
+/**
+ * Where the chip sits. Constrained slots, never free x/y: the chip must not
+ * occlude the current speed or the limit. Covering exactly the two numbers
+ * the alert is telling the driver to act on has been the single
+ * most-complained-about defect in the category since 2023, and a free
+ * position would let a customer reintroduce it.
+ */
+declare const NAV_ALERT_CHIP_POSITIONS: readonly ["aboveSpeed", "topLeading", "topTrailing"];
+/** One chip position slot. */
+type NavAlertChipPosition = (typeof NAV_ALERT_CHIP_POSITIONS)[number];
+/**
+ * Per-kind surfaces and channels. The three booleans are orthogonal: a
+ * kind can appear on the map without alerting, alert without appearing on
+ * the map, or be listed in the route preview only.
+ */
+interface NavAlertKindDesign {
+    /**
+     * Draw a pin for this kind while BROWSING the map (no active guidance).
+     *
+     * Kept as the browse-mode field under its original name so themes saved
+     * before the browse/navigate split round-trip unchanged.
+     */
+    showOnMap: boolean;
+    /**
+     * Draw a pin for this kind on the map DURING active navigation.
+     *
+     * Separate from {@link showOnMap} because the two are genuinely
+     * different decisions: a fleet product may want a clean driving map and
+     * a fully annotated planning map, or the reverse. Defaults to `true`,
+     * and absent in an older theme reads as `true` - the market shows
+     * cameras with or without a planned route, so gating map display behind
+     * guidance would be more restrictive than every product a driver has
+     * used.
+     */
+    showOnMapWhileNavigating: boolean;
+    /** Show the alert chip for this kind while driving. */
+    alertWhileDriving: boolean;
+    /** List this kind in the pre-drive route preview. */
+    showInRoutePreview: boolean;
+    /** When the AUDIBLE alert fires. The chip itself follows `alertWhileDriving`. */
+    alertMode: NavAlertMode;
+    /** Which audio channel this kind uses. */
+    audioMode: NavAlertAudioMode;
+}
+/**
+ * Safety-alert tokens (`extra.nav.alerts`): the camera alert chip, its
+ * escalated state, per-kind icons and surfaces, and the average-speed
+ * corridor highlight.
+ *
+ * The whole block is optional since v1 - themes saved without it load
+ * unchanged and hosts keep their built-in look - but a block that IS
+ * present is always complete: every field, including both escalated
+ * tokens, parses to a value. The escalated state can be restyled, never
+ * removed.
+ *
+ * Two states only, calm and escalated. There is no amber tier: no shipping
+ * navigation product uses a three-colour alert state and drivers have no
+ * learned mapping for one.
+ *
+ * NOT STYLEABLE HERE: whether cameras may be shown at all. That is a
+ * server-side jurisdiction policy applied before any camera leaves the
+ * gateway. A design styles what the policy permits and nothing more.
+ */
+interface NavAlertsDesign {
+    /** Chip background in the calm (default) state. */
+    background: string;
+    /** Chip text and icon colour in the calm state. */
+    textColor: string;
+    /** Chip outline colour (both states). */
+    outlineColor: string;
+    /** Chip corner radius in px, 0-24. */
+    cornerRadius: number;
+    /** Chip outline width in px, 0-4. */
+    outlineWidth: number;
+    /** Chip background when escalated (driver over the limit). */
+    escalatedBackground: string;
+    /** Chip text and icon colour when escalated. */
+    escalatedTextColor: string;
+    /** Curated icon set for the chip and map pins. */
+    iconSet: NavAlertIconSet;
+    /**
+     * Per-kind icon overrides (`https:` or `data:` URIs only). Any kind left
+     * out keeps `iconSet`'s icon. Absent when no kind is overridden.
+     */
+    iconUrlOverrides?: Partial<Record<NavCameraKind, string>>;
+    /**
+     * The earcon played for a calm alert. One sound for the whole design,
+     * never one per kind - see {@link NAV_ALERT_SOUNDS}.
+     */
+    alertSound: NavAlertSound;
+    /**
+     * Optional replacement for the calm earcon (`https:` or `data:` URIs
+     * only, same rule as `iconUrlOverrides`). Absent = the built-in
+     * {@link alertSound}.
+     */
+    alertSoundUrl?: string;
+    /**
+     * The earcon played when the driver is over the limit. The escalated
+     * state is not removable - it can be restyled and its sound chosen, but
+     * a design cannot silence the escalation itself (set the kind's
+     * `audioMode` to `off` if you want no audio at all).
+     */
+    escalatedSound: NavAlertSound;
+    /** Optional replacement for the escalated earcon; same URL rule. */
+    escalatedSoundUrl?: string;
+    /** Map pin size as a multiplier of the default ramp, 0.75-1.5. */
+    mapIconSize: number;
+    /** Lowest zoom at which map pins are drawn, 9-14. */
+    mapMinZoom: number;
+    /** Lead-distance preset; see {@link NAV_ALERT_LEAD_DISTANCE_M}. */
+    leadDistance: NavAlertLeadDistance;
+    /** Which constrained slot the chip occupies. */
+    chipPosition: NavAlertChipPosition;
+    /** Colour of the average-speed corridor highlight on the route line. */
+    corridorColor: string;
+    /** Corridor highlight opacity, 0-1. */
+    corridorOpacity: number;
+    /** Per-kind surfaces and channels; always all five kinds. */
+    kinds: Record<NavCameraKind, NavAlertKindDesign>;
+}
 /** The `extra.nav` block: navigation design tokens for the SDKs. */
 interface NavDesign {
     /** Block schema version; currently always 1. */
@@ -593,12 +812,42 @@ interface NavDesign {
      * means "SDK built-ins" - the block stays `version: 1` either way.
      */
     camera?: NavCameraDesign;
+    /**
+     * Optional since v1: safety-alert chip, per-kind surfaces and corridor
+     * highlight. Absent means "SDK built-ins"; the block stays `version: 1`.
+     */
+    alerts?: NavAlertsDesign;
 }
+/**
+ * Defaults for the optional `alerts` block. LOCKSTEP: mirrors
+ * `defaultNavAlertsDesign` in `website/lib/studio-nav.ts`.
+ *
+ * Calm chip = the banner's dark pill, so an unstyled alert already matches
+ * the rest of the guidance surface. Escalated = a red that clears 4.5:1
+ * against white text.
+ *
+ * Per-kind defaults follow the "visual always, audio conditional" rule:
+ * the three confidently classified kinds alert unconditionally, a mobile
+ * site (a location where enforcement sometimes happens, not a device)
+ * warns only if speeding, and an unclassified camera stays on the map but
+ * does not interrupt a drive.
+ */
+declare function defaultNavAlertsDesign(): NavAlertsDesign;
 /**
  * Defaults mirror what the SDK draws today with no design: `RouteLayer`'s
  * signal-blue line over a dark casing, and `GuidanceBanner`'s dark pill.
  */
 declare function defaultNavDesign(): NavDesign;
+/**
+ * Lenient parse of an `extra.nav.alerts` value. Every numeric is clamped,
+ * every enum validated, and garbage falls back per field to the defaults -
+ * so a hand-edited or older theme can never produce an alert that is
+ * unreadable, positioned over the speed readout, or missing its escalated
+ * state. The escalated tokens in particular always come back set, even
+ * when the input omits or nulls them: a driver-facing escalation is not a
+ * removable feature.
+ */
+declare function parseNavAlertsDesign(value: unknown): NavAlertsDesign;
 /**
  * Lenient parse of an `extra.nav` value: unknown or malformed fields fall
  * back to the defaults, so an imported theme never fails on its nav block.
@@ -929,6 +1178,13 @@ interface RouteLayerOptions {
      * without a design the layer keeps its built-in signal-blue look.
      */
     design?: NavRouteDesign;
+    /**
+     * Studio safety-alert design (`extra.nav` `alerts` block), used for the
+     * average-speed corridor highlight drawn by
+     * {@link RouteLayer.setAlertCorridors}. Defaults to the map's
+     * `navDesign.alerts` when given a `MapMapMap` whose theme carried one.
+     */
+    alertsDesign?: NavAlertsDesign;
     /**
      * Colour of the already-travelled part of the line once
      * {@link RouteLayer.setProgress} is used (the Google-style "vanishing
@@ -950,11 +1206,15 @@ declare class RouteLayer {
     private readonly maneuverSourceId;
     private readonly maneuverLayerId;
     private readonly arrowImageId;
+    private readonly corridorSourceId;
+    private readonly corridorLayerId;
     private readonly design;
+    private alertsDesign;
     private readonly progressColor;
     private lastRoute;
     private progress;
     private maneuver;
+    private corridors;
     constructor(map: MapMapMap | Map, options?: RouteLayerOptions);
     private readonly handleStyleLoad;
     /**
@@ -995,6 +1255,26 @@ declare class RouteLayer {
     clearManeuver(): void;
     /** Add-or-update the manoeuvre arrow source/layer for the current style. */
     private installManeuver;
+    /**
+     * Highlights average-speed enforcement corridors on the route line.
+     *
+     * A corridor is a stretch of the route between an entry and an exit
+     * camera, so it is a property of the LINE, not a point alert: drawing it
+     * as a tinted overlay above the route is what makes "you are inside a
+     * section check right now" readable at a glance, and it is the only part
+     * of the alert design that persists rather than firing once.
+     *
+     * Pass the corridor geometries (arrays of `[lng, lat]` along the route)
+     * and, optionally, a Studio alerts design for the colour and opacity;
+     * without one the layer uses the design carried by the owning map, then
+     * a built-in tint. An empty array clears the highlight. Survives style
+     * swaps like the route itself.
+     */
+    setAlertCorridors(corridors: readonly (readonly [number, number])[][], design?: NavAlertsDesign): void;
+    /** Removes the corridor highlight (the route line itself is untouched). */
+    clearAlertCorridors(): void;
+    /** Add-or-update the corridor source/layer for the current style. */
+    private installCorridors;
     /** Remove the route's layers and source from the map. */
     clear(): void;
     /**
@@ -1004,6 +1284,76 @@ declare class RouteLayer {
     destroy(): void;
 }
 
+/**
+ * WCAG relative-luminance contrast, and the legibility gate for the
+ * safety-alert chip.
+ *
+ * WHY THIS IS A SAFETY CHECK, NOT A TASTE CHECK: NHTSA's visual-manual
+ * driver-distraction guidelines are built around single glances of under
+ * two seconds away from the road. An alert chip whose text does not
+ * resolve inside one such glance either costs the driver a second glance
+ * or is not read at all, so a low-contrast colour pair is a defect in the
+ * alert, not a stylistic preference. Studio therefore warns on a failing
+ * pair rather than silently accepting it.
+ *
+ * The threshold is WCAG 2.x AA for large text (3:1) raised to the
+ * body-text floor (4.5:1) - a chip is glanced at, not read at leisure, and
+ * the guidance surface already renders at banner sizes.
+ *
+ * DELIBERATELY NOT the Rust `sn_style::contrast` helper (nor the
+ * `check_style_contrast` MCP tool): the web SDK does not link Rust, and
+ * Studio needs this in the browser as the customer drags a colour picker.
+ * Same formula (WCAG 2.x `(L1 + 0.05) / (L2 + 0.05)` over sRGB
+ * relative luminance), independently implemented and unit-tested.
+ *
+ * LOCKSTEP: mirrors the contrast helpers in `website/lib/studio-nav.ts`.
+ */
+
+/** Minimum acceptable contrast ratio for alert-chip text on its background. */
+declare const ALERT_CONTRAST_MIN = 4.5;
+/**
+ * Parses a CSS hex colour (`#rgb`, `#rrggbb`, `#rgba`, `#rrggbbaa`) into
+ * 0-255 sRGB channels. Alpha is accepted and ignored - the chip composites
+ * over an opaque background, so its alpha does not describe what the
+ * driver sees. Returns `undefined` for any other notation (named colours,
+ * `rgb()`, gradients): unparseable means "cannot judge", never "fails".
+ */
+declare function parseHexColor(value: unknown): [number, number, number] | undefined;
+/** WCAG 2.x relative luminance of an sRGB triple (channels 0-255). */
+declare function relativeLuminance(rgb: readonly [number, number, number]): number;
+/**
+ * WCAG 2.x contrast ratio between two hex colours, from 1 (identical) to
+ * 21 (black on white). Order-independent. Returns `undefined` when either
+ * colour cannot be parsed, so callers can distinguish "not judgeable" from
+ * "fails".
+ */
+declare function contrastRatio(a: unknown, b: unknown): number | undefined;
+/** A chip colour pair that falls below {@link ALERT_CONTRAST_MIN}. */
+interface AlertContrastIssue {
+    /** Which chip state the pair belongs to. */
+    state: "calm" | "escalated";
+    /** The text colour of the failing pair. */
+    textColor: string;
+    /** The background colour of the failing pair. */
+    background: string;
+    /** The measured ratio, rounded to 2 dp. */
+    ratio: number;
+    /** The floor it failed to clear. */
+    minimum: number;
+}
+/**
+ * Every chip colour pair in `design` that fails the contrast floor, in
+ * state order. An empty array means both states are legible (or, for
+ * colours this module cannot parse, not judgeable - those are skipped
+ * rather than reported as failures).
+ *
+ * Advisory by design: the parser stays lenient and never rejects a theme
+ * on contrast. Studio surfaces these as warnings next to the pickers so a
+ * designer sees the problem while choosing, which is the only moment the
+ * warning can actually change the outcome.
+ */
+declare function alertContrastIssues(design: NavAlertsDesign): AlertContrastIssue[];
+
 /** Maximum accepted `data:` puck-image payload (matches Studio's upload cap). */
 declare const MAX_PUCK_IMAGE_BYTES: number;
 /**
@@ -1861,9 +2211,10 @@ declare class IsochroneLayer {
  *   micro-frontends - breaks the shared WebGL context and styles)
  * - WebGL unavailable (headless browsers, blocked GPU, old devices)
  * - missing/invalid API key (a 401 from the tile or routing endpoints)
+ * - a basemap tiles URL that 404s (the map loads but renders blank)
  */
 /** The distinct issues the diagnostics can report. */
-type DiagnosticIssue = "container-zero-height" | "container-detached" | "duplicate-maplibre" | "webgl-unavailable" | "invalid-api-key";
+type DiagnosticIssue = "container-zero-height" | "container-detached" | "duplicate-maplibre" | "webgl-unavailable" | "invalid-api-key" | "basemap-not-found";
 /** Reset the once-per-page dedup - for tests (and hot-reload tooling). */
 declare function resetDiagnostics(): void;
 /** What `runMapDiagnostics` needs; everything optional and structural. */
@@ -2031,6 +2382,18 @@ interface StepGuidance {
     voice: VoiceInstruction[];
     /** Visual banners for the upcoming maneuver. */
     banners: BannerInstruction[];
+    /**
+     * OSRM travel mode of the step (`driving`, `ferry`, …) where the server
+     * emits it. Pass the guidance entry as {@link GuidanceBanner.update}'s
+     * second argument so ferry legs render the ferry icon.
+     */
+    mode?: string;
+    /**
+     * `left`/`right` where the server emits it (the MapMap gateway sets it on
+     * u-turn steps), so u-turn icons point the correct way in left-hand-traffic
+     * regions.
+     */
+    drivingSide?: string;
 }
 /**
  * Extracts per-step guidance from a parsed route (requires the route to
@@ -2079,19 +2442,228 @@ interface SpeakOptions {
  */
 declare function speak(instruction: VoiceInstruction, options?: SpeakOptions): boolean;
 /**
- * A minimal DOM banner: primary text with a maneuver arrow, optional lane
- * row. Style with the `mapmap-banner` / `mapmap-banner-lanes` classes, pass
- * a Studio design (`extra.nav` `banner` block, e.g. `map.navDesign?.banner`)
- * to match a Studio theme, or read {@link StepGuidance} yourself for fully
- * custom UI.
+ * A minimal DOM banner: primary text with a maneuver icon from the platform
+ * direction set (the same `direction-icons` glyphs the MapMap apps use —
+ * ferry, roundabouts, forks, ramps and all), plus an optional lane row.
+ * Style with the `mapmap-banner` / `mapmap-banner-lanes` /
+ * `mapmap-banner-icon` classes, pass a Studio design (`extra.nav` `banner`
+ * block, e.g. `map.navDesign?.banner`) to match a Studio theme, or read
+ * {@link StepGuidance} yourself for fully custom UI. The icon's secondary
+ * shapes retheme via the `--mm-icon-secondary` CSS custom property.
  */
 declare class GuidanceBanner {
     /** The banner root element; attach it wherever your UI needs it. */
     readonly element: HTMLElement;
     private readonly design;
     constructor(container?: HTMLElement, design?: NavBannerDesign);
-    /** Renders a banner instruction (or hides the element with `null`). */
-    update(banner: BannerInstruction | null): void;
+    /**
+     * Renders a banner instruction (or hides the element with `null`).
+     *
+     * `step` is optional icon context — pass the step's {@link StepGuidance}
+     * (or any `{ mode, drivingSide }`) so ferry legs render the ferry glyph
+     * and u-turns point the correct way in left-hand-traffic regions.
+     */
+    update(banner: BannerInstruction | null, step?: Pick<StepGuidance, "mode" | "drivingSide">): void;
+}
+/**
+ * One camera alert to present. `kind` is normalised through
+ * {@link navCameraKind}, so a raw gateway value (`"redlight"`) is accepted.
+ *
+ * JURISDICTION: whether a camera reaches you at all is decided server-side
+ * before the response leaves the gateway. Nothing in this module can widen
+ * that; it styles what the policy already permitted.
+ */
+interface CameraAlert {
+    /** Camera regime; wire values are normalised. */
+    kind: NavCameraKind | string;
+    /** Enforced limit in km/h, when known. */
+    limitKph?: number;
+    /** Metres to the camera, when known. */
+    distanceM?: number;
+}
+/**
+ * What a host should actually do with an alert, given the design and
+ * whether the driver is currently over the limit.
+ *
+ * The rule this encodes, and the reason it is a pure function rather than
+ * scattered branches in a renderer: the VISUAL alert is unconditional and
+ * calm, and AUDIO is the escalation channel. A driver within the limit
+ * still sees the chip; only the sound waits for speeding.
+ */
+interface AlertPresentation {
+    /** Whether to show the chip at all. */
+    visible: boolean;
+    /** Whether the chip should render in its escalated state. */
+    escalated: boolean;
+    /** Whether audio should fire now. */
+    audible: boolean;
+    /** Which audio channel to use when `audible`. */
+    audioMode: NavAlertAudioMode;
+    /**
+     * The earcon to play for THIS state: the design's calm sound, or its
+     * escalated variant when `escalated`. Always set (even when `audible` is
+     * false) so a host can pre-load it; play it only when `audible`.
+     */
+    soundUrl: string;
+    /** Metres of lead this design guarantees before the camera. */
+    leadDistanceM: number;
+}
+/**
+ * Resolves a design plus live state into what to present.
+ *
+ * Escalation is by INTENSITY, not identity: `escalated` restyles the same
+ * chip and re-uses the same earcon motif more insistently. It never swaps
+ * in a different icon or a different sound - kind is carried by the icon
+ * and by speech, urgency by timbre, and mixing the two channels is how
+ * drivers end up unable to tell "a camera" from "you are speeding".
+ */
+declare function alertPresentation(design: NavAlertsDesign, alert: CameraAlert, state?: {
+    speeding?: boolean;
+}): AlertPresentation;
+/**
+ * The earcon URL for a design in the calm or escalated state.
+ *
+ * A design-level `alertSoundUrl` / `escalatedSoundUrl` override wins;
+ * otherwise the chosen built-in resolves against the hosted earcon
+ * library. There is deliberately no per-kind sound: kind travels in the
+ * icon and in speech, urgency travels in timbre.
+ */
+declare function alertSoundUrl(design: NavAlertsDesign, escalated: boolean): string;
+/** Whether the map is being browsed or actively navigated. */
+type MapDisplayMode = "browse" | "navigating";
+/**
+ * Whether a kind's pin should be drawn on the map in the given mode.
+ *
+ * Browsing and navigating are separate switches because they are separate
+ * decisions - the market warns with or without a planned route, so a
+ * design that shows a camera on the planning map is not thereby committed
+ * to a cluttered driving map, nor the reverse.
+ */
+declare function cameraShownOnMap(design: NavAlertsDesign, kind: NavCameraKind | string, mode?: MapDisplayMode): boolean;
+/**
+ * The camera kinds a style should draw in the given mode, in the canonical
+ * kind order. Feed it straight into a MapLibre `filter` (see
+ * {@link cameraSymbolLayer}); an empty array means "draw nothing", which
+ * a caller must honour by removing or hiding the layer.
+ */
+declare function cameraKindsShownOnMap(design: NavAlertsDesign, mode?: MapDisplayMode): NavCameraKind[];
+/**
+ * A MapLibre symbol layer that draws camera POIs from the sprite sheet.
+ *
+ * Additive by design: the style compiler is untouched and ships no camera
+ * layer of its own, because cameras arrive as host data (the gateway's
+ * `POST /v1/cameras/along`, projected into a GeoJSON source) rather than
+ * in the vector tiles. Point this at that source and the sprite icons
+ * built from `map-assets/icons/cameras` render at the design's size, zoom
+ * floor and per-mode visibility.
+ *
+ * The features must carry a `kind` property holding one of
+ * {@link NAV_CAMERA_KINDS} (or the gateway's `redlight` spelling); an
+ * unrecognised value falls back to the `unknown` icon, never to a guess at
+ * a specific camera type.
+ *
+ * @param source GeoJSON source id holding the camera features.
+ * @param variant Sprite variant to draw: `"light"` icons read on a dark
+ *   basemap, `"dark"` icons on a light one.
+ */
+declare function cameraSymbolLayer(design: NavAlertsDesign, source: string, mode?: MapDisplayMode, variant?: "light" | "dark", id?: string): Record<string, unknown>;
+/**
+ * Sprite image id for a camera kind, as built into the published sprite
+ * sheet by `map-assets/icons/cameras/generate.mjs`.
+ *
+ * LOCKSTEP: the file names in `map-assets/sprites/svg/camera-*.svg` are
+ * exactly these ids — spreet names each image after its file.
+ */
+declare function cameraSpriteName(kind: NavCameraKind | string, variant?: "light" | "dark"): string;
+/**
+ * Human-readable name for a camera kind, used in the chip's text and in
+ * the spoken announcement. Kind lives here and in the icon, never in the
+ * earcon.
+ */
+declare function cameraKindLabel(kind: NavCameraKind | string): string;
+/**
+ * The icon for a kind under a design, as a complete inline SVG string.
+ *
+ * `iconSet` chooses the frame (a European circular plate, a US rounded
+ * plate, or no frame); the glyph inside always encodes the KIND, because
+ * that is the channel kind is allowed to travel on. `"brand"` draws the
+ * unframed glyph as its fallback - it expects an `iconUrlOverrides` entry,
+ * and {@link alertIconUrl} is what actually resolves one.
+ */
+declare function alertIconSvg(design: NavAlertsDesign, kind: NavCameraKind | string): string;
+/**
+ * The override URL for a kind, if the design sets one. Overrides win over
+ * `iconSet` for that kind only; every other kind keeps the curated icon.
+ */
+declare function alertIconUrl(design: NavAlertsDesign, kind: NavCameraKind | string): string | undefined;
+/**
+ * Template-shaped content for an alert: the fields a head unit can
+ * actually render.
+ *
+ * CarPlay's `CPNavigationAlert` and Android Auto's `Alert` inside a
+ * `NavigationTemplate` take a title, a subtitle and an image - the system
+ * draws them, and none of the chip's colour, radius or position tokens
+ * survive the trip. Hosts targeting a head unit should read this instead
+ * of the DOM chip, so styling degrades gracefully rather than being
+ * assumed to render.
+ */
+interface AlertChipContent {
+    kind: NavCameraKind;
+    /** Primary line, e.g. "Average speed check". */
+    title: string;
+    /** Secondary line: limit and distance when known, else empty. */
+    subtitle: string;
+    /** Override icon URL when the design sets one for this kind. */
+    iconUrl?: string;
+}
+/** The text/icon content of an alert chip, free of any styling tokens. */
+declare function alertChipContent(design: NavAlertsDesign, alert: CameraAlert): AlertChipContent;
+/**
+ * The colour a host should paint the SPEED readout, given a design and
+ * whether the driver is speeding.
+ *
+ * Deliberate division of labour: the escalation the driver reads is the
+ * speed number turning the escalated colour, while the alert chip stays
+ * legible in its own escalated tokens. Colouring the card and leaving the
+ * speed untouched puts the urgency on the wrong element - the driver has
+ * to act on the speed, so the speed is what changes. Returns `undefined`
+ * when calm, meaning "leave the readout in its normal colour".
+ */
+declare function alertSpeedReadoutColor(design: NavAlertsDesign, escalated: boolean): string | undefined;
+/**
+ * A minimal DOM safety-alert chip: kind icon, kind label and (when known)
+ * the limit and distance, in a calm or escalated state.
+ *
+ * Style with the `mapmap-alert-chip` class, or pass a Studio design
+ * (`extra.nav` `alerts` block, e.g. `map.navDesign?.alerts`) to match a
+ * Studio theme. Framework-free and DOM-only, exactly like
+ * {@link GuidanceBanner}; head units should read {@link alertChipContent}
+ * instead.
+ *
+ * The chip NEVER overlaps the speed or the limit: its position comes from
+ * a constrained slot enum, and `aboveSpeed` reserves its own clearance.
+ */
+declare class CameraAlertChip {
+    /** The chip root element; attach it wherever your UI needs it. */
+    readonly element: HTMLElement;
+    private readonly design;
+    private escalated;
+    constructor(container?: HTMLElement, design?: NavAlertsDesign);
+    /** Whether the chip is currently in its escalated state. */
+    get isEscalated(): boolean;
+    /**
+     * Renders an alert (or hides the chip with `null`). `state.speeding`
+     * drives the escalated state; the chip itself shows regardless, because
+     * the visual alert is unconditional.
+     *
+     * A kind whose design turns `alertWhileDriving` off hides the chip: the
+     * customer chose not to surface that kind while driving.
+     */
+    update(alert: CameraAlert | null, state?: {
+        speeding?: boolean;
+    }): void;
+    /** Writes the calm/escalated tokens (and slot) onto the root element. */
+    private applyStateStyles;
 }
 
 /**
@@ -2211,4 +2783,4 @@ declare class VoiceGuidance {
     private playEarcon;
 }
 
-export { AdrCheck, type AdrCheckOptions, type AdrCheckRequest, type AdrCheckResult, type AdrDimensions, type AdrTunnelCategory, type BannerComponent, type BannerContent, type BannerInstruction, type BuildStyleOptions, type CameraFix, DEFAULT_GLYPHS_URL, DEFAULT_TERRITORY_TILES_URL, type DiagnosticIssue, EFFECTS_METADATA_KEY, FLOW_DEFAULTS, FULL_ATTRIBUTION, FlowRouteEffectLayer, type FlythroughController, type FlythroughOptions, type FlythroughPose, GuidanceBanner, type GuidanceSeverity, type GuidanceSpokenPrompt, type IsochroneFeatureCollection, IsochroneLayer, type IsochroneLayerOptions, LOGO_SVG, type LaneIndication, type LayerOverride, type LngLatLike, LogoControl, type LogoOptions, type LogoPosition, MAX_PUCK_IMAGE_BYTES, type MapDiagnosticsInput, MapMapMap, type MapMapOptions, type MapMapTheme, NAV_CAMERA_DEFAULTS, type NavBannerDesign, type NavCameraDesign, type NavDesign, type NavPuckDesign, type NavRouteDesign, NavigationCamera, type NavigationCameraMode, type NavigationCameraOptions, type NearestByDriveTimeOptions, OPENMAPTILES_ATTRIBUTION, OSM_ATTRIBUTION, PALETTE_SLOTS, POI_CATEGORY_COLORS, POI_CATEGORY_IDS, POI_CLASS_CATEGORIES, type ParsedRoute, type Place, type PlacePointFeature, type PlaceWithDistance, type PlaceWithDriveTime, type PlacesFeatureCollection, type PlacesIcon, type PlacesInput, PlacesLayer, type PlacesLayerIds, type PlacesLayerOptions, type PlacesSelectOptions, type PoiCategoryDesign, type PoiDesign, PositionPuck, type PositionPuckOptions, type ProbeUploadOutcome, RIBBON_FLOATS_PER_VERTEX, ROUTE_EFFECTS, type ReachabilityMode, type RibbonMesh, type RouteEffectLayer, type RouteEffectName, type RouteFlowOptions, type RouteGeometry, RouteLayer, type RouteLayerOptions, type RouteOptions, type RouteProfile, SIGNAL_BLUE, SOURCE_LAYERS, type SetRouteEffectOptions, type SeverityProsody, type ShowReachabilityOptions, type SpeakOptions, type StepGuidance, type SunTimes, type Theme, type ThemeEffects, ThemeScheduler, type ThemeSchedulerOptions, type TruckParams, type UploadProbeOptions, VoiceGuidance, type VoiceGuidanceOptions, type VoiceGuidanceUpdate, type VoiceInstruction, applyPoiDesign, bannerLanes, bearingBetween, bindFlythroughToScroll, buildAdrCheckBody, buildProbeUrl, buildRouteQuery, buildRouteUrl, buildStyle, builtInPoiColor, createMap, createRouteEffect, defaultNavDesign, defaultPoiDesign, directionArrow, effectsFromStyleMetadata, extractGuidance, flythrough, flythroughPose, formatCoord, formatCoords, haversineDistanceM, isNameTextField, languageTextField, lngLatToMercator, navDesignFromTheme, navDesignFromThemeUrl, parseCssColour, parseNavDesign, parseOsrmRoute, parsePoiDesign, placesFromGeoJSON, poiDesignFromTheme, poiDesignFromThemeUrl, poiDesignIsDefault, poiTextColorExpression, prefersReducedMotion, registerPmtilesProtocol, resetDiagnostics, resolveTheme, runMapDiagnostics, setMapLanguage, severityProsody, shortestArcDeg, shortestArcDelta, speak, ssmlToText, sunTimes, tessellateRouteRibbon, toLngLat, toPmtilesUrl, uploadProbeBatch };
+export { ALERT_CONTRAST_MIN, AdrCheck, type AdrCheckOptions, type AdrCheckRequest, type AdrCheckResult, type AdrDimensions, type AdrTunnelCategory, type AlertChipContent, type AlertContrastIssue, type AlertPresentation, type BannerComponent, type BannerContent, type BannerInstruction, type BuildStyleOptions, type CameraAlert, CameraAlertChip, type CameraFix, DEFAULT_GLYPHS_URL, DEFAULT_TERRITORY_TILES_URL, type DiagnosticIssue, EFFECTS_METADATA_KEY, FLOW_DEFAULTS, FULL_ATTRIBUTION, FlowRouteEffectLayer, type FlythroughController, type FlythroughOptions, type FlythroughPose, GuidanceBanner, type GuidanceSeverity, type GuidanceSpokenPrompt, type IsochroneFeatureCollection, IsochroneLayer, type IsochroneLayerOptions, LOGO_SVG, type LaneIndication, type LayerOverride, type LngLatLike, LogoControl, type LogoOptions, type LogoPosition, MAX_PUCK_IMAGE_BYTES, type MapDiagnosticsInput, type MapDisplayMode, MapMapMap, type MapMapOptions, type MapMapTheme, NAV_ALERT_AUDIO_MODES, NAV_ALERT_CHIP_POSITIONS, NAV_ALERT_ICON_SETS, NAV_ALERT_LEAD_DISTANCES, NAV_ALERT_LEAD_DISTANCE_M, NAV_ALERT_MODES, NAV_ALERT_SOUNDS, NAV_ALERT_SOUND_BASE_URL, NAV_ALERT_SOUND_FILES, NAV_CAMERA_DEFAULTS, NAV_CAMERA_KINDS, type NavAlertAudioMode, type NavAlertChipPosition, type NavAlertIconSet, type NavAlertKindDesign, type NavAlertLeadDistance, type NavAlertMode, type NavAlertSound, type NavAlertsDesign, type NavBannerDesign, type NavCameraDesign, type NavCameraKind, type NavDesign, type NavPuckDesign, type NavRouteDesign, NavigationCamera, type NavigationCameraMode, type NavigationCameraOptions, type NearestByDriveTimeOptions, OPENMAPTILES_ATTRIBUTION, OSM_ATTRIBUTION, PALETTE_SLOTS, POI_CATEGORY_COLORS, POI_CATEGORY_IDS, POI_CLASS_CATEGORIES, type ParsedRoute, type Place, type PlacePointFeature, type PlaceWithDistance, type PlaceWithDriveTime, type PlacesFeatureCollection, type PlacesIcon, type PlacesInput, PlacesLayer, type PlacesLayerIds, type PlacesLayerOptions, type PlacesSelectOptions, type PoiCategoryDesign, type PoiDesign, PositionPuck, type PositionPuckOptions, type ProbeUploadOutcome, RIBBON_FLOATS_PER_VERTEX, ROUTE_EFFECTS, type ReachabilityMode, type RibbonMesh, type RouteEffectLayer, type RouteEffectName, type RouteFlowOptions, type RouteGeometry, RouteLayer, type RouteLayerOptions, type RouteOptions, type RouteProfile, SIGNAL_BLUE, SOURCE_LAYERS, type SetRouteEffectOptions, type SeverityProsody, type ShowReachabilityOptions, type SpeakOptions, type StepGuidance, type SunTimes, type Theme, type ThemeEffects, ThemeScheduler, type ThemeSchedulerOptions, type TruckParams, type UploadProbeOptions, VoiceGuidance, type VoiceGuidanceOptions, type VoiceGuidanceUpdate, type VoiceInstruction, alertChipContent, alertContrastIssues, alertIconSvg, alertIconUrl, alertPresentation, alertSoundUrl, alertSpeedReadoutColor, applyPoiDesign, bannerLanes, bearingBetween, bindFlythroughToScroll, buildAdrCheckBody, buildProbeUrl, buildRouteQuery, buildRouteUrl, buildStyle, builtInPoiColor, cameraKindLabel, cameraKindsShownOnMap, cameraShownOnMap, cameraSpriteName, cameraSymbolLayer, contrastRatio, createMap, createRouteEffect, defaultNavAlertsDesign, defaultNavDesign, defaultPoiDesign, directionArrow, effectsFromStyleMetadata, extractGuidance, flythrough, flythroughPose, formatCoord, formatCoords, haversineDistanceM, isNameTextField, languageTextField, lngLatToMercator, navAlertLeadDistanceM, navAlertSoundUrl, navCameraKind, navDesignFromTheme, navDesignFromThemeUrl, parseCssColour, parseHexColor, parseNavAlertsDesign, parseNavDesign, parseOsrmRoute, parsePoiDesign, placesFromGeoJSON, poiDesignFromTheme, poiDesignFromThemeUrl, poiDesignIsDefault, poiTextColorExpression, prefersReducedMotion, registerPmtilesProtocol, relativeLuminance, resetDiagnostics, resolveTheme, runMapDiagnostics, setMapLanguage, severityProsody, shortestArcDeg, shortestArcDelta, speak, ssmlToText, sunTimes, tessellateRouteRibbon, toLngLat, toPmtilesUrl, uploadProbeBatch };