@jjlmoya/utils-diy 1.3.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/package.json +2 -1
  2. package/src/category/i18n/de.ts +12 -0
  3. package/src/category/i18n/id.ts +12 -0
  4. package/src/category/i18n/it.ts +12 -0
  5. package/src/category/i18n/ja.ts +12 -0
  6. package/src/category/i18n/ko.ts +12 -0
  7. package/src/category/i18n/nl.ts +12 -0
  8. package/src/category/i18n/pl.ts +12 -0
  9. package/src/category/i18n/pt.ts +12 -0
  10. package/src/category/i18n/ru.ts +12 -0
  11. package/src/category/i18n/sv.ts +12 -0
  12. package/src/category/i18n/tr.ts +12 -0
  13. package/src/category/i18n/zh.ts +12 -0
  14. package/src/category/index.ts +13 -1
  15. package/src/index.ts +1 -1
  16. package/src/tests/category_validation.test.ts +18 -0
  17. package/src/tests/faq_count.test.ts +1 -1
  18. package/src/tests/i18n_coverage.test.ts +36 -0
  19. package/src/tests/locale_completeness.test.ts +2 -2
  20. package/src/tests/seo_length.test.ts +3 -0
  21. package/src/tests/slug_language_code_format.test.ts +23 -0
  22. package/src/tests/slug_uniqueness.test.ts +81 -0
  23. package/src/tool/balusterCalculator/i18n/de.ts +264 -0
  24. package/src/tool/balusterCalculator/i18n/id.ts +264 -0
  25. package/src/tool/balusterCalculator/i18n/it.ts +264 -0
  26. package/src/tool/balusterCalculator/i18n/ja.ts +264 -0
  27. package/src/tool/balusterCalculator/i18n/ko.ts +264 -0
  28. package/src/tool/balusterCalculator/i18n/nl.ts +264 -0
  29. package/src/tool/balusterCalculator/i18n/pl.ts +264 -0
  30. package/src/tool/balusterCalculator/i18n/pt.ts +264 -0
  31. package/src/tool/balusterCalculator/i18n/ru.ts +264 -0
  32. package/src/tool/balusterCalculator/i18n/sv.ts +264 -0
  33. package/src/tool/balusterCalculator/i18n/tr.ts +264 -0
  34. package/src/tool/balusterCalculator/i18n/zh.ts +264 -0
  35. package/src/tool/balusterCalculator/index.ts +15 -7
  36. package/src/tool/clayCalculator/i18n/de.ts +183 -0
  37. package/src/tool/clayCalculator/i18n/id.ts +183 -0
  38. package/src/tool/clayCalculator/i18n/it.ts +183 -0
  39. package/src/tool/clayCalculator/i18n/ja.ts +182 -0
  40. package/src/tool/clayCalculator/i18n/ko.ts +183 -0
  41. package/src/tool/clayCalculator/i18n/nl.ts +183 -0
  42. package/src/tool/clayCalculator/i18n/pl.ts +183 -0
  43. package/src/tool/clayCalculator/i18n/pt.ts +183 -0
  44. package/src/tool/clayCalculator/i18n/ru.ts +183 -0
  45. package/src/tool/clayCalculator/i18n/sv.ts +183 -0
  46. package/src/tool/clayCalculator/i18n/tr.ts +183 -0
  47. package/src/tool/clayCalculator/i18n/zh.ts +183 -0
  48. package/src/tool/clayCalculator/index.ts +15 -7
  49. package/src/tool/concreteCalculator/i18n/de.ts +201 -0
  50. package/src/tool/concreteCalculator/i18n/id.ts +201 -0
  51. package/src/tool/concreteCalculator/i18n/it.ts +201 -0
  52. package/src/tool/concreteCalculator/i18n/ja.ts +201 -0
  53. package/src/tool/concreteCalculator/i18n/ko.ts +201 -0
  54. package/src/tool/concreteCalculator/i18n/nl.ts +201 -0
  55. package/src/tool/concreteCalculator/i18n/pl.ts +201 -0
  56. package/src/tool/concreteCalculator/i18n/pt.ts +201 -0
  57. package/src/tool/concreteCalculator/i18n/ru.ts +201 -0
  58. package/src/tool/concreteCalculator/i18n/sv.ts +201 -0
  59. package/src/tool/concreteCalculator/i18n/tr.ts +201 -0
  60. package/src/tool/concreteCalculator/i18n/zh.ts +201 -0
  61. package/src/tool/concreteCalculator/index.ts +17 -5
  62. package/src/tool/cutOptimizer/i18n/de.ts +178 -0
  63. package/src/tool/cutOptimizer/i18n/id.ts +178 -0
  64. package/src/tool/cutOptimizer/i18n/it.ts +178 -0
  65. package/src/tool/cutOptimizer/i18n/ja.ts +178 -0
  66. package/src/tool/cutOptimizer/i18n/ko.ts +178 -0
  67. package/src/tool/cutOptimizer/i18n/nl.ts +178 -0
  68. package/src/tool/cutOptimizer/i18n/pl.ts +178 -0
  69. package/src/tool/cutOptimizer/i18n/pt.ts +178 -0
  70. package/src/tool/cutOptimizer/i18n/ru.ts +178 -0
  71. package/src/tool/cutOptimizer/i18n/sv.ts +178 -0
  72. package/src/tool/cutOptimizer/i18n/tr.ts +178 -0
  73. package/src/tool/cutOptimizer/i18n/zh.ts +178 -0
  74. package/src/tool/cutOptimizer/index.ts +17 -5
  75. package/src/tool/drillCalculator/i18n/de.ts +137 -0
  76. package/src/tool/drillCalculator/i18n/id.ts +137 -0
  77. package/src/tool/drillCalculator/i18n/it.ts +137 -0
  78. package/src/tool/drillCalculator/i18n/ja.ts +137 -0
  79. package/src/tool/drillCalculator/i18n/ko.ts +137 -0
  80. package/src/tool/drillCalculator/i18n/nl.ts +137 -0
  81. package/src/tool/drillCalculator/i18n/pl.ts +137 -0
  82. package/src/tool/drillCalculator/i18n/pt.ts +137 -0
  83. package/src/tool/drillCalculator/i18n/ru.ts +137 -0
  84. package/src/tool/drillCalculator/i18n/sv.ts +137 -0
  85. package/src/tool/drillCalculator/i18n/tr.ts +137 -0
  86. package/src/tool/drillCalculator/i18n/zh.ts +137 -0
  87. package/src/tool/drillCalculator/index.ts +17 -5
  88. package/src/tool/drillSharpener/i18n/de.ts +120 -0
  89. package/src/tool/drillSharpener/i18n/id.ts +120 -0
  90. package/src/tool/drillSharpener/i18n/it.ts +120 -0
  91. package/src/tool/drillSharpener/i18n/ja.ts +120 -0
  92. package/src/tool/drillSharpener/i18n/ko.ts +120 -0
  93. package/src/tool/drillSharpener/i18n/nl.ts +120 -0
  94. package/src/tool/drillSharpener/i18n/pl.ts +120 -0
  95. package/src/tool/drillSharpener/i18n/pt.ts +120 -0
  96. package/src/tool/drillSharpener/i18n/ru.ts +120 -0
  97. package/src/tool/drillSharpener/i18n/sv.ts +120 -0
  98. package/src/tool/drillSharpener/i18n/tr.ts +120 -0
  99. package/src/tool/drillSharpener/i18n/zh.ts +120 -0
  100. package/src/tool/drillSharpener/index.ts +17 -5
  101. package/src/tool/epoxyCalculator/i18n/de.ts +118 -0
  102. package/src/tool/epoxyCalculator/i18n/id.ts +118 -0
  103. package/src/tool/epoxyCalculator/i18n/it.ts +118 -0
  104. package/src/tool/epoxyCalculator/i18n/ja.ts +118 -0
  105. package/src/tool/epoxyCalculator/i18n/ko.ts +118 -0
  106. package/src/tool/epoxyCalculator/i18n/nl.ts +118 -0
  107. package/src/tool/epoxyCalculator/i18n/pl.ts +118 -0
  108. package/src/tool/epoxyCalculator/i18n/pt.ts +118 -0
  109. package/src/tool/epoxyCalculator/i18n/ru.ts +118 -0
  110. package/src/tool/epoxyCalculator/i18n/sv.ts +118 -0
  111. package/src/tool/epoxyCalculator/i18n/tr.ts +118 -0
  112. package/src/tool/epoxyCalculator/i18n/zh.ts +118 -0
  113. package/src/tool/epoxyCalculator/index.ts +15 -7
  114. package/src/tool/furnitureFit/i18n/de.ts +113 -0
  115. package/src/tool/furnitureFit/i18n/id.ts +113 -0
  116. package/src/tool/furnitureFit/i18n/it.ts +113 -0
  117. package/src/tool/furnitureFit/i18n/ja.ts +113 -0
  118. package/src/tool/furnitureFit/i18n/ko.ts +113 -0
  119. package/src/tool/furnitureFit/i18n/nl.ts +113 -0
  120. package/src/tool/furnitureFit/i18n/pl.ts +113 -0
  121. package/src/tool/furnitureFit/i18n/pt.ts +113 -0
  122. package/src/tool/furnitureFit/i18n/ru.ts +113 -0
  123. package/src/tool/furnitureFit/i18n/sv.ts +113 -0
  124. package/src/tool/furnitureFit/i18n/tr.ts +113 -0
  125. package/src/tool/furnitureFit/i18n/zh.ts +113 -0
  126. package/src/tool/furnitureFit/index.ts +17 -5
  127. package/src/tool/mortarCalculator/i18n/de.ts +129 -0
  128. package/src/tool/mortarCalculator/i18n/id.ts +129 -0
  129. package/src/tool/mortarCalculator/i18n/it.ts +129 -0
  130. package/src/tool/mortarCalculator/i18n/ja.ts +129 -0
  131. package/src/tool/mortarCalculator/i18n/ko.ts +129 -0
  132. package/src/tool/mortarCalculator/i18n/nl.ts +129 -0
  133. package/src/tool/mortarCalculator/i18n/pl.ts +129 -0
  134. package/src/tool/mortarCalculator/i18n/pt.ts +129 -0
  135. package/src/tool/mortarCalculator/i18n/ru.ts +129 -0
  136. package/src/tool/mortarCalculator/i18n/sv.ts +129 -0
  137. package/src/tool/mortarCalculator/i18n/tr.ts +129 -0
  138. package/src/tool/mortarCalculator/i18n/zh.ts +129 -0
  139. package/src/tool/mortarCalculator/index.ts +17 -5
  140. package/src/tool/passepartoutCalculator/i18n/de.ts +108 -0
  141. package/src/tool/passepartoutCalculator/i18n/id.ts +108 -0
  142. package/src/tool/passepartoutCalculator/i18n/it.ts +108 -0
  143. package/src/tool/passepartoutCalculator/i18n/ja.ts +108 -0
  144. package/src/tool/passepartoutCalculator/i18n/ko.ts +108 -0
  145. package/src/tool/passepartoutCalculator/i18n/nl.ts +108 -0
  146. package/src/tool/passepartoutCalculator/i18n/pl.ts +108 -0
  147. package/src/tool/passepartoutCalculator/i18n/pt.ts +108 -0
  148. package/src/tool/passepartoutCalculator/i18n/ru.ts +108 -0
  149. package/src/tool/passepartoutCalculator/i18n/sv.ts +108 -0
  150. package/src/tool/passepartoutCalculator/i18n/tr.ts +108 -0
  151. package/src/tool/passepartoutCalculator/i18n/zh.ts +108 -0
  152. package/src/tool/passepartoutCalculator/index.ts +17 -5
  153. package/src/tool/stairCalculator/i18n/de.ts +144 -0
  154. package/src/tool/stairCalculator/i18n/id.ts +144 -0
  155. package/src/tool/stairCalculator/i18n/it.ts +144 -0
  156. package/src/tool/stairCalculator/i18n/ja.ts +144 -0
  157. package/src/tool/stairCalculator/i18n/ko.ts +144 -0
  158. package/src/tool/stairCalculator/i18n/nl.ts +144 -0
  159. package/src/tool/stairCalculator/i18n/pl.ts +144 -0
  160. package/src/tool/stairCalculator/i18n/pt.ts +144 -0
  161. package/src/tool/stairCalculator/i18n/ru.ts +144 -0
  162. package/src/tool/stairCalculator/i18n/sv.ts +144 -0
  163. package/src/tool/stairCalculator/i18n/tr.ts +144 -0
  164. package/src/tool/stairCalculator/i18n/zh.ts +144 -0
  165. package/src/tool/stairCalculator/index.ts +17 -5
  166. package/src/tool/thermalExpansionCalculator/i18n/de.ts +132 -0
  167. package/src/tool/thermalExpansionCalculator/i18n/id.ts +130 -0
  168. package/src/tool/thermalExpansionCalculator/i18n/it.ts +130 -0
  169. package/src/tool/thermalExpansionCalculator/i18n/ja.ts +130 -0
  170. package/src/tool/thermalExpansionCalculator/i18n/ko.ts +130 -0
  171. package/src/tool/thermalExpansionCalculator/i18n/nl.ts +130 -0
  172. package/src/tool/thermalExpansionCalculator/i18n/pl.ts +130 -0
  173. package/src/tool/thermalExpansionCalculator/i18n/pt.ts +130 -0
  174. package/src/tool/thermalExpansionCalculator/i18n/ru.ts +130 -0
  175. package/src/tool/thermalExpansionCalculator/i18n/sv.ts +130 -0
  176. package/src/tool/thermalExpansionCalculator/i18n/tr.ts +130 -0
  177. package/src/tool/thermalExpansionCalculator/i18n/zh.ts +130 -0
  178. package/src/tool/thermalExpansionCalculator/index.ts +17 -5
  179. package/src/tool/voltageDropCalculator/i18n/de.ts +112 -0
  180. package/src/tool/voltageDropCalculator/i18n/id.ts +110 -0
  181. package/src/tool/voltageDropCalculator/i18n/it.ts +110 -0
  182. package/src/tool/voltageDropCalculator/i18n/ja.ts +110 -0
  183. package/src/tool/voltageDropCalculator/i18n/ko.ts +110 -0
  184. package/src/tool/voltageDropCalculator/i18n/nl.ts +110 -0
  185. package/src/tool/voltageDropCalculator/i18n/pl.ts +110 -0
  186. package/src/tool/voltageDropCalculator/i18n/pt.ts +110 -0
  187. package/src/tool/voltageDropCalculator/i18n/ru.ts +110 -0
  188. package/src/tool/voltageDropCalculator/i18n/sv.ts +110 -0
  189. package/src/tool/voltageDropCalculator/i18n/tr.ts +110 -0
  190. package/src/tool/voltageDropCalculator/i18n/zh.ts +110 -0
  191. package/src/tool/voltageDropCalculator/index.ts +17 -5
  192. package/src/tools.ts +2 -0
  193. package/src/types.ts +1 -1
