@jjlmoya/utils-home 1.30.0 → 1.32.0

package/src/tool/lightingCalculator/i18n/tr.ts

@@ -0,0 +1,213 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { LightingCalculatorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'ev-aydinlatma-ve-lumen-hesaplayici';
+const title = 'Ev Aydınlatma ve Lümen Hesaplayıcı';
+const description =
+  'Herhangi bir oda için tam olarak kaç lümen ve ampule ihtiyacınız olduğunu hesaplayın. Oda tipi, boyutlar ve ampul tipini seçerek gerçek zamanlı lüks tahminleriyle profesyonel bir aydınlatma planı elde edin.';
+
+const faqData = [
+  {
+    question: 'Oturma odası için kaç lümen gerekiyor?',
+    answer:
+      'Tipik bir oturma odası için zeminde yaklaşık 150 lüks hedefleyin. Oda alanını metrekare cinsinden 150 ile çarparak gerekli lümeni bulun. 20 metrekarelik bir oda için yaklaşık 3.000 lümen gereklidir.',
+  },
+  {
+    question: 'Lüks ile lümen arasındaki fark nedir?',
+    answer:
+      'Lümen, bir ampulün toplam ışık çıktısını ölçer. Lüks, gerçekten bir yüzeye ulaşan ışığı ölçer. Yüksek tavanlı veya koyu duvarlı bir oda, mesafe ve emilim nedeniyle ışık kaybı yaşadığından aynı lüks seviyesine ulaşmak için daha fazla lümen gerektirir.',
+  },
+  {
+    question: 'LED ampuller gerçekten enerji tasarrufu sağlar mı?',
+    answer:
+      'Evet. LED ampuller yaklaşık 100 lümen/watt üretirken, akkor ampuller sadece yaklaşık 15 lümen/watt üretir. 10W\'lık bir LED ampul, 60W\'lık bir akkor ampulle aynı ışığı verir ve elektriğin altıda birini kullanır.',
+  },
+  {
+    question: 'Oda rengi aydınlatma ihtiyacını nasıl etkiler?',
+    answer:
+      'Koyu duvarlar ve tavanlar ışığı emer. Koyu yüzeylere sahip bir odada, standart öneriye göre yüzde 50 daha fazla lümen gerekebilir.',
+  },
+  {
+    question: 'Okumak için iyi bir lüks seviyesi nedir?',
+    answer:
+      'Rahat okumak için sayfada 300 ila 500 lüks gerekir. Genel ortam aydınlatması genellikle 150 ila 200 lüks sağlar, bu nedenle ek parlaklık için okuma yerinizin yakınına bir çalışma lambası ekleyin.',
+  },
+  {
+    question: 'LED ampulleri kısabilir miyim?',
+    answer:
+      'Yalnızca kısılabilir olarak işaretlenmişse. Standart LED\'ler bir kısıcıya bağlandığında titreyebilir veya ömrü kısalabilir. Kurulumdan önce her zaman ambalajdaki kısılabilir sembolünü kontrol edin.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Oda tipinizi seçin',
+    text: 'Oda işlevini seçin. Mutfaklar ve ofisler, yatak odaları veya koridorlardan daha parlak ışığa ihtiyaç duyar.',
+  },
+  {
+    name: 'Boyutları girin',
+    text: 'Oda genişliği, uzunluğu ve tavan yüksekliğini girin. Hesaplayıcı, bunları oda indeksini ve ışık kullanım faktörünü belirlemek için kullanır.',
+  },
+  {
+    name: 'Ampul tipi ve sayısını seçin',
+    text: 'Tercih ettiğiniz ampul teknolojisini ve sahip olduğunuz armatür sayısını seçin. Hesaplayıcı, daha fazla ampule ihtiyacınız olup olmadığını söyler.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'tr',
+};
+
+export const content: ToolLocaleContent<LightingCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Ev Aydınlatma Tasarımı ve Lümen Planlaması için Tam Kılavuz',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Doğru aydınlatma, bir evi yuva haline getirir. Estetiğin ötesinde, doğru ışık miktarı ruh halini, verimliliği ve hatta göz sağlığını etkiler. <strong>Ev aydınlatma hesaplayıcımız</strong>, oda büyüklüğü, tavan yüksekliği, yüzey renkleri ve ampul tipini göz önünde bulundurarak herhangi bir oda için tam olarak kaç lümen gerektiğini belirlemenize yardımcı olur.',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '150-500', label: 'Önerilen Lüks Aralığı', icon: 'mdi:brightness-6' },
+        { value: '100 lm/W', label: 'LED Verimliliği', icon: 'mdi:lightbulb' },
+        { value: '80%', label: 'Bakım Faktörü', icon: 'mdi:tools' },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: 'Sıcak Ortam Aydınlatması',
+          description: 'Oturma odaları ve yatak odaları için ideal. Rahat bir atmosfer yaratır ve akşamları göz yorgunluğunu azaltır.',
+          icon: 'mdi:weather-night',
+          points: ['150-200 lux', 'Sıcak renk sıcaklığı (2700K)', 'Birden fazla kısılabilir kaynak'],
+        },
+        {
+          title: 'Parlak Görev Aydınlatması',
+          description: 'Mutfaklar, ofisler ve banyolar için zorunlu. Detaylı işler için net görünürlük sağlar.',
+          icon: 'mdi:white-balance-sunny',
+          points: ['300-500 lux', 'Serin beyaz (4000K)', 'Çalışma yüzeylerine odaklanmış'],
+        },
+      ],
+      columns: 2,
+    },
+    {
+      type: 'title',
+      text: 'Neden Oda Boyutları Önemli',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Işık yayılır ve mesafe ile zayıflar. 2,5 metrelik bir tavan için yeterince parlak olan bir ampul, 4 metrelik bir tavan için çok loş olabilir. Hesaplayıcı, bu durumu oda indeksi formülü kullanarak hesaba katar; formül hem zemin alanını hem de montaj yüksekliğini dikkate alarak gerçekten çalışma düzleminize ulaşan ışık miktarını tahmin eder.',
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: 'Hızlı Referans Lüks Tablosu',
+      icon: 'mdi:table',
+      badge: 'Referans',
+      html: '<ul style="margin:0;padding-left:1.2em"><li><strong>Oturma odası</strong> → 150 lux</li><li><strong>Mutfak</strong> → 300 lux</li><li><strong>Yatak odası</strong> → 100 lux</li><li><strong>Banyo</strong> → 200 lux</li><li><strong>Ofis</strong> → 500 lux</li><li><strong>Koridor</strong> → 100 lux</li></ul>',
+    },
+    {
+      type: 'summary',
+      title: 'Daha İyi Aydınlatma için Uzman İpuçları',
+      items: [
+        'Ortam, görev ve vurgu olmak üzere üç aydınlatma türünü katmanlayın.',
+        'Günün farklı saatlerinde parlaklığı ayarlamak için kısıcılar kullanın.',
+        'Uzun ömür ve düşük enerji tüketimi için LED ampuller seçin.',
+        'Gölge oluşumunu önlemek için çalışma lambalarını baskın elinizin karşı tarafına yerleştirin.',
+        'Otomatik planlama ve renk sıcaklığı değişimi için akıllı ampulleri düşünün.',
+      ],
+    },
+  ],
+  ui: {
+    sectionTitle: 'Oda Aydınlatma Hesaplayıcı',
+    labelRoomType: 'Oda tipi',
+    labelRoomWidth: 'Genişlik',
+    labelRoomLength: 'Uzunluk',
+    labelHeight: 'Tavan',
+    labelBulbType: 'Ampul',
+    labelBulbWatt: 'Güç',
+    labelFixtures: 'Armatür',
+    labelAmbient: 'Ortam',
+    btnAmbientCozy: 'Rahat',
+    btnAmbientNormal: 'Normal',
+    btnAmbientBright: 'Parlak',
+    unitMetricRoom: 'm',
+    unitImperialRoom: 'ft',
+    unitHeight: 'm',
+    unitBulbs: 'ad',
+    unitWatt: 'W',
+    unitLux: 'lux',
+    labelTargetLux: 'Hedef lüks',
+    labelCurrentLux: 'Mevcut lüks',
+    labelBulbsNeeded: 'Gerekli ampul',
+    labelRoomArea: 'Alan',
+    statusOptimal: 'Mükemmel',
+    statusInsufficient: 'Çok Loş',
+    statusExcess: 'Çok Parlak',
+    btnLiving: 'Oturma',
+    btnKitchen: 'Mutfak',
+    btnBedroom: 'Yatak',
+    btnBathroom: 'Banyo',
+    btnOffice: 'Ofis',
+    btnHallway: 'Koridor',
+    btnBulbLED: 'LED',
+    btnBulbCFL: 'CFL',
+    btnBulbHalogen: 'Halojen',
+    btnBulbIncandescent: 'Akkor',
+    btnMetric: 'M',
+    btnImperial: 'ft',
+    tipOptimal: 'Aydınlatmanız bu oda için mükemmel dengelenmiş.',
+    tipInsufficient: 'Daha fazla armatür veya daha yüksek güçte ampul ekleyin.',
+    tipExcess: 'Enerji tasarrufu için armatür azaltın veya kısın.',
+    labelManualAdjust: 'Manuel ayar',
+    labelSummary: 'Aydınlatma planınız',
+    labelTotalLumens: 'Toplam gerekli lümen',
+    labelSuggestedSetup: 'Önerilen kurulum',
+    btnExport: 'PDF İndir',
+  },
+};

