@india-boundary-corrector/maplibre-protocol 0.0.1

package/dist/index.js

@@ -0,0 +1,189 @@
+// src/index.js
+import { getPmtilesUrl } from "@india-boundary-corrector/data";
+import { layerConfigs } from "@india-boundary-corrector/layer-configs";
+import { BoundaryCorrector as TileFixer } from "@india-boundary-corrector/tilefixer";
+import { layerConfigs as layerConfigs2, LayerConfig } from "@india-boundary-corrector/layer-configs";
+import { getPmtilesUrl as getPmtilesUrl2 } from "@india-boundary-corrector/data";
+var PROTOCOL_PREFIX = "ibc";
+function parseCorrectionsUrl(url) {
+  const withoutProtocol = url.replace(`${PROTOCOL_PREFIX}://`, "");
+  let configId = null;
+  let tileUrl = withoutProtocol;
+  const atIndex = withoutProtocol.indexOf("@");
+  if (atIndex > 0 && atIndex < withoutProtocol.indexOf("/")) {
+    configId = withoutProtocol.substring(0, atIndex);
+    tileUrl = withoutProtocol.substring(atIndex + 1);
+  }
+  const urlObj = new URL(tileUrl);
+  const pathParts = urlObj.pathname.split("/").filter((p) => p.length > 0);
+  let z, x, y;
+  for (let i = pathParts.length - 1; i >= 2; i--) {
+    const yPart = pathParts[i].replace(/\.[^.]+$/, "");
+    const xPart = pathParts[i - 1];
+    const zPart = pathParts[i - 2];
+    if (/^\d+$/.test(zPart) && /^\d+$/.test(xPart) && /^\d+$/.test(yPart)) {
+      z = parseInt(zPart, 10);
+      x = parseInt(xPart, 10);
+      y = parseInt(yPart, 10);
+      break;
+    }
+  }
+  return { configId, tileUrl, z, x, y };
+}
+async function fetchAndFixTile(tileUrl, z, x, y, tileFixer, layerConfig, tileSize, options = {}) {
+  const { data, correctionsFailed, correctionsError } = await tileFixer.fetchAndFixTile(
+    tileUrl,
+    z,
+    x,
+    y,
+    layerConfig,
+    { tileSize, signal: options.signal }
+  );
+  return { data, correctionsFailed, correctionsError };
+}
+var CorrectionProtocol = class {
+  /**
+   * @param {Object} [options]
+   * @param {string} [options.pmtilesUrl] - URL to PMTiles file (defaults to CDN)
+   * @param {number} [options.tileSize=256] - Tile size in pixels
+   */
+  constructor(options = {}) {
+    this._pmtilesUrl = options.pmtilesUrl ?? getPmtilesUrl();
+    this._tileSize = options.tileSize ?? 256;
+    this._tileFixer = new TileFixer(this._pmtilesUrl);
+    this._registry = layerConfigs.createMergedRegistry();
+    this._listeners = /* @__PURE__ */ new Map();
+    this._loadFn = this._createLoadFunction();
+  }
+  /**
+   * Add a listener for an event.
+   * @param {'correctionerror'} event - Event name
+   * @param {Function} listener - Callback function receiving event data
+   * @returns {this}
+   */
+  on(event, listener) {
+    if (!this._listeners.has(event)) {
+      this._listeners.set(event, /* @__PURE__ */ new Set());
+    }
+    this._listeners.get(event).add(listener);
+    return this;
+  }
+  /**
+   * Remove an event listener.
+   * @param {'correctionerror'} event - Event name
+   * @param {Function} listener - Callback to remove
+   * @returns {this}
+   */
+  off(event, listener) {
+    this._listeners.get(event)?.delete(listener);
+    return this;
+  }
+  /**
+   * Emit an event to all listeners.
+   * @param {string} event - Event name
+   * @param {Object} data - Event data
+   * @private
+   */
+  _emit(event, data) {
+    this._listeners.get(event)?.forEach((fn) => fn(data));
+  }
+  /**
+   * Add a custom layer config to the registry.
+   * @param {Object} layerConfig - LayerConfig to add
+   * @returns {this}
+   */
+  addLayerConfig(layerConfig) {
+    this._registry.register(layerConfig);
+    return this;
+  }
+  /**
+   * Get the registry.
+   * @returns {LayerConfigRegistry}
+   */
+  getRegistry() {
+    return this._registry;
+  }
+  /**
+   * Get the TileFixer instance.
+   * @returns {TileFixer}
+   */
+  getTileFixer() {
+    return this._tileFixer;
+  }
+  /**
+   * Register the protocol with MapLibre GL.
+   * @param {typeof import('maplibre-gl')} maplibregl - MapLibre GL namespace
+   * @returns {this}
+   */
+  register(maplibregl) {
+    maplibregl.addProtocol(PROTOCOL_PREFIX, this._loadFn);
+    return this;
+  }
+  /**
+   * Unregister the protocol from MapLibre GL.
+   * @param {typeof import('maplibre-gl')} maplibregl - MapLibre GL namespace
+   * @returns {this}
+   */
+  unregister(maplibregl) {
+    maplibregl.removeProtocol(PROTOCOL_PREFIX);
+    return this;
+  }
+  /**
+   * Create the protocol load function.
+   * @returns {Function}
+   * @private
+   */
+  _createLoadFunction() {
+    const self = this;
+    return async (params, abortController) => {
+      const { configId, tileUrl, z, x, y } = parseCorrectionsUrl(params.url);
+      if (z === void 0 || x === void 0 || y === void 0) {
+        console.warn(`[CorrectionProtocol] Could not parse tile coordinates from URL: ${params.url}, falling back to original`);
+        const response = await fetch(tileUrl, { signal: abortController?.signal });
+        return { data: await response.arrayBuffer() };
+      }
+      let layerConfig;
+      if (configId) {
+        layerConfig = self._registry.get(configId);
+      } else {
+        layerConfig = self._registry.detectFromTileUrls([tileUrl]);
+      }
+      try {
+        const result = await fetchAndFixTile(
+          tileUrl,
+          z,
+          x,
+          y,
+          self._tileFixer,
+          layerConfig,
+          self._tileSize,
+          { signal: abortController?.signal }
+        );
+        if (result.correctionsFailed) {
+          console.warn("[CorrectionProtocol] Corrections fetch failed:", result.correctionsError);
+          self._emit("correctionerror", { error: result.correctionsError, coords: { z, x, y }, tileUrl });
+        }
+        return { data: result.data };
+      } catch (err) {
+        console.warn("[CorrectionProtocol] Error applying corrections, falling back to original:", err);
+        self._emit("correctionerror", { error: err, coords: { z, x, y }, tileUrl });
+        const response = await fetch(tileUrl, { signal: abortController?.signal });
+        return { data: await response.arrayBuffer() };
+      }
+    };
+  }
+};
+function registerCorrectionProtocol(maplibregl, options = {}) {
+  const protocol = new CorrectionProtocol(options);
+  return protocol.register(maplibregl);
+}
+export {
+  CorrectionProtocol,
+  LayerConfig,
+  fetchAndFixTile,
+  getPmtilesUrl2 as getPmtilesUrl,
+  layerConfigs2 as layerConfigs,
+  parseCorrectionsUrl,
+  registerCorrectionProtocol
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.js"],"sourcesContent":["import { getPmtilesUrl } from '@india-boundary-corrector/data';\nimport { layerConfigs } from '@india-boundary-corrector/layer-configs';\nimport { BoundaryCorrector as TileFixer } from '@india-boundary-corrector/tilefixer';\n\n// Re-export for convenience\nexport { layerConfigs, LayerConfig } from '@india-boundary-corrector/layer-configs';\nexport { getPmtilesUrl } from '@india-boundary-corrector/data';\n\nconst PROTOCOL_PREFIX = 'ibc';\n\n/**\n * Parse an ibc:// URL.\n * Format: ibc://[configId@]originalUrl\n * Examples:\n *   ibc://https://tile.openstreetmap.org/{z}/{x}/{y}.png\n *   ibc://osm-carto@https://tile.openstreetmap.org/{z}/{x}/{y}.png\n * \n * @param {string} url - The full URL with ibc:// prefix\n * @returns {{ configId: string|null, tileUrl: string, z: number, x: number, y: number }}\n */\nfunction parseCorrectionsUrl(url) {\n  // Remove protocol prefix\n  const withoutProtocol = url.replace(`${PROTOCOL_PREFIX}://`, '');\n  \n  // Check for configId@url format\n  let configId = null;\n  let tileUrl = withoutProtocol;\n  \n  const atIndex = withoutProtocol.indexOf('@');\n  if (atIndex > 0 && atIndex < withoutProtocol.indexOf('/')) {\n    // Has configId prefix\n    configId = withoutProtocol.substring(0, atIndex);\n    tileUrl = withoutProtocol.substring(atIndex + 1);\n  }\n  \n  // Extract z, x, y from the URL (assuming standard {z}/{x}/{y} pattern in the path)\n  // The URL has already been templated by MapLibre, so we need to parse actual numbers\n  const urlObj = new URL(tileUrl);\n  const pathParts = urlObj.pathname.split('/').filter(p => p.length > 0);\n  \n  // Find z/x/y pattern - typically last 3 numeric segments\n  let z, x, y;\n  for (let i = pathParts.length - 1; i >= 2; i--) {\n    const yPart = pathParts[i].replace(/\\.[^.]+$/, ''); // Remove extension\n    const xPart = pathParts[i - 1];\n    const zPart = pathParts[i - 2];\n    \n    if (/^\\d+$/.test(zPart) && /^\\d+$/.test(xPart) && /^\\d+$/.test(yPart)) {\n      z = parseInt(zPart, 10);\n      x = parseInt(xPart, 10);\n      y = parseInt(yPart, 10);\n      break;\n    }\n  }\n  \n  return { configId, tileUrl, z, x, y };\n}\n\n/**\n * Fetch and fix a tile for MapLibre protocol.\n * Extracted for testability.\n * @param {string} tileUrl - URL of the raster tile\n * @param {number} z - Zoom level\n * @param {number} x - Tile X coordinate\n * @param {number} y - Tile Y coordinate\n * @param {TileFixer} tileFixer - TileFixer instance\n * @param {Object} layerConfig - Layer configuration (can be null)\n * @param {number} tileSize - Tile size in pixels\n * @param {Object} [options] - Fetch options\n * @param {AbortSignal} [options.signal] - Abort signal\n * @returns {Promise<{data: ArrayBuffer, correctionsFailed: boolean, correctionsError: Error|null}>}\n */\nasync function fetchAndFixTile(tileUrl, z, x, y, tileFixer, layerConfig, tileSize, options = {}) {\n  const { data, correctionsFailed, correctionsError } = await tileFixer.fetchAndFixTile(\n    tileUrl, z, x, y, layerConfig, { tileSize, signal: options.signal }\n  );\n  return { data, correctionsFailed, correctionsError };\n}\n\n/**\n * India boundary corrections protocol for MapLibre GL.\n * \n * Usage:\n *   const protocol = new CorrectionProtocol();\n *   protocol.register(maplibregl);\n * \n *   // In your style:\n *   tiles: ['ibc://https://tile.openstreetmap.org/{z}/{x}/{y}.png']\n *   // Or with explicit config:\n *   tiles: ['ibc://osm-carto@https://tile.openstreetmap.org/{z}/{x}/{y}.png']\n */\nexport class CorrectionProtocol {\n  /**\n   * @param {Object} [options]\n   * @param {string} [options.pmtilesUrl] - URL to PMTiles file (defaults to CDN)\n   * @param {number} [options.tileSize=256] - Tile size in pixels\n   */\n  constructor(options = {}) {\n    this._pmtilesUrl = options.pmtilesUrl ?? getPmtilesUrl();\n    this._tileSize = options.tileSize ?? 256;\n    this._tileFixer = new TileFixer(this._pmtilesUrl);\n    this._registry = layerConfigs.createMergedRegistry();\n    /** @type {Map<string, Set<Function>>} */\n    this._listeners = new Map();\n    \n    this._loadFn = this._createLoadFunction();\n  }\n\n  /**\n   * Add a listener for an event.\n   * @param {'correctionerror'} event - Event name\n   * @param {Function} listener - Callback function receiving event data\n   * @returns {this}\n   */\n  on(event, listener) {\n    if (!this._listeners.has(event)) {\n      this._listeners.set(event, new Set());\n    }\n    this._listeners.get(event).add(listener);\n    return this;\n  }\n\n  /**\n   * Remove an event listener.\n   * @param {'correctionerror'} event - Event name\n   * @param {Function} listener - Callback to remove\n   * @returns {this}\n   */\n  off(event, listener) {\n    this._listeners.get(event)?.delete(listener);\n    return this;\n  }\n\n  /**\n   * Emit an event to all listeners.\n   * @param {string} event - Event name\n   * @param {Object} data - Event data\n   * @private\n   */\n  _emit(event, data) {\n    this._listeners.get(event)?.forEach(fn => fn(data));\n  }\n\n  /**\n   * Add a custom layer config to the registry.\n   * @param {Object} layerConfig - LayerConfig to add\n   * @returns {this}\n   */\n  addLayerConfig(layerConfig) {\n    this._registry.register(layerConfig);\n    return this;\n  }\n\n  /**\n   * Get the registry.\n   * @returns {LayerConfigRegistry}\n   */\n  getRegistry() {\n    return this._registry;\n  }\n\n  /**\n   * Get the TileFixer instance.\n   * @returns {TileFixer}\n   */\n  getTileFixer() {\n    return this._tileFixer;\n  }\n\n  /**\n   * Register the protocol with MapLibre GL.\n   * @param {typeof import('maplibre-gl')} maplibregl - MapLibre GL namespace\n   * @returns {this}\n   */\n  register(maplibregl) {\n    maplibregl.addProtocol(PROTOCOL_PREFIX, this._loadFn);\n    return this;\n  }\n\n  /**\n   * Unregister the protocol from MapLibre GL.\n   * @param {typeof import('maplibre-gl')} maplibregl - MapLibre GL namespace\n   * @returns {this}\n   */\n  unregister(maplibregl) {\n    maplibregl.removeProtocol(PROTOCOL_PREFIX);\n    return this;\n  }\n\n  /**\n   * Create the protocol load function.\n   * @returns {Function}\n   * @private\n   */\n  _createLoadFunction() {\n    const self = this;\n    \n    return async (params, abortController) => {\n      const { configId, tileUrl, z, x, y } = parseCorrectionsUrl(params.url);\n      \n      // Validate parsed coordinates\n      if (z === undefined || x === undefined || y === undefined) {\n        console.warn(`[CorrectionProtocol] Could not parse tile coordinates from URL: ${params.url}, falling back to original`);\n        const response = await fetch(tileUrl, { signal: abortController?.signal });\n        return { data: await response.arrayBuffer() };\n      }\n      \n      // Resolve layer config\n      let layerConfig;\n      if (configId) {\n        layerConfig = self._registry.get(configId);\n      } else {\n        layerConfig = self._registry.detectFromTileUrls([tileUrl]);\n      }\n      \n      try {\n        const result = await fetchAndFixTile(\n          tileUrl,\n          z, \n          x,\n          y,\n          self._tileFixer,\n          layerConfig,\n          self._tileSize,\n          { signal: abortController?.signal }\n        );\n        \n        if (result.correctionsFailed) {\n          console.warn('[CorrectionProtocol] Corrections fetch failed:', result.correctionsError);\n          self._emit('correctionerror', { error: result.correctionsError, coords: { z, x, y }, tileUrl });\n        }\n        \n        return { data: result.data };\n      } catch (err) {\n        console.warn('[CorrectionProtocol] Error applying corrections, falling back to original:', err);\n        self._emit('correctionerror', { error: err, coords: { z, x, y }, tileUrl });\n        const response = await fetch(tileUrl, { signal: abortController?.signal });\n        return { data: await response.arrayBuffer() };\n      }\n    };\n  }\n}\n\n/**\n * Create and register a correction protocol with MapLibre GL.\n * \n * @param {typeof import('maplibre-gl')} maplibregl - MapLibre GL namespace\n * @param {Object} [options] - Protocol options\n * @param {string} [options.pmtilesUrl] - URL to PMTiles file\n * @param {number} [options.tileSize=256] - Tile size in pixels\n * @returns {CorrectionProtocol}\n * \n * @example\n * import maplibregl from 'maplibre-gl';\n * import { registerCorrectionProtocol } from '@india-boundary-corrector/maplibre-protocol';\n * \n * const protocol = registerCorrectionProtocol(maplibregl);\n * \n * // Use in style:\n * const map = new maplibregl.Map({\n *   container: 'map',\n *   style: {\n *     sources: {\n *       osm: {\n *         type: 'raster',\n *         tiles: ['ibc://https://tile.openstreetmap.org/{z}/{x}/{y}.png'],\n *         tileSize: 256\n *       }\n *     },\n *     layers: [{ id: 'osm', type: 'raster', source: 'osm' }]\n *   }\n * });\n */\nexport function registerCorrectionProtocol(maplibregl, options = {}) {\n  const protocol = new CorrectionProtocol(options);\n  return protocol.register(maplibregl);\n}\n\n// Export for testing\nexport { parseCorrectionsUrl, fetchAndFixTile };\n"],"mappings":"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","names":["layerConfigs","getPmtilesUrl"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@india-boundary-corrector/maplibre-protocol",
+  "version": "0.0.1",
+  "description": "MapLibre GL custom protocol for India boundary corrections",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./src/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./src/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup"
+  },
+  "peerDependencies": {
+    "maplibre-gl": ">=3.0.0"
+  },
+  "dependencies": {
+    "@india-boundary-corrector/data": "^0.0.1",
+    "@india-boundary-corrector/layer-configs": "^0.0.1",
+    "@india-boundary-corrector/tilefixer": "^0.0.1"
+  },
+  "keywords": [
+    "india",
+    "boundary",
+    "map",
+    "maplibre",
+    "protocol"
+  ],
+  "author": "ramSeraph",
+  "license": "Unlicense",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ramSeraph/india_boundary_corrector.git",
+    "directory": "packages/maplibre-protocol"
+  },
+  "bugs": {
+    "url": "https://github.com/ramSeraph/india_boundary_corrector/issues"
+  },
+  "homepage": "https://github.com/ramSeraph/india_boundary_corrector#readme"
+}

