gulp-aum-import

0.0.2 verified Fri May 01 auth: no javascript abandoned

Gulp plugin that transpiles Aum particle imports (e.g. #import) into resolved dependencies. Version 0.0.2, currently in early experimental stage. No active releases since 2016. Differentiators: integrates with Aum MVC framework's particle system; minimal API surface. Alternatives: direct Aum CLI tools or Webpack loaders.

Common errors

error Error: Cannot find module 'gulp-aum-import' ↓

cause Package not installed or missing in node_modules.

fix

Run npm install gulp-aum-import --save-dev

error TypeError: aumImport is not a function ↓

cause Incorrect import style (e.g., named import instead of default).

fix

Use import aumImport from 'gulp-aum-import'

Warnings

gotcha Plugin only works with .aum files, not standard JavaScript. ↓

fix Ensure source glob matches .aum extension.

deprecated Package has not been updated since 2016; consider using Aum CLI or Webpack loader. ↓

fix Migrate to aum-tools or @aum/webpack-loader.

gotcha Does not handle circular imports; may cause infinite loop. ↓

fix Avoid circular imports in Aum particle files.

Install

npm install gulp-aum-import

yarn add gulp-aum-import

pnpm add gulp-aum-import

Imports

default

wrong

const aumImport = require('gulp-aum-import')

correct

import aumImport from 'gulp-aum-import'

ESM import is preferred, but require() works in CJS environments.

aumImport
```
import aumImport from 'gulp-aum-import'
```
Default export is the plugin function.

gulp

import gulp from 'gulp'; import aumImport from 'gulp-aum-import'

Must also import gulp to use this plugin.

Quickstart

Transpile Aum particle imports from source .aum files to dist.

import gulp from 'gulp';
import aumImport from 'gulp-aum-import';

gulp.task('aum', () => {
  return gulp.src('src/**/*.aum')
    .pipe(aumImport())
    .pipe(gulp.dest('dist'));
});