npm - @atlas-composer/projection-loader - Versions diffs - 1.1.0-rc.9 → 1.1.0 - Mend

@atlas-composer/projection-loader 1.1.0-rc.9 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +20 -428
package/dist/d3-projection-helpers.d.ts +1 -0
package/dist/index.d.ts +28 -50
package/dist/index.js +50 -172
package/dist/index.js.map +1 -1
package/package.json +8 -1

package/README.md CHANGED Viewed

@@ -1,459 +1,51 @@
 # @atlas-composer/projection-loader
-> Zero-dependency standalone loader for composite map projections with plugin architecture
+> The runtime engine for Atlas Composer maps.
-A lightweight, framework-agnostic library for loading composite map projections exported from [Atlas composer](https://github.com/ShallowRed/atlas-composer). Features a plugin architecture that lets you register only the projections you need.
+This package allows you to render composite projections exported from **Atlas Composer** in your own applications. It is lightweight, and works seamlessly with D3.js.
-**✨ NEW**: Now supports the updated preset format from Atlas composer 2.0+ with backward compatibility for legacy exports.
+## ✨ Features
-## Features
+- **Zero Runtime Dependencies** (excluding your choice of projection library).
+- **Plugin Architecture**: Only import the projection definitions you need.
+- **Type-Safe**: Written in TypeScript with full type definitions.
-- 🎯 **Zero Dependencies** - Bring your own projections (D3, Proj4, or custom)
-- 📦 **Tree-Shakeable** - Only bundle what you use (~6KB vs 100KB)
-- 🔌 **Plugin Architecture** - Register projections on-demand
-- 🌐 **Framework Agnostic** - Works with D3, Observable Plot, React, Vue, Svelte
-- 📘 **Full TypeScript Support** - Complete type definitions included
-- ⚡ **Fast** - Optimized stream multiplexing for efficient rendering
+## 🚀 Usage
-## Installation
+### 1. Install
 ```bash
-npm install @atlas-composer/projection-loader d3-geo d3-geo-projection
-# or
-pnpm add @atlas-composer/projection-loader d3-geo d3-geo-projection
-# or
-yarn add @atlas-composer/projection-loader d3-geo d3-geo-projection
+npm install @atlas-composer/projection-loader d3-geo
 ```
-## Quick Start
+### 2. Implementation
 ```typescript
 import { loadCompositeProjection, registerProjection } from '@atlas-composer/projection-loader'
 import * as d3 from 'd3-geo'
+import config from './my-exported-map.json'
-// 2. Load your exported configuration
-import config from './france-composite.json'
-// 1. Register projections (only what you need!)
+// 1. Register the projections required by your map
 registerProjection('mercator', () => d3.geoMercator())
 registerProjection('conic-conformal', () => d3.geoConicConformal())
+// 2. Load the composite projection
+// The resulting object is a standard D3 stream-compatible projection
 const projection = loadCompositeProjection(config, {
   width: 800,
   height: 600
 })
-// 3. Use with D3
+// 3. Render using D3
 const path = d3.geoPath(projection)
-svg.selectAll('path')
-  .data(features)
+d3.select('svg')
+  .selectAll('path')
+  .data(geojson.features)
   .join('path')
   .attr('d', path)
-  .attr('fill', 'lightgray')
-  .attr('stroke', 'white')
-```
-## Usage with Helpers (Convenience)
-For quick prototyping, use the optional helpers module:
-```typescript
-import { registerProjections } from '@atlas-composer/projection-loader'
-import { d3ProjectionFactories } from '@atlas-composer/projection-loader/helpers'
-// Register all standard D3 projections at once
-registerProjections(d3ProjectionFactories)
-// Now load your configuration
-const projection = loadCompositeProjection(config, { width: 800, height: 600 })
-```
-## Tree-Shaking (Production)
-For optimal bundle sizes, import only what you need:
-```typescript
-import { loadCompositeProjection, registerProjections } from '@atlas-composer/projection-loader'
-import { geoConicConformal, geoMercator } from 'd3-geo'
-// Only these two projections will be in your bundle
-registerProjections({
-  'mercator': () => geoMercator(),
-  'conic-conformal': () => geoConicConformal()
-})
-const projection = loadCompositeProjection(config, { width: 800, height: 600 })
 ```
-**Result**: ~6KB instead of ~100KB (94% reduction) 🎉
-## Configuration Format Support
-The loader supports multiple configuration formats for maximum compatibility:
-### New Format (Atlas composer 2.0+)
-```json
-{
-  "version": "1.0",
-  "metadata": { "atlasId": "france", "atlasName": "France" },
-  "pattern": "single-focus",
-  "referenceScale": 2700,
-  "territories": [
-    {
-      "code": "FR-MET",
-      "projection": {
-        "id": "conic-conformal",
-        "family": "CONIC",
-        "parameters": {
-          "rotate": [-3, -46.2, 0],
-          "scaleMultiplier": 1
-        }
-      },
-      "layout": { "translateOffset": [0, 0] }
-    }
-  ]
-}
-```
-### Legacy Format (Atlas composer 1.x)
-```json
-{
-  "version": "1.0",
-  "territories": [
-    {
-      "code": "FR-MET",
-      "projectionId": "conic-conformal",
-      "parameters": {
-        "scale": 2700,
-        "baseScale": 2700,
-        "scaleMultiplier": 1
-      }
-    }
-  ]
-}
-```
-The loader automatically detects and handles both formats seamlessly.
-## Observable Plot Integration
-```typescript
-import { loadCompositeProjection, registerProjection } from '@atlas-composer/projection-loader'
-import * as Plot from '@observablehq/plot'
-import * as d3 from 'd3-geo'
-// Register projections
-registerProjection('mercator', () => d3.geoMercator())
-registerProjection('conic-conformal', () => d3.geoConicConformal())
-// Create projection factory for Plot
-function createProjection({ width, height }) {
-  return loadCompositeProjection(config, { width, height })
-}
-// Use with Plot
-Plot.plot({
-  width: 975,
-  height: 610,
-  projection: createProjection,
-  marks: [
-    Plot.geo(countries, { fill: 'lightgray', stroke: 'white' })
-  ]
-})
-```
-## Framework Examples
-### React
-```tsx
-import { loadCompositeProjection, registerProjections } from '@atlas-composer/projection-loader'
-import * as d3 from 'd3-geo'
-import { useEffect, useRef } from 'react'
-function MapComponent({ config }) {
-  const svgRef = useRef<SVGSVGElement>(null)
-  useEffect(() => {
-    // Register projections once
-    registerProjections({
-      'mercator': () => d3.geoMercator(),
-      'conic-conformal': () => d3.geoConicConformal()
-    })
-    // Create projection
-    const projection = loadCompositeProjection(config, {
-      width: 800,
-      height: 600
-    })
-    // Render map
-    const path = d3.geoPath(projection)
-    const svg = d3.select(svgRef.current)
-    svg.selectAll('path')
-      .data(features)
-      .join('path')
-      .attr('d', path)
-      .attr('fill', 'lightgray')
-  }, [config])
-  return <svg ref={svgRef} width={800} height={600} />
-}
-```
-### Vue 3
-```vue
-<script setup lang="ts">
-import { loadCompositeProjection, registerProjections } from '@atlas-composer/projection-loader'
-import * as d3 from 'd3-geo'
-import { onMounted, ref } from 'vue'
-const props = defineProps<{ config: any }>()
-const svgRef = ref<SVGSVGElement>()
-onMounted(() => {
-  registerProjections({
-    'mercator': () => d3.geoMercator(),
-    'conic-conformal': () => d3.geoConicConformal()
-  })
-  const projection = loadCompositeProjection(props.config, {
-    width: 800,
-    height: 600
-  })
-  const path = d3.geoPath(projection)
-  const svg = d3.select(svgRef.value)
-  svg.selectAll('path')
-    .data(features)
-    .join('path')
-    .attr('d', path)
-    .attr('fill', 'lightgray')
-})
-</script>
-<template>
-  <svg
-    ref="svgRef"
-    width="800"
-    height="600"
-  />
-</template>
-```
-### Svelte
-```svelte
-<script lang="ts">
-import * as d3 from 'd3-geo'
-import { onMount } from 'svelte'
-import { loadCompositeProjection, registerProjections } from '@atlas-composer/projection-loader'
-export let config: any
-let svgElement: SVGSVGElement
-onMount(() => {
-  registerProjections({
-    'mercator': () => d3.geoMercator(),
-    'conic-conformal': () => d3.geoConicConformal()
-  })
-  const projection = loadCompositeProjection(config, {
-    width: 800,
-    height: 600
-  })
-  const path = d3.geoPath(projection)
-  const svg = d3.select(svgElement)
-  svg.selectAll('path')
-    .data(features)
-    .join('path')
-    .attr('d', path)
-    .attr('fill', 'lightgray')
-})
-</script>
-<svg bind:this={svgElement} width="800" height="600" />
-```
-## Custom Projections
-You can register any projection factory, including custom implementations:
-```typescript
-import { registerProjection } from '@atlas-composer/projection-loader'
-// Custom projection
-registerProjection('my-custom', () => {
-  // Return a D3-compatible projection
-  return {
-    // Implement projection interface
-    (coordinates) => [x, y],
-    scale: (s?) => s ? (scale = s, this) : scale,
-    translate: (t?) => t ? (translate = t, this) : translate,
-    // ... other D3 projection methods
-  }
-})
-// Proj4 wrapper
-import proj4 from 'proj4'
-registerProjection('lambert93', () => {
-  const projection = proj4('EPSG:2154')
-  return {
-    (coords) => projection.forward(coords),
-    scale: () => 1,
-    translate: () => [0, 0]
-  }
-})
-```
-## API Reference
-### Core Functions
-#### `registerProjection(id: string, factory: ProjectionFactory): void`
-Register a projection factory with a given ID.
-```typescript
-registerProjection('mercator', () => d3.geoMercator())
-```
-#### `registerProjections(factories: Record<string, ProjectionFactory>): void`
-Register multiple projections at once.
-```typescript
-registerProjections({
-  mercator: () => d3.geoMercator(),
-  albers: () => d3.geoAlbers()
-})
-```
-#### `loadCompositeProjection(config: ExportedConfig, options: LoaderOptions): ProjectionLike`
-Load a composite projection from an exported configuration.
-```typescript
-const projection = loadCompositeProjection(config, {
-  width: 800,
-  height: 600,
-  enableClipping: true, // optional, default: true
-  debug: false // optional, default: false
-})
-```
-#### `loadFromJSON(jsonString: string, options: LoaderOptions): ProjectionLike`
-Load a composite projection from a JSON string.
-```typescript
-const jsonString = fs.readFileSync('config.json', 'utf-8')
-const projection = loadFromJSON(jsonString, { width: 800, height: 600 })
-```
-### Utility Functions
-#### `getRegisteredProjections(): string[]`
-Get list of registered projection IDs.
-#### `isProjectionRegistered(id: string): boolean`
-Check if a projection is registered.
-#### `unregisterProjection(id: string): boolean`
-Remove a projection from the registry.
-#### `clearProjections(): void`
-Clear all registered projections.
-#### `validateConfig(config: any): boolean`
-Validate a configuration object. Throws descriptive errors if invalid.
-## Configuration Format
-Exported configurations follow this structure:
-```typescript
-interface ExportedConfig {
-  version: '1.0'
-  metadata: {
-    atlasId: string
-    atlasName: string
-  }
-  pattern: 'single-focus' | 'equal-members'
-  referenceScale: number
-  territories: Territory[]
-}
-interface Territory {
-  code: string
-  name: string
-  role: 'primary' | 'secondary' | 'member'
-  projectionId: string
-  projectionFamily: string
-  parameters: {
-    center?: [number, number]
-    rotate?: [number, number, number]
-    parallels?: [number, number]
-    scale: number
-    baseScale: number
-    scaleMultiplier: number
-  }
-  layout: {
-    translateOffset: [number, number]
-    clipExtent: [[number, number], [number, number]] | null
-  }
-  bounds: [[number, number], [number, number]]
-}
-```
-## Bundle Size
-| Approach | Bundle Size | Savings |
-|----------|-------------|---------|
-| All D3 projections | ~100KB | - |
-| With projection-loader | ~6KB | **94%** 🎉 |
-## TypeScript Support
-Full TypeScript definitions are included. No need for `@types/*` packages.
-```typescript
-import type {
-  ExportedConfig,
-  LoaderOptions,
-  ProjectionFactory,
-  ProjectionLike,
-  Territory
-} from '@atlas-composer/projection-loader'
-```
-## Browser Support
-Works in all modern browsers that support ES2020+. For older browsers, transpile with your build tool.
-## Contributing
-Contributions are welcome! This package is part of the [Atlas composer](https://github.com/ShallowRed/atlas-composer) monorepo.
-## License
-MIT © 2025 Lucas Poulain
-## Related
+## 📖 Documentation
-- [Atlas composer](https://github.com/ShallowRed/atlas-composer) - Create custom composite projections
-- [D3.js](https://d3js.org/) - Data visualization library
-- [Observable Plot](https://observablehq.com/plot/) - High-level plotting library
+For more context on the ecosystem, see the [root architecture documentation](../../docs/architecture.md).

package/dist/d3-projection-helpers.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
 import { ProjectionFactory } from './index.js';
+import '@atlas-composer/specification';
 /**
  * D3 Projection Helpers

package/dist/index.d.ts CHANGED Viewed

@@ -1,11 +1,14 @@
+import { CompositeProjectionConfig, LayoutConfig, ProjectionParameters as ProjectionParameters$1, TerritoryConfig } from '@atlas-composer/specification';
 /**
  * Standalone Composite Projection Loader (Zero Dependencies)
  *
  * A pure JavaScript/TypeScript module that consumes exported composite projection
  * configurations and creates D3-compatible projections using a plugin architecture.
  *
- * This package has ZERO dependencies. Users must register projection factories
- * before loading configurations.
+ * This package uses @atlas-composer/projection-core for the shared composite
+ * projection building logic. Users must register projection factories before
+ * loading configurations.
  *
  * @example
  * ```typescript
@@ -22,6 +25,7 @@
  *
  * @packageDocumentation
  */
 /**
  * Generic projection-like interface that matches D3 projections
  * without requiring d3-geo as a dependency
@@ -84,56 +88,30 @@ interface StreamLike {
  * Factory function that creates a projection instance
  */
 type ProjectionFactory = () => ProjectionLike;
 /**
- * Exported configuration format (subset needed for loading)
+ * Projection parameters with loader-specific extensions.
+ * @deprecated Specification now includes all legacy parameters
  */
-interface ExportedConfig {
-    version: string;
-    metadata: {
-        atlasId: string;
-        atlasName: string;
-        exportDate?: string;
-        createdWith?: string;
-        notes?: string;
-    };
-    pattern: string;
-    referenceScale?: number;
-    canvasDimensions?: {
-        width: number;
-        height: number;
-    };
-    territories: Territory[];
-}
-interface Territory {
-    code: string;
-    name: string;
-    role: string;
-    projectionId?: string;
-    projectionFamily?: string;
-    projection?: {
-        id: string;
-        family: string;
-        parameters: ProjectionParameters;
-    };
-    parameters?: ProjectionParameters;
-    layout: Layout;
-    bounds: [[number, number], [number, number]];
-}
-interface ProjectionParameters {
-    center?: [number, number];
-    rotate?: [number, number, number];
-    scale?: number;
-    baseScale?: number;
-    scaleMultiplier?: number;
-    parallels?: [number, number];
-    translate?: [number, number];
-    clipAngle?: number;
-    precision?: number;
-}
-interface Layout {
-    translateOffset?: [number, number];
-    clipExtent?: [[number, number], [number, number]] | null;
-}
+type ProjectionParameters = ProjectionParameters$1;
+/**
+ * Exported configuration format.
+ * Alias for CompositeProjectionConfig for backward compatibility.
+ * @deprecated Use CompositeProjectionConfig from @atlas-composer/specification
+ */
+type ExportedConfig = CompositeProjectionConfig;
+/**
+ * Territory configuration.
+ * Alias for TerritoryConfig for backward compatibility.
+ * @deprecated Use TerritoryConfig from @atlas-composer/specification
+ */
+type Territory = TerritoryConfig;
+/**
+ * Layout configuration.
+ * Alias for LayoutConfig for backward compatibility.
+ * @deprecated Use LayoutConfig from @atlas-composer/specification
+ */
+type Layout = LayoutConfig;
 /**
  * Options for creating the composite projection
  */

package/dist/index.js CHANGED Viewed

@@ -1,4 +1,12 @@
+import { buildCompositeProjection, calculateClipExtentFromPixelOffset } from '@atlas-composer/projection-core';
 // src/standalone-projection-loader.ts
+function resolveI18nString(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  return value.en || Object.values(value).find((v) => typeof v === "string") || "";
+}
 var projectionRegistry = /* @__PURE__ */ new Map();
 function registerProjection(id, factory) {
   projectionRegistry.set(id, factory);
@@ -28,152 +36,35 @@ function loadCompositeProjection(config, options) {
   if (!config.territories || config.territories.length === 0) {
     throw new Error("Configuration must contain at least one territory");
   }
-  const subProjections = config.territories.map((territory) => {
+  const entries = config.territories.map((territory) => {
     const proj = createSubProjection(territory, width, height, config.referenceScale, debug);
     return {
-      territory,
+      id: territory.code,
+      name: resolveI18nString(territory.name),
       projection: proj,
-      bounds: territory.bounds
+      bounds: {
+        minLon: territory.bounds[0][0],
+        minLat: territory.bounds[0][1],
+        maxLon: territory.bounds[1][0],
+        maxLat: territory.bounds[1][1]
+      }
     };
   });
   if (debug) {
     console.log("[CompositeProjection] Created sub-projections:", {
-      territories: config.territories.map((t) => ({ code: t.code, name: t.name })),
-      count: subProjections.length
+      territories: config.territories.map((t) => ({ code: t.code, name: resolveI18nString(t.name) })),
+      count: entries.length
     });
   }
-  let capturedPoint = null;
-  const pointStream = {
-    point: (x, y) => {
-      capturedPoint = [x, y];
-    },
-    lineStart: () => {
-    },
-    lineEnd: () => {
-    },
-    polygonStart: () => {
-    },
-    polygonEnd: () => {
-    },
-    sphere: () => {
-    }
-  };
-  const subProjPoints = subProjections.map((subProj) => ({
-    subProj: {
-      territoryCode: subProj.territory.code,
-      territoryName: subProj.territory.name,
-      bounds: subProj.bounds,
-      projection: subProj.projection
-    },
-    stream: subProj.projection.stream(pointStream)
-  }));
-  const compositeProjection = (coordinates) => {
-    const [lon, lat] = coordinates;
-    capturedPoint = null;
-    for (const { subProj, stream } of subProjPoints) {
-      if (subProj.bounds) {
-        const [[minLon, minLat], [maxLon, maxLat]] = subProj.bounds;
-        if (lon >= minLon && lon <= maxLon && lat >= minLat && lat <= maxLat) {
-          stream.point(lon, lat);
-          if (capturedPoint) {
-            return capturedPoint;
-          }
-        }
-      }
-    }
-    return null;
-  };
-  compositeProjection.stream = (stream) => {
-    const streams = subProjections.map((sp) => sp.projection.stream(stream));
-    return {
-      point: (x, y) => {
-        for (const s of streams) s.point(x, y);
-      },
-      sphere: () => {
-        for (const s of streams) {
-          if (s.sphere)
-            s.sphere();
-        }
-      },
-      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();
-      }
-    };
-  };
-  compositeProjection.invert = (coordinates) => {
-    if (!coordinates || !Array.isArray(coordinates) || coordinates.length < 2) {
-      return null;
-    }
-    const [x, y] = coordinates;
-    for (const { projection } of subProjections) {
-      if (projection.invert) {
-        try {
-          const result = projection.invert([x, y]);
-          if (result && Array.isArray(result) && result.length >= 2) {
-            return result;
-          }
-        } catch (error) {
-          if (debug) {
-            console.warn("[Invert] Error in sub-projection invert:", error);
-          }
-        }
-      }
-    }
-    return null;
-  };
-  compositeProjection.scale = function(_s) {
-    var _a, _b;
-    if (arguments.length === 0) {
-      return subProjections[0] ? ((_b = (_a = subProjections[0].projection).scale) == null ? void 0 : _b.call(_a)) || 1 : 1;
-    }
-    return compositeProjection;
-  };
-  compositeProjection.translate = function(_t) {
-    if (arguments.length === 0) {
-      return [width / 2, height / 2];
-    }
-    return compositeProjection;
-  };
-  return compositeProjection;
-}
-function inferProjectionIdFromFamily(family, parameters) {
-  switch (family.toUpperCase()) {
-    case "CYLINDRICAL":
-      return "mercator";
-    // Most common cylindrical projection
-    case "CONIC":
-      return parameters.parallels ? "conic-conformal" : "conic-equal-area";
-    case "AZIMUTHAL":
-      return "azimuthal-equal-area";
-    default:
-      console.warn(`Unknown projection family: ${family}, falling back to mercator`);
-      return "mercator";
-  }
+  const composite = buildCompositeProjection({ entries, debug });
+  return composite;
 }
 function createSubProjection(territory, width, height, referenceScale, debug) {
-  var _a, _b;
-  let projectionId;
-  let parameters;
+  var _a, _b, _c;
   const { layout } = territory;
-  if (territory.projection) {
-    projectionId = territory.projection.id;
-    parameters = territory.projection.parameters;
-  } else if (territory.projectionId && territory.parameters) {
-    projectionId = territory.projectionId;
-    parameters = territory.parameters;
-  } else if (territory.projectionFamily && territory.parameters) {
-    projectionId = inferProjectionIdFromFamily(territory.projectionFamily, territory.parameters);
-    parameters = territory.parameters;
-  } else {
+  const projectionId = territory.projection.id;
+  const parameters = territory.projection.parameters;
+  if (!projectionId || !parameters) {
     throw new Error(`Territory ${territory.code} missing projection configuration`);
   }
   const factory = projectionRegistry.get(projectionId);
@@ -185,10 +76,16 @@ function createSubProjection(territory, width, height, referenceScale, debug) {
     );
   }
   const projection = factory();
-  if (parameters.center && projection.center) {
+  const hasFocus = parameters.focusLongitude !== void 0 && parameters.focusLatitude !== void 0;
+  const projFamily = territory.projection.family;
+  if (hasFocus && projFamily === "CONIC" && projection.rotate) {
+    projection.rotate([-parameters.focusLongitude, -parameters.focusLatitude, 0]);
+  } else if (hasFocus && projection.center) {
+    projection.center([parameters.focusLongitude, parameters.focusLatitude]);
+  } else if (parameters.center && projection.center) {
     projection.center(parameters.center);
   }
-  if (parameters.rotate && projection.rotate) {
+  if (parameters.rotate && projection.rotate && !hasFocus) {
     const rotate = Array.isArray(parameters.rotate) ? [...parameters.rotate, 0, 0].slice(0, 3) : [0, 0, 0];
     projection.rotate(rotate);
   }
@@ -196,14 +93,10 @@ function createSubProjection(territory, width, height, referenceScale, debug) {
     const parallels = Array.isArray(parameters.parallels) ? [...parameters.parallels, 0].slice(0, 2) : [0, 60];
     projection.parallels(parallels);
   }
-  if (projection.scale) {
-    if (parameters.scale) {
-      projection.scale(parameters.scale);
-    } else if (parameters.scaleMultiplier) {
-      const effectiveReferenceScale = referenceScale || 2700;
-      const calculatedScale = effectiveReferenceScale * parameters.scaleMultiplier;
-      projection.scale(calculatedScale);
-    }
+  if (projection.scale && parameters.scaleMultiplier) {
+    const effectiveReferenceScale = referenceScale || 2700;
+    const calculatedScale = effectiveReferenceScale * parameters.scaleMultiplier;
+    projection.scale(calculatedScale);
   }
   if (parameters.clipAngle && projection.clipAngle) {
     projection.clipAngle(parameters.clipAngle);
@@ -218,36 +111,24 @@ function createSubProjection(territory, width, height, referenceScale, debug) {
       height / 2 + offsetY
     ]);
   }
-  if (parameters.translate && projection.translate) {
-    const currentTranslate = projection.translate();
-    const [additionalX, additionalY] = parameters.translate;
-    projection.translate([
-      currentTranslate[0] + additionalX,
-      currentTranslate[1] + additionalY
-    ]);
-  }
-  if (layout.clipExtent && projection.clipExtent) {
-    const effectiveReferenceScale = referenceScale || 2700;
-    const centerX = width / 2;
-    const centerY = height / 2;
-    const [[x1, y1], [x2, y2]] = layout.clipExtent;
-    const epsilon = 1e-6;
-    const transformedClipExtent = [
-      [centerX + x1 * effectiveReferenceScale + epsilon, centerY + y1 * effectiveReferenceScale + epsilon],
-      [centerX + x2 * effectiveReferenceScale - epsilon, centerY + y2 * effectiveReferenceScale - epsilon]
-    ];
-    projection.clipExtent(transformedClipExtent);
+  if (layout.pixelClipExtent && projection.clipExtent) {
+    const territoryCenter = ((_a = projection.translate) == null ? void 0 : _a.call(projection)) || [width / 2, height / 2];
+    const clipExtent = calculateClipExtentFromPixelOffset(
+      territoryCenter,
+      layout.pixelClipExtent
+    );
+    projection.clipExtent(clipExtent);
     if (debug) {
       console.log(
-        `[Clipping] Applied Atlas Composer-style clip extent for ${territory.code}:`,
-        `original: ${JSON.stringify(layout.clipExtent)} -> transformed: ${JSON.stringify(transformedClipExtent)}`
+        `[Clipping] Applied pixelClipExtent for ${territory.code}:`,
+        `original: ${JSON.stringify(layout.pixelClipExtent)} -> transformed: ${JSON.stringify(clipExtent)}`
       );
     }
   } else if (projection.clipExtent) {
     const bounds = territory.bounds;
     if (bounds && bounds.length === 2 && bounds[0].length === 2 && bounds[1].length === 2) {
-      const scale = ((_a = projection.scale) == null ? void 0 : _a.call(projection)) || 1;
-      const translate = ((_b = projection.translate) == null ? void 0 : _b.call(projection)) || [0, 0];
+      const scale = ((_b = projection.scale) == null ? void 0 : _b.call(projection)) || 1;
+      const translate = ((_c = projection.translate) == null ? void 0 : _c.call(projection)) || [0, 0];
       const padding = scale * 0.1;
       const clipExtent = [
         [translate[0] - padding, translate[1] - padding],
@@ -281,11 +162,8 @@ function validateConfig(config) {
     if (!territory.code) {
       throw new Error(`Territory missing required field 'code': ${JSON.stringify(territory)}`);
     }
-    const hasLegacyFormat = territory.projectionId && territory.parameters;
-    const hasNewFormat = territory.projection && territory.projection.id && territory.projection.parameters;
-    const hasIncompleteFormat = territory.projectionFamily && territory.parameters;
-    if (!hasLegacyFormat && !hasNewFormat && !hasIncompleteFormat) {
-      throw new Error(`Territory ${territory.code} missing projection configuration. Available fields: ${Object.keys(territory).join(", ")}`);
+    if (!territory.projection || !territory.projection.id || !territory.projection.parameters) {
+      throw new Error(`Territory ${territory.code} missing projection configuration. Required: projection.id and projection.parameters`);
     }
     if (!territory.bounds) {
       throw new Error(`Territory ${territory.code} missing bounds`);

package/dist/index.js.map CHANGED Viewed

	@@ -1 +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 has ZERO dependencies. Users must register projection factories\n * before 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\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 // Support multiple formats\n projectionId?: string // Legacy format\n projectionFamily?: string // Migration script format\n projection?: {\n id: string\n family: string\n parameters: ProjectionParameters\n } // New format\n parameters?: ProjectionParameters // Used in legacy and migration formats\n layout: Layout\n bounds: [[number, number], [number, number]]\n}\n\nexport interface ProjectionParameters {\n center?: [number, number]\n rotate?: [number, number, number]\n // Legacy format support\n scale?: number\n baseScale?: number\n scaleMultiplier?: number\n parallels?: [number, number]\n // Additional parameters from new format\n translate?: [number, number]\n clipAngle?: number\n precision?: number\n}\n\nexport interface Layout {\n translateOffset?: [number, number] // Make optional for migration script format\n clipExtent?: [[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\n const subProjections = config.territories.map((territory) => {\n const proj = createSubProjection(territory, width, height, config.referenceScale, debug)\n\n return {\n territory,\n projection: proj,\n bounds: territory.bounds,\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: subProjections.length,\n })\n }\n\n // Point capture mechanism (like Atlas Composer's CompositeProjection)\n let capturedPoint: [number, number] \| null = null\n const pointStream = {\n point: (x: number, y: number) => {\n capturedPoint = [x, y]\n },\n lineStart: () => {},\n lineEnd: () => {},\n polygonStart: () => {},\n polygonEnd: () => {},\n sphere: () => {},\n }\n\n // Create point capture for each sub-projection\n const subProjPoints = subProjections.map(subProj => ({\n subProj: {\n territoryCode: subProj.territory.code,\n territoryName: subProj.territory.name,\n bounds: subProj.bounds,\n projection: subProj.projection,\n },\n stream: subProj.projection.stream(pointStream),\n }))\n\n // Main projection function (like Atlas Composer's CompositeProjection)\n const compositeProjection = (coordinates: [number, number]): [number, number] \| null => {\n const [lon, lat] = coordinates\n\n capturedPoint = null\n\n // Try each sub-projection's bounds\n for (const { subProj, stream } of subProjPoints) {\n if (subProj.bounds) {\n const [[minLon, minLat], [maxLon, maxLat]] = subProj.bounds\n\n if (lon >= minLon && lon <= maxLon && lat >= minLat && lat <= maxLat) {\n // Project through stream (offset already applied in projection.translate)\n stream.point(lon, lat)\n\n if (capturedPoint) {\n return capturedPoint\n }\n }\n }\n }\n\n // No match found\n return null\n }\n\n // Multiplex stream (like Atlas Composer's CompositeProjection)\n ;(compositeProjection as any).stream = (stream: any) => {\n const streams = subProjections.map(sp => sp.projection.stream(stream))\n return {\n point: (x: number, y: number) => {\n for (const s of streams) s.point(x, y)\n },\n sphere: () => {\n for (const s of streams) {\n if (s.sphere)\n s.sphere()\n }\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 }\n }\n\n // Add invert method (like Atlas Composer's CompositeProjection)\n ;(compositeProjection as any).invert = (coordinates: [number, number]) => {\n if (!coordinates \|\| !Array.isArray(coordinates) \|\| coordinates.length < 2) {\n return null\n }\n\n const [x, y] = coordinates\n\n // Try each sub-projection's invert\n for (const { projection } of subProjections) {\n if ((projection as any).invert) {\n try {\n const result = (projection as any).invert([x, y])\n if (result && Array.isArray(result) && result.length >= 2) {\n return result as [number, number]\n }\n }\n catch (error) {\n // Continue to next projection\n if (debug) {\n console.warn('[Invert] Error in sub-projection invert:', error)\n }\n }\n }\n }\n\n return null\n }\n\n // Add scale and translate methods (like Atlas Composer's CompositeProjection)\n ;(compositeProjection as any).scale = function (_s?: number): any {\n if (arguments.length === 0) {\n // Return scale from first sub-projection as reference\n return subProjections[0] ? subProjections[0].projection.scale?.() \|\| 1 : 1\n }\n // Setting scale - not typically used for composite projections\n // Individual territories manage their own scales\n return compositeProjection\n }\n\n ;(compositeProjection as any).translate = function (_t?: [number, number]): any {\n if (arguments.length === 0) {\n // Return center point as reference\n return [width / 2, height / 2]\n }\n // Setting translate - not typically used for composite projections\n // Individual territories manage their own translations\n return compositeProjection\n }\n\n return compositeProjection as ProjectionLike\n}\n\n/\n Infer projection ID from family and parameters (for migration script format)\n /\nfunction inferProjectionIdFromFamily(family: string, parameters: ProjectionParameters): string {\n // Common projection mappings based on family and parameters\n switch (family.toUpperCase()) {\n case 'CYLINDRICAL':\n return 'mercator' // Most common cylindrical projection\n case 'CONIC':\n return parameters.parallels ? 'conic-conformal' : 'conic-equal-area'\n case 'AZIMUTHAL':\n return 'azimuthal-equal-area'\n default:\n // Fallback to mercator if we can't determine\n console.warn(`Unknown projection family: ${family}, falling back to mercator`)\n return 'mercator'\n }\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 multiple formats\n let projectionId: string\n let parameters: ProjectionParameters\n const { layout } = territory\n\n if (territory.projection) {\n // New format: nested projection object\n projectionId = territory.projection.id\n parameters = territory.projection.parameters\n }\n else if (territory.projectionId && territory.parameters) {\n // Legacy format: direct properties\n projectionId = territory.projectionId\n parameters = territory.parameters\n }\n else if (territory.projectionFamily && territory.parameters) {\n // Migration script format: has projectionFamily but missing projectionId\n // Try to infer projection ID from family and parameters\n projectionId = inferProjectionIdFromFamily(territory.projectionFamily as string, territory.parameters)\n parameters = territory.parameters\n }\n else {\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 - support both legacy (scale) and new (scaleMultiplier + referenceScale) formats\n if (projection.scale) {\n if (parameters.scale) {\n // Legacy format: use direct scale value\n projection.scale(parameters.scale)\n }\n else if (parameters.scaleMultiplier) {\n // New format: calculate scale from reference scale and multiplier\n const effectiveReferenceScale = referenceScale \|\| 2700 // Default reference scale\n const calculatedScale = effectiveReferenceScale parameters.scaleMultiplier\n projection.scale(calculatedScale)\n }\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 parameter-level translate (additional adjustment)\n if (parameters.translate && projection.translate) {\n const currentTranslate = projection.translate()\n const [additionalX, additionalY] = parameters.translate\n projection.translate([\n currentTranslate[0] + additionalX,\n currentTranslate[1] + additionalY,\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.clipExtent && projection.clipExtent) {\n // Like Atlas Composer: clipExtent is relative to the main projection coordinate system\n // Get the reference scale (use same as Atlas Composer does)\n const effectiveReferenceScale = referenceScale \|\| 2700\n const centerX = width / 2\n const centerY = height / 2\n \n // Apply Atlas Composer's approach: clipExtent values are multiplied by reference scale\n // and positioned relative to map center, with small epsilon for padding\n const [[x1, y1], [x2, y2]] = layout.clipExtent\n const epsilon = 1e-6 // Small value for padding, matching d3-composite-projections\n \n const transformedClipExtent: [[number, number], [number, number]] = [\n [centerX + x1 * effectiveReferenceScale + epsilon, centerY + y1 * effectiveReferenceScale + epsilon],\n [centerX + x2 * effectiveReferenceScale - epsilon, centerY + y2 * effectiveReferenceScale - epsilon],\n ]\n \n projection.clipExtent(transformedClipExtent)\n if (debug) {\n console.log(`[Clipping] Applied Atlas Composer-style clip extent for ${territory.code}:`, \n `original: ${JSON.stringify(layout.clipExtent)} -> transformed: ${JSON.stringify(transformedClipExtent)}`)\n }\n }\n else if (projection.clipExtent) {\n // If no clip extent is specified, create a default one based on territory bounds\n // This prevents the projection from processing geometry outside its area\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 // This is a simplified approach - in practice, you'd want more precise clipping\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 projection info in either format\n const hasLegacyFormat = territory.projectionId && territory.parameters\n const hasNewFormat = territory.projection && territory.projection.id && territory.projection.parameters\n const hasIncompleteFormat = territory.projectionFamily && territory.parameters // Migration script format\n\n if (!hasLegacyFormat && !hasNewFormat && !hasIncompleteFormat) {\n throw new Error(`Territory ${territory.code} missing projection configuration. Available fields: ${Object.keys(territory).join(', ')}`)\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"]}
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'\nimport type {\n CompositeProjectionConfig,\n GeoBounds,\n I18nString,\n LayoutConfig,\n ProjectionParameters as SpecProjectionParameters,\n TerritoryConfig,\n} from '@atlas-composer/specification'\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// Re-export specification types for convenience\nexport type { CompositeProjectionConfig, GeoBounds, I18nString, LayoutConfig, TerritoryConfig }\n\n/\n Resolve an I18nString to a plain string.\n * For i18n objects, returns the English value or the first available translation.\n /\nfunction resolveI18nString(value: I18nString): string {\n if (typeof value === 'string') {\n return value\n }\n // Return English first, or the first available language\n return value.en \|\| Object.values(value).find(v => typeof v === 'string') \|\| ''\n}\n\n/\n Projection parameters with loader-specific extensions.\n * @deprecated Specification now includes all legacy parameters\n /\nexport type ProjectionParameters = SpecProjectionParameters\n\n/\n Exported configuration format.\n * Alias for CompositeProjectionConfig for backward compatibility.\n * @deprecated Use CompositeProjectionConfig from @atlas-composer/specification\n /\nexport type ExportedConfig = CompositeProjectionConfig\n\n/\n Territory configuration.\n * Alias for TerritoryConfig for backward compatibility.\n * @deprecated Use TerritoryConfig from @atlas-composer/specification\n /\nexport type Territory = TerritoryConfig\n\n/\n Layout configuration.\n * Alias for LayoutConfig for backward compatibility.\n * @deprecated Use LayoutConfig from @atlas-composer/specification\n /\nexport type Layout = LayoutConfig\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: resolveI18nString(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: resolveI18nString(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 // Convert legacy focusLongitude/focusLatitude to center/rotate\n const hasFocus = parameters.focusLongitude !== undefined && parameters.focusLatitude !== undefined\n const projFamily = territory.projection.family\n\n // Apply parameters based on projection family\n if (hasFocus && projFamily === 'CONIC' && projection.rotate) {\n // Conic projections use rotate: [-focusLon, -focusLat, 0]\n projection.rotate([-parameters.focusLongitude!, -parameters.focusLatitude!, 0])\n }\n else if (hasFocus && projection.center) {\n // Other projections use center: [focusLon, focusLat]\n projection.center([parameters.focusLongitude!, parameters.focusLatitude!])\n }\n else if (parameters.center && projection.center) {\n // Standard center format\n projection.center(parameters.center)\n }\n\n if (parameters.rotate && projection.rotate && !hasFocus) {\n // Only apply rotate if not already set by focusLongitude/focusLatitude\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 CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@atlas-composer/projection-loader",
   "type": "module",
-  "version": "1.1.0-rc.9",
+  "version": "1.1.0",
   "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",
@@ -28,6 +28,9 @@
     "zero-dependencies"
   ],
   "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -72,6 +75,10 @@
       "optional": true
     }
   },
+  "dependencies": {
+    "@atlas-composer/projection-core": "1.0.1",
+    "@atlas-composer/specification": "1.0.1"
+  },
   "devDependencies": {
     "@size-limit/preset-small-lib": "^11.2.0",
     "@types/d3-geo": "^3.1.0",