weasel-icons 0.9.0 → 0.11.0

package/README.md

@@ -2,7 +2,9 @@
 
 Icons that overreact beautifully. Stateful React SVG icons with smooth transitions and optional continuous behavior.
 
-Version `0.9.0` contains 674 icons, adding 195 across home, food, travel, tools, outdoors, devices, diagrams, editing, care and commerce. Existing released icons retain their APIs.
+Version `0.11.0` adds an optional multi-agent customization skill and CLI with version-matched editable source.
+
+Version `0.10.0` contains 874 icons, adding 200 across documents, collaboration, spatial tools, media, commerce, transport and characters. Existing released icons retain their APIs.
 
 Version `0.7.0` contained 469 icons; `0.6.0` contained 265 icons.
 
@@ -16,6 +18,37 @@ pnpm add weasel-icons
 
 Supports React / React DOM 18.3 or 19. Motion is installed as a dependency. No stylesheet, provider, Tailwind, or Next.js dependency is required. The package is ESM with TypeScript declarations and per-icon exports.
 
+## Customize with your coding agent
+
+```sh
+npm install weasel-icons
+npx weasel-icons setup
+```
+
+Choose all the agents you use: Codex, Claude Code, Antigravity IDE/App, Antigravity CLI or Cursor. Personal setup is the default and stays outside your repository. Then ask your agent: **“Use weasel-customize to add a state to my icon.”** Setup installs instructions; it does not launch an AI, share conversations or generate code by itself.
+
+For non-interactive setup, or to add another agent later:
+
+```sh
+npx weasel-icons setup --agent codex,claude-code --scope user
+```
+
+Use `--scope project` for a team skill checked into this app. Existing or modified skill entries are preserved. Restart/reload the agent if the skill does not appear. The `weasel-customize` skill is separate from the internal `weasel-motion` authoring skill.
+
+The agent reads the full guide from the installed package and copies only the selected icon and its required runtime:
+
+```sh
+npm exec --no -- weasel-icons skills get customize
+npm exec --no -- weasel-icons icons list refresh
+npm exec --no -- weasel-icons icons add refresh --dir src/components/weasel
+```
+
+Declare `motion` as a direct dependency when using copied source (use the dependency range from the installed `weasel-icons/package.json`). Copied TypeScript needs a compiler target of ES2015+ or downlevelIteration. Import the customized component from your local source. Other icons can keep their npm imports. Existing custom files are never overwritten; conflicting runtime versions require a separate destination. Keep the copied license notices with redistributed source.
+
+The CLI uses bundled source and makes no network requests. It requires Node 22.13 or newer; the icon components themselves remain React 18.3/19 compatible. Personal setup paths are agent-specific: Codex `~/.agents/skills`, Claude Code `~/.claude/skills`, Antigravity IDE/App `~/.gemini/config/skills`, Antigravity CLI `~/.gemini/antigravity-cli/skills`, Cursor `~/.cursor/skills`. Project paths are `.agents/skills` for Codex/Antigravity, `.claude/skills` for Claude Code and `.cursor/skills` for Cursor.
+
+To remove an unchanged discovery entry, run `npx weasel-icons setup --agent codex,claude-code --remove`. Modified entries and customized app source are preserved. Re-run setup to restore an entry. The detailed guide updates when the app's Weasel package is updated.
+
 ## Use
 
 ```tsx
@@ -53,6 +86,10 @@ The existing SVG smoothly transitions when `state` changes, including during an
 
 Exports include: `DogIcon`, `MonkeyIcon`, `HeartIcon`, `ShipIcon`, `RocketIcon`, `SearchIcon`, `BellIcon`, `DownloadIcon`, `ShieldIcon`, `CursorIcon`, `ClapperboardIcon`, `PlugIcon`, `BulbIcon`, `AlertIcon`, `BadgeCheckIcon`, `ReplaceIcon`, `DeleteIcon`, `SwapIcon`, `SparklesIcon`, `SparkleIcon`, `StarIcon`, `WaveIcon`, `RefreshIcon`, `CopyIcon`, `EyeIcon`, `LinkIcon`, `CheckIcon`, and `CloseIcon`. Each icon exports its own state type and list, for example `DogState` and `dogStates`, or `BadgeCheckState` and `badgeCheckStates`. TypeScript autocompletion shows the valid states for each icon.
 
+### Added in 0.10.0
+
+New exports include `FilePlayIcon`, `FileSignalIcon`, `FileSlidersIcon`, `FileAxis3dIcon`, `CloudSyncIcon`, `UserShieldIcon` and `SnailIcon`, from the root or their individual subpaths. Most new icons expose three states; File Play exposes `ready`, `playing`, `paused`, `buffering` and `ended`. The application supplies playback and result states. Snail exposes `still`, `feelers` and `retracted`, with feeler exploration and a retained shell withdrawal. Its shell uses `--weasel-surface` (white by default) for occlusion; set that variable to match a non-white host surface.
+
 ### Added in 0.9.0
 
 New exports include `ToolCaseIcon` (`closed`, `open`), `LampFloorIcon` (`off`, `lit`), `TicketValidationIcon` (`unchecked`, `valid`, `invalid`) and `BanknoteTransferIcon` (`outgoing`, `incoming`, `declined`). Import them from the root or their subpaths, such as `weasel-icons/tool-case`. Each exports its state list and type.
@@ -93,80 +130,80 @@ Each addition supports the same props and exports its typed state list. The appl
 
 ### Added in 0.3.0
 
-| Icon | States | Intended use |
-| --- | --- | --- |
-| `HomeIcon` | `idle`, `entering`, `active` | Navigation: Home link in a header or sidebar |
-| `MenuIcon` | `closed`, `hover`, `open` | Navigation: Collapsed mobile navigation |
-| `PlusIcon` | `idle`, `hover`, `pressed` | Actions: Create item or increase quantity |
-| `MinusIcon` | `idle`, `hover`, `pressed` | Actions: Decrease quantity or remove a row |
-| `ChevronDownIcon` | `collapsed`, `hover`, `expanded` | Navigation: Closed disclosure or select menu |
-| `ChevronRightIcon` | `idle`, `advancing`, `arrived` | Navigation: Next step or drill into a row |
-| `ChevronLeftIcon` | `idle`, `returning`, `arrived` | Navigation: Previous page or back in a wizard |
-| `ChevronUpIcon` | `collapsed`, `hover`, `expanded` | Navigation: Closed upward popover |
-| `ArrowRightIcon` | `idle`, `moving`, `arrived` | Navigation: Next page or primary landing-page CTA |
-| `ArrowLeftIcon` | `idle`, `moving`, `arrived` | Navigation: Back navigation |
-| `ArrowUpIcon` | `idle`, `moving`, `arrived` | Navigation: Scroll to top or move a row upward |
-| `ArrowDownIcon` | `idle`, `moving`, `arrived` | Navigation: Scroll down or move a row downward |
-| `ExternalLinkIcon` | `idle`, `opening`, `opened` | Navigation: Open external resource from blog or app |
-| `MoreHorizontalIcon` | `closed`, `opening`, `open` | Actions: Overflow action menu closed |
-| `MoreVerticalIcon` | `closed`, `opening`, `open` | Actions: Row overflow menu closed |
-| `UserIcon` | `idle`, `loading`, `active` | Accounts: Profile or account entry |
-| `UsersIcon` | `idle`, `inviting`, `joined` | Accounts: Team or member list |
-| `SettingsIcon` | `idle`, `adjusting`, `applied` | Accounts: Open preferences |
-| `LogInIcon` | `idle`, `entering`, `signed-in` | Accounts: Sign-in action |
-| `LogOutIcon` | `idle`, `leaving`, `signed-out` | Accounts: Sign-out action |
-| `LockIcon` | `locked`, `unlocking`, `unlocked` | Security: Protected or private content |
-| `KeyIcon` | `idle`, `turning`, `unlocked` | Security: Credentials or access-key action |
-| `InfoIcon` | `idle`, `revealing`, `open` | Status: Information tooltip trigger |
-| `MailIcon` | `unread`, `opening`, `read` | Communication: Unread email or inbox |
-| `SendIcon` | `idle`, `sending`, `sent` | Communication: Submit message or contact form |
-| `MessageCircleIcon` | `idle`, `typing`, `received` | Communication: Conversation or comment entry |
-| `PhoneIcon` | `idle`, `ringing`, `connected` | Communication: Start a phone call |
-| `VideoIcon` | `off`, `connecting`, `on` | Media: Camera is disabled |
-| `MicIcon` | `muted`, `listening`, `recording` | Media: Microphone is muted |
-| `PencilIcon` | `idle`, `writing`, `saved` | Editing: Edit article or field |
-| `FileTextIcon` | `idle`, `reading`, `complete` | Files: Document or blog post link |
-| `FileIcon` | `idle`, `creating`, `ready` | Files: File picker or file row |
-| `FolderIcon` | `closed`, `opening`, `open` | Files: Closed folder or collapsed collection |
-| `SaveIcon` | `idle`, `saving`, `saved` | Editing: Save document or preferences |
-| `UploadIcon` | `idle`, `uploading`, `complete` | Files: Upload media or attachment |
-| `ClipboardIcon` | `idle`, `checking`, `complete` | Files: Checklist or review queue |
-| `BookmarkIcon` | `unsaved`, `saving`, `saved` | Content: Save blog post or resource |
-| `BookOpenIcon` | `idle`, `reading`, `finished` | Content: Documentation or article reading entry |
-| `ImageIcon` | `idle`, `loading`, `loaded` | Content: Image picker or media placeholder |
-| `CameraIcon` | `idle`, `focusing`, `captured` | Media: Take a photo or avatar picture |
-| `ShareIcon` | `idle`, `sharing`, `shared` | Content: Share article or app content |
-| `CalendarIcon` | `idle`, `selecting`, `selected` | Time: Date picker or event link |
-| `ClockIcon` | `idle`, `running`, `paused` | Time: Time or recent activity |
-| `TimerIcon` | `idle`, `running`, `finished` | Time: Start a countdown |
-| `MapPinIcon` | `idle`, `locating`, `located` | Location: Address or location entry |
-| `GlobeIcon` | `idle`, `connecting`, `online` | Location: Language or worldwide availability |
-| `CircleHelpIcon` | `idle`, `asking`, `answered` | Status: Help or FAQ trigger |
-| `PlayIcon` | `idle`, `hover`, `pressed` | Media: Start media or a tutorial |
-| `PauseIcon` | `idle`, `hover`, `pressed` | Media: Pause media or a task |
-| `VolumeIcon` | `muted`, `low`, `high` | Media: Audio muted |
-| `MusicIcon` | `idle`, `playing`, `paused` | Media: Music or audio track |
-| `SunIcon` | `idle`, `rising`, `bright` | Appearance: Light theme or daylight |
-| `ShoppingCartIcon` | `empty`, `adding`, `filled` | Commerce: Cart has no selected items |
-| `ShoppingBagIcon` | `empty`, `packing`, `packed` | Commerce: Shopping bag or checkout entry |
-| `CreditCardIcon` | `idle`, `processing`, `approved` | Commerce: Payment method selection |
-| `WalletIcon` | `closed`, `opening`, `open` | Commerce: Wallet or balance entry |
-| `PackageIcon` | `sealed`, `opening`, `open` | Commerce: Shipment or package row |
-| `TruckIcon` | `idle`, `delivering`, `delivered` | Commerce: Delivery option or shipment |
-| `FilterIcon` | `idle`, `filtering`, `filtered` | Controls: Filter options available |
-| `SlidersIcon` | `idle`, `adjusting`, `applied` | Controls: Open tuning or adjustment controls |
-| `LayoutGridIcon` | `idle`, `reordering`, `ordered` | Controls: Grid view or app launcher |
-| `LayoutDashboardIcon` | `idle`, `loading`, `ready` | Controls: Dashboard navigation |
-| `ListIcon` | `idle`, `sorting`, `sorted` | Controls: List view or item collection |
-| `LayersIcon` | `stacked`, `separating`, `separated` | Controls: Layer stack or grouped content |
-| `MaximizeIcon` | `idle`, `expanding`, `expanded` | Controls: Enter fullscreen or expand preview |
-| `MinimizeIcon` | `idle`, `contracting`, `contracted` | Controls: Exit fullscreen or collapse preview |
-| `CodeIcon` | `idle`, `compiling`, `ready` | Development: Code sample or developer feature |
-| `TerminalIcon` | `idle`, `running`, `complete` | Development: Open command prompt or CLI example |
-| `DatabaseIcon` | `idle`, `syncing`, `synced` | Development: Data store or record source |
-| `WifiIcon` | `offline`, `connecting`, `connected` | Connectivity: No wireless connection |
-| `CloudIcon` | `idle`, `syncing`, `synced` | Connectivity: Cloud files or remote storage |
-| `MoonIcon` | `idle`, `setting`, `asleep` | Appearance: Dark theme or quiet hours |
+| Icon                  | States                               | Intended use                                        |
+| --------------------- | ------------------------------------ | --------------------------------------------------- |
+| `HomeIcon`            | `idle`, `entering`, `active`         | Navigation: Home link in a header or sidebar        |
+| `MenuIcon`            | `closed`, `hover`, `open`            | Navigation: Collapsed mobile navigation             |
+| `PlusIcon`            | `idle`, `hover`, `pressed`           | Actions: Create item or increase quantity           |
+| `MinusIcon`           | `idle`, `hover`, `pressed`           | Actions: Decrease quantity or remove a row          |
+| `ChevronDownIcon`     | `collapsed`, `hover`, `expanded`     | Navigation: Closed disclosure or select menu        |
+| `ChevronRightIcon`    | `idle`, `advancing`, `arrived`       | Navigation: Next step or drill into a row           |
+| `ChevronLeftIcon`     | `idle`, `returning`, `arrived`       | Navigation: Previous page or back in a wizard       |
+| `ChevronUpIcon`       | `collapsed`, `hover`, `expanded`     | Navigation: Closed upward popover                   |
+| `ArrowRightIcon`      | `idle`, `moving`, `arrived`          | Navigation: Next page or primary landing-page CTA   |
+| `ArrowLeftIcon`       | `idle`, `moving`, `arrived`          | Navigation: Back navigation                         |
+| `ArrowUpIcon`         | `idle`, `moving`, `arrived`          | Navigation: Scroll to top or move a row upward      |
+| `ArrowDownIcon`       | `idle`, `moving`, `arrived`          | Navigation: Scroll down or move a row downward      |
+| `ExternalLinkIcon`    | `idle`, `opening`, `opened`          | Navigation: Open external resource from blog or app |
+| `MoreHorizontalIcon`  | `closed`, `opening`, `open`          | Actions: Overflow action menu closed                |
+| `MoreVerticalIcon`    | `closed`, `opening`, `open`          | Actions: Row overflow menu closed                   |
+| `UserIcon`            | `idle`, `loading`, `active`          | Accounts: Profile or account entry                  |
+| `UsersIcon`           | `idle`, `inviting`, `joined`         | Accounts: Team or member list                       |
+| `SettingsIcon`        | `idle`, `adjusting`, `applied`       | Accounts: Open preferences                          |
+| `LogInIcon`           | `idle`, `entering`, `signed-in`      | Accounts: Sign-in action                            |
+| `LogOutIcon`          | `idle`, `leaving`, `signed-out`      | Accounts: Sign-out action                           |
+| `LockIcon`            | `locked`, `unlocking`, `unlocked`    | Security: Protected or private content              |
+| `KeyIcon`             | `idle`, `turning`, `unlocked`        | Security: Credentials or access-key action          |
+| `InfoIcon`            | `idle`, `revealing`, `open`          | Status: Information tooltip trigger                 |
+| `MailIcon`            | `unread`, `opening`, `read`          | Communication: Unread email or inbox                |
+| `SendIcon`            | `idle`, `sending`, `sent`            | Communication: Submit message or contact form       |
+| `MessageCircleIcon`   | `idle`, `typing`, `received`         | Communication: Conversation or comment entry        |
+| `PhoneIcon`           | `idle`, `ringing`, `connected`       | Communication: Start a phone call                   |
+| `VideoIcon`           | `off`, `connecting`, `on`            | Media: Camera is disabled                           |
+| `MicIcon`             | `muted`, `listening`, `recording`    | Media: Microphone is muted                          |
+| `PencilIcon`          | `idle`, `writing`, `saved`           | Editing: Edit article or field                      |
+| `FileTextIcon`        | `idle`, `reading`, `complete`        | Files: Document or blog post link                   |
+| `FileIcon`            | `idle`, `creating`, `ready`          | Files: File picker or file row                      |
+| `FolderIcon`          | `closed`, `opening`, `open`          | Files: Closed folder or collapsed collection        |
+| `SaveIcon`            | `idle`, `saving`, `saved`            | Editing: Save document or preferences               |
+| `UploadIcon`          | `idle`, `uploading`, `complete`      | Files: Upload media or attachment                   |
+| `ClipboardIcon`       | `idle`, `checking`, `complete`       | Files: Checklist or review queue                    |
+| `BookmarkIcon`        | `unsaved`, `saving`, `saved`         | Content: Save blog post or resource                 |
+| `BookOpenIcon`        | `idle`, `reading`, `finished`        | Content: Documentation or article reading entry     |
+| `ImageIcon`           | `idle`, `loading`, `loaded`          | Content: Image picker or media placeholder          |
+| `CameraIcon`          | `idle`, `focusing`, `captured`       | Media: Take a photo or avatar picture               |
+| `ShareIcon`           | `idle`, `sharing`, `shared`          | Content: Share article or app content               |
+| `CalendarIcon`        | `idle`, `selecting`, `selected`      | Time: Date picker or event link                     |
+| `ClockIcon`           | `idle`, `running`, `paused`          | Time: Time or recent activity                       |
+| `TimerIcon`           | `idle`, `running`, `finished`        | Time: Start a countdown                             |
+| `MapPinIcon`          | `idle`, `locating`, `located`        | Location: Address or location entry                 |
+| `GlobeIcon`           | `idle`, `connecting`, `online`       | Location: Language or worldwide availability        |
+| `CircleHelpIcon`      | `idle`, `asking`, `answered`         | Status: Help or FAQ trigger                         |
+| `PlayIcon`            | `idle`, `hover`, `pressed`           | Media: Start media or a tutorial                    |
+| `PauseIcon`           | `idle`, `hover`, `pressed`           | Media: Pause media or a task                        |
+| `VolumeIcon`          | `muted`, `low`, `high`               | Media: Audio muted                                  |
+| `MusicIcon`           | `idle`, `playing`, `paused`          | Media: Music or audio track                         |
+| `SunIcon`             | `idle`, `rising`, `bright`           | Appearance: Light theme or daylight                 |
+| `ShoppingCartIcon`    | `empty`, `adding`, `filled`          | Commerce: Cart has no selected items                |
+| `ShoppingBagIcon`     | `empty`, `packing`, `packed`         | Commerce: Shopping bag or checkout entry            |
+| `CreditCardIcon`      | `idle`, `processing`, `approved`     | Commerce: Payment method selection                  |
+| `WalletIcon`          | `closed`, `opening`, `open`          | Commerce: Wallet or balance entry                   |
+| `PackageIcon`         | `sealed`, `opening`, `open`          | Commerce: Shipment or package row                   |
+| `TruckIcon`           | `idle`, `delivering`, `delivered`    | Commerce: Delivery option or shipment               |
+| `FilterIcon`          | `idle`, `filtering`, `filtered`      | Controls: Filter options available                  |
+| `SlidersIcon`         | `idle`, `adjusting`, `applied`       | Controls: Open tuning or adjustment controls        |
+| `LayoutGridIcon`      | `idle`, `reordering`, `ordered`      | Controls: Grid view or app launcher                 |
+| `LayoutDashboardIcon` | `idle`, `loading`, `ready`           | Controls: Dashboard navigation                      |
+| `ListIcon`            | `idle`, `sorting`, `sorted`          | Controls: List view or item collection              |
+| `LayersIcon`          | `stacked`, `separating`, `separated` | Controls: Layer stack or grouped content            |
+| `MaximizeIcon`        | `idle`, `expanding`, `expanded`      | Controls: Enter fullscreen or expand preview        |
+| `MinimizeIcon`        | `idle`, `contracting`, `contracted`  | Controls: Exit fullscreen or collapse preview       |
+| `CodeIcon`            | `idle`, `compiling`, `ready`         | Development: Code sample or developer feature       |
+| `TerminalIcon`        | `idle`, `running`, `complete`        | Development: Open command prompt or CLI example     |
+| `DatabaseIcon`        | `idle`, `syncing`, `synced`          | Development: Data store or record source            |
+| `WifiIcon`            | `offline`, `connecting`, `connected` | Connectivity: No wireless connection                |
+| `CloudIcon`           | `idle`, `syncing`, `synced`          | Connectivity: Cloud files or remote storage         |
+| `MoonIcon`            | `idle`, `setting`, `asleep`          | Appearance: Dark theme or quiet hours               |
 
 New icons also expose per-icon imports such as `weasel-icons/menu`, `weasel-icons/upload` and `weasel-icons/shopping-cart`, plus typed state lists. Play and Pause use control states (`idle`, `hover`, `pressed`); the application owns playback. Clock, Timer and Truck retain phase when activity stops. Quiet states remain still even with `alive`; finite capture, selection and insertion actions play once per entry.
 

package/THIRD_PARTY_NOTICES.md

@@ -28,6 +28,8 @@ The ten-icon expansion additionally adapts `fuel`, `brick-wall`, `blocks`, `dice
 
 The local 200-icon expansion additionally adapts these assets at the same pinned revision: `air-vent`, `alarm-smoke`, `armchair`, `bed-double`, `blinds`, `blender`, `concierge-bell`, `faucet`, `heater`, `lamp-ceiling`, `lamp-floor`, `microwave`, `rocking-chair`, `shower-head`, `sofa`, `toilet`, `towel-rack`, `shelving-unit`, `mirror-round`, `robot-vacuum`, `avocado`, `bacon`, `bean`, `beef`, `beer`, `bottle-wine`, `broccoli`, `can-soda`, `croissant`, `cup-soda`, `cupcake`, `donut`, `drumstick`, `egg-fried`, `ham`, `leafy-green`, `lollipop`, `popcorn`, `popsicle`, `soup`, `binoculars`, `bow-arrow`, `cable-car`, `caravan`, `drone`, `engine`, `ev-charger`, `ferris-wheel`, `fire-extinguisher`, `fishing-rod`, `flashlight`, `helicopter`, `kayak`, `life-buoy`, `parking-meter`, `plane-landing`, `plane-takeoff`, `radar`, `ship-wheel`, `train-track`, `barrel`, `bolt`, `broom`, `brush-cleaning`, `container`, `dam`, `fence`, `gavel`, `pickaxe`, `pocket-knife`, `printer-3d`, `robot-arm`, `screw`, `shredder`, `solar-panel`, `spool`, `spray-can`, `stamp`, `tool-case`, `utility-pole`, `amphora`, `bridge`, `eclipse`, `flask-round`, `galaxy`, `haze`, `hiking-stick`, `land-plot`, `mountain-snow`, `orbit`, `origami`, `plant-pot`, `rose`, `shell`, `stone`, `tent-tree`, `waves-ladder`, `wheat`, `airplay`, `car-battery`, `card-sim`, `cctv`, `computer`, `credit-card-reader`, `dock`, `id-card-lanyard`, `inspection-panel`, `microchip`, `midi-port`, `pc-case`, `radio-receiver`, `screen-share`, `server-nas`, `smartphone-charging`, `speaker`, `turntable`, `usb-c-port`, `watch`, `chart-area`, `chart-candlestick`, `chart-gantt`, `chart-network`, `chart-scatter`, `chart-spline`, `chart-bar-stacked`, `chart-column-stacked`, `graph-hub`, `graph-star`, `timeline`, `workflow`, `waypoints`, `split`, `combine`, `git-fork`, `git-graph`, `git-merge-conflict`, `git-pull-request-draft`, `git-pull-request-closed`, `blend`, `contrast`, `frame`, `lens-concave`, `lens-convex`, `letter-spacing`, `line-height`, `line-style`, `vector-polygon`, `vector-square`, `spline-pointer`, `tangent`, `radius`, `diameter`, `proportions`, `squares-exclude`, `squares-intersect`, `squares-subtract`, `squares-unite`, `ruler-dimension-line`, `baby`, `biceps-flexed`, `bone`, `bone-fracture`, `cross`, `germ`, `iv-bag`, `pill-bottle`, `tablets`, `perfume-bottle`, `soap-dispenser-droplet`, `toothbrush`, `tube-lotion`, `recycle`, `ribbon`, `weight`, `whistle`, `siren`, `skull`, `hand-heart`, `banknote-arrow-down`, `banknote-arrow-up`, `banknote-check`, `banknote-x`, `certificate`, `crown`, `gem`, `hand-coins`, `hand-helping`, `hand-platter`, `medal`, `podium`, `vote`, `ticket-check`, `ticket-x`, `tickets-plane`, `wallet-cards`, `receipt-text`, `signature`, `tags`. Parts, compatible morphs, and state choreography are independently authored. The upstream ISC and Feather notices below are retained for all adapted assets.
 
