@questwork/q-utilities 0.1.32 → 0.1.33

package/eslint.config.js

@@ -1,3 +0,0 @@
-import qec from '@questwork/q-eslint-config'
-
-export default qec()

package/tests/runtime-test.js

@@ -1,563 +0,0 @@
-// tests/runtime-test.js
-import { exec } from 'child_process'
-import fs from 'fs'
-import path from 'path'
-import { fileURLToPath } from 'url'
-import http from 'http'
-import { promisify } from 'util'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const PROJECT_ROOT = path.resolve(__dirname, '..')
-const execPromise = promisify(exec)
-
-console.log('📁 Project root:', PROJECT_ROOT)
-console.log('🧪 Testing @questwork/q-utilities builds\n')
-
-// Check if build exists
-function checkBuild() {
-  const distPath = path.join(PROJECT_ROOT, 'dist')
-  if (!fs.existsSync(distPath)) {
-    console.error('\n❌ Build not found! Please run build first:')
-    console.error('   pnpm run build\n')
-    process.exit(1)
-  }
-
-  const requiredFiles = [
-    'q-utilities.esm.js',
-    'q-utilities.cjs',
-    'q-utilities.umd.js',
-    'q-utilities.iife.js'
-  ]
-
-  const missing = requiredFiles.filter(file => {
-    const filePath = path.join(distPath, file)
-    return !fs.existsSync(filePath)
-  })
-
-  if (missing.length > 0) {
-    console.error('\n❌ Missing build files:', missing.join(', '))
-    console.error('   Please run: pnpm run build\n')
-    process.exit(1)
-  }
-
-  console.log('✅ Build files found:\n')
-  requiredFiles.forEach(file => {
-    const stats = fs.statSync(path.join(distPath, file))
-    console.log(`   📦 ${file}: ${(stats.size / 1024).toFixed(2)} KB`)
-  })
-  console.log('')
-}
-
-// Test ESM format (import)
-async function testESM() {
-  console.log('🧪 Testing ESM format (import)...')
-
-  const testFilePath = path.join(PROJECT_ROOT, 'test-temp-esm.mjs')
-
-  const testCode = `
-    import { fileURLToPath } from 'url'
-    import path from 'path'
-    
-    const __filename = fileURLToPath(import.meta.url)
-    const __dirname = path.dirname(__filename)
-    
-    try {
-      const projectRoot = ${JSON.stringify(PROJECT_ROOT)}
-      const modulePath = path.join(projectRoot, 'dist/q-utilities.esm.js')
-      console.log('📂 Loading from:', modulePath)
-      
-      const module = await import(modulePath)
-      console.log('✅ ESM module loaded successfully')
-      console.log('📦 Exports:', Object.keys(module))
-      
-      // Test specific exports based on your library
-      if (module.default) {
-        console.log('✅ Default export exists')
-      }
-      
-      // Check for common utility functions (adjust based on your actual exports)
-      const expectedExports = ['default', 'displayName', 'TrackedEntity'] // Replace with actual exports
-      expectedExports.forEach(exp => {
-        if (module[exp]) {
-          console.log(\`✅ Export "\${exp}" found\`)
-        }
-      })
-      
-      console.log(module)
-      const { displayName, TrackedEntity } = module
-      console.log(new TrackedEntity())
-      
-      process.exit(0)
-    } catch (error) {
-      console.error('❌ ESM test failed:', error.message)
-      console.error(error.stack)
-      process.exit(1)
-    }
-  `
-
-  fs.writeFileSync(testFilePath, testCode)
-
-  try {
-    const { stdout, stderr } = await execPromise(`node ${testFilePath}`)
-    console.log(stdout)
-    if (stderr) console.error(stderr)
-    return true
-  } catch (error) {
-    console.error('❌ ESM test execution failed:', error.message)
-    return false
-  } finally {
-    if (fs.existsSync(testFilePath)) {
-      fs.unlinkSync(testFilePath)
-    }
-  }
-}
-
-// Test CJS format (require)
-async function testCJS() {
-  console.log('\n🧪 Testing CJS format (require)...')
-
-  const testFilePath = path.join(PROJECT_ROOT, 'test-temp-cjs.cjs')
-
-  const testCode = `
-    const path = require('path')
-    
-    try {
-      const projectRoot = ${JSON.stringify(PROJECT_ROOT)}
-      const modulePath = path.join(projectRoot, 'dist/q-utilities.cjs')
-      console.log('📂 Loading from:', modulePath)
-      
-      const module = require(modulePath)
-      console.log('✅ CJS module loaded successfully')
-      console.log('📦 Exports:', Object.keys(module))
-      
-      // Test specific exports
-      if (module.default) {
-        console.log('✅ Default export exists')
-      }
-
-      console.log(module)
-      const { displayName, TrackedEntity } = module
-      console.log(new TrackedEntity())
-      
-      process.exit(0)
-    } catch (error) {
-      console.error('❌ CJS test failed:', error.message)
-      console.error(error.stack)
-      process.exit(1)
-    }
-  `
-
-  fs.writeFileSync(testFilePath, testCode)
-
-  try {
-    const { stdout, stderr } = await execPromise(`node ${testFilePath}`)
-    console.log(stdout)
-    if (stderr) console.error(stderr)
-    return true
-  } catch (error) {
-    console.error('❌ CJS test execution failed:', error.message)
-    return false
-  } finally {
-    if (fs.existsSync(testFilePath)) {
-      fs.unlinkSync(testFilePath)
-    }
-  }
-}
-
-// Test UMD format in Node.js (CommonJS environment)
-async function testUMD() {
-  console.log('\n🧪 Testing UMD format (Node.js require)...')
-
-  const testFilePath = path.join(PROJECT_ROOT, 'test-temp-umd.cjs')
-
-  const testCode = `
-    const path = require('path')
-
-    try {
-      const projectRoot = ${JSON.stringify(PROJECT_ROOT)}
-      const modulePath = path.join(projectRoot, 'dist/q-utilities.umd.js')
-      console.log('📂 Loading from:', modulePath)
-      
-      const module = require(modulePath)
-      console.log('✅ UMD module loaded successfully in Node.js')
-      console.log('📦 Exports:', Object.keys(module))
-
-      console.log(module)
-      // const { displayName, TrackedEntity } = module
-      // console.log(new TrackedEntity())
-      
-      process.exit(0)
-    } catch (error) {
-      console.error('❌ UMD test failed:', error.message)
-      console.error(error.stack)
-      process.exit(1)
-    }
-  `
-
-  fs.writeFileSync(testFilePath, testCode)
-
-  try {
-    const { stdout, stderr } = await execPromise(`node ${testFilePath}`)
-    console.log(stdout)
-    if (stderr) console.error(stderr)
-    return true
-  } catch (error) {
-    console.error('❌ UMD test execution failed:', error.message)
-    return false
-  } finally {
-    if (fs.existsSync(testFilePath)) {
-      fs.unlinkSync(testFilePath)
-    }
-  }
-}
-
-// Test IIFE format in browser
-async function testIIFE() {
-  console.log('\n🧪 Testing IIFE format (browser)...')
-
-  const distPath = path.join(PROJECT_ROOT, 'dist')
-  const htmlPath = path.join(PROJECT_ROOT, 'tests/test-iife.html')
-
-  // Ensure tests directory exists
-  const testsDir = path.join(PROJECT_ROOT, 'tests')
-  if (!fs.existsSync(testsDir)) {
-    fs.mkdirSync(testsDir)
-  }
-
-  const html = `
-    <!DOCTYPE html>
-    <html>
-    <head>
-      <title>IIFE Test - @questwork/q-utilities</title>
-      <style>
-        body {
-          font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, monospace;
-          padding: 20px;
-          max-width: 1200px;
-          margin: 0 auto;
-        }
-        .success { color: #22c55e; font-weight: bold; }
-        .error { color: #ef4444; font-weight: bold; }
-        .info { color: #3b82f6; }
-        .warning { color: #f59e0b; }
-        pre {
-          background: #1e1e1e;
-          color: #d4d4d4;
-          padding: 15px;
-          border-radius: 8px;
-          overflow-x: auto;
-          font-size: 12px;
-        }
-        .test-card {
-          border: 1px solid #e5e7eb;
-          border-radius: 8px;
-          padding: 20px;
-          margin: 20px 0;
-          background: #f9fafb;
-        }
-        .test-card h3 {
-          margin-top: 0;
-          color: #111827;
-        }
-        .badge {
-          display: inline-block;
-          padding: 2px 8px;
-          border-radius: 4px;
-          font-size: 12px;
-          font-weight: bold;
-          margin-left: 10px;
-        }
-        .badge-esm { background: #3b82f6; color: white; }
-        .badge-cjs { background: #8b5cf6; color: white; }
-        .badge-umd { background: #ec489a; color: white; }
-        .badge-iife { background: #10b981; color: white; }
-      </style>
-    </head>
-    <body>
-      <h1>🧪 @questwork/q-utilities - IIFE Build Test</h1>
-      <p>Testing the IIFE build in browser environment</p>
-      
-      <div class="test-card">
-        <h3>📦 qUtilities Global Object <span class="badge badge-iife">IIFE</span></h3>
-        <div id="test-results"></div>
-      </div>
-      
-      <div class="test-card">
-        <h3>🔧 Available Utilities <span class="badge badge-iife">IIFE</span></h3>
-        <div id="utilities-list"></div>
-      </div>
-      
-      <!-- Load the IIFE build -->
-      <script src="../dist/q-utilities.iife.js"></script>
-      
-      <script>
-        const results = document.getElementById('test-results');
-        const utilitiesList = document.getElementById('utilities-list');
-        
-        function addResult(message, isError = false, isWarning = false) {
-          const div = document.createElement('div');
-          div.textContent = message;
-          div.style.margin = '8px 0';
-          div.style.padding = '8px';
-          div.style.borderRadius = '4px';
-          
-          if (isError) {
-            div.style.color = '#ef4444';
-            div.style.backgroundColor = '#fef2f2';
-            div.style.borderLeft = '4px solid #ef4444';
-          } else if (isWarning) {
-            div.style.color = '#f59e0b';
-            div.style.backgroundColor = '#fffbeb';
-            div.style.borderLeft = '4px solid #f59e0b';
-          } else {
-            div.style.color = '#22c55e';
-            div.style.backgroundColor = '#f0fdf4';
-            div.style.borderLeft = '4px solid #22c55e';
-          }
-          
-          results.appendChild(div);
-        }
-        
-        function addUtility(name, value) {
-          const div = document.createElement('div');
-          div.style.margin = '8px 0';
-          div.style.padding = '8px';
-          div.style.backgroundColor = '#f3f4f6';
-          div.style.borderRadius = '4px';
-          div.style.fontFamily = 'monospace';
-          
-          const type = typeof value;
-          const typeColor = type === 'function' ? '#3b82f6' : '#8b5cf6';
-          
-          div.innerHTML = \`
-            <strong style="color: #111827;">\${name}</strong>
-            <span style="color: \${typeColor}; margin-left: 10px;">(\${type})</span>
-            <pre style="margin-top: 8px; font-size: 11px; background: white;">\${JSON.stringify(value, null, 2).substring(0, 200)}\${JSON.stringify(value, null, 2).length > 200 ? '...' : ''}</pre>
-          \`;
-          
-          utilitiesList.appendChild(div);
-        }
-        
-        try {
-          // Check if library loaded
-          if (typeof window.qUtilities !== 'undefined') {
-            const { qUtilities } = window
-            const { displayName, TrackedEntity } = qUtilities
-            console.log(new TrackedEntity(), displayName)
-
-            addResult('✅ IIFE module loaded successfully');
-            addResult('📦 Global export: qUtilities found on window');
-            
-            const exports = Object.keys(window.qUtilities);
-            addResult(\`📦 Exports found: \${exports.length} exports\`);
-            
-            // List all exports
-            if (exports.length > 0) {
-              addResult(\`🔍 Available exports: \${exports.join(', ')}\`);
-              
-              // Show details of each export
-              exports.forEach(exp => {
-                const value = window.qUtilities[exp];
-                addUtility(exp, value);
-              });
-            } else {
-              addResult('⚠️ No exports found in qUtilities object', false, true);
-            }
-            
-            // Check for default export
-            if (window.qUtilities.default) {
-              addResult('✅ Default export exists');
-            }
-            
-            addResult('✨ All IIFE tests passed!');
-          } else {
-            throw new Error('qUtilities not found on window object');
-          }
-        } catch (error) {
-          addResult('❌ IIFE test failed: ' + error.message, true);
-          console.error(error);
-        }
-        
-        // Check if any other Questwork globals exist
-        const questworkGlobals = Object.keys(window).filter(key => 
-          key.toLowerCase().includes('qutil') || 
-          key.toLowerCase().includes('quest') ||
-          key === 'qUtilities'
-        );
-        
-        if (questworkGlobals.length > 1) {
-          console.log('Other Questwork globals found:', questworkGlobals);
-        }
-      </script>
-    </body>
-    </html>
-  `
-
-  fs.writeFileSync(htmlPath, html)
-
-  console.log('📄 Test HTML created at:', htmlPath)
-  console.log('🌐 You can open it in browser:')
-  console.log(`   file://${htmlPath}\n`)
-
-  // Start a simple server for better testing
-  const server = http.createServer((req, res) => {
-    // Map requests to files
-    let filePath = req.url === '/' ? htmlPath : path.join(PROJECT_ROOT, req.url)
-
-    // Security: only serve files within project
-    if (!filePath.startsWith(PROJECT_ROOT)) {
-      res.writeHead(403)
-      res.end('Forbidden')
-      return
-    }
-
-    // Check if file exists
-    if (!fs.existsSync(filePath)) {
-      res.writeHead(404)
-      res.end('Not found')
-      return
-    }
-
-    const ext = path.extname(filePath)
-    const contentType = {
-      '.html': 'text/html',
-      '.js': 'application/javascript',
-      '.css': 'text/css',
-      '.json': 'application/json',
-      '.map': 'application/json',
-      '.cjs': 'application/javascript',
-      '.mjs': 'application/javascript'
-    }[ext] || 'text/plain'
-
-    fs.readFile(filePath, (err, data) => {
-      if (err) {
-        res.writeHead(500)
-        res.end('Server error')
-      } else {
-        res.writeHead(200, {
-          'Content-Type': contentType,
-          'Cache-Control': 'no-cache'
-        })
-        res.end(data)
-      }
-    })
-  })
-
-  server.listen(3000, () => {
-    console.log('🌐 Test server running at http://localhost:3000')
-    console.log('   Open this URL to test IIFE build in browser')
-    console.log('   Press Ctrl+C to stop server when done\n')
-  })
-
-  return server
-}
-
-// Test UMD format in browser (using script tag)
-async function testUMDInBrowser() {
-  console.log('\n🧪 Testing UMD format in browser...')
-
-  const htmlPath = path.join(PROJECT_ROOT, 'tests/test-umd.html')
-
-  const html = `
-    <!DOCTYPE html>
-    <html>
-    <head>
-      <title>UMD Test - @questwork/q-utilities</title>
-      <style>
-        body { font-family: monospace; padding: 20px; }
-        .success { color: green; }
-        .error { color: red; }
-        pre { background: #f5f5f5; padding: 10px; border-radius: 5px; }
-      </style>
-    </head>
-    <body>
-      <h1>🧪 UMD Build Test (Browser)</h1>
-      <div id="results"></div>
-      
-      <!-- Load UMD build -->
-      <script src="../dist/q-utilities.umd.js"></script>
-      
-      <script>
-        const results = document.getElementById('results');
-        
-        function addResult(message, isError = false) {
-          const div = document.createElement('div');
-          div.textContent = message;
-          div.style.color = isError ? 'red' : 'green';
-          div.style.margin = '5px 0';
-          results.appendChild(div);
-        }
-        
-        try {
-          if (typeof window.qUtilities !== 'undefined') {
-            const { qUtilities } = window
-            const { displayName, TrackedEntity } = qUtilities
-            console.log(new TrackedEntity(), displayName)
-
-            addResult('✅ UMD module loaded successfully');
-            addResult('📦 Exports: ' + JSON.stringify(Object.keys(window.qUtilities)));
-            addResult('✨ All UMD tests passed!');
-          } else {
-            throw new Error('qUtilities not found');
-          }
-        } catch (error) {
-          addResult('❌ UMD test failed: ' + error.message, true);
-        }
-      </script>
-    </body>
-    </html>
-  `
-
-  fs.writeFileSync(htmlPath, html)
-  console.log('📄 UMD test HTML created at:', htmlPath)
-  console.log('   http://localhost:3000/tests/test-umd.html')
-}
-
-// Main test runner
-async function runTests() {
-  console.log('🚀 Starting runtime tests for @questwork/q-utilities\n')
-  console.log('=' .repeat(60))
-
-  // Check build first
-  checkBuild()
-
-  // Run Node.js tests
-  const esmPassed = await testESM()
-  const cjsPassed = await testCJS()
-  const umdPassed = await testUMD()
-
-  // Display results
-  console.log('\n' + '=' .repeat(60))
-  console.log('\n📊 Test Results:\n')
-  console.log(`ESM (import):  ${esmPassed ? '✅ PASSED' : '❌ FAILED'}`)
-  console.log(`CJS (require): ${cjsPassed ? '✅ PASSED' : '❌ FAILED'}`)
-  console.log(`UMD (require): ${umdPassed ? '✅ PASSED' : '❌ FAILED'}`)
-
-  if (esmPassed && cjsPassed && umdPassed) {
-    console.log('\n✨ All Node.js tests passed!')
-  } else {
-    console.log('\n⚠️  Some Node.js tests failed')
-  }
-
-  // Generate browser test files
-  await testUMDInBrowser()
-
-  // Start IIFE test server
-  const server = await testIIFE()
-
-  console.log('\n📝 Browser Test Instructions:')
-  console.log('1. Open http://localhost:3000 to test IIFE build')
-  console.log('2. Open http://localhost:3000/tests/test-umd.html to test UMD build')
-  console.log('3. Check browser console for detailed logs')
-  console.log('\nPress Ctrl+C to stop the server\n')
-
-  // Keep server running
-  process.on('SIGINT', () => {
-    console.log('\n🛑 Shutting down test server...')
-    server.close()
-    process.exit(0)
-  })
-}
-
-// Run tests
-runTests().catch(console.error)