@@ -0,0 +1,264 @@
1
+ import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
2
+ import type { ToolLocaleContent } from '../../../types';
3
+ import type { BalusterCalculatorUI } from '../ui';
4
+
5
+ const slug = 'kalkulator-tralek';
6
+ const title = 'Kalkulator Tralek: Dokładne Rozmieszczenie dla Barierek';
7
+ const description =
8
+ 'Oblicz dokładny odstęp między szczeblami lub tralkami barierek zgodnie z normą 10 cm. Automatyczne plany.';
9
+
10
+ const faqData = [
11
+ {
12
+ question: 'Jaka jest maksymalna legalna odległość między tralkami?',
13
+ answer:
14
+ 'W większości międzynarodowych przepisów budowlanych wolna przestrzeń między elementami barierki nie powinna pozwalać na przejście sfery o średnicy 10 cm, aby zapobiec wypadkom z udziałem dzieci.',
15
+ },
16
+ {
17
+ question: 'Jak mierzy się odstępy: między środkami czy prześwity?',
18
+ answer:
19
+ "Nasz kalkulator podaje obie wartości. 'Prześwit' to rzeczywista luka między szczeblami (kluczowa dla bezpieczeństwa), natomiast 'odległość między środkami' (on-center) wyznacza miejsca wiercenia lub mocowania każdej tralki.",
20
+ },
21
+ {
22
+ question: 'Co jeśli podział nie jest dokładny?',
23
+ answer:
24
+ 'Kalkulator automatycznie dostosowuje liczbę szczebli, aby pierwsza i ostatnia luka były identyczne, gwarantując symetrię wizualną i ścisłe przestrzeganie maksymalnego dozwolonego prześwitu.',
25
+ },
26
+ {
27
+ question: 'Lepiej spawać czy przykręcać tralki?',
28
+ answer:
29
+ 'To zależy od materiału. W przypadku stali spawanie zapewnia maksymalną sztywność konstrukcyjną. W drewnie lub aluminium stosuje się kotwy mechaniczne lub śruby przelotowe. Ważne jest, aby barierka wytrzymała siłę poziomą co najmniej 0,8 kN/m.',
30
+ },
31
+ ];
32
+
33
+ const howToData = [
34
+ {
35
+ name: 'Zmierz długość całkowitą',
36
+ text: 'Zmierzy dokładną odległość między pierwszym a ostatnim słupkiem, gdzie zostanie zainstalowana barierka.',
37
+ },
38
+ {
39
+ name: 'Określ grubość tralki',
40
+ text: 'Zmierz szerokość pojedynczego szczebla (np. 2x2 cm dla profilu kwadratowego lub średnicę, jeśli jest okrągły).',
41
+ },
42
+ {
43
+ name: 'Ustal maksymalny prześwit',
44
+ text: 'Wskaż maksymalną pożądaną separację (zalecane 10 cm dla zachowania norm).',
45
+ },
46
+ {
47
+ name: 'Pobierz oznaczenia montażowe',
48
+ text: 'Sprawdź listę dokładnych pozycji do wiercenia otworów, aby zapewnić symetryczny i bezpieczny rozkład.',
49
+ },
50
+ ];
51
+
52
+ const faqSchema: WithContext<FAQPage> = {
53
+ '@context': 'https://schema.org',
54
+ '@type': 'FAQPage',
55
+ mainEntity: faqData.map((item) => ({
56
+ '@type': 'Question',
57
+ name: item.question,
58
+ acceptedAnswer: { '@type': 'Answer', text: item.answer },
59
+ })),
60
+ };
61
+
62
+ const howToSchema: WithContext<HowToThing> = {
63
+ '@context': 'https://schema.org',
64
+ '@type': 'HowTo',
65
+ name: title,
66
+ description,
67
+ step: howToData.map((step, i) => ({
68
+ '@type': 'HowToStep',
69
+ position: i + 1,
70
+ name: step.name,
71
+ text: step.text,
72
+ })),
73
+ };
74
+
75
+ const appSchema: WithContext<SoftwareApplication> = {
76
+ '@context': 'https://schema.org',
77
+ '@type': 'SoftwareApplication',
78
+ name: title,
79
+ description,
80
+ applicationCategory: 'UtilityApplication',
81
+ operatingSystem: 'All',
82
+ offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
83
+ inLanguage: 'pl',
84
+ };
85
+
86
+ export const content: ToolLocaleContent<BalusterCalculatorUI> = {
87
+ slug,
88
+ title,
89
+ description,
90
+ faqTitle: 'Często Zadawane Pytania',
91
+ faq: faqData,
92
+ bibliographyTitle: 'Referencje Techniczne',
93
+ bibliography: [
94
+ {
95
+ name: 'Prawo Budowlane (Polska)',
96
+ url: 'https://isap.sejm.gov.pl/',
97
+ },
98
+ {
99
+ name: 'IRC - International Residential Code (USA)',
100
+ url: 'https://codes.iccsafe.org/content/IRC2021',
101
+ },
102
+ {
103
+ name: 'IBC - International Building Code',
104
+ url: 'https://codes.iccsafe.org/content/IBC2021',
105
+ },
106
+ ],
107
+ howTo: howToData,
108
+ schemas: [faqSchema, howToSchema, appSchema],
109
+ seo: [
110
+ {
111
+ type: 'title',
112
+ text: 'Ostateczny Przewodnik: Jak Obliczyć Rozstaw Tralek w Barierkach',
113
+ level: 2,
114
+ },
115
+ {
116
+ type: 'paragraph',
117
+ html: 'Projektowanie bezpiecznej i estetycznie doskonałej barierki to sztuka łącząca precyzję matematyczną z przepisami budowlanymi. Czy to na taras, balkon czy schody wewnętrzne, prawidłowe obliczenie tralek (lub szczebli) jest najbardziej krytycznym krokiem projektu. Błąd w obliczeniach nie tylko psuje symetrię wizualną, ale może sprawić, że Twoja konstrukcja będzie nielegalna i niebezpieczna.',
118
+ },
119
+ {
120
+ type: 'card',
121
+ icon: 'mdi:alert-circle-outline',
122
+ title: 'Dlaczego to obliczenie jest takie ważne?',
123
+ html: '<p>Nie chodzi tylko o "wypełnienie luki". Chodzi o przestrzeganie <strong>Zasady Sfery 4 Cali (10 cm)</strong>, międzynarodowej normy bezpieczeństwa zaprojektowanej w celu zapobiegania wypadkom dzieci.</p>',
124
+ },
125
+ {
126
+ type: 'title',
127
+ text: '1. Przepisy Bezpieczeństwa: Zasada 10 cm',
128
+ level: 3,
129
+ },
130
+ {
131
+ type: 'paragraph',
132
+ html: 'Zanim przetniesz pierwszy kawałek drewna lub metalu, musisz zrozumieć "dlaczego" kryjące się za matematyką. Przepisy budowlane w wielu krajach ustalają jasną normę: <em>"Wolna przestrzeń między elementami pionowymi nie powinna pozwalać na przejście sfery o średnicy 10 cm (4 cale)."</em>',
133
+ },
134
+ {
135
+ type: 'paragraph',
136
+ html: 'Ta miara nie jest przypadkowa. Jest to średnia średnica głowy małego dziecka (zwykle poniżej 1 roku życia). Jeśli dziecko może przełożyć ciało, ale głowa utknie, ryzyko uduszenia jest bardzo wysokie. Jeśli głowa przejdzie, może spaść w przepaść. Dlatego celem naszego <strong>Kalkulatora Tralek</strong> nie jest tylko estetyka, ale ratowanie życia.',
137
+ },
138
+ {
139
+ type: 'title',
140
+ text: '2. Problem Matematyczny: Błąd Słupka Ogrodzeniowego',
141
+ level: 3,
142
+ },
143
+ {
144
+ type: 'paragraph',
145
+ html: 'W programowaniu i budownictwie istnieje klasyczny problem zwany <em>"Fencepost Error"</em> (Błąd Słupka Ogrodzeniowego). Jeśli chcesz zbudować 10-metrowy płot ze słupkami co metr, ilu słupków potrzebujesz? Intuicyjna odpowiedź to 10, ale poprawna to 11.',
146
+ },
147
+ {
148
+ type: 'paragraph',
149
+ html: 'Z tralkami dzieje się coś podobnego, ale bardziej złożonego, ponieważ szerokość samej tralki zajmuje miejsce. Formuła, której używa nasze narzędzie, rozwiązuje ten układ równań za Ciebie:',
150
+ },
151
+ {
152
+ type: 'grid',
153
+ columns: [
154
+ {
155
+ type: 'card',
156
+ icon: 'mdi:calculator',
157
+ title: 'Krok A: Obliczanie Luk',
158
+ html: '<p class="bc-formula">n = (L - g_max) / (w + g_max)</p><p>Najpierw określamy, ile tralek zmieściłoby się teoretycznie przy użyciu maksymalnej dozwolonej przestrzeni. Zaokrąglamy tę liczbę w górę, aby zapewnić, że wynikowe luki są <em>mniejsze</em> niż maksimum.</p>',
159
+ },
160
+ {
161
+ type: 'card',
162
+ icon: 'mdi:function-variant',
163
+ title: 'Krok B: Ponowne Obliczenie Dokładnego Odstępu',
164
+ html: '<p class="bc-formula">g = (L - n × w) / (n + 1)</p><p>Gdy znamy dokładną liczbę tralek (n), obliczamy ile miejsca "zostaje" po odjęciu szerokości całego materiału i dzielimy je równo między luki (n+1).</p>',
165
+ },
166
+ ],
167
+ },
168
+ {
169
+ type: 'title',
170
+ text: '3. Przewodnik Krok po Kroku dla Idealnej Instalacji',
171
+ level: 3,
172
+ },
173
+ {
174
+ type: 'paragraph',
175
+ html: 'Posiadanie liczb to tylko połowa sukcesu. Tutaj wyjaśniamy, jak przenieść te dane z papieru (lub ekranu) do rzeczywistości Twojej budowy.',
176
+ },
177
+ {
178
+ type: 'title',
179
+ text: 'Krok 1: Pomiar Precyzyjny',
180
+ level: 3,
181
+ },
182
+ {
183
+ type: 'paragraph',
184
+ html: 'Zmierz odległość <strong>wewnętrzną</strong> między słupkiem a słupkiem. Nie mierz od środka słupka. Musisz znać dokładny prześwit, który wypełnisz (L). Jeśli Twoja barierka ma kilka odcinków, zmierz każdy indywidualnie; konstrukcje rzadko są idealnie prostopadłe, a błąd 0,5 cm może zepsuć symetrię.',
185
+ },
186
+ {
187
+ type: 'title',
188
+ text: 'Krok 2: Znalezienie Środka',
189
+ level: 3,
190
+ },
191
+ {
192
+ type: 'paragraph',
193
+ html: 'Błąd numer jeden początkujących to zaczynanie rozmieszczania tralek od jednego końca do drugiego. Prawie zawsze skutkuje to ostatnią luką o dziwnym rozmiarze, co niszczy harmonię wizualną.<ul><li>Zaznacz <strong>dokładny środek</strong> barierki (L / 2).</li><li>Zdecyduj, czy na środku ma być <em>tralka</em> czy <em>luka</em>.</li><li>Jeśli chcesz tralkę na środku: zaznacz połowę szerokości tralki po obu stronach znaku środkowego.</li><li>Jeśli chcesz lukę na środku: zaznacz połowę odległości luki (g / 2) po obu stronach.</li></ul>',
194
+ },
195
+ {
196
+ type: 'title',
197
+ text: 'Krok 3: Wykonanie Szablonu (Dystansów)',
198
+ level: 3,
199
+ },
200
+ {
201
+ type: 'paragraph',
202
+ html: 'Nie używaj miarki przy każdej tralce. Skumulowany błąd ludzki sprawi, że ostatnia tralka odchyli się o kilka centymetrów. Profesjonalnym sposobem jest wycięcie klocka drewna (lub dwóch) o dokładnym wymiarze luki (g) podanym przez nasz kalkulator.',
203
+ },
204
+ {
205
+ type: 'paragraph',
206
+ html: 'Użyj tego klocka jako szablonu fizycznego. Umieść tralkę, przyłóż klocek, umieść następną tralkę dociśniętą do klocka i zamocuj ją. Gwarantuje to milimetrową spójność.',
207
+ },
208
+ {
209
+ type: 'title',
210
+ text: '4. Materiały i Potrzebne Narzędzia',
211
+ level: 3,
212
+ },
213
+ {
214
+ type: 'card',
215
+ icon: 'mdi:tools',
216
+ title: 'Wyposażenie dla profesjonalnego wykończenia',
217
+ html: '<ul><li>Miarka o wysokiej precyzji</li><li>Ołówek stolarski</li><li>Poziomica (do pionowania)</li><li>Ukośnica (do czystych cięć)</li><li>Wiertarka i wkręty do drewna</li><li>Klocki dystansowe (wykonane na wymiar)</li></ul>',
218
+ },
219
+ {
220
+ type: 'title',
221
+ text: '5. Dodatkowe Pytania Techniczne',
222
+ level: 3,
223
+ },
224
+ {
225
+ type: 'card',
226
+ icon: 'mdi:help-circle-outline',
227
+ title: 'Co jeśli ostatnia luka nie pasuje?',
228
+ html: '<p>Jeśli skorzystałeś z naszego kalkulatora, nie powinno to się zdarzyć. Jednak w świecie rzeczywistym drewno się wygina, a słupki nie zawsze są proste. Jeśli po dotarciu do końca zostanie lub zabraknie Ci 1-2 mm, jest to niezauważalne. Jeśli brakuje 1 cm, sprawdź swoje klocki dystansowe, prawdopodobnie na każdym kroku traciłeś milimetry.</p>',
229
+ },
230
+ {
231
+ type: 'card',
232
+ icon: 'mdi:shield-check-outline',
233
+ title: 'Czy mogę umieścić tralki rzadziej, jeśli nie mam dzieci?',
234
+ html: '<p>Prawnie: nie. Przepisy budowlane dotyczą domu, a nie obecnych mieszkańców. Jeśli kiedyś sprzedasz dom, barierka niezgodna z normami będzie problemem przy inspekcji. Ponadto goście (siostrzeńcy, wnuki) mogą być w niebezpieczeństwie.</p>',
235
+ },
236
+ {
237
+ type: 'card',
238
+ icon: 'mdi:wrench-outline',
239
+ title: 'Drewno, Metal czy Szkło?',
240
+ html: '<p>Ten kalkulator działa dla <strong>każdego powtarzalnego elementu pionowego</strong>. Jeśli używasz poziomych linek stalowych, przepisy są inne (zazwyczaj nie mogą pozwalać na wspinanie się, "efekt drabiny"). W przypadku szkła uważa się je za panel ciągły i nie stosuje się rozstawu, lecz odporność na uderzenia.</p>',
241
+ },
242
+ {
243
+ type: 'card',
244
+ icon: 'mdi:format-quote-close',
245
+ title: 'Mies van der Rohe',
246
+ html: '<p><em>"Architektura jest wolą epoki przełożoną na przestrzeń."</em></p><p>Mamy nadzieję, że to narzędzie pomoże Ci budować bezpieczniejsze i piękniejsze przestrzenie. Zawsze pamiętaj o sprawdzeniu lokalnych przepisów budowlanych w Twojej gminie, ponieważ mogą istnieć specyficzne warianty dotyczące minimalnej wysokości (zwykle 90-110 cm) lub obciążeń siłowych.</p>',
247
+ },
248
+ ],
249
+ ui: {
250
+ sectionTitle: 'Wymiary',
251
+ sectionDesc: 'Wprowadź wymiary swojej barierki',
252
+ labelRailLength: 'Długość Całkowita (L)',
253
+ labelBalusterWidth: 'Szerokość Tralki (w)',
254
+ labelMaxGap: 'Maksymalna Luka (g)',
255
+ blueprintTitle: 'Plan Montażu',
256
+ blueprintRef: 'REF: BAL-001 // SKALA: AUTO',
257
+ labelRequired: 'Wymagane Tralki',
258
+ labelExactGap: 'Dokładna Luka',
259
+ labelOnCenter: 'Od Środka do Środka',
260
+ labelTotalSpaces: 'Łączna Liczba Luk',
261
+ labelCoveredLength: 'Długość Pokryta',
262
+ labelDisclaimer: '* Pokazane wymiary są przybliżone do celów wizualizacji.',
263
+ },
264
+ };
@@ -0,0 +1,264 @@
1
+ import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
2
+ import type { ToolLocaleContent } from '../../../types';
3
+ import type { BalusterCalculatorUI } from '../ui';
4
+
5
+ const slug = 'calculadora-balaustres';
6
+ const title = 'Calculadora de Balaústres: Espaçamento Exato para Guardas';
7
+ const description =
8
+ 'Calcule o espaço exato entre barras ou balaústres para guardas de proteção cumprindo a norma dos 10 cm. Planos automáticos.';
9
+
10
+ const faqData = [
11
+ {
12
+ question: 'Qual é a distância máxima legal entre balaústres?',
13
+ answer:
14
+ 'Na maioria das normas internacionais, o espaço livre entre os elementos de uma guarda não deve permitir a passagem de uma esfera de 10 cm de diâmetro para evitar acidentes com crianças.',
15
+ },
16
+ {
17
+ question: 'Como se mede o espaçamento: entre centros ou vãos?',
18
+ answer:
19
+ "A nossa calculadora fornece ambos. O 'espaçamento livre' é o vão real entre barras (vital por segurança), enquanto a 'distância entre centros' (on-center) é a que marca onde furar ou fixar cada balaústre.",
20
+ },
21
+ {
22
+ question: 'O que acontece se a distribuição não for exata?',
23
+ answer:
24
+ 'A calculadora ajusta automaticamente o número de barras para que o primeiro e o último vão sejam idênticos, garantindo a simetria visual e o cumprimento estrito do vão máximo permitido.',
25
+ },
26
+ {
27
+ question: 'É melhor soldar ou aparafusar os balaústres?',
28
+ answer:
29
+ 'Depende do material. Em aço, a soldadura oferece máxima rigidez estrutural. Em madeira ou alumínio, usam-se fixações mecânicas ou parafusos passantes. O importante é que a guarda suporte uma força horizontal de pelo menos 0.8 kN/m.',
30
+ },
31
+ ];
32
+
33
+ const howToData = [
34
+ {
35
+ name: 'Medir a largura total',
36
+ text: 'Meça a distância exata entre o primeiro e o último poste onde será instalada a guarda.',
37
+ },
38
+ {
39
+ name: 'Definir a espessura do balaústre',
40
+ text: 'Meça a largura de uma barra individual (ex: 2x2 cm para tubo quadrado ou o diâmetro se for redondo).',
41
+ },
42
+ {
43
+ name: 'Estabelecer o vão máximo',
44
+ text: 'Indique a separação máxima desejada (recomendado 10 cm para cumprir a norma).',
45
+ },
46
+ {
47
+ name: 'Obter marcas de instalação',
48
+ text: 'Reveja a lista de posições exatas para realizar as furações e assegurar uma distribuição simétrica e segura.',
49
+ },
50
+ ];
51
+
52
+ const faqSchema: WithContext<FAQPage> = {
53
+ '@context': 'https://schema.org',
54
+ '@type': 'FAQPage',
55
+ mainEntity: faqData.map((item) => ({
56
+ '@type': 'Question',
57
+ name: item.question,
58
+ acceptedAnswer: { '@type': 'Answer', text: item.answer },
59
+ })),
60
+ };
61
+
62
+ const howToSchema: WithContext<HowToThing> = {
63
+ '@context': 'https://schema.org',
64
+ '@type': 'HowTo',
65
+ name: title,
66
+ description,
67
+ step: howToData.map((step, i) => ({
68
+ '@type': 'HowToStep',
69
+ position: i + 1,
70
+ name: step.name,
71
+ text: step.text,
72
+ })),
73
+ };
74
+
75
+ const appSchema: WithContext<SoftwareApplication> = {
76
+ '@context': 'https://schema.org',
77
+ '@type': 'SoftwareApplication',
78
+ name: title,
79
+ description,
80
+ applicationCategory: 'UtilityApplication',
81
+ operatingSystem: 'All',
82
+ offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
83
+ inLanguage: 'pt',
84
+ };
85
+
86
+ export const content: ToolLocaleContent<BalusterCalculatorUI> = {
87
+ slug,
88
+ title,
89
+ description,
90
+ faqTitle: 'Perguntas Frequentes',
91
+ faq: faqData,
92
+ bibliographyTitle: 'Referências Técnicas',
93
+ bibliography: [
94
+ {
95
+ name: 'RGEU - Regulamento Geral das Edificações Urbanas (Portugal)',
96
+ url: 'https://DiariodaRepublica.pt/',
97
+ },
98
+ {
99
+ name: 'IRC - International Residential Code (EUA)',
100
+ url: 'https://codes.iccsafe.org/content/IRC2021',
101
+ },
102
+ {
103
+ name: 'IBC - International Building Code',
104
+ url: 'https://codes.iccsafe.org/content/IBC2021',
105
+ },
106
+ ],
107
+ howTo: howToData,
108
+ schemas: [faqSchema, howToSchema, appSchema],
109
+ seo: [
110
+ {
111
+ type: 'title',
112
+ text: 'Guia Definitivo: Como Calcular o Espaçamento de Balaústres para Guardas',
113
+ level: 2,
114
+ },
115
+ {
116
+ type: 'paragraph',
117
+ html: 'Projetar uma guarda segura e esteticamente perfeita é uma arte que combina a precisão matemática com as normas de construção. Seja para um terraço, uma varanda ou uma escada interior, o cálculo correto dos balaústres (ou barras) é o passo mais crítico do projeto. Um erro de cálculo não só arruína a simetria visual, como pode tornar a sua estrutura ilegal e insegura.',
118
+ },
119
+ {
120
+ type: 'card',
121
+ icon: 'mdi:alert-circle-outline',
122
+ title: 'Por que é que este cálculo é tão importante?',
123
+ html: '<p>Não se trata apenas de "preencher o vazio". Trata-se de cumprir a <strong>Regra da Esfera de 4 Polegadas (10 cm)</strong>, uma norma internacional de segurança desenhada para evitar acidentes infantis.</p>',
124
+ },
125
+ {
126
+ type: 'title',
127
+ text: '1. A Normativa de Segurança: A Regra dos 10 cm',
128
+ level: 3,
129
+ },
130
+ {
131
+ type: 'paragraph',
132
+ html: 'Antes de cortar a primeira peça de madeira ou metal, deve entender o "porquê" da matemática. O Regulamento Geral das Edificações Urbanas (RGEU) em Portugal, assim como o IRC (International Residential Code) nos Estados Unidos, estabelecem uma norma clara: <em>"O espaço livre entre os elementos verticais não deve permitir a passagem de uma esfera de 10 cm (4 polegadas) de diâmetro."</em>',
133
+ },
134
+ {
135
+ type: 'paragraph',
136
+ html: 'Esta medida não é arbitrária. É o diâmetro médio da cabeça de uma criança pequena (geralmente com menos de 1 ano). Se uma criança consegue passar o corpo mas a cabeça fica presa, o risco de asfixia é altíssimo. Se conseguir passar a cabeça, pode cair no vazio. Portanto, o objetivo da nossa <strong>Calculadora de Balaústres</strong> não é apenas estético, é salvar vidas.',
137
+ },
138
+ {
139
+ type: 'title',
140
+ text: '2. O Problema Matemático: O Erro do Poste da Cerca',
141
+ level: 3,
142
+ },
143
+ {
144
+ type: 'paragraph',
145
+ html: 'Em programação e construção, existe um problema clássico chamado <em>"Fencepost Error"</em> (Erro do Poste da Cerca). Se quer construir uma vedação de 10 metros com postes a cada metro, quantos postes precisa? A resposta intuitiva é 10, mas a correta é 11.',
146
+ },
147
+ {
148
+ type: 'paragraph',
149
+ html: 'Com os balaústres ocorre algo semelhante, mas mais complexo, porque a largura do próprio balaústre ocupa espaço. A fórmula que utiliza a nossa ferramenta resolve este sistema de equações por si:',
150
+ },
151
+ {
152
+ type: 'grid',
153
+ columns: [
154
+ {
155
+ type: 'card',
156
+ icon: 'mdi:calculator',
157
+ title: 'Passo A: Calcular Vãos',
158
+ html: '<p class="bc-formula">n = (L - g_max) / (w + g_max)</p><p>Primeiro determinamos quantos balaústres cabem teoricamente se usássemos o espaço máximo permitido. Arredondamos este número para cima para assegurar que os vãos resultantes sejam <em>menores</em> que o máximo.</p>',
159
+ },
160
+ {
161
+ type: 'card',
162
+ icon: 'mdi:function-variant',
163
+ title: 'Passo B: Recalcular Espaço Exato',
164
+ html: '<p class="bc-formula">g = (L - n × w) / (n + 1)</p><p>Assim que sabemos o número exato de balaústres (n), calculamos quanto espaço "sobra" se subtrairmos a largura de todo o material, e dividimo-lo equitativamente entre os vãos (n+1).</p>',
165
+ },
166
+ ],
167
+ },
168
+ {
169
+ type: 'title',
170
+ text: '3. Guia Passo a Passo para a Instalação Perfeita',
171
+ level: 3,
172
+ },
173
+ {
174
+ type: 'paragraph',
175
+ html: 'Ter os números é apenas metade da batalha. Aqui explicamos como trasladar esses valores do papel (ou do ecrã) para a realidade da sua obra.',
176
+ },
177
+ {
178
+ type: 'title',
179
+ text: 'Passo 1: Medição de Precisão',
180
+ level: 3,
181
+ },
182
+ {
183
+ type: 'paragraph',
184
+ html: 'Meça a distância <strong>interna</strong> entre poste e poste. Não meça a partir do centro do poste. Precisa de saber o espaço luz exato que vai preencher (L). Se a sua guarda tem vários lances, meça cada um individualmente; as construções raramente são perfeitamente esquadriadas e um erro de 0.5 cm pode arruinar a simetria.',
185
+ },
186
+ {
187
+ type: 'title',
188
+ text: 'Passo 2: Encontrar o Centro',
189
+ level: 3,
190
+ },
191
+ {
192
+ type: 'paragraph',
193
+ html: 'O erro de principiante número um é começar a colocar balaústres de uma extremidade para a outra. Isto quase sempre resulta num último vão de tamanho estranho, quebrando a harmonia visual.<ul><li>Marque o <strong>centro exato</strong> da guarda (L / 2).</li><li>Decida se quer que no centro haja um <em>balaústre</em> ou um <em>vão</em>.</li><li>Se quer um balaústre no centro: marque metade da largura do balaústre para cada lado da sua marca central.</li><li>Se quer um vão no centro: marque metade da distância do vão (g / 2) para cada lado.</li></ul>',
194
+ },
195
+ {
196
+ type: 'title',
197
+ text: 'Passo 3: Fabricar um Separador (Spacers)',
198
+ level: 3,
199
+ },
200
+ {
201
+ type: 'paragraph',
202
+ html: 'Não use a fita métrica para cada balaústre. O erro humano acumulado fará com que o último balaústre esteja desviado vários centímetros. O profissional é cortar um bloco de madeira (ou dois) com a medida exata do vão (g) que lhe foi dada pela nossa calculadora.',
203
+ },
204
+ {
205
+ type: 'paragraph',
206
+ html: 'Use este bloco como molde físico. Coloque um balaústre, ponha o bloco, coloque o seguinte balaústre apertado contra o bloco, e fixe-o. Isto garante uma consistência milimétrica.',
207
+ },
208
+ {
209
+ type: 'title',
210
+ text: '4. Materiais e Ferramentas Necessárias',
211
+ level: 3,
212
+ },
213
+ {
214
+ type: 'card',
215
+ icon: 'mdi:tools',
216
+ title: 'Equipamento para um acabamento profissional',
217
+ html: '<ul><li>Fita métrica de alta precisão</li><li>Lápis de carpinteiro</li><li>Nível de bolha (para a verticalidade)</li><li>Serra de meia esquadria (para cortes limpos)</li><li>Berbequim e parafusos para madeira</li><li>Blocos separadores (feitos à medida)</li></ul>',
218
+ },
219
+ {
220
+ type: 'title',
221
+ text: '5. Perguntas Técnicas Adicionais',
222
+ level: 3,
223
+ },
224
+ {
225
+ type: 'card',
226
+ icon: 'mdi:help-circle-outline',
227
+ title: 'O que acontece se o último vão não encaixar?',
228
+ html: '<p>Se usou a nossa calculadora, isto não deveria acontecer. No entanto, no mundo real, a madeira curva e os postes não estão sempre direitos. Se ao chegar ao fim lhe sobrar ou faltar 1-2 mm, é impercetível. Se lhe faltar 1 cm, reveja os seus blocos separadores, provavelmente foi acumulando erros em cada passo.</p>',
229
+ },
230
+ {
231
+ type: 'card',
232
+ icon: 'mdi:shield-check-outline',
233
+ title: 'Posso colocar os balaústres mais separados se não tiver crianças?',
234
+ html: '<p>Legalmente, não. O código de construção aplica-se à habitação, não aos habitantes atuais. Se algum dia vender a casa, uma guarda fora da norma será um problema na inspeção. Além disso, as visitas (sobrinhos, netos) podem estar em perigo.</p>',
235
+ },
236
+ {
237
+ type: 'card',
238
+ icon: 'mdi:wrench-outline',
239
+ title: 'Madeira, Metal ou Vidro?',
240
+ html: '<p>Esta calculadora funciona para <strong>qualquer elemento vertical repetitivo</strong>. Se usar cabos de aço horizontais, a normativa é diferente (normalmente não devem permitir escalar, "efeito escada"). Para vidro, é considerado um painel contínuo e não se aplica espaçamento, mas sim resistência ao impacto.</p>',
241
+ },
242
+ {
243
+ type: 'card',
244
+ icon: 'mdi:format-quote-close',
245
+ title: 'Mies van der Rohe',
246
+ html: '<p><em>"A arquitetura é a vontade da época traduzida em espaço."</em></p><p>Esperamos que esta ferramenta o ajude a construir espaços mais seguros e belos. Lembre-se sempre de consultar o código de construção local do seu município, já que pode haver variações específicas sobre a altura mínima (geralmente 90-110 cm) ou cargas de força.</p>',
247
+ },
248
+ ],
249
+ ui: {
250
+ sectionTitle: 'Dimensões',
251
+ sectionDesc: 'Insira as medidas da sua guarda',
252
+ labelRailLength: 'Comprimento Total (L)',
253
+ labelBalusterWidth: 'Largura Balaústre (w)',
254
+ labelMaxGap: 'Vão Máximo (g)',
255
+ blueprintTitle: 'Plano de Montagem',
256
+ blueprintRef: 'REF: BAL-001 // ESCALA: AUTO',
257
+ labelRequired: 'Balaústres Necessários',
258
+ labelExactGap: 'Vão Exato',
259
+ labelOnCenter: 'Centro a Centro',
260
+ labelTotalSpaces: 'Espaços Totais',
261
+ labelCoveredLength: 'Comprimento Coberto',
262
+ labelDisclaimer: '* As dimensões mostradas são aproximadas para visualização.',
263
+ },
264
+ };