@startupjs-ui/menu 0.1.13 → 0.1.19

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.1.19](https://github.com/startupjs/startupjs-ui/compare/v0.1.18...v0.1.19) (2026-03-17)
+
+
+### Bug Fixes
+
+* **docs:** don't load all icons to keep bundle small ([#17](https://github.com/startupjs/startupjs-ui/issues/17)) ([d7eb70b](https://github.com/startupjs/startupjs-ui/commit/d7eb70bc11f5b15923f2e43b7ef1f86ea066494e))
+
+
+
+
+
+## [0.1.16](https://github.com/startupjs/startupjs-ui/compare/v0.1.15...v0.1.16) (2026-02-10)
+
+**Note:** Version bump only for package @startupjs-ui/menu
+
+
+
+
+
 ## [0.1.13](https://github.com/startupjs/startupjs-ui/compare/v0.1.12...v0.1.13) (2026-02-03)
 
 **Note:** Version bump only for package @startupjs-ui/menu

package/README.mdx

@@ -1,7 +1,9 @@
 import { useState } from 'react'
 import { pug, u } from 'startupjs'
 import useRouter from 'startupjs/useRouter'
-import { faShareAlt, faHouseUser, faTable } from '@fortawesome/free-solid-svg-icons'
+import { faShareAlt } from '@fortawesome/free-solid-svg-icons/faShareAlt'
+import { faHouseUser } from '@fortawesome/free-solid-svg-icons/faHouseUser'
+import { faTable } from '@fortawesome/free-solid-svg-icons/faTable'
 import Menu, { _PropsJsonSchema as MenuPropsJsonSchema } from './index'
 import MenuItem, { _PropsJsonSchema as MenuItemPropsJsonSchema } from './MenuItem'
 import Collapse from '@startupjs-ui/collapse'
@@ -11,7 +13,9 @@ import { Sandbox } from '@startupjs-ui/docs'
 
 Inherits [Div props](/docs/components/Div).
 
-Menu displays a list of choices and also can be used for navigation.
+Menu displays a list of choices on screen. It can be used for navigation, selecting options, or organizing actions into a vertical or horizontal list.
+
+Each item in the menu is a `Menu.Item`. Items can be marked as active, display icons, act as navigation links, and be styled with custom colors.
 
 ```jsx
 import { Menu } from 'startupjs-ui'
@@ -19,6 +23,8 @@ import { Menu } from 'startupjs-ui'
 
 ## Simple example
 
+At its simplest, a Menu contains a set of `Menu.Item` children. Track which item is active using component state and the `active` prop.
+
 ```jsx example
 const [active, setActive] = useState('option-1')
 return (
@@ -41,7 +47,7 @@ return (
 
 ## Highlighted active item
 
-By default the active menu item is not highlighted. To highlight it use the `activeBorder` property.
+By default, the active menu item has no visible border highlight. Use the `activeBorder` prop on the `Menu` component to add a colored border to whichever item is currently active. Supported positions are `'top'`, `'bottom'`, `'left'`, and `'right'`.
 
 ```jsx example
 const [active, setActive] = useState('option-1')
@@ -71,7 +77,7 @@ return (
 
 ## Horizontal menu
 
-By default the menu shows vertically. To make it horizontal, you need pass the string `horizontal` to the `variant` property.
+By default, the menu is laid out vertically. Set `variant='horizontal'` to arrange items in a row instead.
 
 ```jsx example
 const [active, setActive] = useState('option-1')
@@ -101,7 +107,7 @@ return (
 
 ## Menu item icon
 
-To display icon in menu item pass the `icon` property to it. Position of icon can be changed by passing `iconPosition` to `Menu` component (`left` by default) and can be override in menu item.
+Pass the `icon` prop to a `Menu.Item` to display an icon alongside its label. The icon position defaults to `'left'` but can be changed by setting `iconPosition` on the `Menu` (which applies to all items) or on an individual `Menu.Item` (which overrides the parent setting).
 
 ```jsx example
 const [active, setActive] = useState('option-1')
@@ -134,7 +140,11 @@ return (
 
 ## Change color of active item
 
-By default, the active menu item has a `primary` color. Use the `activeColor` property to set the desired color for the active element. This property will also change the color of border and icon (if you passed an `activeBorder` property for a Menu or an `icon` for a Menu.Item). `activeColor` accepts color as a string which will be compatible with the CSS color property.(ex. `red`, `#fff`, `rgb(123, 23, 122)`)
+By default, the active menu item uses the `primary` theme color. Use the `activeColor` prop to apply a custom color to the active item's text, icon, and border. It accepts any valid CSS color value (e.g. `'red'`, `'#fff'`, `'rgb(123, 23, 122)'`).
+
+You can also use the `color` prop on individual `Menu.Item` components to override the default text and icon color for inactive items.
+
+To render item text in bold, pass the `bold` prop to `Menu.Item`.
 
 ```jsx example
 const [active, setActive] = useState('option-1')
@@ -171,7 +181,7 @@ return (
 
 ## Menu item as link
 
-Sometimes you want using menu item as link, for example in navigation menu. See below how you can do this.
+Use the `to` prop on `Menu.Item` to turn it into a navigation link. This is useful for building navigation menus where each item routes to a different page.
 
 ```jsx example
 const { usePathname } = useRouter()
@@ -195,7 +205,7 @@ return pug`
 
 ## Complex interaction (integration with other components)
 
-An example of a collapsible menu with submenus nested in.
+This example shows a collapsible menu with nested submenus, built by combining Menu with the Collapse component. You can pass custom `style` and `containerStyle` props to fine-tune the layout.
 
 ```jsx example
 const [showMenu, setShowMenu] = useState(true)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@startupjs-ui/menu",
-  "version": "0.1.13",
+  "version": "0.1.19",
   "publishConfig": {
     "access": "public"
   },
@@ -8,16 +8,16 @@
   "types": "index.d.ts",
   "type": "module",
   "dependencies": {
-    "@startupjs-ui/core": "^0.1.11",
-    "@startupjs-ui/div": "^0.1.13",
-    "@startupjs-ui/icon": "^0.1.13",
-    "@startupjs-ui/item": "^0.1.13",
-    "@startupjs-ui/span": "^0.1.13"
+    "@startupjs-ui/core": "^0.1.19",
+    "@startupjs-ui/div": "^0.1.19",
+    "@startupjs-ui/icon": "^0.1.19",
+    "@startupjs-ui/item": "^0.1.19",
+    "@startupjs-ui/span": "^0.1.19"
   },
   "peerDependencies": {
     "react": "*",
     "react-native": "*",
     "startupjs": "*"
   },
-  "gitHead": "5cfdccf2bdae3873e968289a3e6b938fad02101a"
+  "gitHead": "bfcca786dc363f42a09b6eef4feb7ca8139302fc"
 }