lucide/packages/vue
Ken Kunz c1a02a04d4
fix(packages): allow string values for size and strokeWidth in global icon config (#4870)
* Allow string values for `size` and `strokeWidth` in icon contexts

The global icon context types declare `size` and `strokeWidth` as `number`,
while the component props they supply defaults for accept `number | string`.
The context value is passed through to the component untouched, so a CSS
length that works on a single icon is rejected when set as a default:

    setLucideProps({ size: '1em' });  // Type 'string' is not assignable to 'number'
    <Moon size="1em" />               // same value, same code path, no error

* Accept a string `size` on vue icon components

@lucide/vue types the component prop as `size?: 24 | number`, so it rejects the
CSS lengths its own `strokeWidth?: number | string` accepts, and that every other
framework accepts. The value goes straight to the `width`/`height` attributes,
so a string already works at runtime.

* Allow string `size` and `strokeWidth` in the icon context

Copilot's PR comment correctly surfaced a gap in the PR - the same type
bug exists in the lucide-react-native project and wasn't fixed there.

Same narrowing as the other framework contexts: `LucideProps` accepts
`size?: string | number`, and `strokeWidth` resolves to react-native-svg's
`NumberProp` (`string | number`), but the context and `LucideProviderProps`
declared both as `number`. `Icon.ts` passes the context value straight through
— `width: width ?? size ?? contextSize` — so nothing downstream needs a number.

* Don't emit NaN stroke width for non-numeric absolute lengths

`absoluteStrokeWidth` scales the stroke by `Number(size)`, so a CSS unit such
as `1em` produced `NaN` and a size of `0` produced `Infinity` – both invalid as
a `stroke-width` attribute. Fall back to the unscaled stroke width whenever the
conversion isn't finite, so the deprecated prop degrades rather than breaking
the rendered icon.

* fix(packages/angular): allow a string `strokeWidth` in the global config

`LucideConfig` already types `size` as `string | number` but left `strokeWidth`
as `number`, while `LucideIconBase` accepts `string | number` for both and
passes the configured value straight to the shared builder. So
`provideLucideConfig({ strokeWidth: '1em' })` was rejected for no reason.

* refactor(shared): keep absolute stroke scaling inside its branch

The finite-value fallback added in b65ee945 computed the scaled width before
testing `absoluteStrokeWidth`, so the default path paid for three `Number`
conversions and a division it never used. Start from the unscaled width and
overwrite it only when scaling both applies and yields a finite result, which
also states the rule more directly.

---------

Co-authored-by: Eric Fennis <eric.fennis@gmail.com>
2026-11-20 14:43:11 +01:00
..
scripts fix(packages/vue): fix generated icon declaration types for @lucide/vue (#4841) 2026-09-10 22:35:01 +02:00
src fix(packages): allow string values for size and strokeWidth in global icon config (#4870) 2026-11-20 14:43:11 +01:00
tests Fix type lucide-vue (#4883) 2026-09-18 12:29:14 +02:00
package.json chore(deps): bump the vue-deps group across 1 directory with 2 updates (#5220) 2026-11-16 09:31:34 +01:00
README.md feat(site): Add sponsor page (#5132) 2026-11-02 12:21:25 +01:00
rollup.config.mjs feat(packages): extract icon build logic into @lucide/shared (#4409) 2026-09-04 16:38:01 +02:00
tsconfig.json Fix type lucide-vue (#4883) 2026-09-18 12:29:14 +02:00
vitest.config.mts feat(@lucide/vue): Rename Vue package name to @lucide/vue (#3337) 2025-09-11 14:38:34 +02:00

Lucide icon library for Vue applications.

Lucide icon library for Vue applications.

npm NPM Downloads License

About · Icons · Documentation · License

Lucide Vue

Implementation of the lucide icon library for Vue applications.

Installation

pnpm add @lucide/vue
npm install @lucide/vue
yarn add @lucide/vue
bun add @lucide/vue

Documentation

For full documentation, visit lucide.dev

Community

Join the Discord server to chat with the maintainers and other users.

License

Lucide is licensed under the ISC license. See LICENSE.

Sponsors

Powered by Vercel

Bronze 🥉

Sourcegraph – Understand, fix, and automate across your codebase with Sourcegraph's code intelligence platform    Zephyr Cloud

Other contributors 💸

You can find all our past and non-recurring financial contributors at our Open Collective page.