@jjlmoya/utils-games-development 1.47.0 → 1.49.0

package/src/tool/spriteSheetPacker/sprite-sheet-packer.css

@@ -0,0 +1,542 @@
+.ssp-container {
+  width: 100%;
+  max-width: 1200px;
+  margin: 0 auto;
+  color: var(--text-base, #1e293b);
+  position: relative;
+}
+
+.theme-dark .ssp-container {
+  color: var(--text-base, #f8fafc);
+}
+
+.ssp-main-card {
+  background: var(--bg-surface, #fff);
+  border: 1px solid var(--border-base, #cbd5e1);
+  border-radius: 16px;
+  overflow: hidden;
+  box-shadow: 0 10px 35px rgba(0, 0, 0, 0.08);
+  display: flex;
+  flex-direction: column;
+  position: relative;
+}
+
+.theme-dark .ssp-main-card {
+  background: var(--bg-surface, #090d16);
+  border-color: var(--border-base, #1e293b);
+  box-shadow: 0 10px 35px rgba(0, 0, 0, 0.4);
+}
+
+.ssp-header-tabs {
+  display: flex;
+  background: rgba(148, 163, 184, 0.08);
+  border-bottom: 1px solid var(--border-base, #e2e8f0);
+  padding: 0.5rem 0.5rem 0;
+  gap: 0.5rem;
+}
+
+.theme-dark .ssp-header-tabs {
+  background: #0f172a;
+  border-color: #1e293b;
+}
+
+.ssp-tab-btn {
+  flex: 1;
+  padding: 0.85rem 1.5rem;
+  border: none;
+  border-radius: 10px 10px 0 0;
+  background: transparent;
+  color: inherit;
+  font-weight: 600;
+  font-size: 0.95rem;
+  cursor: pointer;
+  transition: all 0.2s ease;
+  opacity: 0.65;
+}
+
+.ssp-tab-btn.active {
+  background: var(--bg-surface, #fff);
+  color: var(--color-primary, #6366f1);
+  opacity: 1;
+  border: 1px solid var(--border-base, #cbd5e1);
+  border-bottom: 1px solid var(--bg-surface, #fff);
+  margin-bottom: -1px;
+}
+
+.theme-dark .ssp-tab-btn.active {
+  background: var(--bg-surface, #090d16);
+  color: var(--color-primary-light, #818cf8);
+  border-color: #1e293b;
+  border-bottom-color: var(--bg-surface, #090d16);
+}
+
+.ssp-body-grid {
+  display: grid;
+  grid-template-columns: 1fr;
+  padding: 1.5rem;
+  gap: 1.5rem;
+}
+
+@media (min-width: 900px) {
+  .ssp-body-grid {
+    grid-template-columns: 340px 1fr;
+  }
+}
+
+.ssp-sidebar-section {
+  display: flex;
+  flex-direction: column;
+  gap: 1.25rem;
+  padding-right: 0;
+}
+
+@media (min-width: 900px) {
+  .ssp-sidebar-section {
+    padding-right: 1.5rem;
+    border-right: 1px solid var(--border-base, #e2e8f0);
+  }
+
+  .theme-dark .ssp-sidebar-section {
+    border-color: #1e293b;
+  }
+}
+
+.ssp-main-section {
+  display: flex;
+  flex-direction: column;
+  gap: 1.25rem;
+}
+
+.ssp-dropzone {
+  border: 2px dashed #818cf8;
+  border-radius: 12px;
+  padding: 1.5rem 1rem;
+  text-align: center;
+  background: rgba(129, 140, 248, 0.05);
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.ssp-dropzone:hover,
+.ssp-dropzone.dragover {
+  background: rgba(129, 140, 248, 0.12);
+  border-color: #6366f1;
+}
+
+.ssp-drop-title {
+  font-weight: 700;
+  font-size: 1rem;
+  margin-bottom: 0.25rem;
+}
+
+.ssp-drop-sub {
+  font-size: 0.8rem;
+  opacity: 0.7;
+}
+
+.ssp-file-input {
+  display: none;
+}
+
+.ssp-presets-row {
+  display: flex;
+  gap: 0.4rem;
+  flex-wrap: wrap;
+}
+
+.ssp-chip-btn {
+  flex: 1;
+  min-width: 85px;
+  padding: 0.45rem 0.6rem;
+  font-size: 0.75rem;
+  font-weight: 600;
+  border-radius: 6px;
+  border: 1px solid rgba(129, 140, 248, 0.3);
+  background: rgba(129, 140, 248, 0.08);
+  color: inherit;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  text-align: center;
+}
+
+.ssp-chip-btn:hover {
+  background: rgba(129, 140, 248, 0.2);
+  border-color: #6366f1;
+}
+
+.ssp-chip-btn.active {
+  background: linear-gradient(135deg, #6366f1, #4f46e5);
+  color: var(--text-on-primary, #fff);
+  border-color: #6366f1;
+  box-shadow: 0 2px 8px rgba(99, 102, 241, 0.3);
+}
+
+.ssp-controls-list {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+
+.ssp-control-group {
+  display: flex;
+  flex-direction: column;
+  gap: 0.4rem;
+}
+
+.ssp-label {
+  font-size: 0.85rem;
+  font-weight: 600;
+  display: flex;
+  justify-content: space-between;
+}
+
+.ssp-stepper-box {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  width: 100%;
+}
+
+.ssp-step-btn {
+  width: 32px;
+  height: 32px;
+  border-radius: 6px;
+  border: 1px solid var(--border-base, #cbd5e1);
+  background: rgba(148, 163, 184, 0.1);
+  color: inherit;
+  font-weight: 700;
+  font-size: 1rem;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: background 0.15s ease, transform 0.1s ease;
+  flex-shrink: 0;
+}
+
+.theme-dark .ssp-step-btn {
+  border-color: #334155;
+}
+
+.ssp-step-btn:hover {
+  background: rgba(99, 102, 241, 0.2);
+  border-color: #6366f1;
+}
+
+.ssp-step-btn:active {
+  transform: scale(0.92);
+}
+
+.ssp-slider {
+  flex: 1;
+  accent-color: #6366f1;
+}
+
+.ssp-select,
+.ssp-input {
+  width: 100%;
+  padding: 0.6rem 0.8rem;
+  border-radius: 8px;
+  border: 1px solid var(--border-base, #cbd5e1);
+  background: var(--bg-surface, #fff);
+  color: inherit;
+  font-size: 0.9rem;
+}
+
+.theme-dark .ssp-select,
+.theme-dark .ssp-input {
+  background: #1e293b;
+  border-color: #334155;
+}
+
+.ssp-toggle-group {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0.3rem 0;
+}
+
+.ssp-toggle-input {
+  width: 1.25rem;
+  height: 1.25rem;
+  accent-color: #6366f1;
+  cursor: pointer;
+}
+
+.ssp-btn-row {
+  display: flex;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+}
+
+.ssp-btn {
+  flex: 1;
+  min-width: 110px;
+  padding: 0.7rem 0.9rem;
+  border-radius: 8px;
+  border: none;
+  font-weight: 600;
+  font-size: 0.88rem;
+  cursor: pointer;
+  transition: transform 0.15s ease, opacity 0.15s ease, background 0.2s ease;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+}
+
+.ssp-btn:hover {
+  transform: translateY(-1px);
+}
+
+.ssp-btn:active {
+  transform: scale(0.96);
+}
+
+.ssp-btn-primary {
+  background: linear-gradient(135deg, #6366f1, #4f46e5);
+  color: var(--text-on-primary, #fff);
+}
+
+.ssp-btn-secondary {
+  background: rgba(148, 163, 184, 0.12);
+  color: inherit;
+  border: 1px solid var(--border-base, #cbd5e1);
+}
+
+.theme-dark .ssp-btn-secondary {
+  border-color: #334155;
+}
+
+.ssp-btn-danger {
+  background: #ef4444;
+  color: var(--text-on-primary, #fff);
+}
+
+.ssp-btn-success {
+  background: #10b981;
+  color: var(--text-on-primary, #fff);
+  border-color: #10b981;
+}
+
+.ssp-stats-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(110px, 1fr));
+  gap: 0.75rem;
+}
+
+.ssp-stat-badge {
+  background: rgba(99, 102, 241, 0.08);
+  border: 1px solid rgba(99, 102, 241, 0.2);
+  border-radius: 10px;
+  padding: 0.6rem 0.75rem;
+  text-align: center;
+}
+
+.ssp-stat-val {
+  font-size: 1.1rem;
+  font-weight: 700;
+  color: var(--color-primary, #6366f1);
+}
+
+.theme-dark .ssp-stat-val {
+  color: var(--color-primary-light, #818cf8);
+}
+
+.ssp-stat-lbl {
+  font-size: 0.75rem;
+  opacity: 0.8;
+}
+
+.ssp-canvas-wrapper {
+  width: 100%;
+  height: 380px;
+  overflow: auto;
+  border-radius: 12px;
+  background-image: linear-gradient(45deg, #cbd5e1 25%, transparent 25%),
+    linear-gradient(-45deg, #cbd5e1 25%, transparent 25%),
+    linear-gradient(45deg, transparent 75%, #cbd5e1 75%),
+    linear-gradient(-45deg, transparent 75%, #cbd5e1 75%);
+  background-size: 16px 16px;
+  background-position: 0 0, 0 8px, 8px -8px, -8px 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 1rem;
+  border: 1px solid var(--border-base, #e2e8f0);
+  box-sizing: border-box;
+}
+
+.theme-dark .ssp-canvas-wrapper {
+  background-image: linear-gradient(45deg, #1e293b 25%, transparent 25%),
+    linear-gradient(-45deg, #1e293b 25%, transparent 25%),
+    linear-gradient(45deg, transparent 75%, #1e293b 75%),
+    linear-gradient(-45deg, transparent 75%, #1e293b 75%);
+  border-color: #1e293b;
+}
+
+.ssp-canvas {
+  max-width: 100%;
+  max-height: 100%;
+  object-fit: contain;
+  border-radius: 4px;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+  image-rendering: pixelated;
+}
+
+.ssp-flipbook-box {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  padding: 1rem;
+  background: rgba(99, 102, 241, 0.04);
+  border-radius: 12px;
+  border: 1px solid rgba(99, 102, 241, 0.18);
+}
+
+.ssp-flipbook-header {
+  font-weight: 700;
+  font-size: 0.9rem;
+}
+
+.ssp-flipbook-body {
+  display: flex;
+  align-items: center;
+  gap: 1.25rem;
+  flex-wrap: wrap;
+}
+
+.ssp-flipbook-canvas {
+  width: 100px;
+  height: 100px;
+  image-rendering: pixelated;
+  background: rgba(0, 0, 0, 0.2);
+  border-radius: 8px;
+  border: 1px solid rgba(255, 255, 255, 0.1);
+}
+
+.ssp-flipbook-controls {
+  flex: 1;
+  min-width: 200px;
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+
+.ssp-code-container {
+  display: flex;
+  flex-direction: column;
+  border-radius: 10px;
+  overflow: hidden;
+  border: 1px solid #1e293b;
+  background: #090d16;
+}
+
+.ssp-code-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  background: #0f172a;
+  padding: 0.6rem 0.85rem;
+  border-bottom: 1px solid #1e293b;
+}
+
+.ssp-code-title {
+  font-size: 0.82rem;
+  font-weight: 600;
+  color: var(--text-muted, #94a3b8);
+}
+
+.ssp-copy-btn {
+  background: rgba(56, 189, 248, 0.12);
+  border: 1px solid rgba(56, 189, 248, 0.3);
+  color: var(--color-cyan, #38bdf8);
+  padding: 0.35rem 0.75rem;
+  border-radius: 6px;
+  font-size: 0.78rem;
+  font-weight: 600;
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+
+.ssp-copy-btn:hover {
+  background: rgba(56, 189, 248, 0.25);
+}
+
+.ssp-copy-btn:active {
+  transform: scale(0.95);
+}
+
+.ssp-code-block {
+  width: 100%;
+  margin: 0;
+  background: #070a12;
+  color: var(--color-cyan, #38bdf8);
+  font-size: 0.82rem;
+  padding: 0.85rem 1rem;
+  overflow-x: auto;
+  white-space: pre-wrap;
+  word-break: break-all;
+}
+
+.ssp-toast {
+  position: fixed;
+  bottom: 2rem;
+  right: 2rem;
+  background: #10b981;
+  color: var(--text-on-primary, #fff);
+  padding: 0.75rem 1.25rem;
+  border-radius: 8px;
+  font-weight: 600;
+  box-shadow: 0 4px 14px rgba(16, 185, 129, 0.4);
+  opacity: 0;
+  transform: translateY(10px);
+  pointer-events: none;
+  transition: opacity 0.3s ease, transform 0.3s ease;
+  z-index: 1000;
+}
+
+.ssp-toast.show {
+  opacity: 1;
+  transform: translateY(0);
+}
+
+.ssp-particle-container {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100vw;
+  height: 100vh;
+  pointer-events: none;
+  z-index: 2000;
+}
+
+.ssp-particle {
+  position: absolute;
+  font-size: 0.75rem;
+  font-weight: 800;
+  color: var(--color-cyan, #38bdf8);
+  background: rgba(15, 23, 42, 0.9);
+  border: 1px solid #38bdf8;
+  border-radius: 4px;
+  padding: 0.2rem 0.5rem;
+  box-shadow: 0 0 10px rgba(56, 189, 248, 0.5);
+  animation: ssp-particle-float 1s forwards ease-out;
+}
+
+@keyframes ssp-particle-float {
+  0% {
+    opacity: 1;
+    transform: translate(-50%, -50%) scale(0.8);
+  }
+
+  50% {
+    opacity: 1;
+    transform: translate(-50%, -120%) scale(1.1);
+  }
+
+  100% {
+    opacity: 0;
+    transform: translate(-50%, -180%) scale(0.9);
+  }
+}

package/src/tool/spriteSheetPacker/types.ts

@@ -0,0 +1,89 @@
+export interface SpriteFrameInput {
+  id: string;
+  name: string;
+  width: number;
+  height: number;
+  x?: number;
+  y?: number;
+  trimmedX?: number;
+  trimmedY?: number;
+  originalWidth?: number;
+  originalHeight?: number;
+  pivotX?: number;
+  pivotY?: number;
+}
+
+export type ExportFormat =
+  | 'generic-json-hash'
+  | 'generic-json-array'
+  | 'unity'
+  | 'godot'
+  | 'phaser'
+  | 'css';
+
+export interface PackerOptions {
+  padding: number;
+  borderExtrusion: number;
+  forcePowerOfTwo: boolean;
+  maxTextureWidth: number;
+  maxTextureHeight: number;
+  allowRotation: boolean;
+  trimTransparency: boolean;
+  format: ExportFormat;
+}
+
+export interface PackedFrame {
+  id: string;
+  name: string;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  rotated: boolean;
+  trimmed: boolean;
+  spriteSourceSize: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+  };
+  sourceSize: {
+    w: number;
+    h: number;
+  };
+  pivot: {
+    x: number;
+    y: number;
+  };
+}
+
+export interface PackedResult {
+  textureWidth: number;
+  textureHeight: number;
+  efficiency: number;
+  totalFrames: number;
+  frames: PackedFrame[];
+  atlasJson: string;
+  cssSnippet: string;
+  codeSnippet: string;
+  drawCallsBefore: number;
+  drawCallsAfter: number;
+}
+
+export interface ExtractionGridConfig {
+  imageWidth: number;
+  imageHeight: number;
+  frameWidth: number;
+  frameHeight: number;
+  margin: number;
+  spacing: number;
+}
+
+export interface ExtractedFrameSlice {
+  id: string;
+  index: number;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}

package/src/tool/spriteSheetPacker/ui.ts

@@ -0,0 +1,42 @@
+export interface SpriteSheetPackerUI extends Record<string, string> {
+  packerTab: string;
+  extractorTab: string;
+  dropZoneTitle: string;
+  dropZoneSubtitle: string;
+  selectFilesButton: string;
+  clearAllButton: string;
+  downloadZipButton: string;
+  copyJsonButton: string;
+  downloadSheetPngButton: string;
+  paddingLabel: string;
+  borderExtrusionLabel: string;
+  maxTextureSizeLabel: string;
+  powerOfTwoLabel: string;
+  exportFormatLabel: string;
+  presetPixelArt: string;
+  presetHdUi: string;
+  presetMobile: string;
+  formatGenericHash: string;
+  formatGenericArray: string;
+  formatUnity: string;
+  formatGodot: string;
+  formatPhaser: string;
+  formatCss: string;
+  previewTitle: string;
+  efficiencyBadge: string;
+  drawCallsBadge: string;
+  totalFramesBadge: string;
+  textureSizeBadge: string;
+  flipbookTitle: string;
+  flipbookFpsLabel: string;
+  playAnimation: string;
+  pauseAnimation: string;
+  frameWidthLabel: string;
+  frameHeightLabel: string;
+  marginLabel: string;
+  spacingLabel: string;
+  extractedCountLabel: string;
+  codeSnippetTitle: string;
+  copySnippetButton: string;
+  copiedToast: string;
+}

package/src/tools.ts

@@ -2,8 +2,10 @@ export { ALL_ENTRIES } from './entries';
 import type { ToolDefinition } from './types';
 import { STEAM_CAPSULE_GENERATOR_TOOL } from './tool/steamCapsuleGenerator';
 import { ITCHIO_GAME_TESTER_TOOL } from './tool/itchioGameTester';
+import { SPRITE_SHEET_PACKER_TOOL } from './tool/spriteSheetPacker';
 
 export const ALL_TOOLS: ToolDefinition[] = [
   STEAM_CAPSULE_GENERATOR_TOOL,
   ITCHIO_GAME_TESTER_TOOL,
+  SPRITE_SHEET_PACKER_TOOL,
 ];