@jjlmoya/utils-diy 1.26.0 → 1.28.0

package/src/tool/excavationVolumeCalculator/logic.ts

@@ -0,0 +1,35 @@
+import type { ExcavationInput, ExcavationOutput, SoilBand, SoilProfile } from './ui';
+
+const SOIL_BANDS: Record<SoilProfile, SoilBand> = {
+  sand: { low: 0.1, high: 0.15 },
+  topsoil: { low: 0.15, high: 0.25 },
+  clay: { low: 0.25, high: 0.4 },
+  gravel: { low: 0.15, high: 0.25 },
+};
+
+export function getSoilBand(soil: SoilProfile): SoilBand {
+  return SOIL_BANDS[soil];
+}
+
+export function calculateExcavation(input: ExcavationInput): ExcavationOutput {
+  const dimensions = [input.length, input.width, input.depth].map((value) => Math.max(0, value));
+  const bankVolume = dimensions.reduce((total, value) => total * value, 1);
+  const soilBand = getSoilBand(input.soil);
+  return {
+    bankVolume,
+    looseLow: bankVolume * (1 + soilBand.low),
+    looseHigh: bankVolume * (1 + soilBand.high),
+    soilBand,
+    expansionLow: soilBand.low,
+    expansionHigh: soilBand.high,
+  };
+}
+
+export function convertDimension(value: number, from: 'metric' | 'imperial', to: 'metric' | 'imperial'): number {
+  if (from === to) return value;
+  return from === 'metric' ? value * 3.280839895 : value / 3.280839895;
+}
+
+export function convertVolume(value: number, system: 'metric' | 'imperial'): number {
+  return system === 'metric' ? value : value * 35.31466672;
+}

package/src/tool/excavationVolumeCalculator/seo.astro

@@ -0,0 +1,15 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { excavationVolumeCalculator } from './entry';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const loader = excavationVolumeCalculator.i18n[locale as KnownLocale] ?? excavationVolumeCalculator.i18n.es ?? excavationVolumeCalculator.i18n.en;
+const content = loader ? await loader() : null;
+---
+
+{content?.seo && content.seo.length > 0 && <SEORenderer content={{ locale, sections: content.seo }} />}

package/src/tool/excavationVolumeCalculator/storage.ts

@@ -0,0 +1,28 @@
+import type { ExcavationInput, ExcavationUnitSystem, SoilProfile } from './ui';
+
+const STORAGE_KEY = 'jjlmoya-excavation-volume-calculator';
+
+interface StoredState {
+  unitSystem: ExcavationUnitSystem;
+  length: number;
+  width: number;
+  depth: number;
+  soil: SoilProfile;
+}
+
+export function readExcavationState(fallback: ExcavationInput): ExcavationInput {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    if (!raw) return fallback;
+    const parsed = JSON.parse(raw) as Partial<StoredState>;
+    if (!parsed.unitSystem || !parsed.soil) return fallback;
+    return { ...fallback, ...parsed };
+  } catch {}
+  return fallback;
+}
+
+export function writeExcavationState(input: ExcavationInput): void {
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(input));
+  } catch {}
+}

package/src/tool/excavationVolumeCalculator/ui.ts

