@jjlmoya/utils-games-development 1.51.0 → 1.53.0

package/src/tool/localizationSanitizer/localization-sanitizer.css

@@ -0,0 +1,634 @@
+.ls-root {
+  --ls-ink: #17202f;
+  --ls-muted: #687487;
+  --ls-line: #dce2ea;
+  --ls-panel: #fff;
+  --ls-panel-soft: #f4f7fa;
+  --ls-accent: #e56a47;
+  --ls-accent-dark: #bc4d30;
+  --ls-cyan: #19a6a0;
+  --ls-yellow: #e7a633;
+  --ls-red: #ce4f61;
+
+  width: 100%;
+  max-width: 1220px;
+  margin: 0 auto;
+  color: var(--ls-ink);
+}
+
+.theme-dark .ls-root {
+  --ls-ink: #f1f5f9;
+  --ls-muted: #a3afc0;
+  --ls-line: #273244;
+  --ls-panel: #111926;
+  --ls-panel-soft: #172232;
+  --ls-accent: #f1845d;
+  --ls-accent-dark: #da6744;
+  --ls-cyan: #42c3b8;
+  --ls-yellow: #efbd57;
+  --ls-red: #f07889;
+}
+
+.ls-root * {
+  box-sizing: border-box;
+}
+
+.ls-root button,
+.ls-root input {
+  font: inherit;
+}
+
+.ls-topline,
+.ls-format-bar,
+.ls-drop-panel,
+.ls-workbench,
+.ls-export-card {
+  border: 1px solid var(--ls-line);
+  background: var(--ls-panel);
+}
+
+.ls-topline {
+  border-bottom: 0;
+  border-radius: 18px 18px 0 0;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 1rem 1.25rem;
+}
+
+.ls-topline > div {
+  display: flex;
+  align-items: center;
+  gap: 0.85rem;
+  min-width: 0;
+}
+
+.ls-topline strong {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.ls-kicker,
+.ls-section-eyebrow {
+  color: var(--ls-accent);
+  font-size: 0.68rem;
+  font-weight: 800;
+  letter-spacing: 0.14em;
+}
+
+.ls-privacy-note,
+.ls-file-type-note,
+.ls-section-heading p,
+.ls-export-copy p,
+.ls-drop-copy span {
+  color: var(--ls-muted);
+  font-size: 0.78rem;
+}
+
+.ls-privacy-note {
+  text-align: right;
+}
+
+.ls-format-bar {
+  display: flex;
+  align-items: center;
+  gap: 0.35rem;
+  padding: 0.55rem 1.25rem;
+  background: var(--ls-panel-soft);
+}
+
+.ls-format-label {
+  color: var(--ls-muted);
+  font-size: 0.72rem;
+  font-weight: 700;
+  margin-right: auto;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+}
+
+.ls-format-button,
+.ls-button {
+  border: 0;
+  cursor: pointer;
+  transition: transform 160ms ease, background-color 160ms ease, border-color 160ms ease, color 160ms ease;
+}
+
+.ls-format-button {
+  border: 1px solid transparent;
+  border-radius: 7px;
+  background: transparent;
+  color: var(--ls-muted);
+  font-size: 0.75rem;
+  font-weight: 800;
+  padding: 0.38rem 0.8rem;
+}
+
+.ls-format-button:hover,
+.ls-format-button.is-active {
+  background: var(--ls-panel);
+  border-color: var(--ls-line);
+  color: var(--ls-accent-dark);
+}
+
+.ls-drop-panel {
+  align-items: center;
+  border-bottom: 0;
+  display: grid;
+  gap: 1rem;
+  grid-template-columns: auto 1fr auto;
+  padding: 1.2rem 1.25rem;
+}
+
+.ls-drop-panel:focus-visible,
+.ls-button:focus-visible,
+.ls-format-button:focus-visible {
+  outline: 3px solid color-mix(in srgb, var(--ls-cyan) 45%, transparent);
+  outline-offset: 2px;
+}
+
+.ls-drop-panel.is-dragging {
+  background: color-mix(in srgb, var(--ls-cyan) 12%, var(--ls-panel));
+  border-color: var(--ls-cyan);
+}
+
+.ls-drop-mark {
+  display: grid;
+  gap: 0.22rem;
+  transform: rotate(-6deg);
+}
+
+.ls-drop-mark span {
+  border: 1px solid var(--ls-accent);
+  color: var(--ls-accent-dark);
+  font-size: 0.58rem;
+  font-weight: 900;
+  letter-spacing: 0.08em;
+  padding: 0.22rem 0.36rem;
+}
+
+.ls-drop-mark span:last-child {
+  background: var(--ls-accent);
+  color: var(--ls-panel);
+  transform: translateX(0.4rem);
+}
+
+.ls-drop-copy {
+  display: grid;
+  gap: 0.22rem;
+}
+
+.ls-drop-copy strong {
+  font-size: 1rem;
+}
+
+.ls-drop-copy span {
+  display: block;
+}
+
+.ls-file-type-note {
+  color: var(--ls-cyan);
+  font-size: 0.69rem;
+  font-weight: 700;
+}
+
+.ls-drop-actions,
+.ls-export-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+}
+
+.ls-button {
+  border-radius: 8px;
+  font-size: 0.76rem;
+  font-weight: 800;
+  padding: 0.68rem 0.9rem;
+  white-space: nowrap;
+}
+
+.ls-button:hover:not(:disabled) {
+  transform: translateY(-1px);
+}
+
+.ls-button:disabled {
+  cursor: not-allowed;
+  opacity: 0.42;
+}
+
+.ls-button-primary {
+  background: var(--ls-accent);
+  color: var(--ls-panel);
+}
+
+.ls-button-primary:hover:not(:disabled) {
+  background: var(--ls-accent-dark);
+}
+
+.ls-button-quiet,
+.ls-button-outline {
+  background: transparent;
+  border: 1px solid var(--ls-line);
+  color: var(--ls-ink);
+}
+
+.ls-button-quiet:hover,
+.ls-button-outline:hover:not(:disabled) {
+  border-color: var(--ls-accent);
+  color: var(--ls-accent-dark);
+}
+
+.ls-workbench {
+  display: grid;
+  grid-template-columns: 0.8fr 1.6fr;
+}
+
+.ls-inspector,
+.ls-preview-panel {
+  min-width: 0;
+  padding: 1.35rem;
+}
+
+.ls-inspector {
+  background: var(--ls-panel-soft);
+  border-right: 1px solid var(--ls-line);
+}
+
+.ls-section-heading {
+  align-items: flex-start;
+  display: flex;
+  gap: 0.7rem;
+  margin-bottom: 1rem;
+}
+
+.ls-section-heading h2,
+.ls-export-copy h2 {
+  font-size: 1rem;
+  line-height: 1.2;
+  margin: 0.18rem 0 0;
+}
+
+.ls-section-heading p,
+.ls-export-copy p {
+  line-height: 1.5;
+  margin: 0.4rem 0 0;
+}
+
+.ls-section-index {
+  color: var(--ls-accent);
+  font-size: 0.72rem;
+  font-weight: 900;
+  padding-top: 0.16rem;
+}
+
+.ls-health-card {
+  align-items: center;
+  background: var(--ls-panel);
+  border: 1px solid var(--ls-line);
+  border-radius: 12px;
+  display: flex;
+  gap: 0.85rem;
+  padding: 0.85rem;
+}
+
+.ls-health-ring {
+  align-items: center;
+  background: conic-gradient(var(--ls-cyan) var(--health-angle, 0deg), var(--ls-line) 0deg);
+  border-radius: 50%;
+  display: flex;
+  height: 62px;
+  justify-content: center;
+  position: relative;
+  width: 62px;
+}
+
+.ls-health-ring::after {
+  background: var(--ls-panel);
+  border-radius: 50%;
+  content: '';
+  inset: 6px;
+  position: absolute;
+}
+
+.ls-health-ring span {
+  font-size: 0.95rem;
+  font-weight: 900;
+  position: relative;
+  z-index: 1;
+}
+
+.ls-health-card strong,
+.ls-health-card span:last-child {
+  display: block;
+}
+
+.ls-health-card strong {
+  font-size: 0.84rem;
+}
+
+.ls-health-card span:last-child {
+  color: var(--ls-muted);
+  font-size: 0.7rem;
+  margin-top: 0.22rem;
+}
+
+.ls-stat-list {
+  border-bottom: 1px solid var(--ls-line);
+  padding: 0.7rem 0 0.85rem;
+}
+
+.ls-stat-row {
+  align-items: center;
+  color: var(--ls-muted);
+  display: flex;
+  font-size: 0.75rem;
+  gap: 0.45rem;
+  padding: 0.3rem 0;
+}
+
+.ls-stat-row strong {
+  color: var(--ls-ink);
+  font-size: 0.82rem;
+  margin-left: auto;
+}
+
+.ls-stat-dot,
+.ls-issue-marker {
+  background: var(--ls-accent);
+  border-radius: 50%;
+  display: inline-block;
+  height: 7px;
+  width: 7px;
+}
+
+.ls-dot-duplicate {
+  background: var(--ls-red);
+}
+
+.ls-dot-malformed {
+  background: var(--ls-yellow);
+}
+
+.ls-dot-clean {
+  background: var(--ls-cyan);
+}
+
+.ls-issue-section {
+  margin-top: 1.1rem;
+}
+
+.ls-section-heading-small {
+  margin-bottom: 0.55rem;
+}
+
+.ls-section-heading-small h2 {
+  font-size: 0.84rem;
+}
+
+.ls-issue-list {
+  display: grid;
+  gap: 0.45rem;
+  max-height: 220px;
+  overflow: auto;
+}
+
+.ls-issue-card {
+  align-items: flex-start;
+  background: var(--ls-panel);
+  border: 1px solid var(--ls-line);
+  border-left: 3px solid var(--ls-accent);
+  border-radius: 7px;
+  display: flex;
+  gap: 0.55rem;
+  padding: 0.55rem 0.6rem;
+}
+
+.ls-issue-duplicate {
+  border-left-color: var(--ls-red);
+}
+
+.ls-issue-malformed {
+  border-left-color: var(--ls-yellow);
+}
+
+.ls-issue-parse {
+  border-left-color: var(--ls-red);
+}
+
+.ls-issue-marker {
+  flex: 0 0 auto;
+  margin-top: 0.26rem;
+}
+
+.ls-issue-duplicate .ls-issue-marker {
+  background: var(--ls-red);
+}
+
+.ls-issue-malformed .ls-issue-marker {
+  background: var(--ls-yellow);
+}
+
+.ls-issue-copy strong,
+.ls-issue-copy span {
+  display: block;
+}
+
+.ls-issue-copy strong {
+  font-size: 0.7rem;
+}
+
+.ls-issue-copy span,
+.ls-issue-more,
+.ls-no-issues {
+  color: var(--ls-muted);
+  font-size: 0.66rem;
+}
+
+.ls-issue-more {
+  display: block;
+  padding: 0.2rem 0;
+  text-align: center;
+}
+
+.ls-no-issues {
+  border: 1px dashed var(--ls-cyan);
+  border-radius: 7px;
+  color: var(--ls-cyan);
+  padding: 0.75rem;
+}
+
+.ls-preview-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.ls-preview-frame {
+  background: var(--ls-panel-soft);
+  border: 1px solid var(--ls-line);
+  border-radius: 12px;
+  min-height: 265px;
+  overflow: auto;
+  position: relative;
+}
+
+.ls-empty-state {
+  align-items: center;
+  color: var(--ls-muted);
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  justify-content: center;
+  min-height: 265px;
+  padding: 2rem;
+  text-align: center;
+}
+
+.ls-empty-state strong {
+  color: var(--ls-ink);
+  font-size: 0.86rem;
+}
+
+.ls-empty-state span:last-child {
+  font-size: 0.73rem;
+}
+
+.ls-empty-grid {
+  background: repeating-linear-gradient(90deg, var(--ls-line) 0 1px, transparent 1px 12px), repeating-linear-gradient(0deg, var(--ls-line) 0 1px, transparent 1px 12px);
+  border: 1px solid var(--ls-line);
+  height: 62px;
+  opacity: 0.8;
+  transform: rotate(3deg);
+  width: 82px;
+}
+
+.ls-table {
+  border-collapse: collapse;
+  font-size: 0.72rem;
+  min-width: 100%;
+  table-layout: fixed;
+}
+
+.ls-table th,
+.ls-table td {
+  border-bottom: 1px solid var(--ls-line);
+  max-width: 220px;
+  overflow: hidden;
+  padding: 0.65rem 0.7rem;
+  text-align: left;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.ls-table th {
+  background: color-mix(in srgb, var(--ls-accent) 8%, var(--ls-panel));
+  color: var(--ls-accent-dark);
+  font-size: 0.65rem;
+  letter-spacing: 0.05em;
+  position: sticky;
+  text-transform: uppercase;
+  top: 0;
+}
+
+.ls-table td:first-child {
+  color: var(--ls-ink);
+  font-weight: 800;
+}
+
+.ls-table td.is-empty {
+  background: color-mix(in srgb, var(--ls-yellow) 14%, transparent);
+  color: var(--ls-yellow);
+}
+
+.ls-preview-note {
+  color: var(--ls-muted);
+  display: block;
+  font-size: 0.68rem;
+  padding: 0.6rem;
+  text-align: center;
+}
+
+.ls-export-card {
+  align-items: center;
+  border-radius: 12px;
+  display: flex;
+  gap: 1rem;
+  justify-content: space-between;
+  padding: 1rem;
+}
+
+.ls-export-copy {
+  min-width: 0;
+}
+
+.ls-export-actions {
+  flex: 0 0 auto;
+}
+
+.ls-live-status {
+  color: var(--ls-cyan);
+  font-size: 0.72rem;
+  min-height: 1rem;
+  padding: 0.35rem 0.2rem;
+}
+
+@media (max-width: 860px) {
+  .ls-workbench {
+    grid-template-columns: 1fr;
+  }
+
+  .ls-inspector {
+    border-bottom: 1px solid var(--ls-line);
+    border-right: 0;
+  }
+
+  .ls-issue-list {
+    max-height: none;
+  }
+}
+
+@media (max-width: 620px) {
+  .ls-topline,
+  .ls-drop-panel,
+  .ls-inspector,
+  .ls-preview-panel {
+    padding: 1rem;
+  }
+
+  .ls-topline,
+  .ls-drop-panel,
+  .ls-export-card {
+    align-items: flex-start;
+    flex-direction: column;
+  }
+
+  .ls-drop-panel {
+    display: flex;
+  }
+
+  .ls-drop-mark {
+    display: none;
+  }
+
+  .ls-drop-actions,
+  .ls-export-actions,
+  .ls-button {
+    width: 100%;
+  }
+
+  .ls-button {
+    text-align: center;
+  }
+
+  .ls-privacy-note {
+    text-align: left;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ls-root * {
+    scroll-behavior: auto;
+    transition-duration: 0.01ms;
+  }
+}

package/src/tool/localizationSanitizer/logic.test.ts

@@ -0,0 +1,38 @@
+import { describe, expect, it } from 'vitest';
+import { detectTranslationFormat, sanitizeTranslationFile } from './logic';
+
+describe('localization sanitizer', () => {
+  it('repairs quoted commas, reports blanks, and removes duplicate CSV keys', () => {
+    const result = sanitizeTranslationFile('key,en,es\nmenu.play,Play,"Jugar, ahora"\nmenu.play,Play again,\nmenu.quit,,Salir\n', 'csv');
+
+    expect(result.valid).toBe(true);
+    expect(result.stats.duplicateKeys).toBe(1);
+    expect(result.stats.emptyCells).toBe(2);
+    expect(result.stats.cleanRows).toBe(2);
+    expect(result.cleanText).toContain('"Jugar, ahora"');
+  });
+
+  it('pads missing CSV cells and joins an extra comma into the final translation', () => {
+    const result = sanitizeTranslationFile('key,en,es\nhello,Hello\nbye,Bye,Adios,unexpected\n', 'csv');
+
+    expect(result.stats.malformedRows).toBe(2);
+    expect(result.rows[0]).toEqual(['hello', 'Hello', '']);
+    expect(result.rows[1]).toEqual(['bye', 'Bye', 'Adios,unexpected']);
+  });
+
+  it('normalizes JSON arrays while keeping the first duplicate record', () => {
+    const result = sanitizeTranslationFile('[{"key":"start","en":"Start","es":""},{"key":"start","en":"Begin","es":"Comenzar"}]', 'json');
+
+    expect(result.valid).toBe(true);
+    expect(result.stats.duplicateKeys).toBe(1);
+    expect(result.stats.emptyCells).toBe(1);
+    expect(JSON.parse(result.cleanText)).toHaveLength(1);
+  });
+
+  it('rejects invalid JSON and detects format from file names or content', () => {
+    expect(sanitizeTranslationFile('{broken', 'json').valid).toBe(false);
+    expect(detectTranslationFormat('strings.json')).toBe('json');
+    expect(detectTranslationFormat('strings.txt', '[{"key":"x"}]')).toBe('json');
+    expect(detectTranslationFormat('strings.txt', 'key,en\nx,Hello')).toBe('csv');
+  });
+});

package/src/tool/localizationSanitizer/logic.ts

@@ -0,0 +1,23 @@
+import { sanitizeCsv } from './csv-sanitizer';
+import { emptyResult } from './csv-sanitizer';
+import { sanitizeJson } from './json-sanitizer';
+import type { SanitizerResult, TranslationFormat } from './types';
+
+export type { TranslationFormat, SanitizerIssueKind, SanitizerIssue, SanitizerStats, SanitizerResult } from './types';
+
+export function detectTranslationFormat(fileName: string, source = ''): TranslationFormat {
+  if (/\.json$/i.test(fileName)) {
+    return 'json';
+  }
+  if (/\.csv$/i.test(fileName)) {
+    return 'csv';
+  }
+  return source.trim().startsWith('{') || source.trim().startsWith('[') ? 'json' : 'csv';
+}
+
+export function sanitizeTranslationFile(source: string, format: TranslationFormat): SanitizerResult {
+  if (!source.trim()) {
+    return emptyResult(format, 'empty_file');
+  }
+  return format === 'csv' ? sanitizeCsv(source) : sanitizeJson(source);
+}

package/src/tool/localizationSanitizer/seo.astro

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