g360-cli 1.4.0 → 1.6.0

package/src/lib/validator.js

@@ -1,10 +1,37 @@
 import fs from 'fs-extra';
 
+/**
+ * @typedef {Object} ValidationResult
+ * @property {boolean} valid - Indica si la validación fue exitosa
+ * @property {string[]} errors - Lista de errores encontrados
+ * @property {string[]} warnings - Lista de advertencias encontradas
+ */
+
+/**
+ * Módulo de validación para proyectos G360
+ * @namespace validator
+ */
 export const validator = {
+  /**
+   * Valida si un nombre de proyecto es válido
+   * @param {string} name - Nombre del proyecto a validar
+   * @returns {boolean} true si el nombre es válido, false en caso contrario
+   * @example
+   * validator.isValidProjectName('my-project') // true
+   * validator.isValidProjectName('My-Project') // false
+   */
   isValidProjectName(name) {
     return /^[a-z0-9][a-z0-9-]*$/.test(name);
   },
 
+  /**
+   * Valida si una ruta existe en el sistema de archivos
+   * @param {string} path - Ruta a validar
+   * @returns {boolean} true si la ruta existe, false en caso contrario
+   * @example
+   * validator.isValidPath('/existing/path') // true
+   * validator.isValidPath('/non/existing') // false
+   */
   isValidPath(path) {
     try {
       return fs.existsSync(path);
@@ -13,6 +40,18 @@ export const validator = {
     }
   },
 
+  /**
+   * Valida si un directorio es un proyecto G360 válido
+   * @param {string} projectDir - Ruta del directorio del proyecto
+   * @returns {ValidationResult} Objeto con resultado de la validación
+   * @example
+   * const result = validator.validateProject('/my/project');
+   * if (result.valid) {
+   *   console.log('Proyecto válido');
+   * } else {
+   *   console.error('Errores:', result.errors);
+   * }
+   */
   validateProject(projectDir) {
     const errors = [];
     const warnings = [];

package/src/schemas/skills-schema.json

@@ -0,0 +1 @@
+{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"skills":{"items":{"properties":{"colors":{"properties":{"accent":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"},"bg":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"},"muted":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"},"surface":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"},"text":{"pattern":"^#[0-9a-fA-F]{6}$","type":"string"}},"required":["bg","surface","accent","text","muted"],"type":"object"},"description":{"minLength":1,"type":"string"},"device":{"enum":["pc","movil","both"],"type":"string"},"name":{"pattern":"^[a-z0-9-]+$","type":"string"},"signature":{"properties":{"mode":{"enum":["powered","own","optional","custom"],"type":"string"},"text":{"minLength":1,"type":"string"}},"required":["mode","text"],"type":"object"}},"required":["name","description","device","colors","signature"],"type":"object"},"type":"array"}},"required":["skills"],"title":"G360 Skills Configuration","type":"object"}

package/src/schemas/snippets-schema.json

@@ -0,0 +1 @@
+{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"snippets":{"items":{"properties":{"code":{"minLength":1,"type":"string"},"description":{"minLength":1,"type":"string"},"language":{"minLength":1,"type":"string"},"name":{"pattern":"^[a-z0-9-]+$","type":"string"}},"required":["name","description","code"],"type":"object"},"type":"array"}},"required":["snippets"],"title":"G360 Snippets Configuration","type":"object"}

package/src/assets/templates/python-customtkinter/build-portable.bat

@@ -1,28 +0,0 @@
-@echo off
-chcp 65001 >nul
-title G360 - Portable CustomTkinter
-
-echo.
-echo ==============================================
-echo   G360 CustomTkinter - Portable
-echo   (Requires Python installed)
-echo ==============================================
-echo.
-
-python --version >nul 2>&1
-if errorlevel 1 (
-    echo ERROR: Python no encontrado
-    pause
-    exit /b 1
-)
-
-pip show customtkinter >nul 2>&1
-if errorlevel 1 (
-    pip install customtkinter
-)
-
-echo.
-echo Ejecutando G360 App...
-python src\main.py
-
-pause

