@datapos/datapos-development 0.3.409 → 0.3.411

package/dist/types/src/utilities/index.d.ts

@@ -2,7 +2,7 @@ import { Dirent, ObjectEncodingOptions, Stats } from 'node:fs';
 /** Interfaces/Types */
 export interface ModuleTypeConfig {
     idPrefix: string;
-    typeId: 'app' | 'api' | 'connector' | 'context' | 'development' | 'engine' | 'presenter' | 'resources' | 'shared' | 'tool';
+    typeId: 'app' | 'api' | 'connector' | 'context' | 'development' | 'engine' | 'eslint' | 'presenter' | 'resources' | 'shared' | 'tool';
     isPublish: boolean;
     uploadGroupName?: 'connectors' | 'contexts' | 'engine' | 'presenters' | 'tools';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datapos/datapos-development",
-    "version": "0.3.409",
+    "version": "0.3.411",
     "description": "A collection of utilities for managing Data Positioning projects.",
     "license": "MIT",
     "author": "Jonathan Terrell <terrell.jm@gmail.com>",
@@ -34,7 +34,10 @@
         "dist",
         "eslint.config.ts",
         "LICENSE",
-        "licenses/license-report-config.json"
+        "licenses/license-report-config.json",
+        "tsconfig.json",
+        "vite.config.ts",
+        "vitest.config.ts"
     ],
     "dependencies": {
         "@datapos/datapos-shared": "^0.3.330",

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+    "compilerOptions": {
+        "baseUrl": "./", // Makes relative imports like "src/..." resolve from the repo root.
+        "declaration": true, // Emit .d.ts files so consumers get typings.
+        "esModuleInterop": true, // Allow default-import syntax for CommonJS packages.
+        "isolatedModules": true, // Treat each file as a separate module; keeps Vite happy.
+        "lib": ["ESNext"], // Target the latest JavaScript libs and built-ins.
+        "module": "ESNext", // Generate native ESM output for bundlers.
+        "moduleResolution": "bundler", // Resolve modules like a bundler (needed for aliases and imports such as 'sonda/vite').
+        "noUncheckedIndexedAccess": true, // Enforce checks when indexing into objects or arrays.
+        "noImplicitAny": true, // Disallow implicit any types to keep everything typed.
+        "outDir": "dist", // Place compiler output in dist/.
+        "paths": {
+            // Configure import aliases used across the project.
+            "~/*": ["*"],
+            "@/*": ["src/*"]
+        },
+        "resolveJsonModule": true, // Allow importing JSON modules directly.
+        "skipLibCheck": true, // Skip type checking for .d.ts in node_modules to speed up builds.
+        "sourceMap": true, // Emit source maps for better debugging.
+        "strict": true, // Enable the full strict type-checking suite.
+        "strictNullChecks": true, // Major strict setting: enforce null/undefined checks.
+        "target": "ESNext", // Target latest JavaScript syntax when emitting.
+        "useDefineForClassFields": true // Use define semantics for class fields (aligns with JS standard).
+    },
+    "include": ["vite.config.*", "src/**/*", "tests/**/*"]
+}

package/vite.config.ts

@@ -0,0 +1,52 @@
+/**
+ * Vite configuration.
+ */
+
+// Dependencies - Vendor.
+import { defineConfig } from 'vite'; // Core Vite API.
+import dts from 'vite-plugin-dts'; // Emit .d.ts files alongside the bundle.
+import Sonda from 'sonda/vite'; // Visualize bundle results with Sonda plugin.
+import { visualizer } from 'rollup-plugin-visualizer'; // Generate bundle size report.
+import { fileURLToPath, URL } from 'node:url'; // ESM-safe path helpers.
+
+// Dependencies - Data.
+import config from './config.json' with { type: 'json' }; // Provide configuration identifier for naming.
+
+// Exposures - Configuration.
+export default defineConfig({
+    build: {
+        lib: {
+            entry: fileURLToPath(new URL('src/index.ts', import.meta.url)), // Absolute entry path.
+            fileName: (format) => `${config.id}.${format}.js`, // Bundle name derived from config identifier and format.
+            formats: ['es'] // Only emit native ES modules.
+        },
+        rollupOptions: {
+            external: ['@datapos/datapos-shared', 'dotenv', 'nanoid', 'node:child_process', 'node:fs', 'node:path', 'node:readline', 'node:url', 'node:util'], // Keep runtime dependencies out of bundle.
+            plugins: [
+                Sonda({
+                    filename: 'index', // Output file name.
+                    format: 'html', // Output file format.
+                    gzip: true, // Include gzip sizes.
+                    brotli: true, // Include brotli sizes.
+                    open: false, // Do not auto-open browser post-build.
+                    outputDir: './bundle-analysis-reports/sonda' // Output directory.
+                }), // Run Sonda analyser to generate additional bundle insights.
+                visualizer({
+                    filename: './bundle-analysis-reports/rollup-visualiser/index.html', // Output file path.
+                    open: false, // Do not auto-open browser post-build.
+                    gzipSize: true, // Include gzip sizes.
+                    brotliSize: true // Include brotli sizes.
+                })
+            ]
+        },
+        sourcemap: true,
+        target: 'ESNext' // Emit modern JavaScript for consumers.
+    },
+    plugins: [dts({ outDir: 'dist/types' })], // Generate type declarations in dist/types.
+    resolve: {
+        alias: {
+            '~': fileURLToPath(new URL('./', import.meta.url)), // Base alias matching tsconfig.
+            '@': fileURLToPath(new URL('src', import.meta.url)) // Source alias matching tsconfig.
+        }
+    }
+});

package/vitest.config.ts

@@ -0,0 +1,21 @@
+/**
+ * Vitest configuration.
+ */
+
+// Dependencies - Vendor.
+import { defineConfig } from 'vitest/config';
+import { resolve } from 'node:path';
+
+// Exposures - Configuration.
+export default defineConfig({
+    resolve: {
+        alias: {
+            '@': resolve(__dirname, './src')
+        }
+    },
+    test: {
+        globals: true,
+        include: ['tests/**/*.test.ts'],
+        environment: 'node'
+    }
+});