package/src/tool/lightingCalculator/i18n/zh.ts

@@ -0,0 +1,213 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { LightingCalculatorUI } from '../ui';
+import { bibliography } from '../bibliography';
+
+const slug = 'how-many-lights-per-room';
+const title = '住宅照明与流明计算器';
+const description =
+  '精确计算每个房间所需的流明数和灯泡数量。选择房间类型、尺寸和灯泡类型，即可获得包含实时照度估算的专业照明方案。';
+
+const faqData = [
+  {
+    question: '客厅需要多少流明？',
+    answer:
+      '对于一般客厅，地面照度目标约为150勒克斯。将房间面积（平方米）乘以150，即可得出所需流明数。20平方米的房间大约需要3000流明。',
+  },
+  {
+    question: '勒克斯和流明有什么区别？',
+    answer:
+      '流明衡量灯泡发出的总光量。勒克斯衡量实际到达某一表面的光量。天花板较高或墙壁较暗的房间需要更多流明才能达到相同勒克斯水平，因为光线会因距离和吸收而损失。',
+  },
+  {
+    question: 'LED灯泡真的省电吗？',
+    answer:
+      '是的。LED灯泡每瓦约产生100流明，而白炽灯泡仅约15流明。10瓦LED灯泡的亮度与60瓦白炽灯泡相当，但耗电量仅为其六分之一。',
+  },
+  {
+    question: '房间颜色如何影响照明需求？',
+    answer:
+      '深色墙壁和天花板会吸收光线。在深色表面的房间中，您可能需要比标准建议多50%的流明。',
+  },
+  {
+    question: '阅读需要多少勒克斯？',
+    answer:
+      '舒适阅读需要页面照度达到300至500勒克斯。一般环境照明通常提供150至200勒克斯，因此请在阅读位置附近添加一盏台灯以补充亮度。',
+  },
+  {
+    question: 'LED灯泡可以调光吗？',
+    answer:
+      '只有标有可调光字样的LED灯泡才能调光。普通LED连接调光器时可能会闪烁或缩短寿命。安装前务必检查包装上的可调光标志。',
+  },
+];
+
+const howToData = [
+  {
+    name: '选择房间类型',
+    text: '选择房间功能。厨房和办公室比卧室或走廊需要更明亮的光线。',
+  },
+  {
+    name: '输入尺寸',
+    text: '输入房间的宽度、长度和天花板高度。计算器将据此计算室形指数和照明利用系数。',
+  },
+  {
+    name: '选择灯泡类型和数量',
+    text: '选择您偏好的灯泡技术和现有灯具数量。计算器会告诉您是否需要更多灯泡。',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'zh',
+};
+
+export const content: ToolLocaleContent<LightingCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faq: faqData,
+  bibliography,
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: '住宅照明设计与流明规划完整指南',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: '恰当的照明能把房子变成家。除了美观之外，合适的光量还会影响情绪、生产力，甚至眼睛健康。<strong>我们的住宅照明计算器</strong>会综合考虑房间大小、天花板高度、表面颜色和灯泡类型，帮助您精确计算每个房间所需的流明数。',
+    },
+    {
+      type: 'stats',
+      items: [
+        { value: '150-500', label: '推荐照度范围', icon: 'mdi:brightness-6' },
+        { value: '100 lm/W', label: 'LED效率', icon: 'mdi:lightbulb' },
+        { value: '80%', label: '维护系数', icon: 'mdi:tools' },
+      ],
+      columns: 3,
+    },
+    {
+      type: 'comparative',
+      items: [
+        {
+          title: '温馨环境照明',
+          description: '适用于客厅和卧室。营造舒适氛围，并在夜间减轻眼睛疲劳。',
+          icon: 'mdi:weather-night',
+          points: ['150-200 lux', '暖色温（2700K）', '多个可调光光源'],
+        },
+        {
+          title: '明亮任务照明',
+          description: '厨房、办公室和浴室必备。为精细工作提供清晰视野。',
+          icon: 'mdi:white-balance-sunny',
+          points: ['300-500 lux', '冷白色（4000K）', '聚焦工作台面'],
+        },
+      ],
+      columns: 2,
+    },
+    {
+      type: 'title',
+      text: '为什么房间尺寸很重要',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: '光线会随着距离扩散而减弱。一盏在2.5米天花板下足够明亮的灯泡，在4米天花板下可能显得太暗。计算器通过室形指数公式来考虑这一点，该公式同时参考地板面积和安装高度，以估算实际到达工作面的光量。',
+    },
+    {
+      type: 'diagnostic',
+      variant: 'info',
+      title: '快速参考照度表',
+      icon: 'mdi:table',
+      badge: '参考',
+      html: '<ul style="margin:0;padding-left:1.2em"><li><strong>客厅</strong> → 150 lux</li><li><strong>厨房</strong> → 300 lux</li><li><strong>卧室</strong> → 100 lux</li><li><strong>浴室</strong> → 200 lux</li><li><strong>办公室</strong> → 500 lux</li><li><strong>走廊</strong> → 100 lux</li></ul>',
+    },
+    {
+      type: 'summary',
+      title: '优化照明的专业建议',
+      items: [
+        '将三种照明叠加使用：环境照明、任务照明和重点照明。',
+        '使用调光器根据不同时间段调整亮度。',
+        '选择LED灯泡，寿命长且耗电低。',
+        '将台灯放在惯用手的另一侧，可避免阴影。',
+        '考虑使用智能灯泡，实现自动定时和色温变化。',
+      ],
+    },
+  ],
+  ui: {
+    sectionTitle: '房间照明计算器',
+    labelRoomType: '房间类型',
+    labelRoomWidth: '宽度',
+    labelRoomLength: '长度',
+    labelHeight: '天花板',
+    labelBulbType: '灯泡',
+    labelBulbWatt: '功率',
+    labelFixtures: '灯具',
+    labelAmbient: '氛围',
+    btnAmbientCozy: '温馨',
+    btnAmbientNormal: '普通',
+    btnAmbientBright: '明亮',
+    unitMetricRoom: 'm',
+    unitImperialRoom: 'ft',
+    unitHeight: 'm',
+    unitBulbs: '个',
+    unitWatt: 'W',
+    unitLux: 'lux',
+    labelTargetLux: '目标照度',
+    labelCurrentLux: '当前照度',
+    labelBulbsNeeded: '所需灯泡',
+    labelRoomArea: '面积',
+    statusOptimal: '完美',
+    statusInsufficient: '太暗',
+    statusExcess: '太亮',
+    btnLiving: '客厅',
+    btnKitchen: '厨房',
+    btnBedroom: '卧室',
+    btnBathroom: '浴室',
+    btnOffice: '办公室',
+    btnHallway: '走廊',
+    btnBulbLED: 'LED',
+    btnBulbCFL: 'CFL',
+    btnBulbHalogen: '卤素',
+    btnBulbIncandescent: '白炽',
+    btnMetric: 'M',
+    btnImperial: 'ft',
+    tipOptimal: '该房间的照明平衡完美。',
+    tipInsufficient: '请增加灯具或更换更高瓦数的灯泡。',
+    tipExcess: '减少灯具或调光以节省能源。',
+    labelManualAdjust: '手动调整',
+    labelSummary: '您的照明方案',
+    labelTotalLumens: '所需总流明',
+    labelSuggestedSetup: '推荐配置',
+    btnExport: '导出PDF',
+  },
+};

