@lilydesignsystem/nunjucks-picker-bar 0.2.0 → 0.4.0

package/LICENSE.md

@@ -0,0 +1,64 @@
+<!-- Synced from the canonical repository by bin/sync-special-files.
+     Do not edit here; edit the root copy and re-run the script.
+     Canonical: https://github.com/LilyDesignSystem/lily-design-system/blob/main/LICENSE.md -->
+
+# License
+
+Lily Design System™ is free open source software.
+
+License is any of these, at your option, or contact us for custom license options.
+
+* [MIT](https://opensource.org/license/mit) ([SPDX: MIT](https://spdx.org/licenses/MIT.html))
+
+* [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) ([SPDX: Apache-2.0](https://spdx.org/licenses/Apache-2.0.html))
+
+* [GNU General Public License v2.0](https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html) ([SPDX: GPL-2.0-only](https://spdx.org/licenses/GPL-2.0-only.html))
+
+* [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0-standalone.html) ([SPDX: GPL-3.0-only](https://spdx.org/licenses/GPL-3.0-only.html))
+
+* [BSD 3-Clause License](https://opensource.org/license/bsd-3-clause) ([SPDX: BSD-3-Clause](https://spdx.org/licenses/BSD-3-Clause.html))
+
+## SPDX
+
+The machine-readable expression for the choice above is:
+
+```
+SPDX-License-Identifier: MIT OR Apache-2.0 OR GPL-2.0-only OR GPL-3.0-only OR BSD-3-Clause
+```
+
+Every package manifest in this repository should carry that expression, or a
+single identifier from the list where the packaging format does not accept a
+disjunction. You do not need permission to pick one: choose whichever member of
+the list suits your project and comply with that one.
+
+This applies to the whole repository — the component catalog, the seven headless
+libraries, the seven example applications, the seven helper catalogs, the
+`themes/` stylesheets, the `bin/` tooling, and the documentation.
+
+## Scope note
+
+This file supersedes an earlier `CC BY-NC-SA` notice. That notice was a content
+license with a non-commercial clause, it was not an open-source license, and it
+contradicted both the specification and the published packages. It should not be
+relied on. If you obtained Lily under it and that raises a question for you,
+contact <joel@joelparkerhenderson.com>.
+
+## Trademarks
+
+Lily™ and Lily Design System™ are trademarks. The trademarks are distinct from
+the software license: a trademark claim (™) asserts use of the marks and is
+independent of the licenses above. A license to the software is not a license to
+the marks.
+
+You may say your project uses Lily, is built with Lily, or is compatible with
+Lily. Please do not use the marks as the name of your fork or product, or in a
+way that suggests affiliation or endorsement. For any use beyond that, contact
+<joel@joelparkerhenderson.com>.
+
+## Third-party references
+
+Lily's example applications and `themes/` stylesheets take visual reference from
+public-sector design systems including NHS UK, GOV.UK, and USWDS. Lily is not
+affiliated with, endorsed by, or connected to any of those organisations. Their
+names and marks belong to them, and this license grants nothing in respect of
+them.

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { initLinkPicker } from '@lilydesignsystem/nunjucks-link-picker';
+export { autoInit as autoInitLinkPicker } from '@lilydesignsystem/nunjucks-link-picker';
 import { initSearchPicker } from '@lilydesignsystem/nunjucks-search-picker';
 export { autoInit as autoInitSearchPicker } from '@lilydesignsystem/nunjucks-search-picker';
 import { initThemePicker } from '@lilydesignsystem/nunjucks-theme-picker';
@@ -25,7 +27,7 @@ export { autoInit as autoInitSharePicker } from '@lilydesignsystem/nunjucks-shar
 
 
 /**
- * All 45 Lily reference theme slugs, in the same order as
+ * All 57 Lily reference theme slugs, in the same order as
  * `DEFAULT_THEMES` in picker-bar.njk. A Nunjucks macro cannot import a
  * JS constant, so the two copies are held in agreement by a test
  * rather than by delegation — the same pattern this catalog already
@@ -36,11 +38,14 @@ const DEFAULT_THEMES = [
   "abyss",
   "acid",
   "adobe-spectrum",
+  "ant-design",
   "aqua",
+  "atlassian",
   "autumn",
   "black",
   "bumblebee",
   "business",
+  "cappuccino",
   "caramellatte",
   "cmyk",
   "coffee",
@@ -51,23 +56,32 @@ const DEFAULT_THEMES = [
   "dim",
   "dracula",
   "emerald",
+  "excel",
   "fantasy",
+  "fluent",
   "forest",
   "garden",
+  "github-primer",
   "halloween",
+  "ibm-carbon",
   "lemonade",
   "light",
+  "linear",
   "lofi",
   "luxury",
   "mozilla-protocol",
   "night",
   "nord",
+  "notion",
   "pastel",
   "retro",
+  "salesforce",
+  "sap-fiori",
   "silk",
   "sunset",
   "synthwave",
   "valentine",
+  "vercel",
   "winter",
   "wireframe",
   "united-kingdom-government-digital-service",
@@ -101,11 +115,12 @@ const DEFAULT_SIZES = [
  * rendered one.
  *
  * @param {HTMLElement} root
- * @param {{searchProps?: object, themeProps?: object, localeProps?: object, textSizeProps?: object, shareProps?: object}=} opts
+ * @param {{linkProps?: object, searchProps?: object, themeProps?: object, localeProps?: object, textSizeProps?: object, shareProps?: object}=} opts
  */
 function initPickerBar(root, opts = {}) {
   if (!root) {
     return {
+      link: null,
       search: null,
       theme: null,
       locale: null,
@@ -114,6 +129,7 @@ function initPickerBar(root, opts = {}) {
     };
   }
   const {
+    linkProps = {},
     searchProps = {},
     themeProps = {},
     localeProps = {},
@@ -121,6 +137,7 @@ function initPickerBar(root, opts = {}) {
     shareProps = {},
   } = opts;
 
+  const linkRoot = root.querySelector("[data-lily-link-picker-root]");
   const searchRoot = root.querySelector("[data-lily-search-picker-root]");
   const themeRoot = root.querySelector("[data-lily-theme-picker-root]");
   const localeRoot = root.querySelector("[data-lily-locale-picker-root]");
@@ -130,6 +147,7 @@ function initPickerBar(root, opts = {}) {
   const shareRoot = root.querySelector("[data-lily-share-picker-root]");
 
   return {
+    link: linkRoot ? initLinkPicker(linkRoot, linkProps) : null,
     search: searchRoot ? initSearchPicker(searchRoot, searchProps) : null,
     theme: themeRoot ? initThemePicker(themeRoot, themeProps) : null,
     locale: localeRoot ? initLocalePicker(localeRoot, localeProps) : null,
@@ -143,7 +161,7 @@ function initPickerBar(root, opts = {}) {
 /**
  * Find every `[data-lily-picker-bar-root]` and wire it.
  *
- * @param {{searchProps?: object, themeProps?: object, localeProps?: object, textSizeProps?: object, shareProps?: object}=} opts
+ * @param {{linkProps?: object, searchProps?: object, themeProps?: object, localeProps?: object, textSizeProps?: object, shareProps?: object}=} opts
  * @returns {Array<ReturnType<typeof initPickerBar>>}
  */
 function autoInit(opts = {}) {

package/dist/index.js

@@ -1,4 +1,8 @@
-// lily-design-system-nunjucks-picker-bar/picker-bar.client.js
+// picker-bar.client.js
+import {
+  initLinkPicker,
+  autoInit as autoInitLinkPicker
+} from "@lilydesignsystem/nunjucks-link-picker";
 import {
   initSearchPicker,
   autoInit as autoInitSearchPicker
@@ -23,11 +27,14 @@ var DEFAULT_THEMES = [
   "abyss",
   "acid",
   "adobe-spectrum",
+  "ant-design",
   "aqua",
+  "atlassian",
   "autumn",
   "black",
   "bumblebee",
   "business",
+  "cappuccino",
   "caramellatte",
   "cmyk",
   "coffee",
@@ -38,23 +45,32 @@ var DEFAULT_THEMES = [
   "dim",
   "dracula",
   "emerald",
+  "excel",
   "fantasy",
+  "fluent",
   "forest",
   "garden",
+  "github-primer",
   "halloween",
+  "ibm-carbon",
   "lemonade",
   "light",
+  "linear",
   "lofi",
   "luxury",
   "mozilla-protocol",
   "night",
   "nord",
+  "notion",
   "pastel",
   "retro",
+  "salesforce",
+  "sap-fiori",
   "silk",
   "sunset",
   "synthwave",
   "valentine",
+  "vercel",
   "winter",
   "wireframe",
   "united-kingdom-government-digital-service",
@@ -78,6 +94,7 @@ var DEFAULT_SIZES = [
 function initPickerBar(root, opts = {}) {
   if (!root) {
     return {
+      link: null,
       search: null,
       theme: null,
       locale: null,
@@ -86,12 +103,14 @@ function initPickerBar(root, opts = {}) {
     };
   }
   const {
+    linkProps = {},
     searchProps = {},
     themeProps = {},
     localeProps = {},
     textSizeProps = {},
     shareProps = {}
   } = opts;
+  const linkRoot = root.querySelector("[data-lily-link-picker-root]");
   const searchRoot = root.querySelector("[data-lily-search-picker-root]");
   const themeRoot = root.querySelector("[data-lily-theme-picker-root]");
   const localeRoot = root.querySelector("[data-lily-locale-picker-root]");
@@ -100,6 +119,7 @@ function initPickerBar(root, opts = {}) {
   );
   const shareRoot = root.querySelector("[data-lily-share-picker-root]");
   return {
+    link: linkRoot ? initLinkPicker(linkRoot, linkProps) : null,
     search: searchRoot ? initSearchPicker(searchRoot, searchProps) : null,
     theme: themeRoot ? initThemePicker(themeRoot, themeProps) : null,
     locale: localeRoot ? initLocalePicker(localeRoot, localeProps) : null,
@@ -118,6 +138,7 @@ export {
   DEFAULT_SIZES,
   DEFAULT_THEMES,
   autoInit,
+  autoInitLinkPicker,
   autoInitLocalePicker,
   autoInitSearchPicker,
   autoInitSharePicker,

package/dist/picker-bar.njk

@@ -1,5 +1,5 @@
 {#
-  PickerBar macro — composes search-picker, theme-picker,
+  PickerBar macro — composes link-picker (optional, leftmost), search-picker, theme-picker,
   locale-picker, text-size-picker, and share-picker (in that order)
   into one page-header row.
 
@@ -22,16 +22,17 @@
   one-line Environment setup. In this monorepo's own dev/test tree the
   same relative shape already holds: each sibling package sits at
   `../lily-design-system-nunjucks-{name}-picker/dist/{name}-picker.njk`
-  relative to the catalog root, exactly where `node_modules` would
+  relative to the repository root, exactly where `node_modules` would
   place it after a real install.
 #}
+{% from "lily-design-system-nunjucks-link-picker/dist/link-picker.njk" import linkPicker %}
 {% from "lily-design-system-nunjucks-search-picker/dist/search-picker.njk" import searchPicker %}
 {% from "lily-design-system-nunjucks-theme-picker/dist/theme-picker.njk" import themePicker %}
 {% from "lily-design-system-nunjucks-locale-picker/dist/locale-picker.njk" import localePicker %}
 {% from "lily-design-system-nunjucks-text-size-picker/dist/text-size-picker.njk" import textSizePicker %}
 {% from "lily-design-system-nunjucks-share-picker/dist/share-picker.njk" import sharePicker %}
 {#
-  All 45 Lily reference theme slugs (see `themes/` at the repo root),
+  All 57 Lily reference theme slugs (see `themes/` at the repo root),
   sorted alphabetically except the United Kingdom and United States
   government/public-sector themes, which sort last as one alphabetical
   group of their own. Mirrors `theme-picker`'s own title-casing of each
@@ -42,13 +43,16 @@
   held in sync by assertion rather than by delegation.
 #}
 {%- set DEFAULT_THEMES = [
-  "abyss", "acid", "adobe-spectrum", "aqua", "autumn", "black",
-  "bumblebee", "business", "caramellatte", "cmyk", "coffee",
-  "corporate", "cupcake", "cyberpunk", "dark", "dim", "dracula",
-  "emerald", "fantasy", "forest", "garden", "halloween", "lemonade",
-  "light", "lofi", "luxury", "mozilla-protocol", "night", "nord",
-  "pastel", "retro", "silk", "sunset", "synthwave", "valentine",
-  "winter", "wireframe",
+  "abyss", "acid", "adobe-spectrum", "ant-design", "aqua",
+  "atlassian", "autumn", "black", "bumblebee", "business",
+  "cappuccino", "caramellatte", "cmyk", "coffee", "corporate",
+  "cupcake", "cyberpunk", "dark", "dim", "dracula", "emerald",
+  "excel", "fantasy", "fluent", "forest", "garden",
+  "github-primer", "halloween", "ibm-carbon", "lemonade", "light",
+  "linear", "lofi", "luxury", "mozilla-protocol", "night", "nord",
+  "notion", "pastel", "retro", "salesforce", "sap-fiori", "silk",
+  "sunset", "synthwave", "valentine", "vercel", "winter",
+  "wireframe",
   "united-kingdom-government-digital-service",
   "united-kingdom-national-health-service-england-for-patients",
   "united-kingdom-national-health-service-england-for-practitioners",
@@ -68,14 +72,24 @@
 ] -%}
 {#
   Params (single `opts` object):
-    labels        — object, required: { search, searchInput,
+    labels        — object, required: { link?, search, searchInput,
                     searchSubmit, theme, locale, textSize, share }.
+                    `link` names the link picker's button and list and is
+                    needed only when `links` is supplied.
                     The seven accessible names: `search` names the
                     search picker's button and search landmark,
                     `searchInput` its field, `searchSubmit` its ⏎
                     button. No English default — a
                     nav row this catalog invented is exactly what the
                     i18n rule exists to prevent hardcoding.
+    links         — array<object>. Page links for the link picker (a home
+                    icon), rendered FIRST — leftmost. Defined by the app,
+                    each { label, href, id?, current?, newTab? }. Omitted or
+                    empty (or no `labels.link`): no link picker.
+    linkProps     — object. Extra link-picker opts (name, id, classes,
+                    attributes). Its function-valued options (navigate,
+                    onNavigate) cannot pass through a macro — hand them to
+                    picker-bar.client.js's `linkProps` instead.
     themesUrl     — string, required. Forwarded to theme-picker.
     locales       — array<string>, required. Forwarded to locale-picker;
                     no catalog default exists.
@@ -130,6 +144,7 @@
 {%- macro pickerBar(opts) -%}
 {%- set themes = opts.themes | default(DEFAULT_THEMES) -%}
 {%- set sizes = opts.sizes | default(DEFAULT_SIZES) -%}
+{%- set linkProps = opts.linkProps | default({}) -%}
 {%- set searchProps = opts.searchProps | default({}) -%}
 {%- set themeProps = opts.themeProps | default({}) -%}
 {%- set localeProps = opts.localeProps | default({}) -%}
@@ -140,6 +155,16 @@
   data-lily-picker-bar-root
   {%- if opts.attributes %}{% for k, v in opts.attributes %} {{ k }}="{{ v }}"{% endfor %}{% endif %}
 >
+{%- if opts.links and opts.links.length > 0 and opts.labels.link -%}
+{{ linkPicker({
+  label: opts.labels.link,
+  links: opts.links,
+  name: linkProps.name,
+  id: linkProps.id,
+  classes: linkProps.classes,
+  attributes: linkProps.attributes
+}) }}
+{%- endif %}
 {{ searchPicker({
   label: opts.labels.search,
   inputLabel: opts.labels.searchInput,

package/index.md

@@ -1,5 +1,7 @@
 # Lily Design System™ — Nunjucks PickerBar
 
+> **Link picker (0.3.0).** Pass `links` (and `labels.link`) to add a `link-picker` — a home icon opening the page links your app defines — as the leftmost icon. It renders only when both are given.
+
 A single page-header macro that composes five of the Lily
 [`*-picker` helpers](../index.md) in this catalog — search, theme,
 locale, text size, and share, in that order — with two catalog-wide

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@lilydesignsystem/nunjucks-picker-bar",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "engines": {
     "node": "=26"
   },
-  "description": "Lily Design System Nunjucks picker bar: composes search-picker, theme-picker, locale-picker, text-size-picker, and share-picker into one page-header row. Headless, SSR-safe, no CSS.",
+  "description": "Lily Design System Nunjucks picker bar: composes link-picker (optional), search-picker, theme-picker, locale-picker, text-size-picker, and share-picker into one page-header row. Headless, SSR-safe, no CSS.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -22,15 +22,26 @@
     "README.md"
   ],
   "scripts": {
-    "prepublishOnly": "cd .. && npm run build"
+    "build": "bash build.sh",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@lilydesignsystem/nunjucks-link-picker": "^0.1.0",
     "@lilydesignsystem/nunjucks-search-picker": "^0.1.0",
     "@lilydesignsystem/nunjucks-theme-picker": "^0.2.0",
     "@lilydesignsystem/nunjucks-locale-picker": "^0.2.0",
     "@lilydesignsystem/nunjucks-text-size-picker": "^0.2.0",
     "@lilydesignsystem/nunjucks-share-picker": "^0.2.0"
   },
+  "devDependencies": {
+    "jsdom": "^30.1.1",
+    "nunjucks": "^3.2.4",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.3"
+  },
   "keywords": [
     "lily",
     "design",
@@ -48,7 +59,7 @@
   "license": "MIT OR Apache-2.0 OR GPL-2.0-only OR GPL-3.0-only OR BSD-3-Clause",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/LilyDesignSystem/lily-design-system-nunjucks-helpers.git",
+    "url": "git+https://github.com/LilyDesignSystem/lily-design-system.git",
     "directory": "lily-design-system-nunjucks-picker-bar"
   },
   "homepage": "https://lilydesignsystem.com/",