## Installation
```bash
# npm
npm install @mingcute/icons
# pnpm
pnpm add @mingcute/icons
# Yarn
yarn add @mingcute/icons
# Bun
bun add @mingcute/icons
```
## Quick Start
Import an icon definition and render a complete SVG document:
```ts
import { Home1Icon } from '@mingcute/icons/core-regular';
import { renderIconSource } from '@mingcute/icons';
const svg = renderIconSource(Home1Icon);
```
For the smallest module graph:
```ts
import Home1Icon from '@mingcute/icons/core-regular/home-1';
import { renderIconSource } from '@mingcute/icons';
const svg = renderIconSource(Home1Icon);
```
## Imports
### Style entry points
Use a style entry point for convenient named imports:
```ts
import {
Home1Icon,
Search2Icon,
} from '@mingcute/icons/core-regular';
```
### Direct icon imports
Use a direct icon path when only one definition is required:
```ts
import Home1Icon from '@mingcute/icons/core-regular/home-1';
```
### Metadata imports
Load generated metadata without importing icon definitions:
```ts
import metadata from '@mingcute/icons/metadata/core-regular' with {
type: 'json',
};
```
Toolchains without JSON-module support may load the metadata through their asset APIs.
## API Reference
| Export | Purpose |
|---|---|
| `renderIconBody(definition, idPrefix?)` | Renders inner SVG markup with scoped resource identifiers |
| `renderIconSource(definition, idPrefix?)` | Renders a complete standalone SVG document |
| `/