package/src/index.d.ts

@@ -0,0 +1,64 @@
+import { LayerConfig, LayerConfigRegistry } from '@india-boundary-corrector/layer-configs';
+import { BoundaryCorrector as TileFixer } from '@india-boundary-corrector/tilefixer';
+
+export { layerConfigs, LayerConfig } from '@india-boundary-corrector/layer-configs';
+export { getPmtilesUrl } from '@india-boundary-corrector/data';
+
+/**
+ * Options for CorrectionProtocol
+ */
+export interface CorrectionProtocolOptions {
+  /** URL to PMTiles file (defaults to CDN) */
+  pmtilesUrl?: string;
+  /** Tile size in pixels (default: 256) */
+  tileSize?: number;
+}
+
+/**
+ * India boundary corrections protocol for MapLibre GL.
+ * 
+ * Usage:
+ *   const protocol = new CorrectionProtocol();
+ *   protocol.register(maplibregl);
+ * 
+ *   // In your style:
+ *   tiles: ['ibc://https://tile.openstreetmap.org/{z}/{x}/{y}.png']
+ *   // Or with explicit config:
+ *   tiles: ['ibc://osm-carto@https://tile.openstreetmap.org/{z}/{x}/{y}.png']
+ */
+export declare class CorrectionProtocol {
+  constructor(options?: CorrectionProtocolOptions);
+  
+  /**
+   * Add a custom layer config to the registry.
+   */
+  addLayerConfig(layerConfig: LayerConfig): this;
+  
+  /**
+   * Get the registry.
+   */
+  getRegistry(): LayerConfigRegistry;
+  
+  /**
+   * Get the TileFixer instance.
+   */
+  getTileFixer(): TileFixer;
+  
+  /**
+   * Register the protocol with MapLibre GL.
+   */
+  register(maplibregl: typeof import('maplibre-gl')): this;
+  
+  /**
+   * Unregister the protocol from MapLibre GL.
+   */
+  unregister(maplibregl: typeof import('maplibre-gl')): this;
+}
+
+/**
+ * Create and register a correction protocol with MapLibre GL.
+ */
+export declare function registerCorrectionProtocol(
+  maplibregl: typeof import('maplibre-gl'),
+  options?: CorrectionProtocolOptions
+): CorrectionProtocol;

