@jjlmoya/utils-nature 1.20.0 → 1.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jjlmoya/utils-nature",
-    "version": "1.20.0",
+    "version": "1.22.0",
     "type": "module",
     "main": "./src/index.ts",
     "types": "./src/index.ts",

package/src/category/index.ts

@@ -3,10 +3,12 @@ import { cricketThermometer } from '../tool/cricketThermometer/entry';
 import { seedCalculator } from '../tool/seedCalculator/entry';
 import { rainHarvester } from '../tool/rainHarvester/entry';
 import { digitalCarbon } from '../tool/digitalCarbon/entry';
+import { urbanGardenPlanner } from '../tool/urbanGardenPlanner/entry';
+import { compostBinVolumeRatioCalculator } from '../tool/compostBinVolumeRatioCalculator/entry';
 
 export const natureCategory: NatureCategoryEntry = {
   icon: 'mdi:leaf',
-  tools: [cricketThermometer, seedCalculator, rainHarvester, digitalCarbon],
+  tools: [cricketThermometer, seedCalculator, rainHarvester, digitalCarbon, urbanGardenPlanner, compostBinVolumeRatioCalculator],
   i18n: {
     en: () => import('./i18n/en').then((m) => m.content),
     es: () => import('./i18n/es').then((m) => m.content),
@@ -25,4 +27,3 @@ export const natureCategory: NatureCategoryEntry = {
     zh: () => import('./i18n/zh').then((m) => m.content),
   },
 };
-

package/src/entries.ts

@@ -6,9 +6,13 @@ export { rainHarvester } from './tool/rainHarvester/entry';
 export type { RainHarvesterLocaleContent } from './tool/rainHarvester/entry';
 export { seedCalculator } from './tool/seedCalculator/entry';
 export type { SeedCalculatorLocaleContent } from './tool/seedCalculator/entry';
+export { urbanGardenPlanner } from './tool/urbanGardenPlanner/entry';
+export type { UrbanGardenPlannerLocaleContent } from './tool/urbanGardenPlanner/entry';
 export { natureCategory } from './category';
 import { cricketThermometer } from './tool/cricketThermometer/entry';
 import { digitalCarbon } from './tool/digitalCarbon/entry';
 import { rainHarvester } from './tool/rainHarvester/entry';
 import { seedCalculator } from './tool/seedCalculator/entry';
-export const ALL_ENTRIES = [cricketThermometer, digitalCarbon, rainHarvester, seedCalculator];
+import { urbanGardenPlanner } from './tool/urbanGardenPlanner/entry';
+import { compostBinVolumeRatioCalculator } from './tool/compostBinVolumeRatioCalculator/entry';
+export const ALL_ENTRIES = [cricketThermometer, digitalCarbon, rainHarvester, seedCalculator, urbanGardenPlanner, compostBinVolumeRatioCalculator];

package/src/index.ts

@@ -24,3 +24,7 @@ export { SEED_CALCULATOR_TOOL, seedCalculator } from './tool/seedCalculator/inde
 export { RAIN_HARVESTER_TOOL, rainHarvester } from './tool/rainHarvester/index';
 
 export { DIGITAL_CARBON_TOOL, digitalCarbon } from './tool/digitalCarbon/index';
+
+export { URBAN_GARDEN_PLANNER_TOOL, urbanGardenPlanner } from './tool/urbanGardenPlanner/index';
+
+export { COMPOST_BIN_VOLUME_RATIO_CALCULATOR_TOOL, compostBinVolumeRatioCalculator } from './tool/compostBinVolumeRatioCalculator/index';

package/src/pages/[locale]/[slug].astro

@@ -15,7 +15,7 @@ export async function getStaticPaths() {
   const paths = [];
 
   for (const { entry, Component: lazyComp } of ALL_TOOLS) {
-    const { default: Component } = await lazyComp();
+    const Component = (await (lazyComp as () => Promise<{ default: unknown }>)()).default;
     const localeEntries = Object.entries(entry.i18n) as [
       KnownLocale,
       () => Promise<ToolLocaleContent>,
@@ -70,7 +70,7 @@ interface NavItem {
   isActive?: boolean;
 }
 
-interface Props {
+export interface Props {
   Component: unknown;
   locale: KnownLocale;
   content: ToolLocaleContent;
@@ -83,7 +83,8 @@ const { Component, locale, content, localeUrls, allToolsNav, englishSlug } = Ast
 
 const cssFiles = import.meta.glob("../../tool/**/*.css", { query: "?raw", import: "default" });
 const cssKey = Object.keys(cssFiles).find((k) => k.endsWith(`/${englishSlug}.css`));
-const toolCss = cssKey ? await cssFiles[cssKey]() as string : "";
+const cssLoader = cssKey ? cssFiles[cssKey] : undefined;
+const toolCss = cssLoader ? await cssLoader() as string : "";
 
 const seoContent: UtilitySEOContent = { locale, sections: content.seo ?? [] };
 
@@ -132,7 +133,7 @@ const titleBase = words.slice(1).join(" ") || "";
     </section>
 
     <section class="section-faq">
-      <FAQSection items={content.faq} inLanguage={locale} />
+      <FAQSection items={content.faq} />
     </section>
 
     <section class="section-bibliography">

package/src/tests/diacritics_density.test.ts

@@ -96,7 +96,7 @@ describe('Diacritics density validation', () => {
           if (!loader) return;
 
           const content = await loader();
-          const text = normalizeText(translatableContent(content as Record<string, unknown>));
+          const text = normalizeText(translatableContent(content as unknown as Record<string, unknown>));
           const rule = DIACRITIC_RULES[typedLocale];
           const letters = letterCount(text);
           const matches = diacriticCount(text, typedLocale);

package/src/tests/inverted_punctuation.test.ts

@@ -60,7 +60,7 @@ describe('Inverted punctuation validation', () => {
 
           const rule = INVERTED_PUNCTUATION_LOCALES[typedLocale];
           const content = await loader();
-          const strings = translatableStrings(content as Record<string, unknown>);
+          const strings = translatableStrings(content as unknown as Record<string, unknown>);
           const missingQuestions = strings.flatMap((text) =>
             findMissingInvertedMarks(text, rule.questionStart, rule.questionEnd)
           );

package/src/tests/script_density.test.ts

@@ -73,7 +73,7 @@ describe('Native script density validation', () => {
 
           const content = await loader();
           const rule = SCRIPT_RULES[typedLocale];
-          const text = normalizeText(translatableContent(content as Record<string, unknown>));
+          const text = normalizeText(translatableContent(content as unknown as Record<string, unknown>));
           const letters = letterCount(text);
           const matches = scriptCount(text, typedLocale);
           const ratio = scriptRatio(text, typedLocale);

package/src/tests/seo_length.test.ts

@@ -11,6 +11,7 @@ describe('SEO Content Length Validation', () => {
       Object.keys(entry.i18n).forEach((locale) => {
         it(`${locale}: SEO section should exist`, async () => {
           const loader = (entry.i18n as Record<string, () => Promise<{ seo?: unknown[] }>>)[locale];
+          if (!loader) return;
           const content = await loader();
           if (!content.seo) return;
           expect(Array.isArray(content.seo)).toBe(true);

package/src/tests/seo_translation_completeness.test.ts

@@ -0,0 +1,69 @@
+import { describe, it, expect } from 'vitest';
+import { ALL_TOOLS } from '../tools';
+
+const ASIAN_LOCALES = ['ja', 'ko', 'zh'];
+
+function getSimpleSectionLength(section: any): number {
+  if (section.type === 'title') return section.text ? section.text.length : 0;
+  if (section.type === 'paragraph') return section.html ? section.html.replace(/<[^>]*>/g, '').length : 0;
+  if (section.type === 'list') return section.items ? section.items.join('').length : 0;
+  return 0;
+}
+
+function getComplexSectionLength(section: any): number {
+  if (section.type === 'diagnostic' || section.type === 'tip') {
+    return (section.title ? section.title.length : 0) + (section.html ? section.html.replace(/<[^>]*>/g, '').length : 0);
+  }
+  if (section.type === 'table') {
+    return ((section.headers || []).join('').length) + ((section.rows || []).flat().join('').length);
+  }
+  return 0;
+}
+
+function getSectionLength(section: any): number {
+  return getSimpleSectionLength(section) || getComplexSectionLength(section);
+}
+
+function calculateSeoTextLength(seoSections: any[]): number {
+  return seoSections.reduce((acc, section) => acc + getSectionLength(section), 0);
+}
+
+function checkLocaleSeoLength(toolId: string, locale: string, localeLen: number, enLen: number): void {
+  const isAsian = ASIAN_LOCALES.includes(locale);
+  const minLength = Math.floor(enLen * (isAsian ? 0.25 : 0.70));
+  const msgType = isAsian ? 'suspiciously short' : 'truncated/lazy';
+
+  expect(
+    localeLen,
+    `[LAZY SEO TRANSLATION] Tool "${toolId}" locale "${locale}" SEO text is ${msgType} (${localeLen} chars vs EN ${enLen} chars, expected min ${minLength})`,
+  ).toBeGreaterThanOrEqual(minLength);
+}
+
+async function auditSingleLocale(toolId: string, locale: string, loader: any, enSeoLength: number): Promise<void> {
+  if (locale === 'en' || !loader) return;
+  const content = await loader();
+  if (!content.seo || !Array.isArray(content.seo)) return;
+
+  checkLocaleSeoLength(toolId, locale, calculateSeoTextLength(content.seo), enSeoLength);
+}
+
+describe('SEO Translation Completeness & Laziness Audit', () => {
+  ALL_TOOLS.forEach(({ entry }) => {
+    describe(`Tool: ${entry.id}`, () => {
+      it('should not have lazy or truncated SEO content compared to English reference', async () => {
+        const enLoader = entry.i18n['en' as keyof typeof entry.i18n];
+        if (!enLoader) return;
+
+        const enContent = await enLoader();
+        if (!enContent.seo || !Array.isArray(enContent.seo)) return;
+
+        const enSeoLength = calculateSeoTextLength(enContent.seo);
+
+        for (const [locale, loader] of Object.entries(entry.i18n)) {
+          await auditSingleLocale(entry.id, locale, loader, enSeoLength);
+        }
+      });
+    });
+  });
+});
+

package/src/tests/title_quality.test.ts

@@ -41,7 +41,7 @@ describe('Project Titles - Separator Validation', () => {
       let match;
       while ((match = pattern.exec(content)) !== null) {
         const title = match[1];
-        if (title.includes('|') || title.includes('-')) {
+        if (title && (title.includes('|') || title.includes('-'))) {
           findings.push(title);
         }
       }

package/src/tests/tool_validation.test.ts

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

package/src/tests/translation_copy.test.ts

@@ -106,8 +106,8 @@ describe('Locales must not copy another locale wholesale', () => {
 
       for (let leftIndex = 0; leftIndex < locales.length; leftIndex += 1) {
         for (let rightIndex = leftIndex + 1; rightIndex < locales.length; rightIndex += 1) {
-          const left = locales[leftIndex];
-          const right = locales[rightIndex];
+          const left = locales[leftIndex]!;
+          const right = locales[rightIndex]!;
           const similarity = copySimilarity(corpora.get(left) ?? '', corpora.get(right) ?? '');
 
           if (similarity >= COPY_THRESHOLD) {

package/src/tool/compostBinVolumeRatioCalculator/bibliography.astro

@@ -0,0 +1,18 @@
+---
+import type { BibliographyEntry } from '../../types';
+import { bibliography } from './bibliography';
+
+interface Props {
+  locale?: string;
+}
+
+const { locale = 'en' } = Astro.props as Props;
+const entries = bibliography;
+---
+
+<section class="compost-references" aria-labelledby="compost-references-title" data-locale={locale}>
+  <h2 id="compost-references-title">References</h2>
+  <ul>
+    {entries.map((entry: BibliographyEntry) => <li><a href={entry.url} target="_blank" rel="noreferrer">{entry.name}</a></li>)}
+  </ul>
+</section>

package/src/tool/compostBinVolumeRatioCalculator/bibliography.ts

@@ -0,0 +1,12 @@
+import type { BibliographyEntry } from "../../types";
+
+export const bibliography: BibliographyEntry[] = [
+  {
+    name: "U.S. Environmental Protection Agency, Composting At Home",
+    url: "https://www.epa.gov/recycle/composting-home",
+  },
+  {
+    name: "Ministerio de Medio Ambiente y Medio Rural y Marino y Amigos de la Tierra España, Manual de compostaje. Experiencias realizadas 2004-2008",
+    url: "https://www.miteco.gob.es/content/dam/miteco/es/calidad-y-evaluacion-ambiental/publicaciones/manual_compostaje_tcm30-185063.pdf",
+  },
+];

package/src/tool/compostBinVolumeRatioCalculator/component.astro

@@ -0,0 +1,77 @@
+---
+import './compost-bin-volume-ratio-calculator.css';
+import type { CompostBinVolumeRatioCalculatorUI } from './ui';
+
+interface Props {
+  ui: CompostBinVolumeRatioCalculatorUI;
+}
+
+const { ui } = Astro.props as Props;
+const initialState = {
+  unitSystem: 'metric',
+  shape: 'rectangular',
+  width: 80,
+  depth: 60,
+  diameter: 60,
+  height: 80,
+  browns: 36,
+  greens: 14,
+  moisture: 'sponge',
+};
+---
+
+<div class="compost-tool" data-compost-tool>
+  <div class="compost-tool-bar">
+    <div class="compost-tool-units" aria-label="Units">
+      <button type="button" data-unit="metric" data-unit-metric aria-pressed="true">{ui.unitMetric}</button>
+      <button type="button" data-unit="imperial" data-unit-imperial aria-pressed="false">{ui.unitImperial}</button>
+    </div>
+    <button type="button" class="compost-tool-reset" data-reset>{ui.resetLabel}</button>
+  </div>
+  <div class="compost-tool-body">
+    <section class="compost-controls" aria-labelledby="compost-controls-title">
+      <div class="compost-section-heading"><span>01</span><h2 id="compost-controls-title">Build the bin</h2></div>
+      <div class="compost-choice-group" role="group" aria-label={ui.shapeTitle}>
+        <span class="compost-choice-group-label">{ui.shapeTitle}</span>
+        <div class="compost-choice-group-buttons">
+          <button type="button" data-shape="rectangular" data-shape-rectangular aria-pressed="true" class="is-active"><span class="compost-shape-icon compost-shape-icon-box"></span>{ui.shapeRectangular}</button>
+          <button type="button" data-shape="cylindrical" data-shape-cylindrical aria-pressed="false"><span class="compost-shape-icon compost-shape-icon-cylinder"></span>{ui.shapeCylindrical}</button>
+        </div>
+      </div>
+      <div class="compost-dimensions" data-dimensions data-shape="rectangular">
+        <label data-rectangular-only><span>{ui.widthLabel}</span><div><input data-input="width" type="number" min="0" step="1" value="80" inputmode="decimal" /><em data-dimension-unit>{ui.dimensionUnitCm}</em></div></label>
+        <label data-rectangular-only><span>{ui.depthLabel}</span><div><input data-input="depth" type="number" min="0" step="1" value="60" inputmode="decimal" /><em data-dimension-unit>{ui.dimensionUnitCm}</em></div></label>
+        <label data-cylinder-only><span>{ui.diameterLabel}</span><div><input data-input="diameter" type="number" min="0" step="1" value="60" inputmode="decimal" /><em data-dimension-unit>{ui.dimensionUnitCm}</em></div></label>
+        <label><span>{ui.heightLabel}</span><div><input data-input="height" type="number" min="0" step="1" value="80" inputmode="decimal" /><em data-dimension-unit>{ui.dimensionUnitCm}</em></div></label>
+      </div>
+      <div class="compost-section-heading compost-section-heading-materials"><span>02</span><h2>{ui.recipeTitle}</h2></div>
+      <div class="compost-volume-inputs">
+        <label><span class="compost-label-dot compost-label-dot-brown"></span>{ui.brownLabel}<div><input data-input="browns" type="number" min="0" step="1" value="36" inputmode="decimal" /><em data-volume-unit>{ui.volumeUnitLiters}</em></div></label>
+        <label><span class="compost-label-dot compost-label-dot-green"></span>{ui.greenLabel}<div><input data-input="greens" type="number" min="0" step="1" value="14" inputmode="decimal" /><em data-volume-unit>{ui.volumeUnitLiters}</em></div></label>
+      </div>
+      <div class="compost-presets" aria-label={ui.recipeTitle}>
+        <button type="button" data-preset="kitchen">{ui.recipeKitchen}</button>
+        <button type="button" data-preset="garden">{ui.recipeGarden}</button>
+        <button type="button" data-preset="leafy">{ui.recipeLeafy}</button>
+      </div>
+      <div class="compost-section-heading compost-section-heading-moisture"><span>03</span><h2>{ui.moistureTitle}</h2></div>
+      <div class="compost-moisture" role="group" aria-label={ui.moistureTitle}>
+        <button type="button" data-moisture="dry" aria-pressed="false">{ui.moistureDry}</button>
+        <button type="button" data-moisture="sponge" aria-pressed="true">{ui.moistureSponge}</button>
+        <button type="button" data-moisture="wet" aria-pressed="false">{ui.moistureWet}</button>
+      </div>
+    </section>
+    <section class="compost-scene" data-compost-scene aria-label={ui.sceneTitle}></section>
+    <section class="compost-result" data-compost-results aria-live="polite"></section>
+  </div>
+  <div class="compost-tool-note"><span aria-hidden="true">◌</span>{ui.localNote}</div>
+  <div hidden data-ui={JSON.stringify(ui)}></div>
+  <script is:inline type="application/json" id="compost-initial-state" set:html={JSON.stringify(initialState)}></script>
+  <script>
+    import { mountCompostCalculator } from './controller';
+    const root = document.querySelector<HTMLElement>('[data-compost-tool]');
+    const uiNode = root?.querySelector('[data-ui]');
+    const ui = uiNode ? JSON.parse(uiNode.getAttribute('data-ui') ?? '{}') : {};
+    if (root) mountCompostCalculator(root, ui);
+  </script>
+</div>