pulsoicon-svelte 0.0.0-stage → 5.2.1

package/LICENSE

@@ -0,0 +1,300 @@
+ISC License
+
+Copyright (c) 2026 CityPulso
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+THIRD-PARTY NOTICES
+
+PulsoIcon's animations, runtime code, and the icons and brand drawings made for
+this set are covered by the ISC license above. The shapes (SVG path data) of
+some icons are based on, or were drawn after, other open icon sets. Each such icon
+names its source in a comment at the top of its file. Their licenses follow:
+
+  1. Lucide (ISC): the Lucide icons (icons without a source comment that are
+     also in Lucide), with some icons derived from Feather (MIT)
+  2. Hugeicons (MIT): five adapted icons, listed below
+  3. Iconoir (MIT): icons marked "Adapted from Iconoir"
+  4. Tabler Icons (MIT): icons marked "Adapted from Tabler Icons", and solid
+     shapes marked "Solid from Tabler Icons"
+  5. Phosphor Icons (MIT): icons marked "Drawn after Phosphor Icons", and solid
+     shapes marked "Solid from Phosphor Icons"
+  6. Simple Icons (CC0 1.0): brand icons marked "Drawn after Simple Icons", with
+     the logos whose owners use other terms listed by name
+
+If you distribute PulsoIcon, or software that includes it (for example an app
+or a website bundle), keep this whole file with it, for instance in your
+third-party or open-source licenses notice. Brand names and logos remain
+trademarks of their owners.
+
+---
+
+The shapes (SVG path data) of the Lucide icons in PulsoIcon are based on
+Lucide, used under the
+following license:
+
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The following PulsoIcon icons are adapted from Hugeicons (free set) and
+re-stroked for this set:
+
+brand-apple-intelligence, brand-microsoft-copilot, brand-perplexity, clap, stretching
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2025 Hugeicons
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The following PulsoIcon icons are adapted from Iconoir: brand-apple-swift, and every icon
+whose source file starts with the comment "Adapted from Iconoir" (Iconoir 7.12, regular set),
+animated for this set.
+
+The MIT License (MIT) (for the icons described above)
+
+Copyright (c) 2021 Luca Burgio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The PulsoIcon icons whose source file starts with the comment
+"Adapted from Tabler Icons" use shapes from Tabler Icons (outline set, 3.50.0),
+animated for this set. The solid shapes of the icons with the comment
+"Solid from Tabler Icons" are taken from Tabler Icons (filled set, 3.50.0).
+
+The MIT License (MIT) (for the icons described above)
+
+Copyright (c) 2020-2026 Paweł Kuna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+The PulsoIcon icons whose source file starts with the comment "Drawn after Phosphor Icons"
+were redrawn as line icons after the corresponding Phosphor Icons (regular weight) and
+animated for this set. The solid shapes of the icons with the comment
+"Solid from Phosphor Icons" are taken from Phosphor Icons (fill weight, core 2.1.1),
+scaled to the 24-unit grid.
+
+The MIT License (MIT) (for the icons described above)
+
+Copyright (c) 2023 Phosphor Icons
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+---
+
+The PulsoIcon icons whose source file starts with the comment "Drawn after Simple Icons"
+are line drawings made for this set after the brand icons collected by Simple Icons
+(https://simpleicons.org). The Simple Icons data is released under CC0 1.0 Universal; brand
+names and logos remain trademarks of their owners. The following of these icons were drawn after
+logos that their owners license under other terms, as recorded by Simple Icons:
+
+- brand-30-seconds-of-code: 30 seconds of code, CC-BY-4.0, source https://github.com/Chalarangelo/30-seconds-of-code/blob/44c0ba94857a7796026c6795c47e964126876d5a/logo/logo-resources/logo.svg
+- brand-ab-download-manager: AB Download Manager, Apache-2.0, source https://abdownloadmanager.com
+- brand-aiohttp: AIOHTTP, Apache-2.0, source https://github.com/aio-libs/aiohttp/blob/fb5fe72b1bca3b899af579d376f5fe45745410e4/docs/aiohttp-plain.svg
+- brand-ajv: Ajv, MIT, source https://github.com/ajv-validator/ajv/blob/95b15b683dfb60f63c5129b0426629b968d53af8/docs/.vuepress/public/img/ajv.svg
+- brand-apache-airflow: Apache Airflow, Apache-2.0, source https://apache.org/logos
+- brand-apache-ant: Apache Ant, Apache-2.0, source https://apache.org/logos
+- brand-apache-arrow: Apache Arrow, Apache-2.0, source https://arrow.apache.org/visual_identity
+- brand-apache-avro: Apache Avro, Apache-2.0, source https://apache.org/logos
+- brand-apache-cassandra: Apache Cassandra, Apache-2.0, source https://www.apache.org/logos
+- brand-apache-cloudstack: Apache CloudStack, Apache-2.0, source https://apache.org/logos
+- brand-apache-cordova: Apache Cordova, Apache-2.0, source https://cordova.apache.org/artwork
+- brand-apache-couchdb: Apache CouchDB, Apache-2.0, source https://apache.org/logos
+- brand-apache-dolphinscheduler: Apache DolphinScheduler, Apache-2.0, source https://apache.org/logos
+- brand-apache-doris: Apache Doris, Apache-2.0, source https://apache.org/logos
+- brand-apache-druid: Apache Druid, Apache-2.0, source https://apache.org/logos
+- brand-apache-echarts: Apache ECharts, Apache-2.0, source https://apache.org/logos
+- brand-apache-flink: Apache Flink, Apache-2.0, source https://apache.org/logos
+- brand-apache-freemarker: Apache FreeMarker, Apache-2.0, source https://www.apache.org/logos
+- brand-apache-groovy: Apache Groovy, Apache-2.0, source https://apache.org/logos
+- brand-apache-guacamole: Apache Guacamole, Apache-2.0, source https://apache.org/logos
+- brand-apache-hadoop: Apache Hadoop, Apache-2.0, source https://apache.org/logos
+- brand-apache-hbase: Apache HBase, Apache-2.0, source https://apache.org/logos
+- brand-apache-hive: Apache Hive, Apache-2.0, source https://apache.org/logos
+- brand-apache-jmeter: Apache JMeter, Apache-2.0, source https://apache.org/logos
+- brand-apache-kafka: Apache Kafka, Apache-2.0, source https://apache.org/logos
+- brand-apache-kylin: Apache Kylin, Apache-2.0, source https://apache.org/logos
+- brand-apache-lucene: Apache Lucene, Apache-2.0, source https://apache.org/logos
+- brand-apache-maven: Apache Maven, Apache-2.0, source https://apache.org/logos
+- brand-apache-netbeans-ide: Apache NetBeans IDE, Apache-2.0, source https://apache.org/logos
+- brand-apache-nifi: Apache NiFi, Apache-2.0, source https://apache.org/logos
+- brand-apache-openoffice: Apache OpenOffice, Apache-2.0, source https://apache.org/logos
+- brand-apache-parquet: Apache Parquet, Apache-2.0, source https://apache.org/logos
+- brand-apache-pdfbox: Apache PDFBox, Apache-2.0, source https://apache.org/logos
+- brand-apache-pulsar: Apache Pulsar, Apache-2.0, source https://apache.org/logos
+- brand-apache-rocketmq: Apache RocketMQ, Apache-2.0, source https://apache.org/logos
+- brand-apache-solr: Apache Solr, Apache-2.0, source https://apache.org/logos
+- brand-apache-spark: Apache Spark, Apache-2.0, source https://apache.org/logos
+- brand-apache-storm: Apache Storm, Apache-2.0, source https://apache.org/logos
+- brand-apache-superset: Apache Superset, Apache-2.0, source https://apache.org/logos
+- brand-apache-tomcat: Apache Tomcat, Apache-2.0, source https://apache.org/logos
+- brand-apache: Apache, Apache-2.0, source https://www.apache.org/foundation/press/kit
+- brand-authelia: Authelia, Apache-2.0, source https://github.com/authelia/authelia/blob/8316cd4eb7a6f0778c8f480c61ad76a88416fc3a/docs/static/images/branding/logo.svg
+- brand-conventional-commits: Conventional Commits, MIT, source https://www.conventionalcommits.org
+- brand-development-containers: Development Containers, CC-BY-4.0, source https://github.com/microsoft/fluentui-system-icons/blob/3e1e525f4499a22d46039ef54e9b9a86b809bc66/assets/Cube/SVG/ic_fluent_cube_24_regular.svg
+- brand-exercism: Exercism, CC-BY-3.0, source https://github.com/exercism/website-icons/blob/2ad12baa465acfaa74efc5da27a6a12f8b05e3d0/exercism/logo-icon.svg
+- brand-flatpak: Flatpak, CC-BY-3.0, source https://flatpak.org/press
+- brand-fluentd: Fluentd, Apache-2.0, source https://docs.fluentd.org/quickstart/logo
+- brand-gin: Gin, CC-BY-4.0, source https://github.com/gin-gonic/logo/blob/eecb3150aa7ce5a77b97fd834276b2b6958eaa9d/wb.svg
+- brand-gleam: Gleam, Apache-2.0, source https://gleam.run
+- brand-gnu-bash: GNU Bash, MIT, source https://github.com/odb/official-bash-logo/tree/61eff022f2dad3c7468f5deb4f06652d15f2c143
+- brand-godot-engine: Godot Engine, CC-BY-4.0, source https://godotengine.org/press
+- brand-gradle-play-publisher: Gradle Play Publisher, MIT, source https://github.com/Triple-T/gradle-play-publisher/blob/df4eadf1ca6b5bad50e21be0b21816722ed50342/assets/logo.svg
+- brand-have-i-been-pwned: Have I Been Pwned, BSD-3-Clause, source https://github.com/HaveIBeenPwned/Branding/blob/d5a5d3c252a461c6c7e2ae60942fc80e50d2755d/Logos/Icon/Icon.svg
+- brand-iconify: Iconify, MIT, source https://iconify.design
+- brand-jabber: Jabber, CC-BY-2.5, source https://commons.wikimedia.org/wiki/File:Jabber-bulb.svg
+- brand-jekyll: Jekyll, CC-BY-4.0, source https://github.com/jekyll/brand/blob/8302ad3ecf045054a095020729a8d2cc7005faf8/jekyll-logo-black.svg
+- brand-jhipster: JHipster, Apache-2.0, source https://github.com/jhipster/jhipster-artwork/blob/1085d85ab6d819b9ef7f6cc710ec8a4977b95e90/logos/JHipster%20bowtie.svg
+- brand-kando: Kando, CC-BY-4.0, source https://github.com/kando-menu/design/blob/6506e2656f791b710b49a4774e7ebeaf419a1236/icons/source/blossom_tiny.svg
+- brand-material-design-icons: Material Design Icons, Apache-2.0, source https://materialdesignicons.com/icon/vector-square
+- brand-nano-stores: Nano Stores, MIT, source https://github.com/nanostores/nanostores/blob/7fb5cd871fa00f484ebc866fdf330b56cab2aa20/img/logo-auto.svg
+- brand-nixos: NixOS, CC-BY-4.0, source https://brand.nixos.org/logos/nixos-logomark-black-flat-minimal.svg
+- brand-ocaml: OCaml, Unlicense, source https://ocaml.org/logo
+- brand-omarchy: Omarchy, MIT, source https://omarchy.org
+- brand-openjdk: OpenJDK, BSD-3-Clause, source https://hg.openjdk.java.net/duke/duke/file/ca00f100dafc/vector/Agent.svg
+- brand-opentelemetry: OpenTelemetry, CC-BY-4.0, source https://cncf-branding.netlify.app/projects/opentelemetry/
+- brand-packagist: Packagist, MIT, source https://github.com/composer/packagist/issues/1147#issuecomment-747951608
+- brand-pelican: Pelican, CC-BY-4.0, source https://blog.getpelican.com/pages/gratitude.html
+- brand-phosphor-icons: Phosphor Icons, MIT, source https://phosphoricons.com
+- brand-purescript: PureScript, CC-BY-4.0, source https://github.com/purescript/logo/tree/1e7a57affdaeaf88ff594c08bd2b5a78fe2ed13c
+- brand-radiant-earth: Radiant Earth, CC-BY-4.0, source https://radiant.earth
+- brand-rocksdb: RocksDB, CC-BY-4.0, source https://github.com/facebook/rocksdb/blob/9ed96703d11a1cf4af0e1c1db0e4a6057a8e5d42/docs/static/logo.svg
+- brand-rook: Rook, Apache-2.0, source https://github.com/rook/artwork/blob/d252db9f43753e6abf64db0ce12d38916a5de464/logo/Rook_Icon.svg
+- brand-root: ROOT, CC-BY-4.0, source https://root.cern/assets/images/logos/svg/ROOT.svg
+- brand-salt-project: Salt Project, Apache-2.0, source https://saltproject.io
+- brand-sanity: Sanity, MIT, source https://github.com/sanity-io/logos/blob/e298a1ac2757c83910fe08b496a115bc9aef06bd/src/sanityMonogram.tsx
+- brand-setuptools: Setuptools, MIT, source https://github.com/pypa/setuptools/blob/c3f486f0f7ebf8fa141dfd7314cbcaba7370db0b/docs/images/logo.svg
+- brand-solidity: Solidity, CC-BY-4.0, source https://docs.soliditylang.org/en/v0.8.6/brand-guide.html
+- brand-sphinx: Sphinx, BSD-3-Clause, source https://github.com/sphinx-doc/sphinx/blob/ed84d63e6f2c4fd43b97fc43ee8be4156a13af9e/doc/_static/favicon.svg
+- brand-sqlalchemy: SQLAlchemy, MIT, source https://commons.wikimedia.org/wiki/File:SQLAlchemy.svg
+- brand-typeorm: TypeORM, MIT, source https://github.com/typeorm/typeorm/blob/e7649d2746f907ff36b1efb600402dedd5f5a499/resources/logo_big.png
+- brand-umami: Umami, MIT, source https://github.com/umami-software/umami/blob/3572df0a09503f357a06fe7f816295ba2c878325/assets/logo.svg
+- brand-vuetify: Vuetify, MIT, source https://vuetifyjs.com/resources/brand-kit
+- brand-webgpu: WebGPU, CC-BY-4.0, source https://www.w3.org/2023/02/webgpu-logos.html
+- brand-zod: Zod, MIT, source https://github.com/colinhacks/zod/blob/ff89187172ac6aa4a6264592980d1628ee785242/logo/Logo%20White.ai

package/README.md

@@ -1,3 +1,328 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="https://raw.githubusercontent.com/CityPulso/PulsoIcon/main/logo.png" alt="PulsoIcon" width="160" />
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<h1 align="center">PulsoIcon</h1>
+
+<p align="center">
+  <strong>9955 animated icons. Every one has its own motion.</strong><br />
+  A drop-in replacement for lucide-react icons that comes alive on hover, also for Vue, Svelte, Jetpack Compose and SwiftUI.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/pulsoicon"><img src="https://img.shields.io/npm/v/pulsoicon?color=f2552c" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/pulsoicon"><img src="https://img.shields.io/npm/dm/pulsoicon?color=f2552c" alt="npm downloads" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/pulsoicon?color=f2552c" alt="license" /></a>
+</p>
+
+---
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/CityPulso/PulsoIcon/main/PulsoIcon_README_Loop.gif" alt="PulsoIcon icons animating on hover" width="720" />
+</p>
+
+A bell rings. A calendar lifts its rings. A trash can opens its lid. A clock's hand goes round.
+
+PulsoIcon gives every icon a motion written for that icon, not one effect stamped on all of them. At rest each icon is a clean 24×24 icon; it plays when someone hovers or focuses the button, link or tab it sits in.
+
+Every one of the 9955 motions is written for this set. About 3,700 icons are drawn here, including the line-art brand logos; the rest build on the shapes of [Lucide](https://lucide.dev), [Tabler Icons](https://tabler.io/icons) and [Iconoir](https://iconoir.com), which are credited in [LICENSE](https://github.com/CityPulso/PulsoIcon/blob/main/LICENSE).
+
+## Why PulsoIcon
+
+- **9955 icons, each with its own motion**:
+  - **About 3,700 drawn for this set**: about 2,770 line-art brand logos (CityPulso, GitHub, Slack, Spotify, OpenAI, Claude, TikTok, VS Code, Google Drive, …, most drawn after the logos collected by [Simple Icons](https://simpleicons.org)) and around 900 other icons, including lowercase a–z, animals, sports, 3D tools and icons drawn after [Phosphor](https://phosphoricons.com).
+  - **Built on open icon sets**: all 2020 [Lucide](https://lucide.dev) icons (as of 1.68), plus the shapes of [Tabler Icons](https://tabler.io/icons) (3.50, including 264 brand logos) and [Iconoir](https://iconoir.com) (7.12).
+  - **3042 brand logos** in all.
+- **Switch in one line**: same component names as lucide-react (`Calendar`, `CalendarIcon`, aliases such as `AlertCircle`) and the same props. Usually you only change the import.
+- **Ships only what you use**: every icon is its own module and the package is side-effect free, so bundlers keep the icons you import and drop the rest. Three icons add about 12 kB before minification.
+- **Plays where people point**: hover or focus anywhere on a button, link, label, tab or menu item and its icon plays.
+- **Respects reduced motion**: nothing moves when the system asks for less motion.
+- **Two dependencies**: React and [Motion](https://motion.dev).
+
+## Install
+
+```bash
+npm install pulsoicon
+```
+
+Works with React 18 or newer. [Motion](https://motion.dev) (12 or newer) is installed for you; if your app already uses Motion, PulsoIcon shares that copy.
+
+The same icons, props and motion are also available for [Vue, Svelte, Android and iOS](#other-platforms).
+
+## Quick start
+
+```tsx
+import { Bell, Calendar, Trash2 } from "pulsoicon";
+
+export function Toolbar() {
+  return (
+    <>
+      <button>
+        <Bell size={20} /> Notifications
+      </button>
+      <button>
+        <Calendar /> Schedule
+      </button>
+      <button>
+        <Trash2 color="crimson" strokeWidth={1.5} /> Delete
+      </button>
+    </>
+  );
+}
+```
+
+Hover a button and its icon plays.
+
+### Coming from lucide-react
+
+```diff
+- import { Bell, Calendar, Trash2 } from "lucide-react";
++ import { Bell, Calendar, Trash2 } from "pulsoicon";
+```
+
+Icon components and their props work the same. Lucide's helpers (`createLucideIcon`, `LucideProvider`, the `icons` object) are not included.
+
+### Coming from Tabler
+
+Tabler icon names work too, without the `Icon` prefix: `IconMoodSad` is `MoodSad`, `IconHome` is `Home`, `IconBrandGithub` is `BrandGithub`. Where Lucide already has the icon, the Tabler name points to it (`Home` is `House`), and Tabler families follow Lucide's naming (`HomeDollar` is `HouseDollar`, `PhotoEdit` is `ImageEdit`).
+
+## Props
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `size` | `number \| string` | `24` | Width and height |
+| `color` | `string` | `currentColor` | Stroke colour, and fill colour when `solid` |
+| `strokeWidth` | `number \| string` | `2` | Stroke width on the 24-unit grid |
+| `absoluteStrokeWidth` | `boolean` | `false` | Keep the stroke the same number of pixels at any size |
+| `solid` | `boolean` | `false` | Filled icon instead of outline (see [Solid icons](#solid-icons)) |
+| `animated` | `boolean` | `true` | `false` makes the icon fully static: nothing plays it, not even the ref or `play` |
+| `autoAnimated` | `boolean` | `true` | Play the built-in hover / focus trigger. `false` turns that off; the ref and `play` still work |
+| `play` | `boolean` | | `true` plays the motion, `false` returns to rest. Works with or without `autoAnimated` |
+
+`autoAnimated` and `play` only exist while the icon can animate, so TypeScript rejects `<Bell animated={false} play />`. Wrapper components that drop a prop should use the exported `DistributiveOmit<IconProps, "size">` instead of `Omit`, which would lose that check.
+
+Any other SVG attribute (`className`, `style`, `aria-label`, …) is passed to the `<svg>`. Icons render with `aria-hidden="true"`; give the surrounding button or link a label.
+
+## When the animation plays
+
+An icon plays when the pointer enters, or focus moves into, its closest `button`, `a`, `label`, `summary`, `[role="button"]`, `[role="link"]`, `[role="tab"]` or `[role="menuitem"]`. If there is none, the icon plays on its own hover.
+
+Any other element can become the trigger with `data-icon-trigger`:
+
+```tsx
+<div className="card" data-icon-trigger>
+  <MapPin /> 3 venues near you
+</div>
+```
+
+### Play from code
+
+Every icon forwards a ref with `startAnimation()` and `stopAnimation()`. Both return a promise that resolves when the motion has finished, so you can `await check.current?.startAnimation()` before moving on. Set `autoAnimated={false}` when only your code should decide when it plays:
+
+```tsx
+import { useRef } from "react";
+import { Check, type IconHandle } from "pulsoicon";
+
+function SaveButton() {
+  const check = useRef<IconHandle>(null);
+  return (
+    <button onClick={() => check.current?.startAnimation()}>
+      <Check autoAnimated={false} ref={check} /> Save
+    </button>
+  );
+}
+```
+
+Or drive it from state with `play`. The motion starts when `play` turns `true` and returns to rest when it turns `false`:
+
+```tsx
+<Bell autoAnimated={false} play={hasNewMessage} />
+```
+
+`animated={false}` keeps an icon completely still; the ref and `play` do nothing.
+
+## Solid icons
+
+`solid` draws the filled version of an icon, in `color`:
+
+```tsx
+<Heart solid color="crimson" />
+```
+
+About 1,700 icons have a filled drawing taken from the [Tabler](https://tabler.io/icons) filled set or the [Phosphor](https://phosphoricons.com) fill weight. Their source file has a `solid` list and a "Solid from …" comment. The other icons fill their closed outline shapes and cut their inner lines out of the fill, so the details stay visible. Motions that draw a stroke on (`draw`, `redraw`, …) pop in instead on filled shapes.
+
+## Other platforms
+
+Every package draws the same 9955 icons with the same motion, from the same source. The props have the same names, defaults and meaning as in React. One version number covers them all.
+
+| Platform | Install | Package |
+|---|---|---|
+| React | `npm install pulsoicon` | [pulsoicon](https://www.npmjs.com/package/pulsoicon) |
+| Vue 3.5+ | `npm install pulsoicon-vue` | [pulsoicon-vue](https://www.npmjs.com/package/pulsoicon-vue) |
+| Svelte 5 | `npm install pulsoicon-svelte` | [pulsoicon-svelte](https://www.npmjs.com/package/pulsoicon-svelte) |
+| Android (Jetpack Compose) | `implementation("com.citypulso:pulsoicon:<version>")` | Maven Central |
+| iOS / macOS (SwiftUI) | `.package(url: "https://github.com/CityPulso/PulsoIcon.git", from: "<version>")` | Swift Package Manager |
+
+### Vue
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue";
+import { Bell, Check, type IconHandle } from "pulsoicon-vue";
+
+const check = ref<IconHandle>();
+</script>
+
+<template>
+  <button><Bell :size="20" /> Notifications</button>
+  <button @click="check?.startAnimation()"><Check ref="check" :auto-animated="false" /> Save</button>
+</template>
+```
+
+### Svelte
+
+```svelte
+<script lang="ts">
+  import { Bell, Check } from "pulsoicon-svelte";
+
+  let check: ReturnType<typeof Check>;
+</script>
+
+<button><Bell size={20} /> Notifications</button>
+<button onclick={() => check.startAnimation()}><Check bind:this={check} autoAnimated={false} /> Save</button>
+```
+
+Vue and Svelte render exactly the same `<svg>` as React and play it with [Motion](https://motion.dev)'s `animate()`. They take `class` and `style` like any element.
+
+### Android (Jetpack Compose)
+
+```kotlin
+import com.citypulso.pulsoicon.PulsoIcon
+import com.citypulso.pulsoicon.PulsoIcons
+import com.citypulso.pulsoicon.icons.Bell
+
+val interactions = remember { MutableInteractionSource() }
+IconButton(onClick = { /* … */ }, interactionSource = interactions) {
+    PulsoIcon(PulsoIcons.Bell, contentDescription = "Notifications", interactionSource = interactions)
+}
+```
+
+The icon plays when the control whose `interactionSource` you pass is pressed, hovered or focused (Compose has no "closest interactive ancestor", so it is passed in). `color` defaults to `LocalContentColor`. Play from code with `play = true`, or with `rememberPulsoIconHandle()` passed as `handle` and its suspending `startAnimation()` / `stopAnimation()`. `PulsoIcons.byKey("bell")` looks an icon up by its stored key. Unused icons are removed by R8.
+
+### iOS and macOS (SwiftUI)
+
+```swift
+import PulsoIcon
+
+Button { /* … */ } label: {
+    Label { Text("Notifications") } icon: { PulsoIconView(.bell, size: 20, play: hasNewMessage) }
+}
+```
+
+Names start lowercase (`.bell`, `.aArrowDown`, `.bellIcon`). `color` defaults to the foreground style. A pointer hovering the icon plays it; for taps use `play` or a `PulsoIconHandle` (`await handle.startAnimation()`). `PulsoIcon.byKey("bell")` looks an icon up by its stored key. Nothing moves with Reduce Motion on.
+
+## Finding icons
+
+### Other names
+
+Icons also answer to the names other icon sets use: `Gear` is `Settings`, `Magnifier` is `Search`, `Cart` is `ShoppingCart`, `World` is `Globe`, `DotsHorizontal` is `Ellipsis`, and so on. Every icon is also exported with an `Icon` suffix (`BellIcon`).
+
+### Brand logos
+
+Brand icons start with `Brand` (`BrandGithub`, `BrandSlack`, `BrandOpenai`, …). The brands added up to 3.1 are also exported without the prefix (`Github`, `Slack`); the ones added in 4.0 only with it, because many brand names are ordinary words. They are simplified line drawings made for this set, most of the newer ones drawn after the logos collected by [Simple Icons](https://simpleicons.org).
+
+All product names, logos and brands are the property of their respective owners and are used here only to refer to those products or services. Their use does not imply endorsement. Follow each brand's own guidelines when you use its logo.
+
+### All icons at once
+
+For icon pickers and galleries, `pulsoicon/all` exports every icon by its kebab-case name. It pulls in all 9955 icons, so use it only where you need the full set:
+
+```tsx
+import { ICON_NAMES, ICONS } from "pulsoicon/all";
+
+const Icon = ICONS["party-popper"];
+```
+
+One icon can also be imported by path: `import { Calendar } from "pulsoicon/icons/calendar"`. To list the names without loading any icon (to build a picker that loads icons on demand), use `pulsoicon/names`:
+
+```tsx
+import { ICON_NAMES, type IconName } from "pulsoicon/names";
+
+const load = (name: IconName) => import(`pulsoicon/icons/${name}`);
+```
+
+## Styling
+
+Each icon renders `<svg class="pulsoicon pulsoicon-<name>">`, so CSS can target every icon or a single one:
+
+```css
+.pulsoicon {
+  vertical-align: -0.125em;
+}
+
+.pulsoicon-bell {
+  color: #f2552c;
+}
+```
+
+## Report a wrong icon
+
+If an icon is drawn wrong, a brand logo doesn't match the real one, or a motion looks off, please email
+**citypulso@gmail.com** with the icon name (for example `brand-avianca`) and, if you can, a screenshot or a link
+to the correct logo. Issues on GitHub are welcome too.
+
+## Contributing
+
+```bash
+npm install
+npm run gen       # writes every platform's icon files from packages/core
+npm run preview   # gallery of every icon at http://localhost:10205
+npm test
+npm run build
+```
+
+Each icon is one data file in `packages/core/src/icons/<name>.ts`, shared by every platform: the shapes of the icon and, for each shape, an optional motion (`r` recipe from `packages/core/src/recipes.ts`, `d` delay, `x`/`y` direction, `a` amplitude, `o` pivot point on the 24×24 grid). Edit that file to change how an icon moves, then run `npm run gen`. Other names live in `packages/core/src/aliases.ts`.
+
+| Folder | What |
+|---|---|
+| `packages/core` | `pulsoicon-core`: the icons, recipes, solid drawings and the framework-free player |
+| `packages/react`, `packages/vue`, `packages/svelte` | The web packages; their icon files are generated |
+| `kotlin/` | The Android library (Gradle); `icons/` is generated and committed |
+| `swift/` and `Package.swift` | The Swift package; `Icons/` is generated and committed |
+
+The Kotlin and Swift recipes are written by hand; their tests check them against `packages/core` (`kotlin/`: `./gradlew :pulsoicon:testDebugUnitTest`; Swift: `swift test`). `npm run test:browser` plays icons in Chromium through React, Vue and Svelte side by side and checks that they move the same.
+
+### Releasing
+
+`package.json` at the root holds the one version of every package. `npm run set-version -- 5.3.0` sets it everywhere; push that to `main` and CI publishes the npm packages and the Maven artifact that are not out yet, then tags `5.3.0` for Swift Package Manager.
+
+## License
+
+PulsoIcon is open source under the [ISC license](https://github.com/CityPulso/PulsoIcon/blob/main/LICENSE) © CityPulso.
+
+### What is ours, and what comes from other icon sets
+
+| Part | Origin |
+|---|---|
+| Every animation (how each icon moves) | Written for PulsoIcon |
+| Runtime code (`createIcon`, triggers, motion recipes) | Written for PulsoIcon |
+| About 3,700 icons, including about 2,770 line-art brand logos | Drawn for PulsoIcon |
+| Shapes of the 2020 Lucide icons | Based on [Lucide](https://lucide.dev) (ISC; some derived from Feather, MIT) |
+| Shapes of the icons marked "Adapted from Tabler Icons" | Based on [Tabler Icons](https://tabler.io/icons) (MIT) |
+| Shapes of the icons marked "Adapted from Iconoir" | Based on [Iconoir](https://iconoir.com) (MIT) |
+| Five icons marked "Adapted from Hugeicons" | Adapted from [Hugeicons](https://hugeicons.com) (MIT) |
+| Icons marked "Drawn after Phosphor Icons" | Redrawn after [Phosphor](https://phosphoricons.com) shapes (MIT) |
+| Solid shapes marked "Solid from Tabler Icons" / "Solid from Phosphor Icons" | Taken from the Tabler filled set and the Phosphor fill weight (MIT) |
+| Brand icons marked "Drawn after Simple Icons" | Drawn after the logos collected by [Simple Icons](https://simpleicons.org) (CC0) |
+
+Icons based on or drawn after Tabler Icons, Iconoir, Hugeicons, Phosphor or Simple Icons name their source in a comment at the top of their file; the Lucide icons keep their Lucide names. The full license texts are in [LICENSE](https://github.com/CityPulso/PulsoIcon/blob/main/LICENSE).
+
+### Using PulsoIcon in your project
+
+You may use PulsoIcon freely, including in commercial and closed-source products. The one condition, from ISC and the MIT licenses of the sets above, is the notice:
+
+- **If you ship PulsoIcon** (in an app, a website bundle, a template or a library of your own), include PulsoIcon's [LICENSE](https://github.com/CityPulso/PulsoIcon/blob/main/LICENSE) file with it, for example on your "open-source licenses" or "third-party notices" page or in a `THIRD_PARTY_NOTICES` file. It already contains the notices of Lucide, Tabler Icons, Iconoir, Hugeicons and Phosphor.
+- **If you copy or modify icons** from PulsoIcon into your own set, keep the source comment at the top of each file, and keep the LICENSE notices.
+- You don't have to credit PulsoIcon inside your product's interface, although a link is always appreciated.
+
+Brand logos are trademarks of their owners. Using a brand icon doesn't imply endorsement, and you should follow each brand's own guidelines.