package/src/index.js

@@ -0,0 +1,280 @@
+import { getPmtilesUrl } from '@india-boundary-corrector/data';
+import { layerConfigs } from '@india-boundary-corrector/layer-configs';
+import { BoundaryCorrector as TileFixer } from '@india-boundary-corrector/tilefixer';
+
+// Re-export for convenience
+export { layerConfigs, LayerConfig } from '@india-boundary-corrector/layer-configs';
+export { getPmtilesUrl } from '@india-boundary-corrector/data';
+
+const PROTOCOL_PREFIX = 'ibc';
+
+/**
+ * Parse an ibc:// URL.
+ * Format: ibc://[configId@]originalUrl
+ * Examples:
+ *   ibc://https://tile.openstreetmap.org/{z}/{x}/{y}.png
+ *   ibc://osm-carto@https://tile.openstreetmap.org/{z}/{x}/{y}.png
+ * 
+ * @param {string} url - The full URL with ibc:// prefix
+ * @returns {{ configId: string|null, tileUrl: string, z: number, x: number, y: number }}
+ */
+function parseCorrectionsUrl(url) {
+  // Remove protocol prefix
+  const withoutProtocol = url.replace(`${PROTOCOL_PREFIX}://`, '');
+  
+  // Check for configId@url format
+  let configId = null;
+  let tileUrl = withoutProtocol;
+  
+  const atIndex = withoutProtocol.indexOf('@');
+  if (atIndex > 0 && atIndex < withoutProtocol.indexOf('/')) {
+    // Has configId prefix
+    configId = withoutProtocol.substring(0, atIndex);
+    tileUrl = withoutProtocol.substring(atIndex + 1);
+  }
+  
+  // Extract z, x, y from the URL (assuming standard {z}/{x}/{y} pattern in the path)
+  // The URL has already been templated by MapLibre, so we need to parse actual numbers
+  const urlObj = new URL(tileUrl);
+  const pathParts = urlObj.pathname.split('/').filter(p => p.length > 0);
+  
+  // Find z/x/y pattern - typically last 3 numeric segments
+  let z, x, y;
+  for (let i = pathParts.length - 1; i >= 2; i--) {
+    const yPart = pathParts[i].replace(/\.[^.]+$/, ''); // Remove extension
+    const xPart = pathParts[i - 1];
+    const zPart = pathParts[i - 2];
+    
+    if (/^\d+$/.test(zPart) && /^\d+$/.test(xPart) && /^\d+$/.test(yPart)) {
+      z = parseInt(zPart, 10);
+      x = parseInt(xPart, 10);
+      y = parseInt(yPart, 10);
+      break;
+    }
+  }
+  
+  return { configId, tileUrl, z, x, y };
+}
+
+/**
+ * Fetch and fix a tile for MapLibre protocol.
+ * Extracted for testability.
+ * @param {string} tileUrl - URL of the raster tile
+ * @param {number} z - Zoom level
+ * @param {number} x - Tile X coordinate
+ * @param {number} y - Tile Y coordinate
+ * @param {TileFixer} tileFixer - TileFixer instance
+ * @param {Object} layerConfig - Layer configuration (can be null)
+ * @param {number} tileSize - Tile size in pixels
+ * @param {Object} [options] - Fetch options
+ * @param {AbortSignal} [options.signal] - Abort signal
+ * @returns {Promise<{data: ArrayBuffer, correctionsFailed: boolean, correctionsError: Error|null}>}
+ */
+async function fetchAndFixTile(tileUrl, z, x, y, tileFixer, layerConfig, tileSize, options = {}) {
+  const { data, correctionsFailed, correctionsError } = await tileFixer.fetchAndFixTile(
+    tileUrl, z, x, y, layerConfig, { tileSize, signal: options.signal }
+  );
+  return { data, correctionsFailed, correctionsError };
+}
+
+/**
+ * India boundary corrections protocol for MapLibre GL.
+ * 
+ * Usage:
+ *   const protocol = new CorrectionProtocol();
+ *   protocol.register(maplibregl);
+ * 
+ *   // In your style:
+ *   tiles: ['ibc://https://tile.openstreetmap.org/{z}/{x}/{y}.png']
+ *   // Or with explicit config:
+ *   tiles: ['ibc://osm-carto@https://tile.openstreetmap.org/{z}/{x}/{y}.png']
+ */
+export class CorrectionProtocol {
+  /**
+   * @param {Object} [options]
+   * @param {string} [options.pmtilesUrl] - URL to PMTiles file (defaults to CDN)
+   * @param {number} [options.tileSize=256] - Tile size in pixels
+   */
+  constructor(options = {}) {
+    this._pmtilesUrl = options.pmtilesUrl ?? getPmtilesUrl();
+    this._tileSize = options.tileSize ?? 256;
+    this._tileFixer = new TileFixer(this._pmtilesUrl);
+    this._registry = layerConfigs.createMergedRegistry();
+    /** @type {Map<string, Set<Function>>} */
+    this._listeners = new Map();
+    
+    this._loadFn = this._createLoadFunction();
+  }
+
+  /**
+   * Add a listener for an event.
+   * @param {'correctionerror'} event - Event name
+   * @param {Function} listener - Callback function receiving event data
+   * @returns {this}
+   */
+  on(event, listener) {
+    if (!this._listeners.has(event)) {
+      this._listeners.set(event, new Set());
+    }
+    this._listeners.get(event).add(listener);
+    return this;
+  }
+
+  /**
+   * Remove an event listener.
+   * @param {'correctionerror'} event - Event name
+   * @param {Function} listener - Callback to remove
+   * @returns {this}
+   */
+  off(event, listener) {
+    this._listeners.get(event)?.delete(listener);
+    return this;
+  }
+
+  /**
+   * Emit an event to all listeners.
+   * @param {string} event - Event name
+   * @param {Object} data - Event data
+   * @private
+   */
+  _emit(event, data) {
+    this._listeners.get(event)?.forEach(fn => fn(data));
+  }
+
+  /**
+   * Add a custom layer config to the registry.
+   * @param {Object} layerConfig - LayerConfig to add
+   * @returns {this}
+   */
+  addLayerConfig(layerConfig) {
+    this._registry.register(layerConfig);
+    return this;
+  }
+
+  /**
+   * Get the registry.
+   * @returns {LayerConfigRegistry}
+   */
+  getRegistry() {
+    return this._registry;
+  }
+
+  /**
+   * Get the TileFixer instance.
+   * @returns {TileFixer}
+   */
+  getTileFixer() {
+    return this._tileFixer;
+  }
+
+  /**
+   * Register the protocol with MapLibre GL.
+   * @param {typeof import('maplibre-gl')} maplibregl - MapLibre GL namespace
+   * @returns {this}
+   */
+  register(maplibregl) {
+    maplibregl.addProtocol(PROTOCOL_PREFIX, this._loadFn);
+    return this;
+  }
+
+  /**
+   * Unregister the protocol from MapLibre GL.
+   * @param {typeof import('maplibre-gl')} maplibregl - MapLibre GL namespace
+   * @returns {this}
+   */
+  unregister(maplibregl) {
+    maplibregl.removeProtocol(PROTOCOL_PREFIX);
+    return this;
+  }
+
+  /**
+   * Create the protocol load function.
+   * @returns {Function}
+   * @private
+   */
+  _createLoadFunction() {
+    const self = this;
+    
+    return async (params, abortController) => {
+      const { configId, tileUrl, z, x, y } = parseCorrectionsUrl(params.url);
+      
+      // Validate parsed coordinates
+      if (z === undefined || x === undefined || y === undefined) {
+        console.warn(`[CorrectionProtocol] Could not parse tile coordinates from URL: ${params.url}, falling back to original`);
+        const response = await fetch(tileUrl, { signal: abortController?.signal });
+        return { data: await response.arrayBuffer() };
+      }
+      
+      // Resolve layer config
+      let layerConfig;
+      if (configId) {
+        layerConfig = self._registry.get(configId);
+      } else {
+        layerConfig = self._registry.detectFromTileUrls([tileUrl]);
+      }
+      
+      try {
+        const result = await fetchAndFixTile(
+          tileUrl,
+          z, 
+          x,
+          y,
+          self._tileFixer,
+          layerConfig,
+          self._tileSize,
+          { signal: abortController?.signal }
+        );
+        
+        if (result.correctionsFailed) {
+          console.warn('[CorrectionProtocol] Corrections fetch failed:', result.correctionsError);
+          self._emit('correctionerror', { error: result.correctionsError, coords: { z, x, y }, tileUrl });
+        }
+        
+        return { data: result.data };
+      } catch (err) {
+        console.warn('[CorrectionProtocol] Error applying corrections, falling back to original:', err);
+        self._emit('correctionerror', { error: err, coords: { z, x, y }, tileUrl });
+        const response = await fetch(tileUrl, { signal: abortController?.signal });
+        return { data: await response.arrayBuffer() };
+      }
+    };
+  }
+}
+
+/**
+ * Create and register a correction protocol with MapLibre GL.
+ * 
+ * @param {typeof import('maplibre-gl')} maplibregl - MapLibre GL namespace
+ * @param {Object} [options] - Protocol options
+ * @param {string} [options.pmtilesUrl] - URL to PMTiles file
+ * @param {number} [options.tileSize=256] - Tile size in pixels
+ * @returns {CorrectionProtocol}
+ * 
+ * @example
+ * import maplibregl from 'maplibre-gl';
+ * import { registerCorrectionProtocol } from '@india-boundary-corrector/maplibre-protocol';
+ * 
+ * const protocol = registerCorrectionProtocol(maplibregl);
+ * 
+ * // Use in style:
+ * const map = new maplibregl.Map({
+ *   container: 'map',
+ *   style: {
+ *     sources: {
+ *       osm: {
+ *         type: 'raster',
+ *         tiles: ['ibc://https://tile.openstreetmap.org/{z}/{x}/{y}.png'],
+ *         tileSize: 256
+ *       }
+ *     },
+ *     layers: [{ id: 'osm', type: 'raster', source: 'osm' }]
+ *   }
+ * });
+ */
+export function registerCorrectionProtocol(maplibregl, options = {}) {
+  const protocol = new CorrectionProtocol(options);
+  return protocol.register(maplibregl);
+}
+
+// Export for testing
+export { parseCorrectionsUrl, fetchAndFixTile };