package/tsconfig.json

@@ -1,28 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "lib": ["ES2020"],
-    "allowJs": true,
-    "checkJs": false,
-    "jsx": "preserve",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./lib",
-    "strict": false,
-    "moduleResolution": "node",
-    "allowSyntheticDefaultImports": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": [
-    "lib/**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}

package/vite.config.js

@@ -1,73 +0,0 @@
-import { defineConfig } from 'vite'
-import path from 'path'
-import dts from 'vite-plugin-dts'
-
-export default defineConfig({
-  plugins: [
-    dts({
-      include: ['lib/**/*.js', 'lib/**/*.ts'],
-      exclude: ['**/*.spec.js', '**/*.spec.ts'],
-      rollupTypes: true,
-      outDir: 'dist',
-      rootDir: 'lib',
-    }),
-  ],
-  build: {
-    outDir: 'dist',
-    sourcemap: true,
-    lib: {
-      entry: path.resolve(__dirname, 'lib/index.ts'),
-      name: 'qUtilities', // This is the global variable name for IIFE/UMD
-      fileName: (format) => {
-        if (format === 'es') return 'q-utilities.esm.js'
-        if (format === 'cjs') return 'q-utilities.cjs'
-        if (format === 'umd') return 'q-utilities.umd.js'
-        if (format === 'iife') return 'q-utilities.iife.js'
-        return `q-utilities.${format}.js`
-      }
-    },
-    rollupOptions: {
-      external: [],
-      output: [
-        {
-          format: 'es',
-          generatedCode: 'es2015',
-          exports: 'named',
-          preserveModules: false
-        },
-        {
-          format: 'cjs',
-          exports: 'named',
-          interop: 'auto'
-        },
-        {
-          format: 'umd',
-          name: 'qUtilities',
-          exports: 'named',
-          extend: true,
-          esModule: true,
-          interop: 'auto'
-        },
-        {
-          format: 'iife',
-          name: 'qUtilities',
-          exports: 'named',
-          extend: true,
-          esModule: false,
-          interop: 'auto'
-        },
-      ],
-    },
-  },
-  test: {
-    environment: 'node',
-    coverage: {
-      reporter: ['text', 'html'],
-    },
-    globals: true,
-    setupFiles: ['lib/test.setup.js', 'lib/helpers/test.setup.js'],
-    mocha: {
-      ui: 'bdd',
-    },
-  },
-})

package/vitest.config.js

@@ -1,9 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    globals: true, // Required for your setup file's global hooks
-    setupFiles: ['./lib/test.setup.js'],
-    include: ['lib/**/*.spec.js'],
-  },
-})