@jjlmoya/utils-drones 1.16.0 → 1.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-drones",
-    "version": "1.16.0",
+    "version": "1.17.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/entries.ts

@@ -6,9 +6,12 @@ export { gpsCoordinatesConverter } from './tool/gps-coordinates-converter/entry'
 export type { GpsCoordinatesConverterUI, GpsCoordinatesConverterLocaleContent } from './tool/gps-coordinates-converter/entry';
 export { dronePowerAnalyzer } from './tool/drone-power-analyzer/entry';
 export type { DronePowerAnalyzerUI, DronePowerAnalyzerLocaleContent } from './tool/drone-power-analyzer/entry';
+export { gsdFlightPlanner } from './tool/gsd-flight-planner/entry';
+export type { GsdFlightPlannerUI, GsdFlightPlannerLocaleContent } from './tool/gsd-flight-planner/entry';
 export { dronesCategory } from './category';
 import { antennaLengthCalculator } from './tool/antenna-length-calculator/entry';
 import { droneFlightTime } from './tool/drone-flight-time/entry';
 import { gpsCoordinatesConverter } from './tool/gps-coordinates-converter/entry';
 import { dronePowerAnalyzer } from './tool/drone-power-analyzer/entry';
-export const ALL_ENTRIES = [antennaLengthCalculator, droneFlightTime, gpsCoordinatesConverter, dronePowerAnalyzer];
+import { gsdFlightPlanner } from './tool/gsd-flight-planner/entry';
+export const ALL_ENTRIES = [antennaLengthCalculator, droneFlightTime, gpsCoordinatesConverter, dronePowerAnalyzer, gsdFlightPlanner];

package/src/index.ts

@@ -20,4 +20,5 @@ export { DRONE_FLIGHT_TIME_TOOL } from './tool/drone-flight-time/index';
 export { ANTENNA_LENGTH_CALCULATOR_TOOL } from './tool/antenna-length-calculator/index';
 export { GPS_COORDINATES_CONVERTER_TOOL } from './tool/gps-coordinates-converter/index';
 export { DRONE_POWER_ANALYZER_TOOL } from './tool/drone-power-analyzer/index';
+export { GSD_FLIGHT_PLANNER_TOOL } from './tool/gsd-flight-planner/index';
 

package/src/tests/locale_completeness.test.ts

@@ -17,8 +17,8 @@ describe('Locale Completeness Validation', () => {
     });
   });
 
-  it('all 4 tools registered', () => {
-    expect(ALL_TOOLS.length).toBe(4);
+  it('all 5 tools registered', () => {
+    expect(ALL_TOOLS.length).toBe(5);
   });
 });
 

package/src/tests/tool_validation.test.ts