+The local 200-icon expansion additionally adapts these assets at the same pinned revision: `file-play`, `file-clock`, `file-pen-line`, `file-type`, `file-user`, `file-heart`, `file-input`, `file-output`, `file-stack`, `file-symlink`, `file-terminal`, `file-key`, `file-video-camera`, `file-volume`, `file-headphone`, `file-question-mark`, `file-signal`, `file-sliders`, `file-box`, `file-axis-3d`, `mail-search`, `mail-clock`, `mail-warning`, `mail-question-mark`, `mail-pen`, `mail-plus`, `mail-minus`, `mails`, `contact`, `phone-missed`, `message-square-lock`, `user-lock`, `message-square-quote`, `message-square-share`, `message-circle-code`, `speech`, `users-collaboration`, `user-check`, `user-search`, `user-shield`, `folder-archive`, `folder-bookmark`, `folder-clock`, `folder-code`, `folder-git`, `folder-kanban`, `folder-key`, `folder-pen`, `folder-symlink`, `folder-users`, `form`, `summary`, `text-search`, `text-quote`, `text-initial`, `ligature`, `a-large-small`, `baseline`, `section`, `list-todo`, `layout-list`, `layout-template`, `layout-freeform`, `list-tree`, `list-music`, `list-video`, `list-sort-ascending`, `list-collapse`, `table-cells-merge`, `table-cells-split`, `axis-3d`, `move-3d`, `rotate-3d`, `scale-3d`, `scaling`, `ratio`, `angle`, `shapes`, `component`, `puzzle`, `shield-alert`, `shield-ban`, `shield-keyhole`, `shield-lock`, `shield-user`, `shield-question-mark`, `earth-lock`, `brain-circuit`, `cpu-ai`, `database-backup`, `server-crash`, `server-cog`, `database-search`, `database-zap`, `cloud-backup`, `cloud-sync`, `monitor-cloud`, `monitor-smartphone`, `smartphone-nfc`, `smartphone-user-round`, `boom-box`, `mic-vocal`, `keyboard-music`, `guitar-electric`, `disc-album`, `clef-bass`, `clef-treble`, `eighth-note`, `sixteenth-notes`, `eject`, `closed-caption`, `hd`, `tv`, `videotape`, `switch-camera`, `spotlight`, `image-upscale`, `image-play`, `scan-text`, `scan-eye`, `ad`, `groceries`, `handbag`, `paper-bag`, `carton`, `can`, `boxes`, `briefcase-conveyor-belt`, `package-search`, `scan-barcode`, `trending-down`, `trending-up-down`, `road`, `traffic-cone`, `park`, `map-pinned`, `map-pin-house`, `map-pin-search`, `map-plus`, `map-minus`, `van`, `scooter`, `truck-electric`, `trailer`, `train-front-tunnel`, `ship-cargo`, `door-stairwell`, `circle-parking`, `tower-control`, `university`, `building-complex`, `birdhouse`, `shrub`, `trees`, `nut`, `hop`, `cannabis`, `vegan`, `shrimp`, `dessert`, `shirt`, `hat-glasses`, `person-standing`, `hand`, `hand-fist`, `hand-grab`, `hand-metal`, `mouth`, `drama`, `venetian-mask`, `panda`, `rat`, `snail`, `squirrel`, `turtle`, `worm`, `ghost`, `virus`, `sport-shoe`, `volleyball`, `sword`, `swords`, `bomb`, `chess-king`, `chess-queen`, `chess-knight`, `chess-rook`, `chess-bishop`, `chess-pawn`, `tic-tac-toe`, `cone`, `cuboid`, `cylinder`, `diamond`, `hexagon`, `pentagon`, `pyramid`, `torus`, `triangle-right`, `rectangle-circle`. Parts, compatible morphs, and state choreography are independently authored. The upstream ISC and Feather notices below are retained for all adapted assets.
+
 The retained Lucide geometry carries the following [Lucide ISC notice](https://lucide.dev/license):
 Star, Sparkles and Sparkle additionally adapt the current `star` and central `sparkles` contours. Sparkle is the single-contour composition; Sparkles' satellite diamonds and the single-line Wave geometry are original to Weasel. Wave follows the user's visual reference, not Lucide's stacked wave glyph.
 

package/bin/cli.mjs

@@ -0,0 +1,264 @@
+#!/usr/bin/env node
+import { lstat, mkdir, readFile, realpath, unlink, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { fileURLToPath } from 'node:url';
+
+const packageRoot = fileURLToPath(new URL('../', import.meta.url));
+const manifest = JSON.parse(await readFile(join(packageRoot, 'package.json'), 'utf8'));
+const skillName = 'weasel-customize';
+const agents = {
+  codex: { label: 'Codex', user: '.agents/skills', project: '.agents/skills' },
+  'claude-code': { label: 'Claude Code', user: '.claude/skills', project: '.claude/skills' },
+  antigravity: {
+    label: 'Antigravity IDE / App',
+    user: '.gemini/config/skills',
+    project: '.agents/skills',
+  },
+  'antigravity-cli': {
+    label: 'Antigravity CLI',
+    user: '.gemini/antigravity-cli/skills',
+    project: '.agents/skills',
+  },
+  cursor: { label: 'Cursor', user: '.cursor/skills', project: '.cursor/skills' },
+};
+const help = `weasel-icons ${manifest.version}
+
+  setup                         Choose agents and install their discovery skill
+  setup --agent codex,claude-code --scope user
+  setup --agent codex --scope project
+  setup --agent codex --remove   Remove only an unchanged Weasel discovery entry
+  skills get customize          Read the installed version's customization guide
+  skills get customize <name>   Read a guide reference (motion or review)
+  icons list [query]            Find an icon's source name
+  icons add <name> [--dir path] Copy editable icon source and runtime into this app
+
+Personal setup is the default. Project setup writes skill files into this repo.
+Existing custom files are never overwritten. No network requests or AI calls.
+`;
+
+function parse(argv) {
+  const positional = [],
+    options = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (!arg.startsWith('--')) positional.push(arg);
+    else if (['--remove', '--help', '--version'].includes(arg)) options[arg.slice(2)] = true;
+    else if (['--agent', '--scope', '--dir'].includes(arg)) {
+      if (!argv[i + 1] || argv[i + 1].startsWith('--')) throw new Error(`Missing value for ${arg}`);
+      if (options[arg.slice(2)]) throw new Error(`Repeated option ${arg}`);
+      options[arg.slice(2)] = argv[++i];
+    } else throw new Error(`Unknown option ${arg}`);
+  }
+  return { positional, options };
+}
+
+async function exists(path) {
+  try {
+    return await lstat(path);
+  } catch (error) {
+    if (error.code === 'ENOENT') return null;
+    throw error;
+  }
+}
+
+// Resolve ordinary parent symlinks (e.g. macOS /tmp), but refuse symlinks within
+// a write target. An icon/skill destination cannot redirect writes elsewhere.
+async function checkedTarget(root, path) {
+  const absolute = resolve(path);
+  const rel = relative(root, absolute);
+  if (rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel))
+    throw new Error(`Destination must stay inside ${root}`);
+  let current = root;
+  for (const segment of rel.split(sep).filter(Boolean)) {
+    current = join(current, segment);
+    const info = await exists(current);
+    if (info?.isSymbolicLink()) throw new Error(`Refusing symlink destination: ${current}`);
+  }
+  return absolute;
+}
+
+async function projectRoot() {
+  let directory = await realpath(process.cwd());
+  while (true) {
+    const path = join(directory, 'package.json');
+    if (await exists(path)) {
+      const project = JSON.parse(await readFile(path, 'utf8'));
+      if (project.name === manifest.name)
+        throw new Error('Run this inside your app, not the Weasel package.');
+      return directory;
+    }
+    if (dirname(directory) === directory)
+      throw new Error('Run this inside an app with a package.json.');
+    directory = dirname(directory);
+  }
+}
+
+async function setup(options) {
+  let selected = options.agent?.split(',').filter(Boolean);
+  let scope = options.scope ?? 'user';
+  if (!selected?.length) {
+    if (!process.stdin.isTTY)
+      throw new Error('Choose agents with --agent codex,claude-code (or run setup interactively).');
+    const prompt = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      const names = Object.keys(agents);
+      console.log('Choose every agent you use:');
+      names.forEach((name, i) => console.log(`  ${i + 1}. ${agents[name].label}`));
+      const answer = await prompt.question('Numbers separated by commas: ');
+      selected = answer.split(',').map((value) => names[Number(value.trim()) - 1]);
+      if (!options.scope) {
+        const answer = (await prompt.question('Scope: personal or project? [personal] ')).trim();
+        scope = answer === 'personal' || !answer ? 'user' : answer;
+      }
+    } finally {
+      prompt.close();
+    }
+  }
+  if (!['user', 'project'].includes(scope)) throw new Error('Scope must be user or project.');
+  if (selected.some((name) => !Object.hasOwn(agents, name)))
+    throw new Error(`Supported agents: ${Object.keys(agents).join(', ')}`);
+  const root = scope === 'user' ? await realpath(homedir()) : await projectRoot();
+  const content = await readFile(join(packageRoot, 'skills', skillName, 'SKILL.md'), 'utf8');
+  const paths = [
+    ...new Set(selected.map((name) => join(root, agents[name][scope], skillName, 'SKILL.md'))),
+  ];
+  const plan = [];
+  // Preflight the entire selection before changing any agent's entry.
+  for (const path of paths) {
+    await checkedTarget(root, path);
+    const previous = await exists(path);
+    if (previous && (!previous.isFile() || (await readFile(path, 'utf8')) !== content))
+      throw new Error(
+        `Preserving an existing or modified skill: ${path}. Move it deliberately before setup; nothing was changed.`,
+      );
+    plan.push({ path, previous });
+  }
+  if (options.remove) {
+    for (const { path, previous } of plan) {
+      if (previous) await unlink(path);
+      console.log(`${previous ? 'Removed' : 'Already absent'}: ${path}`);
+    }
+    return;
+  }
+  const created = [];
+  try {
+    for (const { path, previous } of plan) {
+      if (!previous) {
+        await mkdir(dirname(path), { recursive: true });
+        await checkedTarget(root, path);
+        await writeFile(path, content, { flag: 'wx' });
+        created.push(path);
+      }
+      console.log(`${previous ? 'Already installed' : 'Installed'}: ${path}`);
+    }
+  } catch (error) {
+    for (const path of created) await unlink(path);
+    throw error;
+  }
+  console.log('\nAsk your agent: Use weasel-customize to add a state to my icon.');
+  console.log('If it is not visible, start a new session or reload the agent.');
+  console.log('This installs instructions; it does not launch an AI or share chat history.');
+}
+
+async function sourceCommand(command, name, options) {
+  const source = JSON.parse(await readFile(join(packageRoot, 'dist', 'source.json'), 'utf8'));
+  if (source.version !== manifest.version)
+    throw new Error('Source and package versions do not match. Reinstall the package.');
+  if (command === 'list') {
+    for (const icon of Object.keys(source.icons)
+      .filter((icon) => icon.includes(name ?? ''))
+      .sort())
+      console.log(icon);
+    return;
+  }
+  if (!name || !Object.hasOwn(source.icons, name))
+    throw new Error('Unknown icon. Use: weasel-icons icons list <query>');
+  const root = await projectRoot();
+  const defaultDir = (await exists(join(root, 'src')))
+    ? 'src/components/weasel'
+    : 'components/weasel';
+  const destination = await checkedTarget(root, resolve(root, options.dir ?? defaultDir));
+  if (
+    relative(root, destination)
+      .split(sep)
+      .some((part) => ['node_modules', '.git', '.agents', '.claude'].includes(part))
+  )
+    throw new Error(
+      'Choose an application source directory, outside dependencies and agent configuration.',
+    );
+  const files = new Set();
+  const visit = (path) => {
+    if (files.has(path)) return;
+    const file = source.files[path];
+    if (!file) throw new Error(`Missing bundled source: ${path}`);
+    files.add(path);
+    file.dependencies.forEach(visit);
+  };
+  source.icons[name].forEach(visit);
+  for (const file of ['LICENSE', 'THIRD_PARTY_NOTICES.md']) files.add(file);
+  const writes = [];
+  for (const file of files) {
+    const path = await checkedTarget(root, join(destination, file));
+    const content = source.files[file].content;
+    if (await exists(path)) {
+      if ((await readFile(path, 'utf8')) !== content)
+        throw new Error(
+          `Preserving customized or different-version source: ${path}. Reuse it, or choose a new --dir. Nothing was copied.`,
+        );
+    } else writes.push({ path, content });
+  }
+  const created = [];
+  try {
+    for (const { path, content } of writes) {
+      await mkdir(dirname(path), { recursive: true });
+      await checkedTarget(root, path);
+      await writeFile(path, content, { flag: 'wx' });
+      created.push(path);
+    }
+  } catch (error) {
+    for (const path of created) await unlink(path);
+    throw error;
+  }
+  console.log(`Weasel ${source.version}: ${writes.length} files copied for ${name}.`);
+  console.log(`Editable icon: ${join(destination, 'icons', name, `${name}-icon.tsx`)}`);
+  console.log(
+    'Import this local component when customizing. Existing package imports keep working.',
+  );
+  console.log(
+    'The copied source imports motion/react. Declare motion directly in your app before using it.',
+  );
+}
+
+try {
+  const { positional: args, options } = parse(process.argv.slice(2));
+  const [command, subcommand, name, ...extra] = args;
+  if (options.version) console.log(manifest.version);
+  else if (options.help || !command || command === 'help') console.log(help);
+  else if (command === 'setup' && args.length === 1) {
+    if (options.dir) throw new Error('--dir belongs to icons add.');
+    await setup(options);
+  } else if (
+    command === 'skills' &&
+    subcommand === 'get' &&
+    name === 'customize' &&
+    extra.length <= 1
+  ) {
+    const reference = extra[0];
+    if (reference && !['motion', 'review'].includes(reference))
+      throw new Error('References: motion, review');
+    const path = reference
+      ? `skill-data/customize/references/${reference}.md`
+      : 'skill-data/customize/SKILL.md';
+    console.log(`# Instructions for installed weasel-icons ${manifest.version}\n`);
+    console.log(await readFile(join(packageRoot, path), 'utf8'));
+  } else if (command === 'icons' && ['list', 'add'].includes(subcommand) && extra.length === 0) {
+    if (options.agent || options.scope || options.remove)
+      throw new Error('Agent options belong to setup.');
+    await sourceCommand(subcommand, name, options);
+  } else throw new Error('Unknown command. Run: weasel-icons --help');
+} catch (error) {
+  console.error(`Weasel: ${error.message}`);
+  process.exitCode = 1;
+}

