@stealthscale/component-navigation 0.3.1 → 0.3.2

package/dist/theme.js

@@ -1,4 +1,4 @@
-import { a as recipe$3, n as recipe$4, o as recipe, r as recipe$2, s as recipe$1, t as recipe$5 } from "./recipe-BN0p1O6u.js";
+import { a as recipe$3, n as recipe$4, o as recipe, r as recipe$2, s as recipe$1, t as recipe$5 } from "./recipes-BN0p1O6u.js";
 import { definePreset } from "@stealthscale/theme/authoring";
 //#region src/theme.ts
 /**

package/locales/en/specimen/breadcrumb.json

@@ -0,0 +1,22 @@
+{
+  "about": "An ordered list of links from the site root to the current page.",
+  "april": "April",
+  "collapsed": {
+    "about": "A trail with the crumbs between the first crumb and the current page replaced by an ellipsis. The ellipsis takes an aria-label with the number of crumbs it replaces, so a screen reader announces the full depth.",
+    "title": "Collapsed"
+  },
+  "dropped": "{{count}} more steps",
+  "home": "Home",
+  "invoices": "Invoices",
+  "label": "Breadcrumb",
+  "shortened": "Collapsed breadcrumb",
+  "size": {
+    "about": "Every size, one trail per row. The size sets the text style and the gap between crumbs.",
+    "title": "Sizes"
+  },
+  "title": "Breadcrumb",
+  "variant": {
+    "about": "Both looks. The current page is a span in the default ink, and the links above it are muted.",
+    "title": "Looks"
+  }
+}

package/locales/en/specimen/link.json

@@ -0,0 +1,19 @@
+{
+  "about": "An anchor in the theme's link ink, underlined at rest or on hover.",
+  "after": " before the end of the month.",
+  "before": "Read the",
+  "inherit": {
+    "about": "A link in the link ink and a link that inherits the text color, both in muted text. Use inherit for a card title or a brand name, where the context already marks the text as a link.",
+    "title": "Inherit"
+  },
+  "palette": {
+    "about": "The eight semantic palettes. Each palette sets the ink from its fg role and the focus ring from its focusRing role.",
+    "title": "Palettes"
+  },
+  "terms": "terms of service",
+  "title": "Link",
+  "variant": {
+    "about": "Both looks inside a sentence. Both underline on hover. The underline look also underlines at rest.",
+    "title": "Looks"
+  }
+}

package/locales/en/specimen/nav-list.json

@@ -0,0 +1,43 @@
+{
+  "about": "A list of links a page is reached from: rows in a column, and branches that expand a nested list.",
+  "acme": "Acme",
+  "billing": "Billing",
+  "effect": {
+    "about": "A glow around the current row, in the palette's solid at half opacity.",
+    "title": "Effects"
+  },
+  "guide": {
+    "about": "Every style of the line down a nested list. The line is aligned with the centre of the branch's icon.",
+    "title": "Guides"
+  },
+  "highlight": {
+    "about": "Every highlight at every size, on the row with `aria-current`.",
+    "title": "Highlights and sizes"
+  },
+  "iconic": {
+    "about": "The list in full and collapsed to a rail. In the rail every row is a square that contains its icon, or its mark, such as the workspace's avatar. The counts, the controls and the nested rows are hidden, and the text remains in the accessibility tree. A link with `tooltip` shows its words beside the icon on hover and on focus.",
+    "title": "Iconic"
+  },
+  "invoices": "Invoices",
+  "overview": "Overview",
+  "palette": {
+    "about": "The eight semantic palettes, on the fill highlight. The palette sets the highlight, the hover fill and the branch rows.",
+    "title": "Palettes"
+  },
+  "radius": {
+    "about": "Every corner, on the current row.",
+    "title": "Corners"
+  },
+  "rename": "Rename {{name}}",
+  "reveal": {
+    "about": "A control that is always visible, and one that appears on hover. The control on the current row is always visible. The others appear under the pointer, while their row has focus, and under a coarse pointer.",
+    "title": "Reveal"
+  },
+  "settings": "Settings",
+  "team": "Team",
+  "title": "Nav list",
+  "variant": {
+    "about": "A column of rows, and a dock of equal columns across the foot of a screen, each an icon over its label.",
+    "title": "Looks"
+  }
+}

package/locales/en/specimen/navigation-menu.json

@@ -0,0 +1,104 @@
+{
+  "about": "Renders a site's navigation landmark: a bar of links and of buttons that open panels of links. Each button follows the WAI-ARIA disclosure pattern, so a screen reader announces a button that expands a group of links. A mouse opens a panel after `openDelay`, a press toggles it, the arrow keys move along the bar and into an open panel, and Escape or a press outside closes it.",
+  "aligned": {
+    "about": "`align` on the viewport positioner places the viewport against the open trigger: its start edge at the trigger's start, centred under the trigger, or its end edge at the trigger's end. The machine keeps the viewport 10px inside the window.",
+    "title": "Alignment"
+  },
+  "click": {
+    "about": "With `disableHoverTrigger` a panel opens only on a press, as a menu in an application's bar does. A second press closes it, and the arrow keys still move along the bar.",
+    "docs": "Documentation",
+    "help": "Help",
+    "label": "Application",
+    "members": "Members",
+    "settings": "Settings",
+    "shortcuts": "Keyboard shortcuts",
+    "support": "Contact support",
+    "switch": "Switch workspace",
+    "title": "Press to open",
+    "workspace": "Workspace"
+  },
+  "controlled": {
+    "about": "The caller keeps `value` and changes it in `onValueChange`, and the status line reads the open item. `onSelect` on a link runs before the menu closes, so the status line also names the last link pressed.",
+    "closed": "Every panel is closed.",
+    "open": "Open: {{item}}.",
+    "picked": "Last link pressed: {{link}}.",
+    "title": "Controlled"
+  },
+  "header": {
+    "about": "Panels open in one shared viewport, which moves to the open trigger and resizes to the panel, and the indicator runs along the bar under the open trigger. The viewport's start edge meets the open trigger's, because the bar starts at the page's start edge. Every panel is written inside its item and shown in the viewport. Pricing is a plain link and marks the page on screen with `current`.",
+    "careers": "Careers",
+    "changelog": {
+      "about": "What shipped each week.",
+      "title": "Changelog"
+    },
+    "company": "Company",
+    "contact": "Contact",
+    "guides": {
+      "about": "Setups for common integrations.",
+      "title": "Guides"
+    },
+    "invoicing": {
+      "about": "Invoices that reconcile when paid.",
+      "title": "Invoicing"
+    },
+    "label": "Site",
+    "ledger": {
+      "about": "Double-entry books for each account.",
+      "title": "Ledger"
+    },
+    "payments": {
+      "about": "Accept cards and bank debits.",
+      "title": "Payments"
+    },
+    "pricing": "Pricing",
+    "products": "Products",
+    "reference": {
+      "about": "Every endpoint and error code.",
+      "title": "API reference"
+    },
+    "reports": {
+      "about": "Revenue, fees and payouts by month.",
+      "title": "Reports"
+    },
+    "resources": "Resources",
+    "story": "About us",
+    "title": "Site header"
+  },
+  "inline": {
+    "about": "Without a viewport each panel opens under its own trigger and is as wide as its links. The indicator runs along the bar under the open trigger, and Changelog marks the page on screen with `current`.",
+    "api": "API",
+    "changelog": "Changelog",
+    "cli": "Command line",
+    "label": "Developers",
+    "logs": "Request logs",
+    "payments": "Payments",
+    "refunds": "Refunds",
+    "sandbox": "Sandbox",
+    "title": "Panels in place",
+    "tools": "Tools",
+    "webhooks": "Webhooks"
+  },
+  "palette": {
+    "about": "The palette colors the indicator and a link to the page on screen. Changelog is current in each row.",
+    "title": "Palettes"
+  },
+  "sidebar": {
+    "about": "With `orientation=\"vertical\"` the bar is a column, the arrow keys move up and down it, and ArrowRight enters an open panel, which opens beside its trigger. Dashboard is current.",
+    "billing": "Billing",
+    "dashboard": "Dashboard",
+    "invoices": "Invoices",
+    "keys": "API keys",
+    "label": "Workspace",
+    "security": "Security",
+    "settings": "Settings",
+    "subscriptions": "Subscriptions",
+    "tax": "Tax",
+    "team": "Team",
+    "title": "Vertical"
+  },
+  "size": {
+    "about": "Every size. The size sets the bar's triggers and links, the gap to a panel, and a panel's padding, links and icons.",
+    "title": "Sizes"
+  },
+  "title": "Navigation menu"
+}

package/locales/en/specimen/pagination.json

@@ -0,0 +1,49 @@
+{
+  "about": "Renders a navigation landmark of page buttons between the buttons that move a page back and forward. Every page and trigger is the library's square button, and the current page is the button marked on.",
+  "edges": {
+    "about": "The first and last triggers jump to the ends. With `siblingCount` 0 the row shows the first, the current and the last page between them.",
+    "title": "Edges"
+  },
+  "first": "First page",
+  "last": "Last page",
+  "links": {
+    "about": "With `type=\"link\"`, every page and trigger is a link to the address `getPageUrl` returns, so a reader can open a page in a new tab and the address bar keeps the page. A press follows the link and leaves the page to the address: the example reads `page` from the hash, as an application reads it from its router.",
+    "title": "Links"
+  },
+  "looks": {
+    "about": "The root passes `variant` to every button. Ghost and outline fill the current page, and subtle fills it one step deeper than the other pages.",
+    "title": "Looks"
+  },
+  "narrow": {
+    "about": "The root measures whether its pages fit the row. When they do not, it sets `data-crowded`, the pages and marks are hidden, and the summary states the current page between the triggers. The `summary` prop of `Pagination.Items` sets the summary's words.",
+    "title": "Narrow"
+  },
+  "next": "Next page",
+  "page": "Page {{page}}",
+  "palette": {
+    "about": "The root passes `palette` to every button, so the current page takes the palette's fill.",
+    "title": "Palettes"
+  },
+  "previous": "Previous page",
+  "siblings": {
+    "about": "`siblingCount` sets how many pages show on each side of the current one. Every row starts on page 12 of 24, where marks replace the runs of pages left out.",
+    "title": "Siblings"
+  },
+  "size": {
+    "about": "Every size. The size sets the buttons, the gaps between them, the ellipsis and the page text.",
+    "title": "Sizes"
+  },
+  "summary": "Page {{page}} of {{totalPages}}",
+  "table": {
+    "about": "A controlled pagination under a list: the caller keeps `page` and `pageSize`, shows the rows of the current page, and changes the page size from a segment group. The page text gives the range of rows.",
+    "amount": "€{{amount}}",
+    "invoice": "Invoice INV-{{number}}",
+    "perPage": "Rows per page",
+    "title": "Controlled"
+  },
+  "text": {
+    "about": "The page text in each format: compact states the page, short gives the page over the count, and long gives the range of items. It is an `output`, so a screen reader reads the new text after a press.",
+    "title": "Page text"
+  },
+  "title": "Pagination"
+}

package/locales/en/specimen/toc.json

@@ -0,0 +1,29 @@
+{
+  "about": "A list of links to the headings on a page, with an indicator next to the headings in view.",
+  "following": {
+    "about": "The aside placement next to three sections of this page. The table of contents sticks to the top of the viewport while the page scrolls, and the indicator moves to the headings in view. Clicking a link scrolls the page to its heading.",
+    "title": "Aside placement"
+  },
+  "headings": {
+    "toc-first": "The first section",
+    "toc-install": "Install",
+    "toc-overview": "Overview",
+    "toc-peers": "Peers",
+    "toc-second": "The second section",
+    "toc-third": "The third section",
+    "toc-usage": "Usage"
+  },
+  "onThisPage": "On this page",
+  "palette": {
+    "about": "The eight semantic palettes, with the indicator on the second heading. The palette sets the indicator and the focus ring.",
+    "title": "Palettes"
+  },
+  "passage": "This section gives the page enough height to scroll. The table of contents marks its heading while the heading is in view.",
+  "second": "With the aside placement the table of contents is sticky. It stays in the viewport while this column scrolls, so the indicator stays visible.",
+  "size": {
+    "about": "Every size, with the indicator on the second heading. A heading at depth 3 is indented by one gap.",
+    "title": "Sizes"
+  },
+  "third": "Clicking a link scrolls the page to its heading and writes the heading's ID to the URL fragment. The indicator then moves to that heading.",
+  "title": "Table of contents"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stealthscale/component-navigation",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Draws the ways a person moves between places: links, tabs, breadcrumbs and rails.",
   "keywords": [
     "components",
@@ -19,6 +19,7 @@
   "files": [
     "dist",
     "LICENSE",
+    "locales",
     "README.md"
   ],
   "type": "module",
@@ -44,16 +45,16 @@
   },
   "devDependencies": {
     "@arethetypeswrong/core": "^0.18",
-    "@stealthscale/component-actions": "^0.2.2",
-    "@stealthscale/component-disclosure": "^0.2.3",
-    "@stealthscale/component-layout": "^0.2.1",
-    "@stealthscale/component-primitives": "^0.3.0",
+    "@stealthscale/component-actions": "^0.2.3",
+    "@stealthscale/component-disclosure": "^0.2.4",
+    "@stealthscale/component-layout": "^0.2.2",
+    "@stealthscale/component-primitives": "^0.3.1",
     "@stealthscale/hooks": "^0.3.0",
     "@stealthscale/theme": "^0.5.0",
     "@stealthscale/vite-config": "^0.8.0",
-    "@stealthscale/vite-config-i18n": "^0.2.1",
+    "@stealthscale/vite-config-i18n": "^0.2.2",
     "@stealthscale/vite-config-react": "^0.9.1",
-    "@stealthscale/vite-config-specimen": "^0.2.1",
+    "@stealthscale/vite-config-specimen": "^0.3.0",
     "@stealthscale/vite-config-theme": "^0.3.0",
     "@stealthscale/vite-config-typescript": "^0.3.0",
     "@testing-library/react": "^16.3",
@@ -69,9 +70,9 @@
     "vitest": "5.0.3"
   },
   "peerDependencies": {
-    "@stealthscale/component-actions": "^0.2.2",
-    "@stealthscale/component-disclosure": "^0.2.3",
-    "@stealthscale/component-primitives": "^0.3.0",
+    "@stealthscale/component-actions": "^0.2.3",
+    "@stealthscale/component-disclosure": "^0.2.4",
+    "@stealthscale/component-primitives": "^0.3.1",
     "@stealthscale/hooks": "^0.3.0",
     "@stealthscale/theme": "^0.5.0",
     "react": "^19.3"