@atlas-composer/projection-loader 1.1.0-rc.13 → 1.1.0-rc.14

package/dist/index.js

@@ -1,4 +1,177 @@
-import { buildCompositeProjection, calculateClipExtentFromPixelOffset } from '@atlas-composer/projection-core';
+// ../projection-core/dist/index.js
+function isPointInBounds(lon, lat, bounds, tolerance = 0) {
+  return lon >= bounds.minLon - tolerance && lon <= bounds.maxLon + tolerance && lat >= bounds.minLat - tolerance && lat <= bounds.maxLat + tolerance;
+}
+function boundsFromArray(bounds) {
+  return {
+    minLon: bounds[0][0],
+    minLat: bounds[0][1],
+    maxLon: bounds[1][0],
+    maxLat: bounds[1][1]
+  };
+}
+function calculateClipExtentFromPixelOffset(center, pixelClipExtent, epsilon = 1e-6) {
+  const [x1, y1, x2, y2] = pixelClipExtent;
+  return [
+    [center[0] + x1 + epsilon, center[1] + y1 + epsilon],
+    [center[0] + x2 - epsilon, center[1] + y2 - epsilon]
+  ];
+}
+function normalizeBounds(bounds) {
+  if ("minLon" in bounds) {
+    return bounds;
+  }
+  return boundsFromArray(bounds);
+}
+function invertWithBoundsValidation(screenCoords, entries, options = {}) {
+  const { tolerance = 0.01, debug = false } = options;
+  const [x, y] = screenCoords;
+  for (const entry of entries) {
+    const { projection, bounds, id } = entry;
+    if (!projection.invert) {
+      continue;
+    }
+    try {
+      const result = projection.invert([x, y]);
+      if (!result || !Array.isArray(result) || result.length < 2) {
+        continue;
+      }
+      const [lon, lat] = result;
+      if (bounds) {
+        const geoBounds = normalizeBounds(bounds);
+        if (isPointInBounds(lon, lat, geoBounds, tolerance)) {
+          if (debug) {
+            console.log(`[Invert] Matched ${id}: [${x}, ${y}] -> [${lon}, ${lat}]`);
+          }
+          return { coordinates: result, territoryId: id };
+        } else if (debug) {
+          console.log(`[Invert] Rejected ${id}: [${lon}, ${lat}] outside bounds`);
+        }
+      } else {
+        if (debug) {
+          console.log(`[Invert] No bounds for ${id}, accepting [${lon}, ${lat}]`);
+        }
+        return { coordinates: result, territoryId: id };
+      }
+    } catch (error) {
+      if (debug) {
+        console.warn(`[Invert] Error in ${id}:`, error);
+      }
+    }
+  }
+  if (debug) {
+    console.log(`[Invert] Failed to invert [${x}, ${y}]`);
+  }
+  return null;
+}
+function createStreamMultiplexer(projections) {
+  return (stream) => {
+    const streams = projections.map((p) => p.stream(stream));
+    return {
+      point: (x, y) => {
+        for (const s of streams) s.point(x, y);
+      },
+      lineStart: () => {
+        for (const s of streams) s.lineStart();
+      },
+      lineEnd: () => {
+        for (const s of streams) s.lineEnd();
+      },
+      polygonStart: () => {
+        for (const s of streams) s.polygonStart();
+      },
+      polygonEnd: () => {
+        for (const s of streams) s.polygonEnd();
+      },
+      sphere: () => {
+        for (const s of streams) {
+          if (s.sphere)
+            s.sphere();
+        }
+      }
+    };
+  };
+}
+function createPointCaptureStream() {
+  let capturedPoint = null;
+  const pointStream = {
+    point: (x, y) => {
+      capturedPoint = [x, y];
+    },
+    lineStart: () => {
+    },
+    lineEnd: () => {
+    },
+    polygonStart: () => {
+    },
+    polygonEnd: () => {
+    },
+    sphere: () => {
+    }
+  };
+  return {
+    pointStream,
+    getCapturedPoint: () => capturedPoint,
+    resetCapture: () => {
+      capturedPoint = null;
+    }
+  };
+}
+function normalizeBounds2(bounds) {
+  if ("minLon" in bounds) {
+    return bounds;
+  }
+  return boundsFromArray(bounds);
+}
+function buildCompositeProjection(config) {
+  const { entries, debug = false } = config;
+  if (entries.length === 0) {
+    throw new Error("Cannot build composite projection with no entries");
+  }
+  const { pointStream, getCapturedPoint, resetCapture } = createPointCaptureStream();
+  const entryStreams = entries.map((entry) => ({
+    entry,
+    stream: entry.projection.stream(pointStream)
+  }));
+  const project = (coordinates) => {
+    const [lon, lat] = coordinates;
+    resetCapture();
+    for (const { entry, stream } of entryStreams) {
+      if (entry.bounds) {
+        const bounds = normalizeBounds2(entry.bounds);
+        if (isPointInBounds(lon, lat, bounds)) {
+          stream.point(lon, lat);
+          const captured = getCapturedPoint();
+          if (captured) {
+            return captured;
+          }
+        }
+      }
+    }
+    return null;
+  };
+  const composite = project;
+  composite.stream = createStreamMultiplexer(entries.map((e) => e.projection));
+  composite.invert = (coords) => {
+    const result = invertWithBoundsValidation(coords, entries, { debug });
+    return (result == null ? void 0 : result.coordinates) ?? null;
+  };
+  composite.scale = function(_s) {
+    var _a;
+    if (arguments.length === 0) {
+      return ((_a = entries[0]) == null ? void 0 : _a.projection.scale()) ?? 1;
+    }
+    return composite;
+  };
+  composite.translate = function(_t) {
+    var _a;
+    if (arguments.length === 0) {
+      return ((_a = entries[0]) == null ? void 0 : _a.projection.translate()) ?? [0, 0];
+    }
+    return composite;
+  };
+  return composite;
+}
 
 // src/standalone-projection-loader.ts
 var projectionRegistry = /* @__PURE__ */ new Map();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/standalone-projection-loader.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Standalone Composite Projection Loader (Zero Dependencies)\n *\n * A pure JavaScript/TypeScript module that consumes exported composite projection\n * configurations and creates D3-compatible projections using a plugin architecture.\n *\n * This package uses @atlas-composer/projection-core for the shared composite\n * projection building logic. Users must register projection factories before\n * loading configurations.\n *\n * @example\n * ```typescript\n * // Register projections first\n * import * as d3 from 'd3-geo'\n * import { registerProjection, loadCompositeProjection } from './standalone-projection-loader'\n *\n * registerProjection('mercator', () => d3.geoMercator())\n * registerProjection('albers', () => d3.geoAlbers())\n *\n * // Then load your configuration\n * const projection = loadCompositeProjection(config, { width: 800, height: 600 })\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { ProjectionLike as CoreProjectionLike, SubProjectionEntry } from '@atlas-composer/projection-core'\n\nimport {\n  buildCompositeProjection,\n  calculateClipExtentFromPixelOffset,\n} from '@atlas-composer/projection-core'\n\n/**\n * Generic projection-like interface that matches D3 projections\n * without requiring d3-geo as a dependency\n *\n * Note: D3 projections use getter/setter pattern where calling without\n * arguments returns the current value, and with arguments sets and returns this.\n */\nexport interface ProjectionLike {\n  (coordinates: [number, number]): [number, number] | null\n  center?: {\n    (): [number, number]\n    (center: [number, number]): ProjectionLike\n  }\n  rotate?: {\n    (): [number, number, number]\n    (angles: [number, number, number]): ProjectionLike\n  }\n  parallels?: {\n    (): [number, number]\n    (parallels: [number, number]): ProjectionLike\n  }\n  scale?: {\n    (): number\n    (scale: number): ProjectionLike\n  }\n  translate?: {\n    (): [number, number]\n    (translate: [number, number]): ProjectionLike\n  }\n  clipExtent?: {\n    (): [[number, number], [number, number]] | null\n    (extent: [[number, number], [number, number]] | null): ProjectionLike\n  }\n  clipAngle?: {\n    (): number\n    (angle: number): ProjectionLike\n  }\n  stream?: (stream: StreamLike) => StreamLike\n  precision?: {\n    (): number\n    (precision: number): ProjectionLike\n  }\n  fitExtent?: (extent: [[number, number], [number, number]], object: any) => ProjectionLike\n  fitSize?: (size: [number, number], object: any) => ProjectionLike\n  fitWidth?: (width: number, object: any) => ProjectionLike\n  fitHeight?: (height: number, object: any) => ProjectionLike\n}\n\n/**\n * Stream protocol interface for D3 geographic transforms\n */\nexport interface StreamLike {\n  point: (x: number, y: number) => void\n  lineStart: () => void\n  lineEnd: () => void\n  polygonStart: () => void\n  polygonEnd: () => void\n  sphere?: () => void\n}\n\n/**\n * Factory function that creates a projection instance\n */\nexport type ProjectionFactory = () => ProjectionLike\n\n/**\n * Exported configuration format (subset needed for loading)\n */\nexport interface ExportedConfig {\n  version: string\n  metadata: {\n    atlasId: string\n    atlasName: string\n    exportDate?: string\n    createdWith?: string\n    notes?: string\n  }\n  pattern: string\n  referenceScale?: number\n  canvasDimensions?: {\n    width: number\n    height: number\n  }\n  territories: Territory[]\n}\n\nexport interface Territory {\n  code: string\n  name: string\n  role: string\n  projection: {\n    id: string\n    family: string\n    parameters: ProjectionParameters\n  }\n  layout: Layout\n  bounds: [[number, number], [number, number]]\n}\n\nexport interface ProjectionParameters {\n  center?: [number, number]\n  rotate?: [number, number, number]\n  scaleMultiplier?: number\n  parallels?: [number, number]\n  clipAngle?: number\n  precision?: number\n}\n\nexport interface Layout {\n  translateOffset?: [number, number]\n  /** Pixel-based clip extent relative to territory center [x1, y1, x2, y2] */\n  pixelClipExtent?: [number, number, number, number] | null\n}\n\n/**\n * Options for creating the composite projection\n */\nexport interface LoaderOptions {\n  /** Canvas width in pixels */\n  width: number\n  /** Canvas height in pixels */\n  height: number\n  /** Whether to apply clipping to territories (default: true) */\n  enableClipping?: boolean\n  /** Debug mode - logs territory selection (default: false) */\n  debug?: boolean\n}\n\n/**\n * Runtime registry for projection factories\n * Users must register projections before loading configurations\n */\nconst projectionRegistry = new Map<string, ProjectionFactory>()\n\n/**\n * Register a projection factory with a given ID\n *\n * @example\n * ```typescript\n * import * as d3 from 'd3-geo'\n * import { registerProjection } from '@atlas-composer/projection-loader'\n *\n * registerProjection('mercator', () => d3.geoMercator())\n * registerProjection('albers', () => d3.geoAlbers())\n * ```\n *\n * @param id - Projection identifier (e.g., 'mercator', 'albers')\n * @param factory - Function that creates a new projection instance\n */\nexport function registerProjection(id: string, factory: ProjectionFactory): void {\n  projectionRegistry.set(id, factory)\n}\n\n/**\n * Register multiple projections at once\n *\n * @example\n * ```typescript\n * import * as d3 from 'd3-geo'\n * import { registerProjections } from '@atlas-composer/projection-loader'\n *\n * registerProjections({\n *   'mercator': () => d3.geoMercator(),\n *   'albers': () => d3.geoAlbers(),\n *   'conic-equal-area': () => d3.geoConicEqualArea()\n * })\n * ```\n *\n * @param factories - Object mapping projection IDs to factory functions\n */\nexport function registerProjections(factories: Record<string, ProjectionFactory>): void {\n  for (const [id, factory] of Object.entries(factories)) {\n    registerProjection(id, factory)\n  }\n}\n\n/**\n * Unregister a projection\n *\n * @param id - Projection identifier to remove\n * @returns True if the projection was removed, false if it wasn't registered\n */\nexport function unregisterProjection(id: string): boolean {\n  return projectionRegistry.delete(id)\n}\n\n/**\n * Clear all registered projections\n */\nexport function clearProjections(): void {\n  projectionRegistry.clear()\n}\n\n/**\n * Get list of currently registered projection IDs\n *\n * @returns Array of registered projection identifiers\n */\nexport function getRegisteredProjections(): string[] {\n  return Array.from(projectionRegistry.keys())\n}\n\n/**\n * Check if a projection is registered\n *\n * @param id - Projection identifier to check\n * @returns True if the projection is registered\n */\nexport function isProjectionRegistered(id: string): boolean {\n  return projectionRegistry.has(id)\n}\n\n/**\n * Create a minimal projection wrapper (similar to d3.geoProjection)\n * This allows us to avoid the d3-geo dependency\n */\n\n/**\n * Create a D3-compatible projection from an exported composite projection configuration\n *\n * @example\n * ```typescript\n * import * as d3 from 'd3-geo'\n * import { registerProjection, loadCompositeProjection } from '@atlas-composer/projection-loader'\n *\n * // Register projections first\n * registerProjection('mercator', () => d3.geoMercator())\n * registerProjection('albers', () => d3.geoAlbers())\n *\n * // Load configuration\n * const config = JSON.parse(jsonString)\n *\n * // Create projection\n * const projection = loadCompositeProjection(config, {\n *   width: 800,\n *   height: 600\n * })\n *\n * // Use with D3\n * const path = d3.geoPath(projection)\n * svg.selectAll('path')\n *   .data(countries.features)\n *   .join('path')\n *   .attr('d', path)\n * ```\n *\n * @param config - Exported composite projection configuration\n * @param options - Canvas dimensions and options\n * @returns D3-compatible projection that routes geometry to appropriate sub-projections\n */\nexport function loadCompositeProjection(\n  config: ExportedConfig,\n  options: LoaderOptions,\n): ProjectionLike {\n  const { width, height, debug = false } = options\n\n  // Validate configuration version\n  if (config.version !== '1.0') {\n    throw new Error(`Unsupported configuration version: ${config.version}`)\n  }\n\n  if (!config.territories || config.territories.length === 0) {\n    throw new Error('Configuration must contain at least one territory')\n  }\n\n  // Create sub-projections for each territory and convert to SubProjectionEntry format\n  const entries: SubProjectionEntry[] = config.territories.map((territory) => {\n    const proj = createSubProjection(territory, width, height, config.referenceScale, debug)\n\n    return {\n      id: territory.code,\n      name: territory.name,\n      projection: proj as CoreProjectionLike,\n      bounds: {\n        minLon: territory.bounds[0][0],\n        minLat: territory.bounds[0][1],\n        maxLon: territory.bounds[1][0],\n        maxLat: territory.bounds[1][1],\n      },\n    }\n  })\n\n  if (debug) {\n    console.log('[CompositeProjection] Created sub-projections:', {\n      territories: config.territories.map(t => ({ code: t.code, name: t.name })),\n      count: entries.length,\n    })\n  }\n\n  // Use projection-core to build the composite projection\n  const composite = buildCompositeProjection({ entries, debug })\n\n  return composite as ProjectionLike\n}\n\n/**\n * Create a sub-projection for a single territory\n */\nfunction createSubProjection(\n  territory: Territory,\n  width: number,\n  height: number,\n  referenceScale?: number,\n  debug?: boolean,\n): ProjectionLike {\n  // Extract projection info and parameters from nested projection object\n  const { layout } = territory\n  const projectionId = territory.projection.id\n  const parameters = territory.projection.parameters\n\n  if (!projectionId || !parameters) {\n    throw new Error(`Territory ${territory.code} missing projection configuration`)\n  }\n\n  // Get projection factory from registry\n  const factory = projectionRegistry.get(projectionId)\n  if (!factory) {\n    const registered = getRegisteredProjections()\n    const availableList = registered.length > 0 ? registered.join(', ') : 'none'\n    throw new Error(\n      `Projection \"${projectionId}\" is not registered. `\n      + `Available projections: ${availableList}. `\n      + `Use registerProjection('${projectionId}', factory) to register it.`,\n    )\n  }\n\n  // Create projection instance\n  const projection = factory()\n\n  // Apply parameters\n  if (parameters.center && projection.center) {\n    projection.center(parameters.center)\n  }\n\n  if (parameters.rotate && projection.rotate) {\n    // Ensure rotate has exactly 3 elements\n    const rotate = Array.isArray(parameters.rotate)\n      ? [...parameters.rotate, 0, 0].slice(0, 3) as [number, number, number]\n      : [0, 0, 0] as [number, number, number]\n    projection.rotate(rotate)\n  }\n\n  if (parameters.parallels && projection.parallels) {\n    // Ensure parallels has exactly 2 elements\n    const parallels = Array.isArray(parameters.parallels)\n      ? [...parameters.parallels, 0].slice(0, 2) as [number, number]\n      : [0, 60] as [number, number]\n    projection.parallels(parallels)\n  }\n\n  // Handle scale using scaleMultiplier and referenceScale\n  if (projection.scale && parameters.scaleMultiplier) {\n    const effectiveReferenceScale = referenceScale || 2700 // Default reference scale\n    const calculatedScale = effectiveReferenceScale * parameters.scaleMultiplier\n    projection.scale(calculatedScale)\n  }\n\n  // Apply additional parameters\n  if (parameters.clipAngle && projection.clipAngle) {\n    projection.clipAngle(parameters.clipAngle)\n  }\n\n  if (parameters.precision && projection.precision) {\n    projection.precision(parameters.precision)\n  }\n\n  // Apply layout translate\n  if (projection.translate) {\n    const [offsetX, offsetY] = layout.translateOffset || [0, 0] // Default to center if missing\n    projection.translate([\n      width / 2 + offsetX,\n      height / 2 + offsetY,\n    ])\n  }\n\n  // Apply clipping - this is CRITICAL for composite projections\n  // Each sub-projection MUST have clipping to avoid geometry processing conflicts\n  if (layout.pixelClipExtent && projection.clipExtent) {\n    // Get territory center from translate\n    const territoryCenter = projection.translate?.() || [width / 2, height / 2]\n\n    // Use core utility for clip extent calculation\n    const clipExtent = calculateClipExtentFromPixelOffset(\n      territoryCenter,\n      layout.pixelClipExtent,\n    )\n\n    projection.clipExtent(clipExtent)\n    if (debug) {\n      console.log(\n        `[Clipping] Applied pixelClipExtent for ${territory.code}:`,\n        `original: ${JSON.stringify(layout.pixelClipExtent)} -> transformed: ${JSON.stringify(clipExtent)}`,\n      )\n    }\n  }\n  else if (projection.clipExtent) {\n    // If no clip extent is specified, create a default one based on territory bounds\n    const bounds = territory.bounds\n    if (bounds && bounds.length === 2 && bounds[0].length === 2 && bounds[1].length === 2) {\n      // Convert geographic bounds to pixel bounds (approximate)\n      const scale = projection.scale?.() || 1\n      const translate = projection.translate?.() || [0, 0]\n\n      // Create a reasonable clip extent based on the geographic bounds\n      const padding = scale * 0.1 // 10% padding\n      const clipExtent: [[number, number], [number, number]] = [\n        [translate[0] - padding, translate[1] - padding],\n        [translate[0] + padding, translate[1] + padding],\n      ]\n\n      projection.clipExtent(clipExtent)\n\n      if (debug) {\n        console.log(`[Clipping] Applied default clip extent for ${territory.code}:`, clipExtent)\n      }\n    }\n  }\n\n  return projection\n}\n\n/**\n * Validate an exported configuration\n *\n * @param config - Configuration to validate\n * @returns True if valid, throws error otherwise\n */\nexport function validateConfig(config: any): config is ExportedConfig {\n  if (!config || typeof config !== 'object') {\n    throw new Error('Configuration must be an object')\n  }\n\n  if (!config.version) {\n    throw new Error('Configuration must have a version field')\n  }\n\n  if (!config.metadata || !config.metadata.atlasId) {\n    throw new Error('Configuration must have metadata with atlasId')\n  }\n\n  if (!config.territories || !Array.isArray(config.territories)) {\n    throw new Error('Configuration must have territories array')\n  }\n\n  if (config.territories.length === 0) {\n    throw new Error('Configuration must have at least one territory')\n  }\n\n  // Validate each territory\n  for (const territory of config.territories) {\n    if (!territory.code) {\n      throw new Error(`Territory missing required field 'code': ${JSON.stringify(territory)}`)\n    }\n\n    // Check for required nested projection format\n    if (!territory.projection || !territory.projection.id || !territory.projection.parameters) {\n      throw new Error(`Territory ${territory.code} missing projection configuration. Required: projection.id and projection.parameters`)\n    }\n\n    if (!territory.bounds) {\n      throw new Error(`Territory ${territory.code} missing bounds`)\n    }\n  }\n\n  return true\n}\n\n/**\n * Load composite projection from JSON string\n *\n * @example\n * ```typescript\n * import * as d3 from 'd3-geo'\n * import { registerProjection, loadFromJSON } from '@atlas-composer/projection-loader'\n *\n * // Register projections first\n * registerProjection('mercator', () => d3.geoMercator())\n *\n * // Load from JSON\n * const jsonString = fs.readFileSync('france-composite.json', 'utf-8')\n * const projection = loadFromJSON(jsonString, { width: 800, height: 600 })\n * ```\n */\nexport function loadFromJSON(\n  jsonString: string,\n  options: LoaderOptions,\n): ProjectionLike {\n  let config: any\n\n  try {\n    config = JSON.parse(jsonString)\n  }\n  catch (error) {\n    throw new Error(`Invalid JSON: ${error instanceof Error ? error.message : 'Unknown error'}`)\n  }\n\n  validateConfig(config)\n  return loadCompositeProjection(config, options)\n}\n\n// Default export\nexport default {\n  // Core loading functions\n  loadCompositeProjection,\n  loadFromJSON,\n  validateConfig,\n\n  // Registry management\n  registerProjection,\n  registerProjections,\n  unregisterProjection,\n  clearProjections,\n  getRegisteredProjections,\n  isProjectionRegistered,\n}\n"]}
