@walkeros/config 0.1.0

package/README.md

@@ -0,0 +1,141 @@
+# @walkeros/config
+
+Unified development configuration package for walkerOS projects. This package provides shared configurations for TypeScript, ESLint, Jest, and tsup build tooling.
+
+## Installation
+
+```bash
+npm install --save-dev @walkeros/config
+```
+
+## Usage
+
+### TypeScript Configuration
+
+Extend from one of the provided TypeScript configurations in your `tsconfig.json`:
+
+```json
+{
+  "extends": "@walkeros/config/tsconfig/base.json",
+  "compilerOptions": {
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"]
+}
+```
+
+**Available configs:**
+- `@walkeros/config/tsconfig/base.json` - Base configuration for all projects
+- `@walkeros/config/tsconfig/web.json` - Browser/web projects (extends base)
+- `@walkeros/config/tsconfig/node.json` - Node.js projects (extends base)
+
+### ESLint Configuration
+
+Import the configuration in your `eslint.config.mjs`:
+
+```javascript
+import baseConfig from '@walkeros/config/eslint';
+
+export default [
+  ...baseConfig,
+  {
+    // Your custom rules
+  },
+];
+```
+
+**Available configs:**
+- `@walkeros/config/eslint` - Base configuration with TypeScript and Jest support
+- `@walkeros/config/eslint/web` - Web projects with browser globals
+- `@walkeros/config/eslint/node` - Node.js projects with Node.js rules
+
+### Jest Configuration
+
+Use the shared Jest configuration in your `jest.config.mjs`:
+
+```javascript
+import baseConfig from '@walkeros/config/jest/web.config';
+
+export default {
+  ...baseConfig,
+  // Your custom configuration
+};
+```
+
+**Available configs:**
+- `@walkeros/config/jest` - Base Jest configuration with SWC transform
+- `@walkeros/config/jest/web.config` - Web projects with jsdom environment
+- `@walkeros/config/jest/node.config` - Node.js projects
+- `@walkeros/config/jest/web.setup` - Web test setup file
+- `@walkeros/config/jest/node.setup` - Node.js test setup file
+
+### tsup Configuration
+
+Use the shared build helpers in your `tsup.config.ts`:
+
+```typescript
+import { defineConfig, buildModules } from '@walkeros/config/tsup';
+
+export default defineConfig([buildModules()]);
+```
+
+**Available helpers:**
+- `defineConfig` - TypeScript-friendly config wrapper
+- `buildModules()` - Build CJS and ESM modules with type declarations
+- `buildExamples()` - Build example files
+- `buildBrowser()` - Build browser IIFE bundles
+- `buildES5()` - Build ES5-compatible bundles
+
+## Features
+
+- **TypeScript**: Strict type checking with modern ECMAScript targets
+- **ESLint**: TypeScript, React, and Jest linting with sensible defaults
+- **Jest**: Fast testing with SWC transforms and jsdom support
+- **tsup**: Simple, fast bundling with multiple output formats
+
+## Migration from Separate Packages
+
+If you were previously using the separate config packages (`@walkeros/tsconfig`, `@walkeros/eslint`, `@walkeros/jest`, `@walkeros/tsup`), update your imports:
+
+**Before:**
+```json
+// package.json
+"devDependencies": {
+  "@walkeros/eslint": "*",
+  "@walkeros/jest": "*",
+  "@walkeros/tsconfig": "*",
+  "@walkeros/tsup": "*"
+}
+```
+
+```typescript
+// Config files
+import from '@walkeros/eslint/index.mjs';
+import from '@walkeros/jest/web.config.mjs';
+import from '@walkeros/tsup';
+{ "extends": "@walkeros/tsconfig/base.json" }
+```
+
+**After:**
+```json
+// package.json
+"devDependencies": {
+  "@walkeros/config": "^0.1.0"
+}
+```
+
+```typescript
+// Config files
+import from '@walkeros/config/eslint';
+import from '@walkeros/config/jest/web.config';
+import from '@walkeros/config/tsup';
+{ "extends": "@walkeros/config/tsconfig/base.json" }
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Issues and pull requests are welcome at [github.com/elbwalker/walkerOS](https://github.com/elbwalker/walkerOS).

package/eslint/index.mjs

@@ -0,0 +1,43 @@
+import typescriptEslint from '@typescript-eslint/eslint-plugin';
+import jest from 'eslint-plugin-jest';
+import globals from 'globals';
+import tsParser from '@typescript-eslint/parser';
+
+export default [
+  {
+    ignores: [
+      '**/coverage/**',
+      '**/dist/**',
+      '**/build/**',
+      '**/node_modules/**',
+      '**/__mocks__/**',
+    ],
+  },
+  {
+    files: ['**/*.{js,ts,tsx}'],
+    plugins: {
+      '@typescript-eslint': typescriptEslint,
+      jest,
+    },
+    languageOptions: {
+      parser: tsParser,
+      globals: {
+        ...globals.jest,
+      },
+    },
+    rules: {
+      'no-console': 'warn',
+      'jest/no-disabled-tests': 'warn',
+      'jest/no-focused-tests': 'error',
+      '@typescript-eslint/no-explicit-any': 'error',
+    },
+  },
+  {
+    // Relaxed rules for test files
+    files: ['**/*.test.{js,ts,tsx}', '**/__tests__/**/*.{js,ts,tsx}'],
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      'no-console': 'off',
+    },
+  },
+];

package/eslint/node.mjs

@@ -0,0 +1,19 @@
+import baseConfig from '@walkeros/config/eslint';
+import globals from 'globals';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.{js,ts,tsx}'],
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+    rules: {
+      'no-process-exit': 'error',
+      'no-path-concat': 'error',
+      'no-buffer-constructor': 'error',
+    },
+  },
+];

package/eslint/web.mjs

@@ -0,0 +1,17 @@
+import baseConfig from '@walkeros/config/eslint';
+import globals from 'globals';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.{js,ts,tsx}'],
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+      },
+    },
+    rules: {
+      // web-specific rules
+    },
+  },
+];

package/jest/index.mjs

@@ -0,0 +1,117 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { readFileSync } from 'fs';
+
+const isWatchMode = process.argv.includes('--watchAll');
+const packagesDir = path.join(
+  path.dirname(fileURLToPath(import.meta.url)),
+  '..',
+  '..',
+  '..',
+  '/',
+);
+
+function getDirectory(dir) {
+  return path.join(packagesDir, dir);
+}
+
+function getModuleMapper() {
+  if (!isWatchMode) return {};
+
+  return {
+    '^@walkeros/core$': getDirectory('core/src/'),
+    '^@walkeros/collector$': getDirectory('collector/src/'),
+    '^@walkeros/web-core$': getDirectory('web/core/src/'),
+    '^@walkeros/web-destination-gtag$': getDirectory(
+      'web/destinations/gtag/src/',
+    ),
+    '^@walkeros/web-destination-api$': getDirectory(
+      'web/destinations/api/src/',
+    ),
+    '^@walkeros/web-destination-meta$': getDirectory(
+      'web/destinations/meta/src/',
+    ),
+    '^@walkeros/web-destination-piwikpro$': getDirectory(
+      'web/destinations/piwikpro/src/',
+    ),
+    '^@walkeros/web-destination-plausible$': getDirectory(
+      'web/destinations/plausible/src/',
+    ),
+    '^@walkeros/web-source-browser$': getDirectory('web/sources/browser/src/'),
+    '^@walkeros/web-source-datalayer$': getDirectory(
+      'web/sources/dataLayer/src/',
+    ),
+    '^@walkeros/server-core$': getDirectory('server/core/src/'),
+    '^@walkeros/server-destination-aws$': getDirectory(
+      'server/destinations/aws/src/',
+    ),
+    '^@walkeros/server-destination-gcp$': getDirectory(
+      'server/destinations/gcp/src/',
+    ),
+    '^@walkeros/server-destination-meta$': getDirectory(
+      'server/destinations/meta/src/',
+    ),
+  };
+}
+
+function getGlobals() {
+  // Auto-inject package version for tests
+  let version = '0.0.0';
+  try {
+    const packagePath = path.join(process.cwd(), 'package.json');
+    const pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
+    version = pkg.version || '0.0.0';
+  } catch (error) {
+    console.warn('Could not read package.json for version injection in tests:', error.message);
+  }
+
+  return {
+    __VERSION__: version,
+  };
+}
+
+const config = {
+  transform: {
+    '^.+\\.(t|j)sx?$': [
+      '@swc/jest',
+      {
+        jsc: {
+          target: 'es2022',
+          parser: {
+            syntax: 'typescript',
+            tsx: true,
+          },
+        },
+        module: {
+          type: 'es6',
+        },
+      },
+    ],
+  },
+  transformIgnorePatterns: ['/node_modules/(?!(@walkerOS)/)'],
+  testMatch: ['<rootDir>/**/*.test.(ts|tsx|js|jsx)'],
+  moduleFileExtensions: ['js', 'ts', 'tsx', 'mjs'],
+  rootDir: '.',
+  moduleDirectories: ['node_modules', 'src'],
+  extensionsToTreatAsEsm: ['.ts', '.tsx'],
+  moduleNameMapper: getModuleMapper(),
+  globals: getGlobals(),
+  
+  // Performance settings - fixed values for consistent behavior
+  maxWorkers: 4,
+  testTimeout: 30000,
+  forceExit: true,
+  clearMocks: true,
+  restoreMocks: true,
+  detectOpenHandles: true,
+  
+  // Enhanced ignore patterns
+  testPathIgnorePatterns: [
+    '/node_modules/',
+    '/dist/',
+    '/build/',
+    '/coverage/'
+  ],
+};
+
+export default config;

package/jest/node.config.mjs

@@ -0,0 +1,7 @@
+import baseConfig from '@walkeros/config/jest';
+
+const config = {
+  setupFilesAfterEnv: ['@walkeros/config/jest/node.setup'],
+};
+
+export default { ...baseConfig, ...config };

package/jest/node.setup.ts

@@ -0,0 +1,13 @@
+const mockDataLayer = jest.fn(); //.mockImplementation(console.log);
+
+global.beforeEach(() => {
+  jest.useFakeTimers();
+
+  // Mocks
+  jest.clearAllMocks();
+  jest.resetModules();
+});
+
+global.afterEach(() => {});
+
+export { mockDataLayer };

package/jest/web.config.mjs

@@ -0,0 +1,8 @@
+import baseConfig from '@walkeros/config/jest';
+
+const config = {
+  setupFilesAfterEnv: ['@walkeros/config/jest/web.setup'],
+  testEnvironment: 'jsdom',
+};
+
+export default { ...baseConfig, ...config };

package/jest/web.setup.ts

@@ -0,0 +1,30 @@
+import '@testing-library/jest-dom';
+
+const mockDataLayer = jest.fn(); //.mockImplementation(console.log);
+
+global.beforeEach(() => {
+  jest.useFakeTimers();
+
+  // Mocks
+  jest.clearAllMocks();
+  jest.resetModules();
+
+  // reset DOM with event listeners etc.
+  document.getElementsByTagName('html')[0].innerHTML = '';
+  document.body = document.body.cloneNode() as HTMLElement;
+
+  // elbLayer and dataLayer
+  const w = window as unknown as Record<string, unknown | unknown[]>;
+  w.elbLayer = undefined;
+  w.dataLayer = [];
+  (w.dataLayer as unknown[]).push = mockDataLayer;
+
+  // Performance
+  global.performance.getEntriesByType = jest
+    .fn()
+    .mockReturnValue([{ type: 'navigate' }]);
+});
+
+global.afterEach(() => {});
+
+export { mockDataLayer };

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@walkeros/config",
+  "version": "0.1.0",
+  "description": "Shared development configuration for walkerOS packages (TypeScript, ESLint, Jest, tsup)",
+  "license": "MIT",
+  "files": [
+    "tsconfig/**/*.json",
+    "eslint/**/*.mjs",
+    "jest/**/*.mjs",
+    "jest/**/*.ts",
+    "tsup/**/*.mjs",
+    "tsup/**/*.d.ts"
+  ],
+  "exports": {
+    "./tsconfig/base.json": "./tsconfig/base.json",
+    "./tsconfig/web.json": "./tsconfig/web.json",
+    "./tsconfig/node.json": "./tsconfig/node.json",
+    "./eslint": "./eslint/index.mjs",
+    "./eslint/web": "./eslint/web.mjs",
+    "./eslint/node": "./eslint/node.mjs",
+    "./jest": "./jest/index.mjs",
+    "./jest/web.config": "./jest/web.config.mjs",
+    "./jest/node.config": "./jest/node.config.mjs",
+    "./jest/web.setup": "./jest/web.setup.ts",
+    "./jest/node.setup": "./jest/node.setup.ts",
+    "./tsup": "./tsup/index.mjs"
+  },
+  "dependencies": {
+    "@swc/core": "^1.11.13",
+    "@swc/jest": "^0.2.37",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@types/jest": "^29.5.14",
+    "@eslint/js": "^9.23.0",
+    "@typescript-eslint/eslint-plugin": "^8.28.0",
+    "@typescript-eslint/parser": "^8.28.0",
+    "eslint": "^9.23.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-jest": "^28.11.0",
+    "eslint-plugin-only-warn": "^1.1.0",
+    "eslint-plugin-react": "^7.37.4",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-turbo": "^2.4.4",
+    "globals": "^16.0.0",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "tsup": "^8.4.0",
+    "terser": "^5.39.0",
+    "typescript": "^5.8.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "url": "git+https://github.com/elbwalker/walkerOS.git",
+    "directory": "packages/config"
+  },
+  "author": "elbwalker <hello@elbwalker.com>",
+  "homepage": "https://github.com/elbwalker/walkerOS#readme",
+  "bugs": {
+    "url": "https://github.com/elbwalker/walkerOS/issues"
+  },
+  "keywords": [
+    "walker",
+    "walkerOS",
+    "config",
+    "typescript",
+    "eslint",
+    "jest",
+    "tsup",
+    "development"
+  ],
+  "funding": [
+    {
+      "type": "GitHub Sponsors",
+      "url": "https://github.com/sponsors/elbwalker"
+    }
+  ]
+}

package/tsconfig/base.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Base",
+  "compilerOptions": {
+    "composite": false,
+    "declaration": true,
+    "declarationMap": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "moduleResolution": "bundler",
+    "module": "es2015",
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "preserveWatchOutput": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "target": "es2022",
+    "allowJs": true,
+    "resolveJsonModule": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "baseUrl": "."
+  },
+  "exclude": ["node_modules", "**/dist", "**/*.d.ts"]
+}

package/tsconfig/node.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Node",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["es2018"],
+    "target": "es2018"
+  }
+}

package/tsconfig/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@walkeros/tsconfig",
+  "version": "0.0.8",
+  "private": true,
+  "license": "MIT",
+  "files": [
+    "*.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/tsconfig/web.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Web",
+  "extends": "./base.json",
+  "compilerOptions": {
+    "lib": ["dom", "es2018"],
+    "target": "es2018"
+  }
+}

package/tsup/index.d.ts

@@ -0,0 +1,16 @@
+import { Options, defineConfig } from 'tsup';
+
+declare const baseConfig: Options;
+declare const buildModules: (customConfig?: Partial<Options>) => Options;
+declare const buildExamples: (customConfig?: Partial<Options>) => Options;
+declare const buildBrowser: (customConfig?: Partial<Options>) => Options;
+declare const buildES5: (customConfig?: Partial<Options>) => Options;
+
+export {
+  baseConfig,
+  defineConfig,
+  buildModules,
+  buildExamples,
+  buildBrowser,
+  buildES5,
+};

package/tsup/index.mjs

@@ -0,0 +1,83 @@
+import { defineConfig } from 'tsup';
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
+
+const baseConfig = {
+  entry: ['src/index.ts'],
+  minify: 'terser',
+  splitting: false,
+};
+
+// Modules
+const buildModules = (customConfig = {}) => {
+  // Auto-inject package version
+  let version = '0.0.0';
+  try {
+    const packagePath = resolve(process.cwd(), 'package.json');
+    const pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
+    version = pkg.version || '0.0.0';
+  } catch (error) {
+    console.warn('Could not read package.json for version injection:', error.message);
+  }
+
+  return {
+    ...baseConfig,
+    clean: true,
+    format: ['cjs', 'esm'],
+    outExtension({ format }) {
+      return { js: format === 'esm' ? '.mjs' : '.js' };
+    },
+    dts: true,
+    sourcemap: true,
+    declaration: true,
+    declarationMap: true,
+    define: {
+      __VERSION__: JSON.stringify(version),
+      ...customConfig.define,
+    },
+    ...customConfig,
+  };
+};
+
+// Examples
+const buildExamples = (customConfig = {}) => ({
+  ...baseConfig,
+  entry: { 'examples/index': 'src/examples/index.ts' },
+  dts: true,
+  minify: false,
+  format: ['cjs', 'esm'],
+  outExtension({ format }) {
+    return { js: format === 'esm' ? '.mjs' : '.js' };
+  },
+  ...customConfig,
+});
+
+// Browser
+const buildBrowser = (customConfig = {}) => ({
+  ...baseConfig,
+  format: ['iife'],
+  outExtension() {
+    return { js: `.browser.js` };
+  },
+  ...customConfig,
+});
+
+// ES5
+const buildES5 = (customConfig = {}) => ({
+  ...baseConfig,
+  format: ['iife'],
+  target: 'es5',
+  outExtension() {
+    return { js: `.es5.js` };
+  },
+  ...customConfig,
+});
+
+export {
+  baseConfig,
+  buildModules,
+  buildExamples,
+  buildBrowser,
+  buildES5,
+  defineConfig,
+};