Skip to content

API Reference

Core API

createSvgSpriteBuilder

The main API for building SVG sprites. Creates a new SVG sprite builder instance.

typescript
import { createSvgSpriteBuilder } from '@neodx/svg';

const builder = createSvgSpriteBuilder({
  inputRoot: 'src/shared/ui/icon/assets',
  output: 'public/sprites',
  metadata: 'src/sprite.gen.ts',
  group: true
});

await builder.load('**/*.svg');
await builder.build();

For detailed information about the builder API and its parameters, see Builder API.

Features

Metadata

Generates TypeScript types and runtime information about your sprites.

typescript
const builder = createSvgSpriteBuilder({
  metadata: 'src/sprite.gen.ts'
});

For detailed information, see Metadata Guide.

Grouping

Controls how sprites are grouped.

typescript
const builder = createSvgSpriteBuilder({
  group: true // Group by directory
});

For detailed information, see Group and Hash Guide.

Optimization

Provides SVG optimization capabilities through SVGO.

typescript
const builder = createSvgSpriteBuilder({
  optimize: true
});

For detailed information, see Optimization Guide.

Color Reset

Allows you to modify or reset colors in SVG files.

typescript
const builder = createSvgSpriteBuilder({
  resetColors: true
});

For detailed information, see Color Reset Guide.

Inlining

Controls sprite inlining behavior.

typescript
const builder = createSvgSpriteBuilder({
  inline: 'auto'
});

For detailed information, see Inlining Guide.

Cleanup

Manages sprite file cleanup.

typescript
const builder = createSvgSpriteBuilder({
  cleanup: 'auto'
});

For detailed information, see Cleanup Guide.

Released under the MIT License.