+{"version":3,"sources":["../../projection-core/src/bounds/checker.ts","../../projection-core/src/bounds/clip-extent.ts","../../projection-core/src/invert/validator.ts","../../projection-core/src/stream/multiplexer.ts","../../projection-core/src/stream/point-capture.ts","../../projection-core/src/composite/builder.ts","../src/standalone-projection-loader.ts"],"names":["normalizeBounds"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Bounds Checker\n *\n * Pure functions for checking if geographic points fall within bounds.\n * Used by composite projections to route points to the correct sub-projection.\n */\n\nimport type { GeoBounds, GeoBoundsArray } from '../types'\n\n/**\n * Check if a geographic point is within the given bounds\n *\n * @param lon - Longitude of the point\n * @param lat - Latitude of the point\n * @param bounds - Geographic bounds to check against\n * @param tolerance - Optional tolerance for edge cases (default: 0)\n * @returns True if the point is within bounds\n *\n * @example\n * ```typescript\n * const bounds = { minLon: -10, minLat: 35, maxLon: 5, maxLat: 45 }\n *\n * isPointInBounds(-5, 40, bounds) // true (inside Portugal/Spain)\n * isPointInBounds(10, 50, bounds) // false (outside bounds)\n * isPointInBounds(-10, 35, bounds, 0.01) // true (on edge, with tolerance)\n * ```\n */\nexport function isPointInBounds(\n  lon: number,\n  lat: number,\n  bounds: GeoBounds,\n  tolerance = 0,\n): boolean {\n  return (\n    lon >= bounds.minLon - tolerance\n    && lon <= bounds.maxLon + tolerance\n    && lat >= bounds.minLat - tolerance\n    && lat <= bounds.maxLat + tolerance\n  )\n}\n\n/**\n * Convert a bounds array to a GeoBounds object\n *\n * @param bounds - Bounds array [[minLon, minLat], [maxLon, maxLat]]\n * @returns GeoBounds object\n *\n * @example\n * ```typescript\n * const arrayBounds: GeoBoundsArray = [[-10, 35], [5, 45]]\n * const objectBounds = boundsFromArray(arrayBounds)\n * // { minLon: -10, minLat: 35, maxLon: 5, maxLat: 45 }\n * ```\n */\nexport function boundsFromArray(bounds: GeoBoundsArray): GeoBounds {\n  return {\n    minLon: bounds[0][0],\n    minLat: bounds[0][1],\n    maxLon: bounds[1][0],\n    maxLat: bounds[1][1],\n  }\n}\n\n/**\n * Convert a GeoBounds object to a bounds array\n *\n * @param bounds - GeoBounds object\n * @returns Bounds array [[minLon, minLat], [maxLon, maxLat]]\n *\n * @example\n * ```typescript\n * const objectBounds = { minLon: -10, minLat: 35, maxLon: 5, maxLat: 45 }\n * const arrayBounds = boundsToArray(objectBounds)\n * // [[-10, 35], [5, 45]]\n * ```\n */\nexport function boundsToArray(bounds: GeoBounds): GeoBoundsArray {\n  return [\n    [bounds.minLon, bounds.minLat],\n    [bounds.maxLon, bounds.maxLat],\n  ]\n}\n","/**\n * Clip Extent Calculator\n *\n * Pure functions for calculating clip extents from geographic bounds\n * or pixel offsets. Used by composite projections to properly clip\n * each territory's rendering area.\n */\n\nimport type { ClipExtentOptions, GeoBounds, ProjectionLike } from '../types'\n\n/**\n * Calculate clip extent from geographic bounds\n *\n * Projects the corner points of geographic bounds to get the corresponding\n * screen coordinates for clipping. This is critical for composite projections\n * to ensure each territory only renders within its designated area.\n *\n * @param projection - The projection to use for transforming bounds\n * @param bounds - Geographic bounds { minLon, minLat, maxLon, maxLat }\n * @param options - Optional configuration (epsilon for padding)\n * @returns Clip extent [[x0, y0], [x1, y1]] or null if projection fails\n *\n * @example\n * ```typescript\n * const bounds = { minLon: -10, minLat: 35, maxLon: 5, maxLat: 45 }\n * const clipExtent = calculateClipExtentFromBounds(projection, bounds)\n *\n * if (clipExtent) {\n *   projection.clipExtent(clipExtent)\n * }\n * ```\n */\nexport function calculateClipExtentFromBounds(\n  projection: ProjectionLike,\n  bounds: GeoBounds,\n  options: ClipExtentOptions = {},\n): [[number, number], [number, number]] | null {\n  const { epsilon = 1e-6 } = options\n\n  // Project the corner points\n  // Note: Geographic coordinates are [lon, lat] where:\n  // - minLon is west, maxLon is east\n  // - minLat is south, maxLat is north\n  // In screen coordinates:\n  // - topLeft corresponds to [minLon, maxLat] (northwest corner)\n  // - bottomRight corresponds to [maxLon, minLat] (southeast corner)\n  const topLeft = projection([\n    bounds.minLon + epsilon,\n    bounds.maxLat - epsilon,\n  ])\n  const bottomRight = projection([\n    bounds.maxLon - epsilon,\n    bounds.minLat + epsilon,\n  ])\n\n  if (!topLeft || !bottomRight) {\n    return null\n  }\n\n  return [\n    [topLeft[0], topLeft[1]],\n    [bottomRight[0], bottomRight[1]],\n  ]\n}\n\n/**\n * Calculate clip extent from pixel offsets\n *\n * Converts a pixel-based clip extent (relative to territory center)\n * to absolute screen coordinates. Used when clip extent is stored\n * as offsets in exported configurations.\n *\n * @param center - The territory center in screen coordinates [x, y]\n * @param pixelClipExtent - Pixel offsets [x1, y1, x2, y2] relative to center\n * @param epsilon - Small value for padding (default: 1e-6)\n * @returns Clip extent [[x0, y0], [x1, y1]] in absolute screen coordinates\n *\n * @example\n * ```typescript\n * const center = [400, 300] // Territory center in pixels\n * const offsets = [-100, -80, 100, 80] // Relative clip bounds\n *\n * const clipExtent = calculateClipExtentFromPixelOffset(center, offsets)\n * // [[300, 220], [500, 380]]\n *\n * projection.clipExtent(clipExtent)\n * ```\n */\nexport function calculateClipExtentFromPixelOffset(\n  center: [number, number],\n  pixelClipExtent: [number, number, number, number],\n  epsilon = 1e-6,\n): [[number, number], [number, number]] {\n  const [x1, y1, x2, y2] = pixelClipExtent\n\n  return [\n    [center[0] + x1 + epsilon, center[1] + y1 + epsilon],\n    [center[0] + x2 - epsilon, center[1] + y2 - epsilon],\n  ]\n}\n","/**\n * Invert Validator\n *\n * Validates inverted coordinates against territory bounds to ensure\n * correct territory matching. This is critical for composite projections\n * where multiple territories may overlap in screen space.\n */\n\nimport type { GeoBounds, GeoBoundsArray, InvertOptions, InvertResult, SubProjectionEntry } from '../types'\n\nimport { boundsFromArray, isPointInBounds } from '../bounds/checker'\n\n/**\n * Normalize bounds to GeoBounds format\n */\nfunction normalizeBounds(bounds: GeoBounds | GeoBoundsArray): GeoBounds {\n  if ('minLon' in bounds) {\n    return bounds\n  }\n  return boundsFromArray(bounds)\n}\n\n/**\n * Invert screen coordinates with bounds validation\n *\n * Tries each sub-projection's invert method and validates the result\n * against the territory's geographic bounds. This ensures that when\n * multiple territories overlap in screen space (common in composite\n * projections), the correct territory is identified.\n *\n * @param screenCoords - Screen coordinates [x, y] to invert\n * @param entries - Array of sub-projection entries with bounds\n * @param options - Optional configuration (tolerance, debug)\n * @returns InvertResult with coordinates and territoryId, or null if no match\n *\n * @example\n * ```typescript\n * const entries = [\n *   { id: 'mainland', projection: mainlandProj, bounds: mainlandBounds },\n *   { id: 'alaska', projection: alaskaProj, bounds: alaskaBounds },\n * ]\n *\n * const result = invertWithBoundsValidation([400, 300], entries)\n *\n * if (result) {\n *   console.log(`Clicked on ${result.territoryId} at [${result.coordinates}]`)\n * }\n * ```\n */\nexport function invertWithBoundsValidation(\n  screenCoords: [number, number],\n  entries: SubProjectionEntry[],\n  options: InvertOptions = {},\n): InvertResult | null {\n  const { tolerance = 0.01, debug = false } = options\n  const [x, y] = screenCoords\n\n  for (const entry of entries) {\n    const { projection, bounds, id } = entry\n\n    if (!projection.invert) {\n      continue\n    }\n\n    try {\n      const result = projection.invert([x, y])\n\n      if (!result || !Array.isArray(result) || result.length < 2) {\n        continue\n      }\n\n      const [lon, lat] = result\n\n      if (bounds) {\n        const geoBounds = normalizeBounds(bounds)\n\n        if (isPointInBounds(lon, lat, geoBounds, tolerance)) {\n          if (debug) {\n            console.log(`[Invert] Matched ${id}: [${x}, ${y}] -> [${lon}, ${lat}]`)\n          }\n          return { coordinates: result as [number, number], territoryId: id }\n        }\n        else if (debug) {\n          console.log(`[Invert] Rejected ${id}: [${lon}, ${lat}] outside bounds`)\n        }\n      }\n      else {\n        // No bounds available, accept first successful invert (legacy behavior)\n        if (debug) {\n          console.log(`[Invert] No bounds for ${id}, accepting [${lon}, ${lat}]`)\n        }\n        return { coordinates: result as [number, number], territoryId: id }\n      }\n    }\n    catch (error) {\n      if (debug) {\n        console.warn(`[Invert] Error in ${id}:`, error)\n      }\n    }\n  }\n\n  if (debug) {\n    console.log(`[Invert] Failed to invert [${x}, ${y}]`)\n  }\n\n  return null\n}\n","/**\n * Stream Multiplexer\n *\n * Creates a stream that fans out geometry to multiple projections.\n * Used by composite projections to render all territories simultaneously.\n *\n * When d3.geoPath renders geometry through a composite projection,\n * the multiplexed stream ensures each sub-projection receives the\n * full geometry and applies its own clipping/transform.\n */\n\nimport type { ProjectionLike, StreamLike } from '../types'\n\n/**\n * Create a stream multiplexer for multiple projections\n *\n * @param projections - Array of projections to multiplex to\n * @returns Function that creates a multiplexed stream\n *\n * @example\n * ```typescript\n * const multiplex = createStreamMultiplexer([mainlandProj, alaskaProj, hawaiiProj])\n *\n * // Use as projection.stream method\n * compositeProjection.stream = multiplex\n *\n * // When d3.geoPath renders, all projections receive the geometry\n * const path = d3.geoPath(compositeProjection)\n * svg.selectAll('path')\n *   .data(countries.features)\n *   .join('path')\n *   .attr('d', path)\n * ```\n */\nexport function createStreamMultiplexer(\n  projections: ProjectionLike[],\n): (stream: StreamLike) => StreamLike {\n  return (stream: StreamLike): StreamLike => {\n    const streams = projections.map(p => p.stream(stream))\n\n    return {\n      point: (x: number, y: number) => {\n        for (const s of streams) s.point(x, y)\n      },\n      lineStart: () => {\n        for (const s of streams) s.lineStart()\n      },\n      lineEnd: () => {\n        for (const s of streams) s.lineEnd()\n      },\n      polygonStart: () => {\n        for (const s of streams) s.polygonStart()\n      },\n      polygonEnd: () => {\n        for (const s of streams) s.polygonEnd()\n      },\n      sphere: () => {\n        for (const s of streams) {\n          if (s.sphere)\n            s.sphere()\n        }\n      },\n    }\n  }\n}\n","/**\n * Point Capture Stream\n *\n * Creates a stream that captures projected point coordinates.\n * Used by composite projections to determine which sub-projection\n * successfully projects a geographic point.\n *\n * The pattern follows d3-composite-projections (albersUsa) approach:\n * 1. Create a point stream that stores the projected coordinates\n * 2. Pipe geographic coordinates through each sub-projection's stream\n * 3. Check if the point was captured (projection succeeded)\n */\n\nimport type { PointCaptureResult, StreamLike } from '../types'\n\n/**\n * Create a point capture stream for projection routing\n *\n * @returns Object with pointStream, getCapturedPoint, and resetCapture\n *\n * @example\n * ```typescript\n * const { pointStream, getCapturedPoint, resetCapture } = createPointCaptureStream()\n *\n * // Create capture stream for a projection\n * const captureStream = projection.stream(pointStream)\n *\n * // Project a point\n * resetCapture()\n * captureStream.point(longitude, latitude)\n *\n * // Check result\n * const projected = getCapturedPoint()\n * if (projected) {\n *   console.log(`Projected to [${projected[0]}, ${projected[1]}]`)\n * }\n * ```\n */\nexport function createPointCaptureStream(): PointCaptureResult {\n  let capturedPoint: [number, number] | null = null\n\n  const pointStream: StreamLike = {\n    point: (x: number, y: number) => {\n      capturedPoint = [x, y]\n    },\n    lineStart: () => {},\n    lineEnd: () => {},\n    polygonStart: () => {},\n    polygonEnd: () => {},\n    sphere: () => {},\n  }\n\n  return {\n    pointStream,\n    getCapturedPoint: () => capturedPoint,\n    resetCapture: () => {\n      capturedPoint = null\n    },\n  }\n}\n","/**\n * Composite Projection Builder\n *\n * Creates a D3-compatible composite projection from multiple sub-projections.\n * This follows the same pattern as d3-composite-projections (albersUsa).\n *\n * The composite projection:\n * 1. Routes projection calls to the correct sub-projection based on bounds\n * 2. Multiplexes geometry streaming to all sub-projections for rendering\n * 3. Validates invert operations against territory bounds\n */\n\nimport type {\n  CompositeProjectionConfig,\n  GeoBounds,\n  GeoBoundsArray,\n  ProjectionLike,\n} from '../types'\n\nimport { boundsFromArray, isPointInBounds } from '../bounds/checker'\nimport { invertWithBoundsValidation } from '../invert/validator'\nimport { createStreamMultiplexer } from '../stream/multiplexer'\nimport { createPointCaptureStream } from '../stream/point-capture'\n\n/**\n * Normalize bounds to GeoBounds format\n */\nfunction normalizeBounds(bounds: GeoBounds | GeoBoundsArray): GeoBounds {\n  if ('minLon' in bounds) {\n    return bounds\n  }\n  return boundsFromArray(bounds)\n}\n\n/**\n * Build a composite projection from sub-projection entries\n *\n * Creates a D3-compatible projection that routes geographic points to the\n * appropriate sub-projection based on territory bounds. When rendering,\n * geometry is multiplexed to all sub-projections so each territory renders\n * its portion of the world.\n *\n * @param config - Configuration with entries and optional debug flag\n * @returns D3-compatible composite projection\n *\n * @example\n * ```typescript\n * // Create sub-projections (e.g., using d3-geo)\n * const mainlandProj = d3.geoAlbers()\n *   .center([0, 38])\n *   .rotate([96, 0])\n *   .scale(1000)\n *\n * const alaskaProj = d3.geoConicEqualArea()\n *   .center([0, 64])\n *   .rotate([154, 0])\n *   .scale(400)\n *\n * // Build composite\n * const composite = buildCompositeProjection({\n *   entries: [\n *     {\n *       id: 'mainland',\n *       name: 'Mainland USA',\n *       projection: mainlandProj,\n *       bounds: { minLon: -125, minLat: 24, maxLon: -66, maxLat: 50 }\n *     },\n *     {\n *       id: 'alaska',\n *       name: 'Alaska',\n *       projection: alaskaProj,\n *       bounds: { minLon: -180, minLat: 51, maxLon: -129, maxLat: 72 }\n *     },\n *   ],\n * })\n *\n * // Use with D3\n * const path = d3.geoPath(composite)\n * svg.selectAll('path')\n *   .data(countries.features)\n *   .join('path')\n *   .attr('d', path)\n * ```\n */\nexport function buildCompositeProjection(\n  config: CompositeProjectionConfig,\n): ProjectionLike {\n  const { entries, debug = false } = config\n\n  if (entries.length === 0) {\n    throw new Error('Cannot build composite projection with no entries')\n  }\n\n  // Create point capture mechanism\n  const { pointStream, getCapturedPoint, resetCapture } = createPointCaptureStream()\n\n  // Create point capture streams for each entry\n  const entryStreams = entries.map(entry => ({\n    entry,\n    stream: entry.projection.stream(pointStream),\n  }))\n\n  // Main projection function - routes to correct sub-projection based on bounds\n  const project = (coordinates: [number, number]): [number, number] | null => {\n    const [lon, lat] = coordinates\n    resetCapture()\n\n    for (const { entry, stream } of entryStreams) {\n      if (entry.bounds) {\n        const bounds = normalizeBounds(entry.bounds)\n\n        if (isPointInBounds(lon, lat, bounds)) {\n          stream.point(lon, lat)\n          const captured = getCapturedPoint()\n\n          if (captured) {\n            return captured\n          }\n        }\n      }\n    }\n\n    return null\n  }\n\n  // Cast to ProjectionLike and add required methods\n  const composite = project as ProjectionLike\n\n  // Stream method - multiplex to all sub-projections\n  composite.stream = createStreamMultiplexer(entries.map(e => e.projection))\n\n  // Invert method - with bounds validation\n  composite.invert = (coords: [number, number]) => {\n    const result = invertWithBoundsValidation(coords, entries, { debug })\n    return result?.coordinates ?? null\n  }\n\n  // Scale getter/setter - returns reference from first sub-projection\n  composite.scale = function (_s?: number): any {\n    if (arguments.length === 0) {\n      return entries[0]?.projection.scale() ?? 1\n    }\n    // Setting scale on composite is a no-op (individual territories manage their scales)\n    return composite\n  } as ProjectionLike['scale']\n\n  // Translate getter/setter - returns reference translate\n  composite.translate = function (_t?: [number, number]): any {\n    if (arguments.length === 0) {\n      return entries[0]?.projection.translate() ?? [0, 0]\n    }\n    // Setting translate on composite is a no-op (individual territories manage their translates)\n    return composite\n  } as ProjectionLike['translate']\n\n  return composite\n}\n","/**\n * Standalone Composite Projection Loader (Zero Dependencies)\n *\n * A pure JavaScript/TypeScript module that consumes exported composite projection\n * configurations and creates D3-compatible projections using a plugin architecture.\n *\n * This package uses @atlas-composer/projection-core for the shared composite\n * projection building logic. Users must register projection factories before\n * loading configurations.\n *\n * @example\n * ```typescript\n * // Register projections first\n * import * as d3 from 'd3-geo'\n * import { registerProjection, loadCompositeProjection } from './standalone-projection-loader'\n *\n * registerProjection('mercator', () => d3.geoMercator())\n * registerProjection('albers', () => d3.geoAlbers())\n *\n * // Then load your configuration\n * const projection = loadCompositeProjection(config, { width: 800, height: 600 })\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { ProjectionLike as CoreProjectionLike, SubProjectionEntry } from '@atlas-composer/projection-core'\n\nimport {\n  buildCompositeProjection,\n  calculateClipExtentFromPixelOffset,\n} from '@atlas-composer/projection-core'\n\n/**\n * Generic projection-like interface that matches D3 projections\n * without requiring d3-geo as a dependency\n *\n * Note: D3 projections use getter/setter pattern where calling without\n * arguments returns the current value, and with arguments sets and returns this.\n */\nexport interface ProjectionLike {\n  (coordinates: [number, number]): [number, number] | null\n  center?: {\n    (): [number, number]\n    (center: [number, number]): ProjectionLike\n  }\n  rotate?: {\n    (): [number, number, number]\n    (angles: [number, number, number]): ProjectionLike\n  }\n  parallels?: {\n    (): [number, number]\n    (parallels: [number, number]): ProjectionLike\n  }\n  scale?: {\n    (): number\n    (scale: number): ProjectionLike\n  }\n  translate?: {\n    (): [number, number]\n    (translate: [number, number]): ProjectionLike\n  }\n  clipExtent?: {\n    (): [[number, number], [number, number]] | null\n    (extent: [[number, number], [number, number]] | null): ProjectionLike\n  }\n  clipAngle?: {\n    (): number\n    (angle: number): ProjectionLike\n  }\n  stream?: (stream: StreamLike) => StreamLike\n  precision?: {\n    (): number\n    (precision: number): ProjectionLike\n  }\n  fitExtent?: (extent: [[number, number], [number, number]], object: any) => ProjectionLike\n  fitSize?: (size: [number, number], object: any) => ProjectionLike\n  fitWidth?: (width: number, object: any) => ProjectionLike\n  fitHeight?: (height: number, object: any) => ProjectionLike\n}\n\n/**\n * Stream protocol interface for D3 geographic transforms\n */\nexport interface StreamLike {\n  point: (x: number, y: number) => void\n  lineStart: () => void\n  lineEnd: () => void\n  polygonStart: () => void\n  polygonEnd: () => void\n  sphere?: () => void\n}\n\n/**\n * Factory function that creates a projection instance\n */\nexport type ProjectionFactory = () => ProjectionLike\n\n/**\n * Exported configuration format (subset needed for loading)\n */\nexport interface ExportedConfig {\n  version: string\n  metadata: {\n    atlasId: string\n    atlasName: string\n    exportDate?: string\n    createdWith?: string\n    notes?: string\n  }\n  pattern: string\n  referenceScale?: number\n  canvasDimensions?: {\n    width: number\n    height: number\n  }\n  territories: Territory[]\n}\n\nexport interface Territory {\n  code: string\n  name: string\n  role: string\n  projection: {\n    id: string\n    family: string\n    parameters: ProjectionParameters\n  }\n  layout: Layout\n  bounds: [[number, number], [number, number]]\n}\n\nexport interface ProjectionParameters {\n  center?: [number, number]\n  rotate?: [number, number, number]\n  scaleMultiplier?: number\n  parallels?: [number, number]\n  clipAngle?: number\n  precision?: number\n}\n\nexport interface Layout {\n  translateOffset?: [number, number]\n  /** Pixel-based clip extent relative to territory center [x1, y1, x2, y2] */\n  pixelClipExtent?: [number, number, number, number] | null\n}\n\n/**\n * Options for creating the composite projection\n */\nexport interface LoaderOptions {\n  /** Canvas width in pixels */\n  width: number\n  /** Canvas height in pixels */\n  height: number\n  /** Whether to apply clipping to territories (default: true) */\n  enableClipping?: boolean\n  /** Debug mode - logs territory selection (default: false) */\n  debug?: boolean\n}\n\n/**\n * Runtime registry for projection factories\n * Users must register projections before loading configurations\n */\nconst projectionRegistry = new Map<string, ProjectionFactory>()\n\n/**\n * Register a projection factory with a given ID\n *\n * @example\n * ```typescript\n * import * as d3 from 'd3-geo'\n * import { registerProjection } from '@atlas-composer/projection-loader'\n *\n * registerProjection('mercator', () => d3.geoMercator())\n * registerProjection('albers', () => d3.geoAlbers())\n * ```\n *\n * @param id - Projection identifier (e.g., 'mercator', 'albers')\n * @param factory - Function that creates a new projection instance\n */\nexport function registerProjection(id: string, factory: ProjectionFactory): void {\n  projectionRegistry.set(id, factory)\n}\n\n/**\n * Register multiple projections at once\n *\n * @example\n * ```typescript\n * import * as d3 from 'd3-geo'\n * import { registerProjections } from '@atlas-composer/projection-loader'\n *\n * registerProjections({\n *   'mercator': () => d3.geoMercator(),\n *   'albers': () => d3.geoAlbers(),\n *   'conic-equal-area': () => d3.geoConicEqualArea()\n * })\n * ```\n *\n * @param factories - Object mapping projection IDs to factory functions\n */\nexport function registerProjections(factories: Record<string, ProjectionFactory>): void {\n  for (const [id, factory] of Object.entries(factories)) {\n    registerProjection(id, factory)\n  }\n}\n\n/**\n * Unregister a projection\n *\n * @param id - Projection identifier to remove\n * @returns True if the projection was removed, false if it wasn't registered\n */\nexport function unregisterProjection(id: string): boolean {\n  return projectionRegistry.delete(id)\n}\n\n/**\n * Clear all registered projections\n */\nexport function clearProjections(): void {\n  projectionRegistry.clear()\n}\n\n/**\n * Get list of currently registered projection IDs\n *\n * @returns Array of registered projection identifiers\n */\nexport function getRegisteredProjections(): string[] {\n  return Array.from(projectionRegistry.keys())\n}\n\n/**\n * Check if a projection is registered\n *\n * @param id - Projection identifier to check\n * @returns True if the projection is registered\n */\nexport function isProjectionRegistered(id: string): boolean {\n  return projectionRegistry.has(id)\n}\n\n/**\n * Create a minimal projection wrapper (similar to d3.geoProjection)\n * This allows us to avoid the d3-geo dependency\n */\n\n/**\n * Create a D3-compatible projection from an exported composite projection configuration\n *\n * @example\n * ```typescript\n * import * as d3 from 'd3-geo'\n * import { registerProjection, loadCompositeProjection } from '@atlas-composer/projection-loader'\n *\n * // Register projections first\n * registerProjection('mercator', () => d3.geoMercator())\n * registerProjection('albers', () => d3.geoAlbers())\n *\n * // Load configuration\n * const config = JSON.parse(jsonString)\n *\n * // Create projection\n * const projection = loadCompositeProjection(config, {\n *   width: 800,\n *   height: 600\n * })\n *\n * // Use with D3\n * const path = d3.geoPath(projection)\n * svg.selectAll('path')\n *   .data(countries.features)\n *   .join('path')\n *   .attr('d', path)\n * ```\n *\n * @param config - Exported composite projection configuration\n * @param options - Canvas dimensions and options\n * @returns D3-compatible projection that routes geometry to appropriate sub-projections\n */\nexport function loadCompositeProjection(\n  config: ExportedConfig,\n  options: LoaderOptions,\n): ProjectionLike {\n  const { width, height, debug = false } = options\n\n  // Validate configuration version\n  if (config.version !== '1.0') {\n    throw new Error(`Unsupported configuration version: ${config.version}`)\n  }\n\n  if (!config.territories || config.territories.length === 0) {\n    throw new Error('Configuration must contain at least one territory')\n  }\n\n  // Create sub-projections for each territory and convert to SubProjectionEntry format\n  const entries: SubProjectionEntry[] = config.territories.map((territory) => {\n    const proj = createSubProjection(territory, width, height, config.referenceScale, debug)\n\n    return {\n      id: territory.code,\n      name: territory.name,\n      projection: proj as CoreProjectionLike,\n      bounds: {\n        minLon: territory.bounds[0][0],\n        minLat: territory.bounds[0][1],\n        maxLon: territory.bounds[1][0],\n        maxLat: territory.bounds[1][1],\n      },\n    }\n  })\n\n  if (debug) {\n    console.log('[CompositeProjection] Created sub-projections:', {\n      territories: config.territories.map(t => ({ code: t.code, name: t.name })),\n      count: entries.length,\n    })\n  }\n\n  // Use projection-core to build the composite projection\n  const composite = buildCompositeProjection({ entries, debug })\n\n  return composite as ProjectionLike\n}\n\n/**\n * Create a sub-projection for a single territory\n */\nfunction createSubProjection(\n  territory: Territory,\n  width: number,\n  height: number,\n  referenceScale?: number,\n  debug?: boolean,\n): ProjectionLike {\n  // Extract projection info and parameters from nested projection object\n  const { layout } = territory\n  const projectionId = territory.projection.id\n  const parameters = territory.projection.parameters\n\n  if (!projectionId || !parameters) {\n    throw new Error(`Territory ${territory.code} missing projection configuration`)\n  }\n\n  // Get projection factory from registry\n  const factory = projectionRegistry.get(projectionId)\n  if (!factory) {\n    const registered = getRegisteredProjections()\n    const availableList = registered.length > 0 ? registered.join(', ') : 'none'\n    throw new Error(\n      `Projection \"${projectionId}\" is not registered. `\n      + `Available projections: ${availableList}. `\n      + `Use registerProjection('${projectionId}', factory) to register it.`,\n    )\n  }\n\n  // Create projection instance\n  const projection = factory()\n\n  // Apply parameters\n  if (parameters.center && projection.center) {\n    projection.center(parameters.center)\n  }\n\n  if (parameters.rotate && projection.rotate) {\n    // Ensure rotate has exactly 3 elements\n    const rotate = Array.isArray(parameters.rotate)\n      ? [...parameters.rotate, 0, 0].slice(0, 3) as [number, number, number]\n      : [0, 0, 0] as [number, number, number]\n    projection.rotate(rotate)\n  }\n\n  if (parameters.parallels && projection.parallels) {\n    // Ensure parallels has exactly 2 elements\n    const parallels = Array.isArray(parameters.parallels)\n      ? [...parameters.parallels, 0].slice(0, 2) as [number, number]\n      : [0, 60] as [number, number]\n    projection.parallels(parallels)\n  }\n\n  // Handle scale using scaleMultiplier and referenceScale\n  if (projection.scale && parameters.scaleMultiplier) {\n    const effectiveReferenceScale = referenceScale || 2700 // Default reference scale\n    const calculatedScale = effectiveReferenceScale * parameters.scaleMultiplier\n    projection.scale(calculatedScale)\n  }\n\n  // Apply additional parameters\n  if (parameters.clipAngle && projection.clipAngle) {\n    projection.clipAngle(parameters.clipAngle)\n  }\n\n  if (parameters.precision && projection.precision) {\n    projection.precision(parameters.precision)\n  }\n\n  // Apply layout translate\n  if (projection.translate) {\n    const [offsetX, offsetY] = layout.translateOffset || [0, 0] // Default to center if missing\n    projection.translate([\n      width / 2 + offsetX,\n      height / 2 + offsetY,\n    ])\n  }\n\n  // Apply clipping - this is CRITICAL for composite projections\n  // Each sub-projection MUST have clipping to avoid geometry processing conflicts\n  if (layout.pixelClipExtent && projection.clipExtent) {\n    // Get territory center from translate\n    const territoryCenter = projection.translate?.() || [width / 2, height / 2]\n\n    // Use core utility for clip extent calculation\n    const clipExtent = calculateClipExtentFromPixelOffset(\n      territoryCenter,\n      layout.pixelClipExtent,\n    )\n\n    projection.clipExtent(clipExtent)\n    if (debug) {\n      console.log(\n        `[Clipping] Applied pixelClipExtent for ${territory.code}:`,\n        `original: ${JSON.stringify(layout.pixelClipExtent)} -> transformed: ${JSON.stringify(clipExtent)}`,\n      )\n    }\n  }\n  else if (projection.clipExtent) {\n    // If no clip extent is specified, create a default one based on territory bounds\n    const bounds = territory.bounds\n    if (bounds && bounds.length === 2 && bounds[0].length === 2 && bounds[1].length === 2) {\n      // Convert geographic bounds to pixel bounds (approximate)\n      const scale = projection.scale?.() || 1\n      const translate = projection.translate?.() || [0, 0]\n\n      // Create a reasonable clip extent based on the geographic bounds\n      const padding = scale * 0.1 // 10% padding\n      const clipExtent: [[number, number], [number, number]] = [\n        [translate[0] - padding, translate[1] - padding],\n        [translate[0] + padding, translate[1] + padding],\n      ]\n\n      projection.clipExtent(clipExtent)\n\n      if (debug) {\n        console.log(`[Clipping] Applied default clip extent for ${territory.code}:`, clipExtent)\n      }\n    }\n  }\n\n  return projection\n}\n\n/**\n * Validate an exported configuration\n *\n * @param config - Configuration to validate\n * @returns True if valid, throws error otherwise\n */\nexport function validateConfig(config: any): config is ExportedConfig {\n  if (!config || typeof config !== 'object') {\n    throw new Error('Configuration must be an object')\n  }\n\n  if (!config.version) {\n    throw new Error('Configuration must have a version field')\n  }\n\n  if (!config.metadata || !config.metadata.atlasId) {\n    throw new Error('Configuration must have metadata with atlasId')\n  }\n\n  if (!config.territories || !Array.isArray(config.territories)) {\n    throw new Error('Configuration must have territories array')\n  }\n\n  if (config.territories.length === 0) {\n    throw new Error('Configuration must have at least one territory')\n  }\n\n  // Validate each territory\n  for (const territory of config.territories) {\n    if (!territory.code) {\n      throw new Error(`Territory missing required field 'code': ${JSON.stringify(territory)}`)\n    }\n\n    // Check for required nested projection format\n    if (!territory.projection || !territory.projection.id || !territory.projection.parameters) {\n      throw new Error(`Territory ${territory.code} missing projection configuration. Required: projection.id and projection.parameters`)\n    }\n\n    if (!territory.bounds) {\n      throw new Error(`Territory ${territory.code} missing bounds`)\n    }\n  }\n\n  return true\n}\n\n/**\n * Load composite projection from JSON string\n *\n * @example\n * ```typescript\n * import * as d3 from 'd3-geo'\n * import { registerProjection, loadFromJSON } from '@atlas-composer/projection-loader'\n *\n * // Register projections first\n * registerProjection('mercator', () => d3.geoMercator())\n *\n * // Load from JSON\n * const jsonString = fs.readFileSync('france-composite.json', 'utf-8')\n * const projection = loadFromJSON(jsonString, { width: 800, height: 600 })\n * ```\n */\nexport function loadFromJSON(\n  jsonString: string,\n  options: LoaderOptions,\n): ProjectionLike {\n  let config: any\n\n  try {\n    config = JSON.parse(jsonString)\n  }\n  catch (error) {\n    throw new Error(`Invalid JSON: ${error instanceof Error ? error.message : 'Unknown error'}`)\n  }\n\n  validateConfig(config)\n  return loadCompositeProjection(config, options)\n}\n\n// Default export\nexport default {\n  // Core loading functions\n  loadCompositeProjection,\n  loadFromJSON,\n  validateConfig,\n\n  // Registry management\n  registerProjection,\n  registerProjections,\n  unregisterProjection,\n  clearProjections,\n  getRegisteredProjections,\n  isProjectionRegistered,\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@atlas-composer/projection-loader",
   "type": "module",
-  "version": "1.1.0-rc.13",
+  "version": "1.1.0-rc.14",
   "description": "Zero-dependency standalone loader for composite map projections with plugin architecture. Supports Atlas composer 2.0+ presets with backward compatibility.",
   "author": "Lucas Poulain (ShallowRed)",
   "license": "MIT",