package/src/tool/lightingCalculator/index.ts

@@ -0,0 +1,9 @@
+import type { ToolDefinition } from '../../types';
+import { lightingCalculator } from './entry';
+export * from './entry';
+export const LIGHTING_CALCULATOR_TOOL: ToolDefinition = {
+  entry: lightingCalculator,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/lightingCalculator/logic.ts

@@ -0,0 +1,119 @@
+export interface LightingInput {
+  roomWidthM: number;
+  roomLengthM: number;
+  roomHeightM: number;
+  roomType: string;
+  bulbType: string;
+  bulbWatt: number;
+  fixtures: number;
+  luxMultiplier: number;
+}
+
+export interface LightingResult {
+  roomArea: number;
+  targetLux: number;
+  requiredLumens: number;
+  bulbLumens: number;
+  currentLux: number;
+  bulbsNeeded: number;
+  optimalBulbs: number;
+  optimalWatt: number;
+  utilizationFactor: number;
+  status: 'optimal' | 'insufficient' | 'excess';
+  luxRatio: number;
+  sensoryContext: string;
+  suggestedProducts: string;
+}
+
+const LUX_TARGETS: Record<string, number> = {
+  living: 150,
+  kitchen: 300,
+  bedroom: 100,
+  bathroom: 200,
+  office: 500,
+  hallway: 100,
+};
+
+const LUMENS_PER_WATT: Record<string, number> = {
+  led: 100,
+  cfl: 60,
+  halogen: 20,
+  incandescent: 15,
+};
+
+const UF_MAP: Record<string, number> = {
+  low: 0.55,
+  medium: 0.50,
+  high: 0.45,
+};
+
+function getUF(roomHeightM: number): number {
+  if (roomHeightM <= 2.5) return UF_MAP.low;
+  if (roomHeightM <= 3.5) return UF_MAP.medium;
+  return UF_MAP.high;
+}
+
+function getSensoryContext(currentLux: number, targetLux: number): string {
+  const ratio = targetLux > 0 ? currentLux / targetLux : 0;
+  if (ratio < 0.3) return 'Like a dark corridor. You need significantly more light.';
+  if (ratio < 0.6) return 'Like a dim restaurant. Good for atmosphere, but not for daily tasks.';
+  if (ratio < 0.9) return 'Getting there. Like a cozy evening, but slightly too dark for comfort.';
+  if (ratio <= 1.3) return 'Perfectly balanced. Like a comfortable living room during the day.';
+  if (ratio <= 1.8) return 'Bright and energetic. Like a well-lit office or kitchen.';
+  return 'Very intense. Like a hospital or studio. Consider dimming for comfort.';
+}
+
+function getSuggestedProducts(
+  bulbsNeeded: number,
+  bulbType: string,
+  optimalWatt: number,
+): string {
+  const typeName = bulbType.toUpperCase();
+  const watt = Math.round(optimalWatt);
+  return `${bulbsNeeded} x ${typeName} ${watt}W bulbs ≈ ${bulbsNeeded * watt * (LUMENS_PER_WATT[bulbType] ?? 100)} lumens total`;
+}
+
+function getStatus(currentLux: number, targetLux: number): 'optimal' | 'insufficient' | 'excess' {
+  if (currentLux < targetLux * 0.9) return 'insufficient';
+  if (currentLux > targetLux * 1.3) return 'excess';
+  return 'optimal';
+}
+
+function getLuxRatio(currentLux: number, targetLux: number): number {
+  return targetLux > 0 ? currentLux / targetLux : 0;
+}
+
+function computeLighting(i: LightingInput) {
+  const roomArea = i.roomWidthM * i.roomLengthM;
+  const baseLux = LUX_TARGETS[i.roomType] ?? 150;
+  const targetLux = Math.round(baseLux * i.luxMultiplier);
+  const utilizationFactor = getUF(i.roomHeightM);
+  const maintenanceFactor = 0.8;
+  const requiredLumens = Math.ceil((targetLux * roomArea) / (utilizationFactor * maintenanceFactor));
+  const bulbLumens = i.bulbWatt * (LUMENS_PER_WATT[i.bulbType] ?? 100);
+  const currentLumens = bulbLumens * i.fixtures;
+  const currentLux = Math.round(currentLumens * utilizationFactor * maintenanceFactor / roomArea);
+  const bulbsNeeded = Math.ceil(requiredLumens / (bulbLumens || 1));
+  const optimalBulbs = bulbsNeeded;
+  const optimalWatt = Math.ceil(requiredLumens / (optimalBulbs * (LUMENS_PER_WATT[i.bulbType] ?? 100)));
+  return {
+    roomArea, targetLux, requiredLumens, bulbLumens, currentLux,
+    bulbsNeeded, optimalBulbs, optimalWatt, utilizationFactor,
+  };
+}
+
+export function calculateLighting(i: LightingInput): LightingResult {
+  const c = computeLighting(i);
+  const luxRatio = getLuxRatio(c.currentLux, c.targetLux);
+  const status = getStatus(c.currentLux, c.targetLux);
+  return {
+    ...c,
+    status,
+    luxRatio,
+    sensoryContext: getSensoryContext(c.currentLux, c.targetLux),
+    suggestedProducts: getSuggestedProducts(c.optimalBulbs, i.bulbType, c.optimalWatt),
+  };
+}
+
+export function fmt0(n: number): string { return String(Math.round(n)); }
+export function fmt1(n: number): string { return n.toFixed(1); }

package/src/tool/lightingCalculator/seo.astro

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

package/src/tool/lightingCalculator/state.ts

@@ -0,0 +1,113 @@
+import { calculateLighting } from './logic';
+import type { LightingInput, LightingResult } from './logic';
+
+const LS_KEY = 'lighting-calc';
+
+export interface State {
+  unitSys: 'metric' | 'imperial';
+  roomType: string;
+  bulbType: string;
+  luxMultiplier: number;
+}
+
+export const defaultState: State = {
+  unitSys: 'metric',
+  roomType: 'living',
+  bulbType: 'led',
+  luxMultiplier: 1,
+};
+
+export function loadState(): State {
+  const s = localStorage.getItem(LS_KEY);
+  if (!s) return { ...defaultState };
+  try {
+    const v = JSON.parse(s);
+    return {
+      unitSys: v.unit || defaultState.unitSys,
+      roomType: v.room || defaultState.roomType,
+      bulbType: v.bulb || defaultState.bulbType,
+      luxMultiplier: typeof v.ambient === 'number' ? v.ambient : defaultState.luxMultiplier,
+    };
+  } catch {
+    return { ...defaultState };
+  }
+}
+
+export function saveState(
+  st: State,
+  getNum: (id: string) => number,
+) {
+  const v = {
+    unit: st.unitSys,
+    room: st.roomType,
+    bulb: st.bulbType,
+    ambient: st.luxMultiplier,
+    w: getNum('lc-w'),
+    l: getNum('lc-l'),
+    h: getNum('lc-h'),
+    bw: getNum('lc-bw'),
+    f: getNum('lc-f'),
+  };
+  localStorage.setItem(LS_KEY, JSON.stringify(v));
+}
+
+export function restoreInputs(
+  getNum: (id: string) => number,
+  setVal: (id: string, v: string) => void,
+) {
+  const s = localStorage.getItem(LS_KEY);
+  if (!s) return;
+  try {
+    const v = JSON.parse(s);
+    const ids = ['lc-w', 'lc-l', 'lc-h', 'lc-bw', 'lc-f'];
+    const keys = ['w', 'l', 'h', 'bw', 'f'];
+    ids.forEach((id, i) => {
+      if (v[keys[i]] !== undefined) setVal(id, String(v[keys[i]]));
+    });
+  } catch {}
+}
+
+export function factors(unitSys: 'metric' | 'imperial') {
+  return unitSys === 'metric'
+    ? { rm: 1, hm: 1 }
+    : { rm: 0.3048, hm: 0.3048 };
+}
+
+export function runCalc(
+  st: State,
+  getNum: (id: string) => number,
+): LightingResult {
+  const f = factors(st.unitSys);
+  const input: LightingInput = {
+    roomWidthM: getNum('lc-w') * f.rm,
+    roomLengthM: getNum('lc-l') * f.rm,
+    roomHeightM: getNum('lc-h') * f.hm,
+    roomType: st.roomType,
+    bulbType: st.bulbType,
+    bulbWatt: getNum('lc-bw'),
+    fixtures: getNum('lc-f'),
+    luxMultiplier: st.luxMultiplier,
+  };
+  return calculateLighting(input);
+}
+
+export function updateUnitLabels(
+  unitSys: 'metric' | 'imperial',
+  setTxt: (id: string, v: string) => void,
+) {
+  const isM = unitSys === 'metric';
+  setTxt('lc-w-u', isM ? 'm' : 'ft');
+  setTxt('lc-l-u', isM ? 'm' : 'ft');
+  setTxt('lc-h-u', isM ? 'm' : 'ft');
+}
+
+export function convertValue(
+  id: string,
+  getNum: (id: string) => number,
+  setVal: (id: string, v: string) => void,
+  toMetric: boolean,
+) {
+  const factor = toMetric ? 0.3048 : 1 / 0.3048;
+  const v = getNum(id);
+  setVal(id, String(Math.round(v * factor * 10) / 10));
+}