package/src/assets/templates/python-customtkinter/requirements.txt

@@ -1 +0,0 @@
-customtkinter>=5.2.0

package/src/assets/templates/python-flet/build-portable.bat

@@ -1,42 +0,0 @@
-@echo off
-chcp 65001 >nul
-title G360 - Portable Flet App
-
-echo.
-echo ==============================================
-echo   G360 Flet - Portable Version
-echo   (Requires Python + flet installed)
-echo ==============================================
-echo.
-
-python --version >nul 2>&1
-if errorlevel 1 (
-    echo ERROR: Python no encontrado
-    echo Instala Python desde: https://python.org
-    pause
-    exit /b 1
-)
-
-echo Verificando flet...
-pip show flet >nul 2>&1
-if errorlevel 1 (
-    echo   Flet no encontrado. Instalando...
-    pip install flet
-    if errorlevel 1 (
-        echo ERROR: No se pudo instalar flet
-        pause
-        exit /b 1
-    )
-)
-
-if not exist "src\main.py" (
-    echo ERROR: src\main.py no encontrado
-    pause
-    exit /b 1
-)
-
-echo.
-echo Ejecutando G360 Flet App...
-python src\main.py %*
-
-pause

package/src/assets/templates/python-flet/create_shortcut.vbs

@@ -1,35 +0,0 @@
-Set objShell = CreateObject("WScript.Shell")
-Set objFSO = CreateObject("Scripting.FileSystemObject")
-
-strCurrentPath = objFSO.GetParentFolderName(WScript.ScriptFullName)
-strDesktop = objShell.SpecialFolders("Desktop")
-
-strExePath = strCurrentPath & "\dist\G360App-Portable.exe"
-strBatPath = strCurrentPath & "\run.bat"
-strIconPath = strCurrentPath & "\assets\images\app.ico"
-
-targetPath = strExePath
-if not objFSO.FileExists(strExePath) Then
-    targetPath = strBatPath
-End If
-
-appName = "G360 App"
-
-If objFSO.FileExists(strDesktop & "\" & appName & ".lnk") Then
-    objFSO.DeleteFile strDesktop & "\" & appName & ".lnk", True
-End If
-
-Set objShortcut = objShell.CreateShortcut(strDesktop & "\" & appName & ".lnk")
-objShortcut.TargetPath = targetPath
-objShortcut.WorkingDirectory = strCurrentPath
-objShortcut.Description = "G360 Desktop Application"
-
-If objFSO.FileExists(strIconPath) Then
-    objShortcut.IconLocation = strIconPath & ", 0"
-Else
-    objShortcut.IconLocation = "%SystemRoot%\system32\shell32.dll, 15"
-End If
-
-objShortcut.Save
-
-objShell.Run "ie4uinit.exe -show", 0, True

package/src/assets/templates/python-flet/requirements.txt

@@ -1,3 +0,0 @@
-flet>=0.21.0
-pytest>=7.0.0
-pytest-cov>=4.0.0

package/src/assets/templates/web-pwa/app.js

@@ -1 +0,0 @@
-console.log('G360 Project initialized');

package/src/assets/templates/web-pwa/styles.css

@@ -1,28 +0,0 @@
-:root {
-  --g360-primary: #3B82F6;
-  --g360-secondary: #10B981;
-  --g360-accent: #8B5CF6;
-  --g360-bg: #ffffff;
-  --g360-text: #1f2937;
-}
-
-* { box-sizing: border-box; margin: 0; padding: 0; }
-
-body {
-  font-family: system-ui, sans-serif;
-  background: var(--g360-bg);
-  color: var(--g360-text);
-  line-height: 1.6;
-}
-
-.g360-header {
-  background: var(--g360-primary);
-  color: white;
-  padding: 1rem 2rem;
-}
-
-.g360-footer {
-  text-align: center;
-  padding: 1rem;
-  color: #6b7280;
-}