@@ -0,0 +1,66 @@
+export type ExcavationUnitSystem = 'metric' | 'imperial';
+export type SoilProfile = 'sand' | 'topsoil' | 'clay' | 'gravel';
+
+export interface ExcavationInput {
+  unitSystem: ExcavationUnitSystem;
+  length: number;
+  width: number;
+  depth: number;
+  soil: SoilProfile;
+}
+
+export interface SoilBand {
+  low: number;
+  high: number;
+}
+
+export interface ExcavationOutput {
+  bankVolume: number;
+  looseLow: number;
+  looseHigh: number;
+  soilBand: SoilBand;
+  expansionLow: number;
+  expansionHigh: number;
+}
+
+export interface ExcavationCalculatorUI extends Record<string, string> {
+  unitSystemLabel: string;
+  unitMetric: string;
+  unitImperial: string;
+  onboarding: string;
+  dimensionLabel: string;
+  lengthLabel: string;
+  widthLabel: string;
+  depthLabel: string;
+  soilLabel: string;
+  soilSand: string;
+  soilTopsoil: string;
+  soilClay: string;
+  soilGravel: string;
+  soilSandBand: string;
+  soilTopsoilBand: string;
+  soilClayBand: string;
+  soilGravelBand: string;
+  bankVolumeLabel: string;
+  bankVolumeHelp: string;
+  looseVolumeLabel: string;
+  looseVolumeHelp: string;
+  expansionLabel: string;
+  expansionHelp: string;
+  sceneTitle: string;
+  sceneBank: string;
+  sceneLoose: string;
+  sceneGround: string;
+  sceneCut: string;
+  interpretationTitle: string;
+  interpretationText: string;
+  warning: string;
+  unitLengthMetric: string;
+  unitLengthImperial: string;
+  unitVolumeMetric: string;
+  unitVolumeImperial: string;
+  soilStatusLow: string;
+  soilStatusMedium: string;
+  soilStatusHigh: string;
+  soilStatusLabel: string;
+}

package/src/tools.ts

@@ -17,6 +17,7 @@ import { WORKSHOP_FRACTION_CONVERTER_TOOL } from './tool/workshopFractionConvert
 import { PYTHAGOREAN_RIGHT_ANGLE_CALCULATOR_TOOL } from './tool/pythagoreanRightAngleCalculator/index';
 import { TWO_STROKE_MIXTURE_CALCULATOR_TOOL } from './tool/twoStrokeMixtureCalculator/index';
 import { DRYWALL_CALCULATOR_TOOL } from './tool/drywallCalculator/index';
+import { EXCAVATION_VOLUME_CALCULATOR_TOOL } from './tool/excavationVolumeCalculator/index';
 
-export const ALL_TOOLS: ToolDefinition[] = [CLAY_CALCULATOR_TOOL, EPOXY_CALCULATOR_TOOL, BALUSTER_CALCULATOR_TOOL, MORTAR_CALCULATOR_TOOL, PASSEPARTOUT_CALCULATOR_TOOL, CONCRETE_CALCULATOR_TOOL, CUT_OPTIMIZER_TOOL, VOLTAGE_DROP_CALCULATOR_TOOL, FURNITURE_FIT_TOOL, THERMAL_EXPANSION_CALCULATOR_TOOL, DRILL_CALCULATOR_TOOL, STAIR_CALCULATOR_TOOL, DRILL_SHARPENER_TOOL, WORKSHOP_FRACTION_CONVERTER_TOOL, PYTHAGOREAN_RIGHT_ANGLE_CALCULATOR_TOOL, TWO_STROKE_MIXTURE_CALCULATOR_TOOL, DRYWALL_CALCULATOR_TOOL];
+export const ALL_TOOLS: ToolDefinition[] = [CLAY_CALCULATOR_TOOL, EPOXY_CALCULATOR_TOOL, BALUSTER_CALCULATOR_TOOL, MORTAR_CALCULATOR_TOOL, PASSEPARTOUT_CALCULATOR_TOOL, CONCRETE_CALCULATOR_TOOL, CUT_OPTIMIZER_TOOL, VOLTAGE_DROP_CALCULATOR_TOOL, FURNITURE_FIT_TOOL, THERMAL_EXPANSION_CALCULATOR_TOOL, DRILL_CALCULATOR_TOOL, STAIR_CALCULATOR_TOOL, DRILL_SHARPENER_TOOL, WORKSHOP_FRACTION_CONVERTER_TOOL, PYTHAGOREAN_RIGHT_ANGLE_CALCULATOR_TOOL, TWO_STROKE_MIXTURE_CALCULATOR_TOOL, DRYWALL_CALCULATOR_TOOL, EXCAVATION_VOLUME_CALCULATOR_TOOL];