package/dist/icons/a-large-small/a-large-small-icon.d.ts

@@ -0,0 +1,5 @@
+import type { StatefulIconProps } from "../../shared/icon-types.js";
+import { type ALargeSmallState } from "./a-large-small-rig.js";
+export { aLargeSmallStates, type ALargeSmallState } from "./a-large-small-rig.js";
+export type ALargeSmallIconProps = StatefulIconProps<ALargeSmallState>;
+export declare const ALargeSmallIcon: import("react").NamedExoticComponent<ALargeSmallIconProps>;

package/dist/icons/a-large-small/a-large-small-icon.js

@@ -0,0 +1,9 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo } from 'react';
+import { ArticulatedIcon } from "../../shared/articulated-icon.js";
+import { aLargeSmallArt, aLargeSmallStates } from "./a-large-small-rig.js";
+export { aLargeSmallStates } from "./a-large-small-rig.js";
+export const ALargeSmallIcon = memo(function ALargeSmallIcon(props) {
+    return _jsx(ArticulatedIcon, { art: aLargeSmallArt, states: aLargeSmallStates, ...props });
+});

package/dist/icons/a-large-small/a-large-small-rig.d.ts

@@ -0,0 +1,28 @@
+export declare const aLargeSmallStates: readonly ["mixed", "balanced", "small"];
+export type ALargeSmallState = (typeof aLargeSmallStates)[number];
+export declare const aLargeSmallArt: {
+    readonly name: "a-large-small";
+    readonly parts: readonly [{
+        readonly name: "large-letter";
+        readonly paths: readonly ["m 2 16 4.039 -9.69 a .5 .5 0 0 1 .923 0 L 11 16", "M 3.304 13 h 6.392"];
+        readonly poses: readonly [{}, {
+            readonly scaleX: 0.8;
+            readonly scaleY: 0.8;
+        }, {
+            readonly scaleX: 0.65;
+            readonly scaleY: 0.65;
+        }];
+        readonly pivot: readonly [6.5, 16];
+    }, {
+        readonly name: "small-letter";
+        readonly paths: readonly ["m 15 16 2.536 -7.328 a 1.02 1.02 1 0 1 1.928 0 L 22 16", "M 15.697 14 h 5.606"];
+        readonly poses: readonly [{}, {
+            readonly scaleX: 1.05;
+            readonly scaleY: 1.05;
+        }, {
+            readonly scaleX: 0.8;
+            readonly scaleY: 0.8;
+        }];
+        readonly pivot: readonly [18.5, 16];
+    }];
+};

