dovmikesoul-codigo-barras-js 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Miguel Angel Pérez Díaz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# dovmikesoul-codigo-barras-js
+
+Una biblioteca ligera, rápida y sin dependencias para generar códigos de barras (Code 39) en formato SVG en JavaScript.
+
+## Instalación
+
+```bash
+npm install dovmikesoul-codigo-barras-js
+```
+
+## Uso
+
+```javascript
+const { generateCode39SVG } = require('dovmikesoul-codigo-barras-js');
+
+// Generar el código de barras (devuelve un string SVG)
+const svgString = generateCode39SVG('NPM 123');
+
+console.log(svgString); // Imprime el contenido <svg>...</svg>
+```
+
+### Opciones de personalización
+
+Puedes pasar un segundo argumento de configuración a la función:
+
+```javascript
+const svgString = generateCode39SVG('PERSONALIZADO', {
+    width: 2,               // Ancho base de las barras (px)
+    height: 80,             // Alto de las barras (px)
+    color: '#000000',       // Color del código de barras
+    background: '#ffffff',  // Color de fondo (usa 'transparent' para omitirlo)
+    showText: true,         // Mostrar texto en la base
+    padding: 15             // Espacio exterior de seguridad
+});
+```
+
+## Caracteres soportados (Code 39)
+- Letras MAYÚSCULAS: `A-Z`
+- Números: `0-9`
+- Caracteres especiales: `-`, `.`, ` `, `$`, `/`, `+`, `%`
+
+## Licencia
+
+MIT
+

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "dovmikesoul-codigo-barras-js",
+  "version": "1.0.0",
+  "description": "Biblioteca en JavaScript para generar códigos de barras (Code 39) en formato SVG.",
+  "main": "src/index.js",
+  "scripts": {
+    "test": "node test/test.js"
+  },
+  "keywords": [
+    "barcode",
+    "svg",
+    "codigo-barras",
+    "code39",
+    "javascript"
+  ],
+  "author": "DovMikeSoul",
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,108 @@
+const code39Map = {
+    '0': '000110100', '1': '100100001', '2': '001100001', '3': '101100000',
+    '4': '000110001', '5': '100110000', '6': '001110000', '7': '000100101',
+    '8': '100100100', '9': '001100100', 'A': '100001001', 'B': '001001001',
+    'C': '101001000', 'D': '000011001', 'E': '100011000', 'F': '001011000',
+    'G': '000001101', 'H': '100001100', 'I': '001001100', 'J': '000011100',
+    'K': '100000011', 'L': '001000011', 'M': '101000010', 'N': '000010011',
+    'O': '100010010', 'P': '001010010', 'Q': '000000111', 'R': '100000110',
+    'S': '001000110', 'T': '000010110', 'U': '110000001', 'V': '011000001',
+    'W': '111000000', 'X': '010010001', 'Y': '110010000', 'Z': '011010000',
+    '-': '010000101', '.': '110000100', ' ': '011000100', '*': '010010100',
+    '$': '010101000', '/': '010100010', '+': '010001010', '%': '000101010'
+};
+
+/**
+ * Genera un código de barras Code 39 en formato SVG.
+ * 
+ * @param {string} text - El texto a codificar.
+ * @param {Object} options - Opciones de configuración.
+ * @param {number} options.width - Ancho de la barra estrecha (por defecto: 2).
+ * @param {number} options.height - Alto de las barras (por defecto: 100).
+ * @param {string} options.color - Color de las barras (por defecto: '#000000').
+ * @param {string} options.background - Color de fondo (por defecto: '#ffffff').
+ * @param {boolean} options.showText - Si se debe mostrar el texto debajo del código (por defecto: true).
+ * @param {number} options.padding - Espaciado interno (por defecto: 10).
+ * @returns {string} Código SVG generado.
+ */
+function generateCode39SVG(text, options = {}) {
+    if (!text) throw new Error("El texto no puede estar vacío");
+
+    const width = options.width || 2;
+    const height = options.height || 100;
+    const color = options.color || '#000000';
+    const background = options.background || '#ffffff';
+    const showText = options.showText !== undefined ? options.showText : true;
+    const padding = options.padding !== undefined ? options.padding : 10;
+
+    const wideWidth = width * 3;
+    
+    // Asegurar que el texto tiene caracteres de inicio y fin '*'
+    let formattedText = text.toUpperCase();
+    if (!formattedText.startsWith('*')) formattedText = '*' + formattedText;
+    if (!formattedText.endsWith('*')) formattedText = formattedText + '*';
+
+    // Validar caracteres
+    for (let i = 0; i < formattedText.length; i++) {
+        if (!code39Map[formattedText[i]]) {
+            throw new Error(`Carácter no válido para Code 39: ${formattedText[i]}`);
+        }
+    }
+
+    let currentX = padding;
+    let svgElements = [];
+
+    for (let i = 0; i < formattedText.length; i++) {
+        const char = formattedText[i];
+        const pattern = code39Map[char];
+        
+        for (let j = 0; j < pattern.length; j++) {
+            const isBar = j % 2 === 0;
+            const isWide = pattern[j] === '1';
+            const elementWidth = isWide ? wideWidth : width;
+
+            if (isBar) {
+                svgElements.push(`<rect x="${currentX}" y="${padding}" width="${elementWidth}" height="${height}" fill="${color}" />`);
+            }
+            
+            currentX += elementWidth;
+        }
+        
+        // Espacio entre caracteres (espacio estrecho)
+        if (i < formattedText.length - 1) {
+            currentX += width;
+        }
+    }
+
+    const totalWidth = currentX + padding;
+    const textHeight = showText ? 24 : 0;
+    const totalHeight = height + (padding * 2) + textHeight;
+
+    let svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${totalWidth}" height="${totalHeight}" viewBox="0 0 ${totalWidth} ${totalHeight}">
+`;
+    
+    if (background !== 'transparent') {
+        svg += `  <rect width="100%" height="100%" fill="${background}" />
+`;
+    }
+    
+    svg += `  <g>
+    ${svgElements.join('\n    ')}
+  </g>
+`;
+
+    if (showText) {
+        // Mostrar el texto original sin los asteriscos de formato si no venían en el texto
+        const displayText = text.toUpperCase();
+        svg += `  <text x="${totalWidth / 2}" y="${totalHeight - padding}" font-family="monospace" font-size="16" fill="${color}" text-anchor="middle">${displayText}</text>
+`;
+    }
+
+    svg += `</svg>`;
+    
+    return svg;
+}
+
+module.exports = {
+    generateCode39SVG
+};

package/test/test.js

@@ -0,0 +1,51 @@
+const { generateCode39SVG } = require('../src/index.js');
+const fs = require('fs');
+const path = require('path');
+
+try {
+    // 1. Probar generación con texto válido
+    const svg = generateCode39SVG('HOLA 123');
+    if (!svg.includes('<svg')) {
+        throw new Error("El SVG no se generó correctamente.");
+    }
+    if (!svg.includes('HOLA 123')) {
+        throw new Error("El texto no está presente en el SVG.");
+    }
+    console.log('✅ Prueba 1: Generación exitosa de SVG.');
+
+    // Guardar para inspección visual
+    const testOutputPath = path.join(__dirname, 'test_output.svg');
+    fs.writeFileSync(testOutputPath, svg);
+    console.log(`SVG de prueba guardado en: ${testOutputPath}`);
+
+    // 2. Probar manejo de errores
+    try {
+        generateCode39SVG('hola_mundo!');
+        throw new Error("Debería haber fallado por caracteres inválidos.");
+    } catch (e) {
+        if (e.message.includes('Carácter no válido')) {
+            console.log('✅ Prueba 2: Detección correcta de caracteres inválidos.');
+        } else {
+            throw e;
+        }
+    }
+
+    // 3. Probar opciones
+    const customSvg = generateCode39SVG('TEST', {
+        color: '#FF0000',
+        background: 'transparent',
+        showText: false
+    });
+    
+    if (customSvg.includes('#FF0000') && !customSvg.includes('TEST</text>')) {
+        console.log('✅ Prueba 3: Opciones personalizadas aplicadas correctamente.');
+    } else {
+        throw new Error("Opciones no aplicadas correctamente.");
+    }
+
+    console.log('\n¡Todas las pruebas pasaron satisfactoriamente!');
+
+} catch (error) {
+    console.error('❌ Error en las pruebas:', error);
+    process.exit(1);
+}