@jjlmoya/utils-drones 1.30.0 → 1.31.0

package/package.json

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

package/src/category/index.ts

@@ -6,6 +6,7 @@ import { dronePowerAnalyzer } from '../tool/drone-power-analyzer/entry';
 import { gsdFlightPlanner } from '../tool/gsd-flight-planner/entry';
 import { droneBatteryCRatingCalculator } from '../tool/drone-battery-c-rating-calculator/entry';
 import { fpvDroneThrustToWeightRatio } from '../tool/fpv-drone-thrust-to-weight-ratio/entry';
+import { droneMotorPropellerCalculator } from '../tool/drone-motor-propeller-calculator/entry';
 
 export const dronesCategory: DronesCategoryEntry = {
   icon: 'mdi:drone',
@@ -17,6 +18,7 @@ export const dronesCategory: DronesCategoryEntry = {
     gsdFlightPlanner,
     droneBatteryCRatingCalculator,
     fpvDroneThrustToWeightRatio,
+    droneMotorPropellerCalculator,
   ],
   i18n: {
     es: () => import('./i18n/es').then((m) => m.content),

package/src/entries.ts

@@ -12,6 +12,8 @@ export { droneBatteryCRatingCalculator } from './tool/drone-battery-c-rating-cal
 export type { DroneBatteryCRatingCalculatorUI, DroneBatteryCRatingCalculatorLocaleContent } from './tool/drone-battery-c-rating-calculator/entry';
 export { fpvDroneThrustToWeightRatio } from './tool/fpv-drone-thrust-to-weight-ratio/entry';
 export type { FpvDroneThrustToWeightRatioUI, FpvDroneThrustToWeightRatioLocaleContent } from './tool/fpv-drone-thrust-to-weight-ratio/entry';
+export { droneMotorPropellerCalculator } from './tool/drone-motor-propeller-calculator/entry';
+export type { DroneMotorPropellerUI, DroneMotorPropellerLocaleContent } from './tool/drone-motor-propeller-calculator/entry';
 export { dronesCategory } from './category';
 
 import { antennaLengthCalculator } from './tool/antenna-length-calculator/entry';
@@ -21,6 +23,7 @@ import { dronePowerAnalyzer } from './tool/drone-power-analyzer/entry';
 import { gsdFlightPlanner } from './tool/gsd-flight-planner/entry';
 import { droneBatteryCRatingCalculator } from './tool/drone-battery-c-rating-calculator/entry';
 import { fpvDroneThrustToWeightRatio } from './tool/fpv-drone-thrust-to-weight-ratio/entry';
+import { droneMotorPropellerCalculator } from './tool/drone-motor-propeller-calculator/entry';
 
 export const ALL_ENTRIES = [
   antennaLengthCalculator,
@@ -30,4 +33,5 @@ export const ALL_ENTRIES = [
   gsdFlightPlanner,
   droneBatteryCRatingCalculator,
   fpvDroneThrustToWeightRatio,
+  droneMotorPropellerCalculator,
 ];

package/src/index.ts

@@ -21,4 +21,4 @@ export { ANTENNA_LENGTH_CALCULATOR_TOOL } from './tool/antenna-length-calculator
 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';
-
+export { DRONE_MOTOR_PROPELLER_CALCULATOR_TOOL } from './tool/drone-motor-propeller-calculator/index';

package/src/tests/locale_completeness.test.ts

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

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 7 tools in ALL_TOOLS', () => {
-      expect(ALL_TOOLS.length).toBe(7);
+    it('should have 8 tools in ALL_TOOLS', () => {
+      expect(ALL_TOOLS.length).toBe(8);
     });
 
     it('dronesCategory should be defined', () => {

package/src/tool/drone-motor-propeller-calculator/bibliography.astro

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

package/src/tool/drone-motor-propeller-calculator/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from '../../types';
+
+export const BIBLIOGRAPHY_ITEMS: BibliographyEntry[] = [
+  {
+    name: 'NASA Thrust Coefficient Definition for Propellers',
+    url: 'https://ntrs.nasa.gov/api/citations/19900020078/downloads/19900020078.pdf',
+  },
+  {
+    name: 'University of Illinois UIUC Propeller Data Site',
+    url: 'https://m-selig.ae.illinois.edu/props/propDB.html',
+  },
+];

package/src/tool/drone-motor-propeller-calculator/component.astro

@@ -0,0 +1,109 @@
+---
+import type { DroneMotorPropellerUI } from './ui';
+
+interface Props {
+  ui: DroneMotorPropellerUI;
+}
+
+const { ui } = Astro.props;
+---
+
+<div class="drone-motor-tool" data-drone-motor-calculator data-unit="metric">
+  <script is:inline type="application/json" data-drone-motor-ui set:html={JSON.stringify(ui)}></script>
+  <div class="tool-controls">
+    <section class="setup-card presets-card" aria-labelledby="presets-title">
+      <div class="eyebrow">{ui.presetsHeader}</div>
+      <div class="preset-row" id="presets-title">
+        <button type="button" class="preset-button" data-preset="tiny-cruiser">{ui.presetTinyCruiser}</button>
+        <button type="button" class="preset-button is-selected" data-preset="freestyle">{ui.presetFreestyle}</button>
+        <button type="button" class="preset-button" data-preset="long-range">{ui.presetLongRange}</button>
+        <button type="button" class="preset-button" data-preset="cinelifter">{ui.presetCinelifter}</button>
+      </div>
+    </section>
+
+    <section class="setup-card unit-card" aria-labelledby="unit-title">
+      <div class="eyebrow" id="unit-title">{ui.unitHeader}</div>
+      <div class="unit-toggle" role="group" aria-label={ui.unitHeader}>
+        <button type="button" class="unit-button is-selected" data-unit="metric" aria-pressed="true">{ui.metricUnit}</button>
+        <button type="button" class="unit-button" data-unit="imperial" aria-pressed="false">{ui.imperialUnit}</button>
+      </div>
+    </section>
+
+    <section class="setup-card specs-card" aria-labelledby="setup-title">
+      <div class="section-heading">
+        <div class="eyebrow">01</div>
+        <h2 id="setup-title">{ui.setupHeader}</h2>
+      </div>
+      <div class="input-grid">
+        <label class="field"><span>{ui.motorKvLabel}</span><input data-field="motorKv" type="number" value="1950" min="100" max="10000" step="50" inputmode="decimal" /><small>KV</small></label>
+        <label class="field"><span>{ui.batteryVoltageLabel}</span><input data-field="batteryVoltage" type="number" value="22.2" min="1" max="60" step="0.1" inputmode="decimal" /><small>V</small></label>
+        <label class="field"><span>{ui.propDiameterLabel}</span><input data-field="propDiameterInches" type="number" value="5.1" min="1" max="30" step="0.1" inputmode="decimal" /><small data-unit-label="length">in</small></label>
+        <label class="field"><span>{ui.propPitchLabel}</span><input data-field="propPitchInches" type="number" value="4.3" min="0.5" max="25" step="0.1" inputmode="decimal" /><small data-unit-label="length">in</small></label>
+        <div class="choice-field"><span>{ui.bladeCountLabel}</span><div class="choice-row" role="group" aria-label={ui.bladeCountLabel}><button type="button" data-choice="bladeCount" data-value="2" aria-pressed="false">{ui.twoBlades}</button><button type="button" class="is-selected" data-choice="bladeCount" data-value="3" aria-pressed="true">{ui.threeBlades}</button><button type="button" data-choice="bladeCount" data-value="4" aria-pressed="false">{ui.fourBlades}</button></div></div>
+        <div class="choice-field"><span>{ui.motorCountLabel}</span><div class="choice-row" role="group" aria-label={ui.motorCountLabel}><button type="button" data-choice="motorCount" data-value="2" aria-pressed="false">{ui.twoMotors}</button><button type="button" class="is-selected" data-choice="motorCount" data-value="4" aria-pressed="true">{ui.fourMotors}</button><button type="button" data-choice="motorCount" data-value="6" aria-pressed="false">{ui.sixMotors}</button><button type="button" data-choice="motorCount" data-value="8" aria-pressed="false">{ui.eightMotors}</button></div></div>
+        <label class="field field-wide"><span>{ui.droneWeightLabel}</span><input data-field="droneWeightGrams" type="number" value="700" min="1" max="50000" step="10" inputmode="decimal" /><small data-unit-label="mass">g</small></label>
+      </div>
+    </section>
+
+    <section class="setup-card bench-card" aria-labelledby="bench-title">
+      <div class="section-heading">
+        <div class="eyebrow">02</div>
+        <h2 id="bench-title">{ui.benchDataHeader} <span>{ui.optionalLabel}</span></h2>
+      </div>
+      <div class="input-grid bench-grid">
+        <label class="field"><span>{ui.benchThrustLabel}</span><input data-field="benchThrustGrams" type="number" value="1900" min="1" max="30000" step="10" inputmode="decimal" /><small data-unit-label="mass">g</small></label>
+        <label class="field"><span>{ui.benchVoltageLabel}</span><input data-field="benchVoltage" type="number" value="22.2" min="1" max="60" step="0.1" inputmode="decimal" /><small>V</small></label>
+      </div>
+      <div class="bench-foot">
+        <p class="fine-print"><span data-output="source-note">{ui.benchBasedLabel}</span></p>
+        <button type="button" class="clear-button" data-action="clear-bench">{ui.clearBenchData}</button>
+      </div>
+    </section>
+  </div>
+
+  <section class="results-card" aria-labelledby="results-title">
+    <div class="results-topline">
+      <div>
+        <div class="eyebrow">03</div>
+        <h2 id="results-title">{ui.resultsHeader}</h2>
+      </div>
+      <div class="status-pill" data-output="status" aria-live="polite">{ui.headroomStatus}</div>
+    </div>
+    <div class="wind-tunnel">
+      <div class="tunnel-label tunnel-label-top">{ui.thrustAxisLabel}</div>
+      <div class="thrust-stream stream-left"></div>
+      <div class="thrust-stream stream-right"></div>
+      <div class="rotor-stage" data-role="rotor-stage">
+        <div class="rotor-shadow"></div>
+        <div class="rotor-disc">
+          <span class="rotor-blade blade-one"></span>
+          <span class="rotor-blade blade-two"></span>
+          <span class="rotor-blade blade-three"></span>
+          <span class="rotor-blade blade-four"></span>
+          <span class="rotor-hub"></span>
+        </div>
+        <div class="rotor-readout"><strong data-output="loaded-rpm">15,000 rpm</strong><span>{ui.sceneCaption}</span></div>
+      </div>
+      <div class="weight-marker"><span class="marker-line"></span><span>{ui.weightAxisLabel}</span></div>
+      <div class="lift-beam"><span></span></div>
+    </div>
+    <p class="status-advice" data-output="status-advice" aria-live="polite">{ui.headroomAdvice}</p>
+    <div class="result-grid">
+      <div class="result-cell accent"><span>{ui.thrustPerMotorLabel}</span><strong data-output="thrust-per-motor">1,900 g</strong></div>
+      <div class="result-cell accent"><span>{ui.totalThrustLabel}</span><strong data-output="total-thrust">7,600 g</strong></div>
+      <div class="result-cell"><span>{ui.pitchSpeedLabel}</span><strong data-output="pitch-speed">1,250 km/h</strong></div>
+      <div class="result-cell"><span>{ui.totalPowerLabel}</span><strong data-output="total-power">1,200 W</strong></div>
+      <div class="result-cell"><span>{ui.totalCurrentLabel}</span><strong data-output="total-current">54 A</strong></div>
+      <div class="result-cell"><span>{ui.thrustMarginLabel}</span><strong data-output="thrust-margin">986%</strong></div>
+      <div class="result-cell"><span>{ui.hoverThrottleLabel}</span><strong data-output="hover-throttle">30%</strong></div>
+    </div>
+    <div class="notes-row"><p>{ui.safetyNote}</p><p>{ui.modelNote}</p></div>
+  </section>
+</div>
+
+<script>
+  import { initDroneMotorPropellerCalculator } from './controller';
+
+  const root = document.querySelector<HTMLElement>('[data-drone-motor-calculator]');
+  if (root) initDroneMotorPropellerCalculator(root);
+</script>

package/src/tool/drone-motor-propeller-calculator/controller.ts

@@ -0,0 +1,174 @@
+import { calculateDroneMotorMetrics, type BladeCount, type DroneMotorInputs, type MotorCount } from './logic';
+import { evaluateSetup } from './evaluator';
+import { formatInputValue, parseInputValue, renderResults, updateInputUnitLabels } from './dom-views';
+import { readStoredState, writeStoredState, type DisplayUnit } from './storage';
+import type { DroneMotorPropellerUI } from './ui';
+
+interface Preset {
+  id: string;
+  inputs: DroneMotorInputs;
+}
+
+const DEFAULT_INPUTS: DroneMotorInputs = {
+  motorKv: 1950,
+  batteryVoltage: 22.2,
+  propDiameterInches: 5.1,
+  propPitchInches: 4.3,
+  bladeCount: 3,
+  motorCount: 4,
+  droneWeightGrams: 700,
+  benchThrustGrams: 1900,
+  benchVoltage: 22.2,
+};
+
+const PRESETS: Preset[] = [
+  { id: 'tiny-cruiser', inputs: { motorKv: 3500, batteryVoltage: 11.1, propDiameterInches: 3.5, propPitchInches: 3, bladeCount: 3, motorCount: 4, droneWeightGrams: 280, benchThrustGrams: 550, benchVoltage: 11.1 } },
+  { id: 'freestyle', inputs: DEFAULT_INPUTS },
+  { id: 'long-range', inputs: { motorKv: 1500, batteryVoltage: 22.2, propDiameterInches: 7, propPitchInches: 3.5, bladeCount: 2, motorCount: 4, droneWeightGrams: 1200, benchThrustGrams: 1800, benchVoltage: 22.2 } },
+  { id: 'cinelifter', inputs: { motorKv: 700, batteryVoltage: 22.2, propDiameterInches: 8, propPitchInches: 4, bladeCount: 3, motorCount: 8, droneWeightGrams: 4200, benchThrustGrams: 1600, benchVoltage: 22.2 } },
+];
+
+function getInput(root: HTMLElement, field: string): HTMLInputElement | null {
+  return root.querySelector<HTMLInputElement>(`[data-field="${field}"]`);
+}
+
+function getNumber(root: HTMLElement, field: string, kind: 'mass' | 'length' | 'plain', unit: DisplayUnit): number {
+  const element = getInput(root, field);
+  if (!element || element.value.trim() === '') return 0;
+  return kind === 'plain' ? Number(element.value) : parseInputValue(element.value, kind, unit);
+}
+
+function getChoice(root: HTMLElement, field: string, fallback: number): number {
+  const selected = root.querySelector<HTMLElement>(`[data-choice="${field}"].is-selected`);
+  return Number(selected?.dataset.value ?? fallback);
+}
+
+function readInputs(root: HTMLElement, unit: DisplayUnit): DroneMotorInputs {
+  return {
+    motorKv: getNumber(root, 'motorKv', 'plain', unit),
+    batteryVoltage: getNumber(root, 'batteryVoltage', 'plain', unit),
+    propDiameterInches: getNumber(root, 'propDiameterInches', 'length', unit),
+    propPitchInches: getNumber(root, 'propPitchInches', 'length', unit),
+    bladeCount: getChoice(root, 'bladeCount', 3) as BladeCount,
+    motorCount: getChoice(root, 'motorCount', 4) as MotorCount,
+    droneWeightGrams: getNumber(root, 'droneWeightGrams', 'mass', unit),
+    benchThrustGrams: getOptionalNumber(root, 'benchThrustGrams', 'mass', unit),
+    benchVoltage: getOptionalNumber(root, 'benchVoltage', 'plain', unit),
+  };
+}
+
+function getOptionalNumber(root: HTMLElement, field: string, kind: 'mass' | 'plain', unit: DisplayUnit): number | undefined {
+  const value = getNumber(root, field, kind, unit);
+  return value > 0 ? value : undefined;
+}
+
+function setInput(root: HTMLElement, field: string, value: string): void {
+  const element = getInput(root, field);
+  if (element) element.value = value;
+}
+
+function setPhysicalInputs(root: HTMLElement, inputs: DroneMotorInputs, unit: DisplayUnit): void {
+  setInput(root, 'motorKv', String(inputs.motorKv));
+  setInput(root, 'batteryVoltage', String(inputs.batteryVoltage));
+  setInput(root, 'propDiameterInches', formatInputValue(inputs.propDiameterInches, 'length', unit));
+  setInput(root, 'propPitchInches', formatInputValue(inputs.propPitchInches, 'length', unit));
+  setInput(root, 'droneWeightGrams', formatInputValue(inputs.droneWeightGrams, 'mass', unit));
+  setInput(root, 'benchThrustGrams', inputs.benchThrustGrams ? formatInputValue(inputs.benchThrustGrams, 'mass', unit) : '');
+  setInput(root, 'benchVoltage', inputs.benchVoltage ? String(inputs.benchVoltage) : '');
+  selectChoice(root, 'bladeCount', inputs.bladeCount);
+  selectChoice(root, 'motorCount', inputs.motorCount);
+}
+
+function selectChoice(root: HTMLElement, field: string, value: number): void {
+  root.querySelectorAll<HTMLElement>(`[data-choice="${field}"]`).forEach((item) => {
+    item.classList.toggle('is-selected', Number(item.dataset.value) === value);
+    item.setAttribute('aria-pressed', String(Number(item.dataset.value) === value));
+  });
+}
+
+function selectPreset(root: HTMLElement, id: string): void {
+  root.querySelectorAll<HTMLElement>('[data-preset]').forEach((item) => {
+    item.classList.toggle('is-selected', item.dataset.preset === id);
+  });
+}
+
+function clearBenchData(root: HTMLElement, ui: DroneMotorPropellerUI): void {
+  setInput(root, 'benchThrustGrams', '');
+  setInput(root, 'benchVoltage', '');
+  selectPreset(root, '');
+  recalculate(root, ui, root.dataset.unit === 'imperial' ? 'imperial' : 'metric');
+}
+
+function updateUnitButtons(root: HTMLElement, unit: DisplayUnit): void {
+  root.querySelectorAll<HTMLElement>('[data-unit]').forEach((item) => {
+    item.classList.toggle('is-selected', item.dataset.unit === unit);
+    item.setAttribute('aria-pressed', String(item.dataset.unit === unit));
+  });
+}
+
+function recalculate(root: HTMLElement, ui: DroneMotorPropellerUI, unit: DisplayUnit): void {
+  const inputs = readInputs(root, unit);
+  if (inputs.motorKv <= 0 || inputs.batteryVoltage <= 0 || inputs.propDiameterInches <= 0 || inputs.propPitchInches <= 0 || inputs.droneWeightGrams <= 0) return;
+  const results = calculateDroneMotorMetrics(inputs);
+  const evaluation = evaluateSetup(results);
+  renderResults({ root, results, labels: ui, unit }, evaluation.status);
+  writeStoredState({ inputs, unit });
+}
+
+function changeUnit(root: HTMLElement, ui: DroneMotorPropellerUI, from: DisplayUnit, to: DisplayUnit): void {
+  if (from === to) return;
+  const inputs = readInputs(root, from);
+  setPhysicalInputs(root, inputs, to);
+  updateUnitButtons(root, to);
+  updateInputUnitLabels(root, to);
+  root.dataset.unit = to;
+  recalculate(root, ui, to);
+}
+
+function restoreState(root: HTMLElement): DisplayUnit {
+  const stored = readStoredState();
+  const unit = stored.unit === 'imperial' ? 'imperial' : 'metric';
+  setPhysicalInputs(root, stored.inputs ?? DEFAULT_INPUTS, unit);
+  return unit;
+}
+
+function readUi(root: HTMLElement): DroneMotorPropellerUI {
+  const element = root.querySelector<HTMLScriptElement>('[data-drone-motor-ui]');
+  return JSON.parse(element?.textContent ?? '{}') as DroneMotorPropellerUI;
+}
+
+function bindEvents(root: HTMLElement, ui: DroneMotorPropellerUI): void {
+  root.querySelectorAll<HTMLElement>('[data-preset]').forEach((item) => item.addEventListener('click', () => {
+    const preset = PRESETS.find((entry) => entry.id === item.dataset.preset);
+    if (!preset) return;
+    const unit = root.dataset.unit === 'imperial' ? 'imperial' : 'metric';
+    setPhysicalInputs(root, preset.inputs, unit);
+    selectPreset(root, preset.id);
+    recalculate(root, ui, unit);
+  }));
+  root.querySelectorAll<HTMLElement>('[data-choice]').forEach((item) => item.addEventListener('click', () => {
+    selectChoice(root, item.dataset.choice ?? '', Number(item.dataset.value));
+    selectPreset(root, '');
+    recalculate(root, ui, root.dataset.unit === 'imperial' ? 'imperial' : 'metric');
+  }));
+  root.querySelectorAll<HTMLElement>('[data-unit]').forEach((item) => item.addEventListener('click', () => {
+    const from = root.dataset.unit === 'imperial' ? 'imperial' : 'metric';
+    const to = item.dataset.unit === 'imperial' ? 'imperial' : 'metric';
+    changeUnit(root, ui, from, to);
+  }));
+  root.querySelectorAll<HTMLInputElement>('input[data-field]').forEach((item) => item.addEventListener('input', () => {
+    selectPreset(root, '');
+    recalculate(root, ui, root.dataset.unit === 'imperial' ? 'imperial' : 'metric');
+  }));
+  root.querySelector<HTMLElement>('[data-action="clear-bench"]')?.addEventListener('click', () => clearBenchData(root, ui));
+}
+
+export function initDroneMotorPropellerCalculator(root: HTMLElement): void {
+  const ui = readUi(root);
+  const unit = restoreState(root);
+  root.dataset.unit = unit;
+  updateUnitButtons(root, unit);
+  updateInputUnitLabels(root, unit);
+  bindEvents(root, ui);
+  recalculate(root, ui, unit);
+}

package/src/tool/drone-motor-propeller-calculator/dom-views.ts

@@ -0,0 +1,78 @@
+import type { DroneMotorResults } from './logic';
+import type { DisplayUnit } from './storage';
+import type { DroneMotorPropellerUI } from './ui';
+
+interface RenderContext {
+  root: HTMLElement;
+  results: DroneMotorResults;
+  labels: DroneMotorPropellerUI;
+  unit: DisplayUnit;
+}
+
+function formatNumber(value: number, digits = 0): string {
+  return new Intl.NumberFormat('en-US', { maximumFractionDigits: digits }).format(value);
+}
+
+function formatMass(grams: number, unit: DisplayUnit): string {
+  return unit === 'metric' ? `${formatNumber(grams)} g` : `${formatNumber(grams / 28.3495, 1)} oz`;
+}
+
+function formatSpeed(kmh: number, unit: DisplayUnit): string {
+  return unit === 'metric' ? `${formatNumber(kmh)} km/h` : `${formatNumber(kmh / 1.60934)} mph`;
+}
+
+function setText(root: HTMLElement, key: string, value: string): void {
+  const element = root.querySelector<HTMLElement>(`[data-output="${key}"]`);
+  if (element) element.textContent = value;
+}
+
+function getStatusText(status: string, labels: DroneMotorPropellerUI): string {
+  if (status === 'underpowered') return labels.underpoweredStatus;
+  if (status === 'workable') return labels.workableStatus;
+  return labels.headroomStatus;
+}
+
+function getStatusAdvice(status: string, labels: DroneMotorPropellerUI): string {
+  if (status === 'underpowered') return labels.underpoweredAdvice;
+  if (status === 'workable') return labels.workableAdvice;
+  return labels.headroomAdvice;
+}
+
+export function renderResults(context: RenderContext, status: string): void {
+  const { root, results, labels, unit } = context;
+  setText(root, 'loaded-rpm', `${formatNumber(results.loadedRpm)} rpm`);
+  setText(root, 'pitch-speed', formatSpeed(results.pitchSpeedKmh, unit));
+  setText(root, 'thrust-per-motor', formatMass(results.thrustPerMotorGrams, unit));
+  setText(root, 'total-thrust', formatMass(results.totalThrustGrams, unit));
+  setText(root, 'total-power', `${formatNumber(results.totalPowerWatts)} W`);
+  setText(root, 'total-current', `${formatNumber(results.totalCurrentAmps, 1)} A`);
+  setText(root, 'thrust-margin', `${formatNumber(results.thrustMarginPercent)}%`);
+  setText(root, 'hover-throttle', `${formatNumber(results.hoverThrottlePercent)}%`);
+  setText(root, 'status', getStatusText(status, labels));
+  setText(root, 'status-advice', getStatusAdvice(status, labels));
+  const sourceLabel = results.thrustSource === 'bench'
+    ? `${labels.benchBasedLabel} ${labels.sourceNote}`
+    : `${labels.estimatedLabel} ${labels.modelSourceNote}`;
+  setText(root, 'source-note', sourceLabel);
+  root.dataset.status = status;
+  root.style.setProperty('--lift-ratio', String(Math.min(results.totalThrustGrams / (results.totalThrustGrams + 1), 1)));
+  root.style.setProperty('--rotor-speed', `${Math.max(80, 90000 / Math.max(results.loadedRpm, 1))}ms`);
+}
+
+export function updateInputUnitLabels(root: HTMLElement, unit: DisplayUnit): void {
+  const massUnit = unit === 'metric' ? 'g' : 'oz';
+  const lengthUnit = unit === 'metric' ? 'cm' : 'in';
+  root.querySelectorAll<HTMLElement>('[data-unit-label="mass"]').forEach((item) => { item.textContent = massUnit; });
+  root.querySelectorAll<HTMLElement>('[data-unit-label="length"]').forEach((item) => { item.textContent = lengthUnit; });
+}
+
+export function formatInputValue(value: number, kind: 'mass' | 'length', unit: DisplayUnit): string {
+  if (kind === 'mass') return unit === 'metric' ? String(Math.round(value)) : String(Math.round(value / 28.3495 * 10) / 10);
+  return unit === 'metric' ? String(Math.round(value * 2.54 * 10) / 10) : String(value);
+}
+
+export function parseInputValue(value: string, kind: 'mass' | 'length', unit: DisplayUnit): number {
+  const parsed = Number(value);
+  if (kind === 'mass') return unit === 'metric' ? parsed : parsed * 28.3495;
+  return unit === 'metric' ? parsed / 2.54 : parsed;
+}