package/dist/icons/a-large-small/a-large-small-rig.js

@@ -0,0 +1,40 @@
+export const aLargeSmallStates = ['mixed', 'balanced', 'small'];
+// Text size normalization. The large A reduces and the small A grows slightly, both anchored on the same baseline. Retain a distinct pose for this configuration or result.
+// Adapted Lucide geometry; see THIRD_PARTY_NOTICES.md.
+export const aLargeSmallArt = {
+    name: 'a-large-small',
+    parts: [
+        {
+            name: 'large-letter',
+            paths: ['m 2 16 4.039 -9.69 a .5 .5 0 0 1 .923 0 L 11 16', 'M 3.304 13 h 6.392'],
+            poses: [
+                {},
+                {
+                    scaleX: 0.8,
+                    scaleY: 0.8,
+                },
+                {
+                    scaleX: 0.65,
+                    scaleY: 0.65,
+                },
+            ],
+            pivot: [6.5, 16],
+        },
+        {
+            name: 'small-letter',
+            paths: ['m 15 16 2.536 -7.328 a 1.02 1.02 1 0 1 1.928 0 L 22 16', 'M 15.697 14 h 5.606'],
+            poses: [
+                {},
+                {
+                    scaleX: 1.05,
+                    scaleY: 1.05,
+                },
+                {
+                    scaleX: 0.8,
+                    scaleY: 0.8,
+                },
+            ],
+            pivot: [18.5, 16],
+        },
+    ],
+};

package/dist/icons/ad/ad-icon.d.ts

@@ -0,0 +1,5 @@
+import type { StatefulIconProps } from "../../shared/icon-types.js";
+import { type AdState } from "./ad-rig.js";
+export { adStates, type AdState } from "./ad-rig.js";
+export type AdIconProps = StatefulIconProps<AdState>;
+export declare const AdIcon: import("react").NamedExoticComponent<AdIconProps>;

package/dist/icons/ad/ad-icon.js

@@ -0,0 +1,9 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo } from 'react';
+import { ArticulatedIcon } from "../../shared/articulated-icon.js";
+import { adArt, adStates } from "./ad-rig.js";
+export { adStates } from "./ad-rig.js";
+export const AdIcon = memo(function AdIcon(props) {
+    return _jsx(ArticulatedIcon, { art: adArt, states: adStates, ...props });
+});