GMI Bundler Webpack

1.0.31-alpha.0 verified Sat Apr 25 auth: no javascript

A webpack bundler wrapper for the GMI framework ecosystem, version 1.0.31-alpha.0. Provides pre-configured webpack integration for GMI applications, handling asset bundling and module resolution. As an alpha release, it is unstable and subject to breaking changes. Differentiated by tight integration with GMI's module system, but lacks documentation and stability guarantees compared to standard webpack setups.

Common errors

error Module not found: Error: Can't resolve '@gmi/bundler-webpack' ↓

cause Package not installed or incorrect import path.

fix

Run 'npm install @gmi/bundler-webpack@1.0.31-alpha.0' and ensure import uses correct path.

error TypeError: gmiBundlerWebpack is not a constructor ↓

cause Attempting to use gmiBundlerWebpack as a constructor when it's a default export.

fix

Use 'new gmiBundlerWebpack.GmiWebpackPlugin()' or import named export.

error You may need an appropriate loader to handle this file type, currently no loaders are configured to process this file. ↓

cause Missing webpack loaders for file types used in GMI (e.g., .gmi files).

fix

Add appropriate loaders (e.g., @gmi/webpack-loader) to webpack config.

Warnings

breaking Alpha version may have incompatible changes without major version bump. ↓

fix Pin exact version and test after each alpha release.

deprecated gmiBundlerWebpack function deprecated in favor of GmiWebpackPlugin class. ↓

fix Use new GmiWebpackPlugin() instead of calling gmiBundlerWebpack().

gotcha Webpack 5 required; not compatible with webpack 4. ↓

fix Ensure project uses webpack 5.x.

Install

npm install gmi-bundler-webpack

yarn add gmi-bundler-webpack

pnpm add gmi-bundler-webpack

Imports

gmiBundlerWebpack

wrong

const { gmiBundlerWebpack } = require('@gmi/bundler-webpack')

correct

import gmiBundlerWebpack from '@gmi/bundler-webpack'

Default export; common mistake is destructuring named export. ESM-only.

GmiWebpackPlugin

wrong

import GmiWebpackPlugin from '@gmi/bundler-webpack'

correct

import { GmiWebpackPlugin } from '@gmi/bundler-webpack'

Named export for the plugin class.

GmiBundlerConfig

wrong

import { GmiBundlerConfig } from '@gmi/bundler-webpack'

correct

import type { GmiBundlerConfig } from '@gmi/bundler-webpack'

TypeScript type import; using value import will cause runtime error.

Quickstart

Shows configuration using TypeScript with GMI bundler webpack, including typed config and plugin instantiation.

import gmiBundlerWebpack from '@gmi/bundler-webpack';
import type { GmiBundlerConfig } from '@gmi/bundler-webpack';

const config: GmiBundlerConfig = {
  entry: './src/index.ts',
  output: {
    path: './dist',
    filename: 'bundle.js'
  },
  plugins: [
    new gmiBundlerWebpack.GmiWebpackPlugin()
  ]
};

export default config;