@@ -4,8 +4,8 @@ import { dronesCategory } from '../data';
 
 describe('Tool Validation Suite', () => {
   describe('Library Registration', () => {
-    it('should have 4 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(4);
+    it('should have 5 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(5);
     });
 
     it('dronesCategory should be defined', () => {

package/src/tool/drone-power-analyzer/i18n/de.ts

@@ -2,7 +2,7 @@ import type { DronePowerAnalyzerLocaleContent } from '../index';
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import { bibliography } from '../bibliography';
 
-const slug = 'drohnen-leistungsanalyzer';
+const slug = 'drohnen-leistungs-analysator';
 const title = 'Drohnen Leistungsanalysator: Schub und Gewichts Verhältnis Rechner für FPV';
 const description = 'Berechnen Sie das kritische Schub-Gewichts-Verhältnis für Ihren FPV-Drohnenbau. Erhalten Sie sofortige Flugprofil-Empfehlungen, eine visuelle Leistungsanzeige und optimieren Sie für Cinematic, Freestyle oder Racing.';
 

package/src/tool/drone-power-analyzer/i18n/es.ts

@@ -3,7 +3,7 @@ import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dt
 import { bibliography } from '../bibliography';
 
 const slug = 'analizador-potencia-dron';
-const title = 'Analizador de Potencia de Drone: Calculadora de Relación Empuje y Peso para FPV';
+const title = 'Analizador de Potencia de Dron: Calculadora de Relación Empuje y Peso para FPV';
 const description = 'Calcula la relación empuje-peso crítica para tu montaje de drone FPV. Obtén recomendaciones instantáneas de perfil de vuelo, medidor de potencia visual y optimiza para cine, freestyle o carreras.';
 
 const faqItems = [

package/src/tool/drone-power-analyzer/i18n/fr.ts

@@ -2,7 +2,7 @@ import type { DronePowerAnalyzerLocaleContent } from '../index';
 import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
 import { bibliography } from '../bibliography';
 
-const slug = 'analyseur-puissance-dron';
+const slug = 'analyseur-puissance-drone';
 const title = 'Analyseur de Puissance de Drone : Calculateur de Rapport Poussée/Poids pour FPV';
 const description = 'Calculez le rapport poussée/poids critique pour votre drone FPV. Obtenez des recommandations de profil de vol instantanées, une jauge de puissance visuelle et optimisez pour le cinématique, le freestyle ou la course.';
 

package/src/tool/gsd-flight-planner/InputsColumn.astro

@@ -0,0 +1,108 @@
+---
+const { ui } = Astro.props;
+---
+
+<div class="column column-inputs">
+  <h2 class="column-title">{ui.configuration || "Configuration"}</h2>
+
+  <div class="section">
+    <label class="section-label">{ui.cameraSelection || "Camera Selection"}</label>
+    <select id="cameraPreset" class="input-field">
+      <option value="">{ui.manualMode || "Manual Mode"}</option>
+      <option value="mavic3e">{ui.presetDjiMavic3e || "DJI Mavic 3E"}</option>
+      <option value="matrice300">{ui.presetDjiMatrice300 || "DJI Matrice 300 RTK"}</option>
+      <option value="autelevoii">{ui.presetAutelEvoII || "Autel EVO II"}</option>
+      <option value="air3s">{ui.presetDjiAir3s || "DJI Air 3S"}</option>
+    </select>
+  </div>
+
+  <div class="section">
+    <label class="section-label">{ui.sensorConfig || "Sensor Configuration"}</label>
+    <div class="input-row">
+      <div class="input-item">
+        <span class="input-label">{ui.width || "Width"}</span>
+        <input id="sensorWidth" type="number" min="1" max="100" step="0.1" value="23.5" class="input-field" />
+        <span class="unit-hint">mm</span>
+      </div>
+      <div class="input-item">
+        <span class="input-label">{ui.height || "Height"}</span>
+        <input id="sensorHeight" type="number" min="1" max="100" step="0.1" value="15.6" class="input-field" />
+        <span class="unit-hint">mm</span>
+      </div>
+    </div>
+  </div>
+
+  <div class="section">
+    <label class="section-label">{ui.focalLength || "Focal Length"}</label>
+    <div class="input-item">
+      <input id="focalLength" type="number" min="1" max="1000" step="0.1" value="35" class="input-field" />
+      <span class="unit-hint" id="focalLengthUnit">mm</span>
+    </div>
+  </div>
+
+  <div class="section">
+    <label class="section-label">{ui.imageResolution || "Image Resolution"}</label>
+    <div class="input-row">
+      <div class="input-item">
+        <span class="input-label">{ui.w || "W"}</span>
+        <input id="imageWidth" type="number" min="100" max="50000" step="1" value="5472" class="input-field" />
+        <span class="unit-hint">{ui.px || "px"}</span>
+      </div>
+      <div class="input-item">
+        <span class="input-label">{ui.h || "H"}</span>
+        <input id="imageHeight" type="number" min="100" max="50000" step="1" value="3648" class="input-field" />
+        <span class="unit-hint">{ui.px || "px"}</span>
+      </div>
+    </div>
+  </div>
+
+  <div class="section">
+    <label class="section-label">{ui.altitudeAgl || "Altitude (AGL)"}</label>
+    <div class="input-item">
+      <input id="altitudeAgl" type="number" min="10" max="500" step="5" value="100" class="input-field" />
+      <span class="unit-hint" id="altUnit">m</span>
+    </div>
+    <input id="altitudeSlider" type="range" min="10" max="500" step="5" value="100" class="slider" />
+  </div>
+
+  <div class="section">
+    <label class="section-label">{ui.overlapSettings || "Overlap Configuration"}</label>
+    <div class="input-row">
+      <div class="input-item">
+        <span class="input-label">{ui.forward || "Forward"}</span>
+        <input id="forwardOverlap" type="number" min="0" max="95" step="5" value="75" class="input-field" />
+        <span class="unit-hint">%</span>
+      </div>
+      <div class="input-item">
+        <span class="input-label">{ui.lateral || "Lateral"}</span>
+        <input id="lateralOverlap" type="number" min="0" max="95" step="5" value="65" class="input-field" />
+        <span class="unit-hint">%</span>
+      </div>
+    </div>
+  </div>
+
+  <div class="section">
+    <label class="section-label">{ui.missionArea || "Mission Area"}</label>
+    <div class="input-item">
+      <span class="input-label">{ui.totalAreaToSurvey || "Total Area to Survey"}</span>
+      <input id="missionArea" type="number" min="0.1" max="10000000" step="0.1" value="100" class="input-field" />
+      <span class="unit-hint" id="areaInputUnit">m²</span>
+      <span class="unit-hint" style="font-size: 0.65rem; margin-top: 0.25rem;">{ui.hectareHint || "1 ha = 10,000 m²"}</span>
+    </div>
+  </div>
+
+  <div class="section">
+    <label class="section-label">{ui.inverseCalc || "Reverse Calculation"}</label>
+    <div class="input-item">
+      <span class="input-label">{ui.targetGsd || "Target GSD"}</span>
+      <input id="desiredGsd" type="number" min="0.1" max="50" step="0.1" value="2" class="input-field" />
+      <span class="unit-hint" id="desiredGsdUnit">cm/px</span>
+    </div>
+    <div class="result-box">
+      <span class="result-label">{ui.maxAltitude || "Max Altitude"}</span>
+      <span class="result-value" id="maxAltResult">0.00 m</span>
+    </div>
+  </div>
+
+  <button id="resetBtn" class="btn-secondary">{ui.reset || "Reset"}</button>
+</div>

package/src/tool/gsd-flight-planner/ResultsColumn.astro

@@ -0,0 +1,90 @@
+---
+const { ui } = Astro.props;
+---
+
+<div class="column column-results">
+  <h2 class="column-title">{ui.results || "Results"}</h2>
+
+  <div class="result-section">
+    <div class="result-header">{ui.gsdResult || "Ground Sample Distance"}</div>
+    <div class="gsd-large">
+      <div class="gsd-number" id="gsdNumberLarge">0.00</div>
+      <div class="gsd-label" id="gsdUnitLabel">{ui.gsdUnit || "cm/px"}</div>
+    </div>
+
+    <div class="precision-bar">
+      <div class="bar-track">
+        <div class="bar-fill" id="scaleFill"></div>
+      </div>
+      <div class="bar-labels">
+        <span class="bar-label-item" title={ui.classHighPrecision}>{ui.highPrec || "High Prec."}</span>
+        <span class="bar-label-item" title={ui.classStandard}>{ui.standard || "Standard"}</span>
+        <span class="bar-label-item" title={ui.classInspection}>{ui.inspection || "Inspection"}</span>
+        <span class="bar-label-item" title={ui.classVisual}>{ui.visual || "Visual"}</span>
+      </div>
+    </div>
+
+    <div class="classification" id="classificationBadge">—</div>
+  </div>
+
+  <div class="result-section">
+    <div class="result-header">{ui.coveragePerImage || "Coverage per Image"}</div>
+    <div class="coverage-display">
+      <div class="coverage-stat">
+        <span class="stat-label">{ui.area || "Area"}</span>
+        <span class="stat-value" id="areaDisplay">0</span>
+        <span class="stat-unit" id="areaUnit">m²</span>
+      </div>
+      <div class="coverage-stat">
+        <span class="stat-label">{ui.spacing || "Spacing"}</span>
+        <span class="stat-value" id="spacingDisplay">0</span>
+        <span class="stat-unit" id="spacingUnit">m</span>
+      </div>
+    </div>
+
+    <svg class="coverage-visual" viewBox="0 0 220 100">
+      <defs>
+        <pattern id="grid" width="10" height="10" patternUnits="userSpaceOnUse">
+          <path d="M 10 0 L 0 0 0 10" fill="none" stroke="currentColor" stroke-width="0.5" opacity="0.1"/>
+        </pattern>
+      </defs>
+      <rect width="220" height="100" fill="url(#grid)"/>
+      <text x="10" y="95" font-size="8" opacity="0.4">{ui.flightDir || "Flight →"}</text>
+      <rect id="photo1Rect" x="20" y="30" width="80" height="40" fill="currentColor" opacity="0.25" stroke="currentColor" stroke-width="1.5" stroke-dasharray="2,2"/>
+      <rect id="photo2Rect" x="70" y="30" width="80" height="40" fill="currentColor" opacity="0.15" stroke="currentColor" stroke-width="1.5"/>
+      <rect id="overlapRect" x="70" y="30" width="30" height="40" fill="currentColor" opacity="0.4" stroke="none"/>
+      <text id="overlapText" x="85" y="58" font-size="9" text-anchor="middle" fill="currentColor" font-weight="bold" opacity="0.8">70%</text>
+    </svg>
+  </div>
+
+  <div class="result-section">
+    <div class="result-header">{ui.missionMetrics || "Mission Metrics"}</div>
+    <div class="metrics-display">
+      <div class="metric-item">
+        <span class="metric-label">{ui.images || "Images"}</span>
+        <span class="metric-number" id="totalImages">0</span>
+        <span class="metric-unit">{ui.shots || "shots"}</span>
+      </div>
+      <div class="metric-item">
+        <span class="metric-label">{ui.flightLines || "Flight Lines"}</span>
+        <span class="metric-number" id="flightLines">0</span>
+        <span class="metric-unit">{ui.lines || "lines"}</span>
+      </div>
+      <div class="metric-item">
+        <span class="metric-label">{ui.flightTime || "Flight Time"}</span>
+        <span class="metric-number" id="flightTime">0</span>
+        <span class="metric-unit">{ui.min || "min"}</span>
+      </div>
+      <div class="metric-item">
+        <span class="metric-label">{ui.dataVolume || "Data Volume"}</span>
+        <span class="metric-number" id="dataVolume">0</span>
+        <span class="metric-unit">{ui.gb || "GB"}</span>
+      </div>
+    </div>
+  </div>
+
+  <div id="alertsContainer" class="alerts-container"></div>
+
+  <button id="shareBtn" class="btn-primary" style="margin-bottom: 0.75rem;">{ui.copyShareLink || "Copy Share Link"}</button>
+  <button id="exportBtn" class="btn-secondary">{ui.downloadReport || "Download Report"}</button>
+</div>

package/src/tool/gsd-flight-planner/bibliography.astro

@@ -0,0 +1,6 @@
+---
+import { Bibliography as BibliographyComponent } from '@jjlmoya/utils-shared';
+import { bibliography } from './bibliography';
+---
+
+<BibliographyComponent links={bibliography} />

package/src/tool/gsd-flight-planner/bibliography.ts

@@ -0,0 +1,7 @@
+import type { BibliographyEntry } from '../../types';
+
+export const bibliography: BibliographyEntry[] = [
+  { name: 'Pix4D - Understanding Ground Sample Distance (GSD)', url: 'https://support.pix4d.com/hc/en-us/articles/202559809' },
+  { name: 'DJI - Photogrammetry Basics & GSD Calculator', url: 'https://enterprise-insights.dji.com/blog/ground-sample-distance' },
+  { name: 'OpenDroneMap - Flight Planning Guide', url: 'https://docs.opendronemap.org/flying/' }
+];

package/src/tool/gsd-flight-planner/component.astro

@@ -0,0 +1,22 @@
+---
+import InputsColumn from './InputsColumn.astro';
+import ResultsColumn from './ResultsColumn.astro';
+const { ui } = Astro.props;
+---
+
+<div class="gsd-flight-planner-ui" data-ui={JSON.stringify(ui)}>
+  <div class="main-card">
+    <div class="unit-toggle unit-toggle-corner">
+      <button id="metricBtn" class="unit-btn active">{ui.metric || "Metric"}</button>
+      <button id="imperialBtn" class="unit-btn">{ui.imperial || "Imperial"}</button>
+    </div>
+    <InputsColumn {ui} />
+    <div class="divider"></div>
+    <ResultsColumn {ui} />
+  </div>
+</div>
+
+<script is:inline define:vars={{ ui }}>
+  window.ui = ui;
+</script>
+<script src="./logic.js"></script>

package/src/tool/gsd-flight-planner/entry.ts

@@ -0,0 +1,29 @@
+import type { DronesToolEntry, ToolLocaleContent } from '../../types';
+
+export interface GsdFlightPlannerUI {
+  [key: string]: string;
+}
+
+export type GsdFlightPlannerLocaleContent = ToolLocaleContent<GsdFlightPlannerUI>;
+
+export const gsdFlightPlanner: DronesToolEntry<GsdFlightPlannerUI> = {
+  id: 'gsd-flight-planner',
+  icons: { bg: 'mdi:drone', fg: 'mdi:map-marker-distance' },
+  i18n: {
+    es: () => import('./i18n/es').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    de: () => import('./i18n/de').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+  },
+};