@lilydesignsystem/angular-link-picker 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# LinkPicker (Angular)
+
+A headless control for **page links**: a single-icon button (a bundled home SVG) that opens a dropdown of links **your app
+defines** — "Home", "About Us", "Contact Us", "Privacy Policy". No CSS, no routes, no English.
+
+The single source of truth is [spec/index.md](./spec/index.md); this file is the guide.
+
+## Quick start
+
+```ts
+import { Component } from "@angular/core";
+import { LinkPicker, type LinkItem } from "@lilydesignsystem/angular-link-picker";
+
+@Component({
+  selector: "app-header",
+  standalone: true,
+  imports: [LinkPicker],
+  template: `<lily-link-picker label="Pages" [links]="links" />`,
+})
+export class AppHeader {
+  links: LinkItem[] = [
+  { label: "Home", href: "/" },
+  { label: "About Us", href: "/about/" },
+  { label: "Contact Us", href: "/contact/" },
+  { label: "Privacy Policy", href: "/privacy/" },
+];
+}
+```
+
+`label` names the button, the list and the tooltip. There is **no default list**: the package ships no routes and no English.
+
+## Client-side navigation
+
+```ts
+import { Component, inject } from "@angular/core";
+import { Router } from "@angular/router";
+import { LinkPicker } from "@lilydesignsystem/angular-link-picker";
+
+@Component({
+  selector: "app-header",
+  standalone: true,
+  imports: [LinkPicker],
+  template: `<lily-link-picker label="Pages" [links]="links()" [navigate]="go" />`,
+})
+export class AppHeader {
+  private router = inject(Router);
+  go = (href: string) => void this.router.navigateByUrl(href);
+  links = () => [
+  { label: "Home", href: "/" },
+  { label: "About Us", href: "/about/" },
+  { label: "Contact Us", href: "/contact/" },
+  { label: "Privacy Policy", href: "/privacy/" },
+].map((p) => ({ ...p, current: this.router.url === p.href }));
+}
+```
+
+Ctrl/Cmd/Shift/Alt-click, middle-click and `newTab` links always stay native browser behaviour.
+
+## `LinkItem`
+
+| Field | Notes |
+| --- | --- |
+| label | Visible text. Yours, so it localises. |
+| href | A route (`"/about/"`) or a full URL. |
+| id | Reported when a link is chosen; defaults to the href. |
+| current | Marks the current page with `aria-current="page"`. |
+| newTab | `target="_blank"` with `rel="noopener noreferrer"`. |
+
+## Props
+
+| `label` | `input.required<string>()` | yes | Accessible name of the button **and** the list; also the tooltip text. |
+| `links` | `input.required<LinkItem[]>()` | yes | `{ id?, label, href, current?, newTab? }`. `id` defaults to `href`. |
+| `navigate` | `input<(href: string) => void>()` | no | Client-side navigation hook (a router's `navigateByUrl`). |
+| `navigated` | `output<{ id, href }>()` | no | Emitted after a link is chosen (the Svelte `onNavigate` callback). |
+| icon template | `<ng-template lilyLinkPickerIcon let-args>` | no | Replaces the **icon**, not the links. |
+| `className` | `input<string>()` | no | Appended to the root class. |
+
+## Styling
+
+Headless: no CSS ships. Hooks: `.link-picker`, `.link-picker-button`, `.link-picker-icon`, `.link-picker-tooltip`,
+`.link-picker-list` (carries `hidden` when closed), `.link-picker-list-item`, `.link-picker-link`. The monorepo's 45 `themes/`
+style them all, including the popup placement.
+
+## Examples
+
+[examples/](./examples/README.md): the four-link example, router integration and a custom icon.

package/fesm2022/lilydesignsystem-angular-link-picker.mjs

@@ -0,0 +1,546 @@
+import { NgTemplateOutlet } from "@angular/common";
+import * as i0 from "@angular/core";
+import { ChangeDetectionStrategy, Component, Directive, TemplateRef, computed, contentChild, effect, input, output, signal, viewChild } from "@angular/core";
+import { IconButton } from "@lilydesignsystem/angular-headless";
+function linkId(link) {
+	return link.id ?? link.href;
+}
+let uid = 0;
+function nextLinkPickerId() {
+	uid += 1;
+	return `link-picker-${uid}`;
+}
+var LinkPickerIcon = class LinkPickerIcon {
+	static ngTemplateContextGuard(_dir, _ctx) {
+		return true;
+	}
+	static {
+		this.ɵfac = i0.ɵɵngDeclareFactory({
+			minVersion: "12.0.0",
+			version: "22.2.1",
+			ngImport: i0,
+			type: LinkPickerIcon,
+			deps: [],
+			target: i0.ɵɵFactoryTarget.Directive
+		});
+	}
+	static {
+		this.ɵdir = i0.ɵɵngDeclareDirective({
+			minVersion: "14.0.0",
+			version: "22.2.1",
+			type: LinkPickerIcon,
+			isStandalone: true,
+			selector: "ng-template[lilyLinkPickerIcon]",
+			ngImport: i0
+		});
+	}
+};
+i0.ɵɵngDeclareClassMetadata({
+	minVersion: "12.0.0",
+	version: "22.2.1",
+	ngImport: i0,
+	type: LinkPickerIcon,
+	decorators: [{
+		type: Directive,
+		args: [{
+			selector: "ng-template[lilyLinkPickerIcon]",
+			standalone: true
+		}]
+	}]
+});
+var LinkPicker = class LinkPicker {
+	constructor() {
+		this.label = input.required(...ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []);
+		this.links = input.required(...ngDevMode ? [{ debugName: "links" }] : /* istanbul ignore next */ []);
+		this.navigate = input(void 0, ...ngDevMode ? [{ debugName: "navigate" }] : /* istanbul ignore next */ []);
+		this.className = input("", ...ngDevMode ? [{ debugName: "className" }] : /* istanbul ignore next */ []);
+		this.navigated = output();
+		this.iconTemplate = contentChild(TemplateRef, ...ngDevMode ? [{ debugName: "iconTemplate" }] : /* istanbul ignore next */ []);
+		this.rootRef = viewChild.required("rootEl", ...ngDevMode ? [{ debugName: "rootRef" }] : /* istanbul ignore next */ []);
+		this.buttonRef = viewChild.required("buttonEl", ...ngDevMode ? [{ debugName: "buttonRef" }] : /* istanbul ignore next */ []);
+		this.listRef = viewChild.required("listEl", ...ngDevMode ? [{ debugName: "listRef" }] : /* istanbul ignore next */ []);
+		this.baseId = nextLinkPickerId();
+		this.listId = `${this.baseId}-list`;
+		this.open = signal(false, ...ngDevMode ? [{ debugName: "open" }] : /* istanbul ignore next */ []);
+		this.tooltipId = `${this.baseId}-tooltip`;
+		this.hoverButton = signal(false, ...ngDevMode ? [{ debugName: "hoverButton" }] : /* istanbul ignore next */ []);
+		this.hoverTooltip = signal(false, ...ngDevMode ? [{ debugName: "hoverTooltip" }] : /* istanbul ignore next */ []);
+		this.focusButton = signal(false, ...ngDevMode ? [{ debugName: "focusButton" }] : /* istanbul ignore next */ []);
+		this.dismissed = signal(false, ...ngDevMode ? [{ debugName: "dismissed" }] : /* istanbul ignore next */ []);
+		this.tooltipVisible = computed(() => !this.open() && !this.dismissed() && (this.hoverButton() || this.hoverTooltip() || this.focusButton()), ...ngDevMode ? [{ debugName: "tooltipVisible" }] : /* istanbul ignore next */ []);
+		this.tooltipEscapeListener = effect((onCleanup) => {
+			if (!this.tooltipVisible() || typeof document === "undefined") return;
+			const onKey = (event) => {
+				if (event.key === "Escape") this.dismissed.set(true);
+			};
+			document.addEventListener("keydown", onKey);
+			onCleanup(() => document.removeEventListener("keydown", onKey));
+		}, ...ngDevMode ? [{ debugName: "tooltipEscapeListener" }] : /* istanbul ignore next */ []);
+		this.childContext = computed(() => {
+			const args = { open: this.open() };
+			return {
+				$implicit: args,
+				...args
+			};
+		}, ...ngDevMode ? [{ debugName: "childContext" }] : /* istanbul ignore next */ []);
+	}
+	onTooltipButtonEnter() {
+		this.hoverButton.set(true);
+		this.dismissed.set(false);
+	}
+	onTooltipButtonFocusIn() {
+		try {
+			this.focusButton.set(this.buttonRef().element?.matches(":focus-visible") ?? false);
+		} catch {
+			this.focusButton.set(true);
+		}
+	}
+	onTooltipButtonFocusOut() {
+		this.focusButton.set(false);
+		this.dismissed.set(false);
+	}
+	onTooltipKeydown(event) {
+		if (event.key === "Escape" && this.tooltipVisible()) this.dismissed.set(true);
+	}
+	idOf(link) {
+		return linkId(link);
+	}
+	items() {
+		return Array.from(this.listRef().nativeElement.querySelectorAll(".link-picker-link"));
+	}
+	openList(focusLast = false) {
+		this.open.set(true);
+		queueMicrotask(() => {
+			const all = this.items();
+			(focusLast ? all[all.length - 1] : all[0])?.focus({ preventScroll: true });
+		});
+	}
+	closeList(refocus = true) {
+		if (!this.open()) return;
+		this.open.set(false);
+		if (refocus) queueMicrotask(() => this.buttonRef().focus({ preventScroll: true }));
+	}
+	onButtonClick() {
+		if (this.open()) this.closeList();
+		else this.openList();
+	}
+	onLinkClick(event, link) {
+		this.navigated.emit({
+			id: linkId(link),
+			href: link.href
+		});
+		const go = this.navigate();
+		const modified = event.ctrlKey || event.metaKey || event.shiftKey || event.altKey || event.button !== 0;
+		if (go && !link.newTab && !modified && !event.defaultPrevented) {
+			event.preventDefault();
+			go(link.href);
+		}
+		this.closeList();
+	}
+	onButtonKeydown(event) {
+		if (event.key === "ArrowDown") {
+			event.preventDefault();
+			if (!this.open()) this.openList();
+			else this.items()[0]?.focus({ preventScroll: true });
+		} else if (event.key === "ArrowUp") {
+			event.preventDefault();
+			if (!this.open()) this.openList(true);
+			else {
+				const all = this.items();
+				all[all.length - 1]?.focus({ preventScroll: true });
+			}
+		}
+	}
+	moveFocus(delta) {
+		const all = this.items();
+		if (all.length === 0) return;
+		const i = all.indexOf(document.activeElement);
+		all[Math.min(Math.max((i < 0 ? 0 : i) + delta, 0), all.length - 1)]?.focus({ preventScroll: true });
+	}
+	onListKeydown(event) {
+		switch (event.key) {
+			case "ArrowDown":
+				event.preventDefault();
+				this.moveFocus(1);
+				break;
+			case "ArrowUp":
+				event.preventDefault();
+				this.moveFocus(-1);
+				break;
+			case "Home":
+				event.preventDefault();
+				this.items()[0]?.focus({ preventScroll: true });
+				break;
+			case "End": {
+				event.preventDefault();
+				const all = this.items();
+				all[all.length - 1]?.focus({ preventScroll: true });
+				break;
+			}
+			case "Escape":
+				event.preventDefault();
+				this.closeList();
+				break;
+			case "Tab":
+				this.buttonRef().focus?.({ preventScroll: true });
+				this.closeList(false);
+		}
+	}
+	onRootFocusOut(event) {
+		const next = event.relatedTarget;
+		if (next && this.rootRef().nativeElement.contains(next)) return;
+		this.closeList(false);
+	}
+	onDocumentClick(event) {
+		if (!this.open()) return;
+		const t = event.target;
+		if (t && !this.rootRef().nativeElement.contains(t)) this.closeList(false);
+	}
+	static {
+		this.ɵfac = i0.ɵɵngDeclareFactory({
+			minVersion: "12.0.0",
+			version: "22.2.1",
+			ngImport: i0,
+			type: LinkPicker,
+			deps: [],
+			target: i0.ɵɵFactoryTarget.Component
+		});
+	}
+	static {
+		this.ɵcmp = i0.ɵɵngDeclareComponent({
+			minVersion: "17.0.0",
+			version: "22.2.1",
+			type: LinkPicker,
+			isStandalone: true,
+			selector: "lily-link-picker",
+			inputs: {
+				label: {
+					classPropertyName: "label",
+					publicName: "label",
+					isSignal: true,
+					isRequired: true,
+					transformFunction: null
+				},
+				links: {
+					classPropertyName: "links",
+					publicName: "links",
+					isSignal: true,
+					isRequired: true,
+					transformFunction: null
+				},
+				navigate: {
+					classPropertyName: "navigate",
+					publicName: "navigate",
+					isSignal: true,
+					isRequired: false,
+					transformFunction: null
+				},
+				className: {
+					classPropertyName: "className",
+					publicName: "className",
+					isSignal: true,
+					isRequired: false,
+					transformFunction: null
+				}
+			},
+			outputs: { navigated: "navigated" },
+			host: { listeners: { "document:click": "onDocumentClick($event)" } },
+			queries: [{
+				propertyName: "iconTemplate",
+				first: true,
+				predicate: TemplateRef,
+				descendants: true,
+				isSignal: true
+			}],
+			viewQueries: [
+				{
+					propertyName: "rootRef",
+					first: true,
+					predicate: ["rootEl"],
+					descendants: true,
+					isSignal: true
+				},
+				{
+					propertyName: "buttonRef",
+					first: true,
+					predicate: ["buttonEl"],
+					descendants: true,
+					isSignal: true
+				},
+				{
+					propertyName: "listRef",
+					first: true,
+					predicate: ["listEl"],
+					descendants: true,
+					isSignal: true
+				}
+			],
+			ngImport: i0,
+			template: `
+    <div
+      #rootEl
+      class="link-picker {{ className() }}"
+      (focusout)="onRootFocusOut($event)"
+    >
+      <lily-icon-button
+        #buttonEl
+        [label]="label()"
+        baseClass="link-picker-button"
+        [ariaExpanded]="open()"
+        [ariaControls]="listId"
+        (click)="onButtonClick(); hoverButton.set(false)"
+        (mouseenter)="onTooltipButtonEnter()"
+        (mouseleave)="hoverButton.set(false)"
+        (focusin)="onTooltipButtonFocusIn()"
+        (focusout)="onTooltipButtonFocusOut()"
+        (keydown)="onButtonKeydown($event); onTooltipKeydown($event)"
+      >
+        @if (iconTemplate(); as tpl) {
+          <ng-container
+            [ngTemplateOutlet]="tpl"
+            [ngTemplateOutletContext]="childContext()"
+          />
+        } @else {
+          <svg
+            class="link-picker-icon"
+            viewBox="0 0 16 16"
+            width="1.05rem"
+            height="1.05rem"
+            aria-hidden="true"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="1.6"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+          >
+            <path d="M2 7.5 8 2.5l6 5" />
+            <path d="M3.5 6.5v7h9v-7" />
+            <path d="M6.5 13.5V10h3v3.5" />
+          </svg>
+        }
+      </lily-icon-button>
+
+      <!-- Purely visual: the same text is already the button's aria-label, so it is not wired
+           with aria-describedby (that would announce the name twice). -->
+      <div
+        class="link-picker-tooltip"
+        role="tooltip"
+        [id]="tooltipId"
+        [attr.hidden]="tooltipVisible() ? null : ''"
+        (mouseenter)="hoverTooltip.set(true)"
+        (mouseleave)="hoverTooltip.set(false)"
+      >{{ label() }}</div>
+
+      <!-- Named like the sibling pickers' popups: a screen reader entering the list hears what
+           it is for. -->
+      <ul
+        #listEl
+        class="link-picker-list"
+        [id]="listId"
+        [attr.aria-label]="label() || null"
+        [attr.hidden]="open() ? null : ''"
+        (keydown)="onListKeydown($event)"
+      >
+        @for (link of links(); track idOf(link)) {
+          <li class="link-picker-list-item">
+            <!-- A real link, not role="menuitem": these ARE navigation. -->
+            <a
+              class="link-picker-link"
+              [attr.data-link-id]="idOf(link)"
+              [attr.href]="link.href"
+              [attr.aria-current]="link.current ? 'page' : null"
+              [attr.target]="link.newTab ? '_blank' : null"
+              [attr.rel]="link.newTab ? 'noopener noreferrer' : null"
+              (click)="onLinkClick($event, link)"
+              >{{ link.label }}</a
+            >
+          </li>
+        }
+      </ul>
+    </div>
+  `,
+			isInline: true,
+			dependencies: [{
+				kind: "directive",
+				type: NgTemplateOutlet,
+				selector: "[ngTemplateOutlet]",
+				inputs: [
+					"ngTemplateOutletContext",
+					"ngTemplateOutlet",
+					"ngTemplateOutletInjector"
+				]
+			}, {
+				kind: "component",
+				type: IconButton,
+				selector: "lily-icon-button",
+				inputs: [
+					"label",
+					"className",
+					"baseClass",
+					"ariaHaspopup",
+					"ariaExpanded",
+					"ariaControls",
+					"tabIndex",
+					"disabled"
+				]
+			}],
+			changeDetection: i0.ChangeDetectionStrategy.OnPush
+		});
+	}
+};
+i0.ɵɵngDeclareClassMetadata({
+	minVersion: "12.0.0",
+	version: "22.2.1",
+	ngImport: i0,
+	type: LinkPicker,
+	decorators: [{
+		type: Component,
+		args: [{
+			selector: "lily-link-picker",
+			standalone: true,
+			imports: [NgTemplateOutlet, IconButton],
+			changeDetection: ChangeDetectionStrategy.OnPush,
+			host: { "(document:click)": "onDocumentClick($event)" },
+			template: `
+    <div
+      #rootEl
+      class="link-picker {{ className() }}"
+      (focusout)="onRootFocusOut($event)"
+    >
+      <lily-icon-button
+        #buttonEl
+        [label]="label()"
+        baseClass="link-picker-button"
+        [ariaExpanded]="open()"
+        [ariaControls]="listId"
+        (click)="onButtonClick(); hoverButton.set(false)"
+        (mouseenter)="onTooltipButtonEnter()"
+        (mouseleave)="hoverButton.set(false)"
+        (focusin)="onTooltipButtonFocusIn()"
+        (focusout)="onTooltipButtonFocusOut()"
+        (keydown)="onButtonKeydown($event); onTooltipKeydown($event)"
+      >
+        @if (iconTemplate(); as tpl) {
+          <ng-container
+            [ngTemplateOutlet]="tpl"
+            [ngTemplateOutletContext]="childContext()"
+          />
+        } @else {
+          <svg
+            class="link-picker-icon"
+            viewBox="0 0 16 16"
+            width="1.05rem"
+            height="1.05rem"
+            aria-hidden="true"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="1.6"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+          >
+            <path d="M2 7.5 8 2.5l6 5" />
+            <path d="M3.5 6.5v7h9v-7" />
+            <path d="M6.5 13.5V10h3v3.5" />
+          </svg>
+        }
+      </lily-icon-button>
+
+      <!-- Purely visual: the same text is already the button's aria-label, so it is not wired
+           with aria-describedby (that would announce the name twice). -->
+      <div
+        class="link-picker-tooltip"
+        role="tooltip"
+        [id]="tooltipId"
+        [attr.hidden]="tooltipVisible() ? null : ''"
+        (mouseenter)="hoverTooltip.set(true)"
+        (mouseleave)="hoverTooltip.set(false)"
+      >{{ label() }}</div>
+
+      <!-- Named like the sibling pickers' popups: a screen reader entering the list hears what
+           it is for. -->
+      <ul
+        #listEl
+        class="link-picker-list"
+        [id]="listId"
+        [attr.aria-label]="label() || null"
+        [attr.hidden]="open() ? null : ''"
+        (keydown)="onListKeydown($event)"
+      >
+        @for (link of links(); track idOf(link)) {
+          <li class="link-picker-list-item">
+            <!-- A real link, not role="menuitem": these ARE navigation. -->
+            <a
+              class="link-picker-link"
+              [attr.data-link-id]="idOf(link)"
+              [attr.href]="link.href"
+              [attr.aria-current]="link.current ? 'page' : null"
+              [attr.target]="link.newTab ? '_blank' : null"
+              [attr.rel]="link.newTab ? 'noopener noreferrer' : null"
+              (click)="onLinkClick($event, link)"
+              >{{ link.label }}</a
+            >
+          </li>
+        }
+      </ul>
+    </div>
+  `
+		}]
+	}],
+	propDecorators: {
+		label: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "label",
+				required: true
+			}]
+		}],
+		links: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "links",
+				required: true
+			}]
+		}],
+		navigate: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "navigate",
+				required: false
+			}]
+		}],
+		className: [{
+			type: i0.Input,
+			args: [{
+				isSignal: true,
+				alias: "className",
+				required: false
+			}]
+		}],
+		navigated: [{
+			type: i0.Output,
+			args: ["navigated"]
+		}],
+		iconTemplate: [{
+			type: i0.ContentChild,
+			args: [i0.forwardRef(() => TemplateRef), { isSignal: true }]
+		}],
+		rootRef: [{
+			type: i0.ViewChild,
+			args: ["rootEl", { isSignal: true }]
+		}],
+		buttonRef: [{
+			type: i0.ViewChild,
+			args: ["buttonEl", { isSignal: true }]
+		}],
+		listRef: [{
+			type: i0.ViewChild,
+			args: ["listEl", { isSignal: true }]
+		}]
+	}
+});
+export { LinkPicker, LinkPickerIcon, linkId, nextLinkPickerId };
+
+//# sourceMappingURL=lilydesignsystem-angular-link-picker.mjs.map

package/fesm2022/lilydesignsystem-angular-link-picker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lilydesignsystem-angular-link-picker.mjs","names":[],"sources":["../../link-picker.component.ts"],"sourcesContent":["import { NgTemplateOutlet } from \"@angular/common\";\nimport {\n  ChangeDetectionStrategy,\n  Component,\n  Directive,\n  ElementRef,\n  TemplateRef,\n  computed,\n  contentChild,\n  effect,\n  input,\n  output,\n  signal,\n  viewChild,\n} from \"@angular/core\";\n// Only the trigger button composes a headless primitive. The list below is real `<a>` navigation\n// with a roving-focus pattern of its own — not an ARIA listbox or menu: role=\"menuitem\" would strip\n// middle-click, open-in-new-tab and copy-link-address from ordinary links. See spec/index.md §3.\nimport { IconButton } from \"@lilydesignsystem/angular-headless\";\n\n/**\n * One destination in the list. The app defines them all: this package ships no routes and no\n * English — `label` is the consumer's text.\n */\nexport type LinkItem = {\n  /** Stable identifier, passed back on the `navigated` output. Defaults to `href`. */\n  id?: string;\n  /** Visible link text. Consumer-supplied, so it localises. */\n  label: string;\n  /** Where the link goes: a route (\"/about/\") or a full URL. */\n  href: string;\n  /** Marks this link as the current page (`aria-current=\"page\"`). */\n  current?: boolean;\n  /** Open in a new tab (`target=\"_blank\"` with `rel=\"noopener noreferrer\"`). */\n  newTab?: boolean;\n};\n\n/** Context passed to a custom icon `<ng-template>` (the button icon). */\nexport type ChildArgs = {\n  /** Is the list open? */\n  open: boolean;\n};\n\n/** Payload of the `navigated` output. */\nexport type LinkNavigatedEvent = {\n  /** The chosen link's `id` (its `href` when it has none). */\n  id: string;\n  /** The chosen link's `href`. */\n  href: string;\n};\n\n/** The id a link reports: its explicit `id`, else its `href`. */\nexport function linkId(link: LinkItem): string {\n  return link.id ?? link.href;\n}\n\nlet uid = 0;\n/** Stable per-instance id prefix; SSR-safe (no Math.random / Date.now). */\nexport function nextLinkPickerId(): string {\n  uid += 1;\n  return `link-picker-${uid}`;\n}\n\n/**\n * Optional marker for the projected icon template. Gives consumers typed `let-` variables:\n *\n * ```html\n * <lily-link-picker label=\"Pages\" [links]=\"links\">\n *   <ng-template lilyLinkPickerIcon let-args>{{ args.open ? \"×\" : \"☰\" }}</ng-template>\n * </lily-link-picker>\n * ```\n */\n@Directive({\n  selector: \"ng-template[lilyLinkPickerIcon]\",\n  standalone: true,\n})\nexport class LinkPickerIcon {\n  static ngTemplateContextGuard(\n    _dir: LinkPickerIcon,\n    _ctx: unknown,\n  ): _ctx is ChildArgs & { $implicit: ChildArgs } {\n    return true;\n  }\n}\n\n/**\n * LinkPicker — a headless page-links control.\n *\n * A single-icon button (a bundled home SVG) that opens a disclosure list of page links the app\n * defines. It applies nothing to the document and persists nothing. See `spec/index.md`.\n */\n@Component({\n  selector: \"lily-link-picker\",\n  standalone: true,\n  imports: [NgTemplateOutlet, IconButton],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  host: {\n    \"(document:click)\": \"onDocumentClick($event)\",\n  },\n  template: `\n    <div\n      #rootEl\n      class=\"link-picker {{ className() }}\"\n      (focusout)=\"onRootFocusOut($event)\"\n    >\n      <lily-icon-button\n        #buttonEl\n        [label]=\"label()\"\n        baseClass=\"link-picker-button\"\n        [ariaExpanded]=\"open()\"\n        [ariaControls]=\"listId\"\n        (click)=\"onButtonClick(); hoverButton.set(false)\"\n        (mouseenter)=\"onTooltipButtonEnter()\"\n        (mouseleave)=\"hoverButton.set(false)\"\n        (focusin)=\"onTooltipButtonFocusIn()\"\n        (focusout)=\"onTooltipButtonFocusOut()\"\n        (keydown)=\"onButtonKeydown($event); onTooltipKeydown($event)\"\n      >\n        @if (iconTemplate(); as tpl) {\n          <ng-container\n            [ngTemplateOutlet]=\"tpl\"\n            [ngTemplateOutletContext]=\"childContext()\"\n          />\n        } @else {\n          <svg\n            class=\"link-picker-icon\"\n            viewBox=\"0 0 16 16\"\n            width=\"1.05rem\"\n            height=\"1.05rem\"\n            aria-hidden=\"true\"\n            fill=\"none\"\n            stroke=\"currentColor\"\n            stroke-width=\"1.6\"\n            stroke-linecap=\"round\"\n            stroke-linejoin=\"round\"\n          >\n            <path d=\"M2 7.5 8 2.5l6 5\" />\n            <path d=\"M3.5 6.5v7h9v-7\" />\n            <path d=\"M6.5 13.5V10h3v3.5\" />\n          </svg>\n        }\n      </lily-icon-button>\n\n      <!-- Purely visual: the same text is already the button's aria-label, so it is not wired\n           with aria-describedby (that would announce the name twice). -->\n      <div\n        class=\"link-picker-tooltip\"\n        role=\"tooltip\"\n        [id]=\"tooltipId\"\n        [attr.hidden]=\"tooltipVisible() ? null : ''\"\n        (mouseenter)=\"hoverTooltip.set(true)\"\n        (mouseleave)=\"hoverTooltip.set(false)\"\n      >{{ label() }}</div>\n\n      <!-- Named like the sibling pickers' popups: a screen reader entering the list hears what\n           it is for. -->\n      <ul\n        #listEl\n        class=\"link-picker-list\"\n        [id]=\"listId\"\n        [attr.aria-label]=\"label() || null\"\n        [attr.hidden]=\"open() ? null : ''\"\n        (keydown)=\"onListKeydown($event)\"\n      >\n        @for (link of links(); track idOf(link)) {\n          <li class=\"link-picker-list-item\">\n            <!-- A real link, not role=\"menuitem\": these ARE navigation. -->\n            <a\n              class=\"link-picker-link\"\n              [attr.data-link-id]=\"idOf(link)\"\n              [attr.href]=\"link.href\"\n              [attr.aria-current]=\"link.current ? 'page' : null\"\n              [attr.target]=\"link.newTab ? '_blank' : null\"\n              [attr.rel]=\"link.newTab ? 'noopener noreferrer' : null\"\n              (click)=\"onLinkClick($event, link)\"\n              >{{ link.label }}</a\n            >\n          </li>\n        }\n      </ul>\n    </div>\n  `,\n})\nexport class LinkPicker {\n  /** Accessible name for the button and the list. */\n  readonly label = input.required<string>();\n  /** The page links to offer. Defined by the app. */\n  readonly links = input.required<LinkItem[]>();\n  /**\n   * Client-side navigation hook, e.g. a router's `navigateByUrl`. When given, a plain left click\n   * on a link calls `navigate(href)` instead of letting the browser load the page; modified\n   * clicks (Ctrl/Cmd/Shift/Alt, middle button) and `newTab` links stay native.\n   */\n  readonly navigate = input<((href: string) => void) | undefined>(undefined);\n  /** Extra CSS class on the root div. */\n  readonly className = input<string>(\"\");\n\n  /** Fires after a link is chosen. */\n  readonly navigated = output<LinkNavigatedEvent>();\n\n  /** Projected icon template; replaces the default icon when supplied. */\n  protected readonly iconTemplate = contentChild(TemplateRef);\n\n  private readonly rootRef =\n    viewChild.required<ElementRef<HTMLDivElement>>(\"rootEl\");\n  // A template-ref-variable on a component tag resolves to the component INSTANCE, which is what\n  // is needed to call the headless component's own public `focus()` method.\n  private readonly buttonRef = viewChild.required<IconButton>(\"buttonEl\");\n  private readonly listRef =\n    viewChild.required<ElementRef<HTMLUListElement>>(\"listEl\");\n\n  private readonly baseId = nextLinkPickerId();\n  protected readonly listId = `${this.baseId}-list`;\n\n  protected readonly open = signal(false);\n\n  // Tooltip: shown while the pointer is over the button or the tooltip itself (hoverable, WCAG\n  // 1.4.13) or while the button has keyboard focus; Escape dismisses it without moving focus;\n  // never shown while the popup is open, since the popup then explains the control.\n  protected readonly tooltipId = `${this.baseId}-tooltip`;\n  protected readonly hoverButton = signal(false);\n  protected readonly hoverTooltip = signal(false);\n  protected readonly focusButton = signal(false);\n  protected readonly dismissed = signal(false);\n  protected readonly tooltipVisible = computed(\n    () =>\n      !this.open() &&\n      !this.dismissed() &&\n      (this.hoverButton() || this.hoverTooltip() || this.focusButton()),\n  );\n\n  protected onTooltipButtonEnter(): void {\n    this.hoverButton.set(true);\n    this.dismissed.set(false);\n  }\n\n  protected onTooltipButtonFocusIn(): void {\n    // Keyboard focus only: a mouse click also focuses the button in Chromium, and the tooltip\n    // should not stick after a click.\n    try {\n      this.focusButton.set(\n        this.buttonRef().element?.matches(\":focus-visible\") ?? false,\n      );\n    } catch {\n      this.focusButton.set(true); // engine without :focus-visible — err towards showing\n    }\n  }\n\n  protected onTooltipButtonFocusOut(): void {\n    this.focusButton.set(false);\n    this.dismissed.set(false);\n  }\n\n  protected onTooltipKeydown(event: KeyboardEvent): void {\n    if (event.key === \"Escape\" && this.tooltipVisible()) this.dismissed.set(true);\n  }\n\n  // WCAG 1.4.13 \"dismissable\": while the tooltip is visible, Escape works wherever focus is. The\n  // listener exists only while visible; the effect cleanup removes it on hide and on destroy.\n  private readonly tooltipEscapeListener = effect((onCleanup) => {\n    if (!this.tooltipVisible() || typeof document === \"undefined\") return;\n    const onKey = (event: KeyboardEvent): void => {\n      if (event.key === \"Escape\") this.dismissed.set(true);\n    };\n    document.addEventListener(\"keydown\", onKey);\n    onCleanup(() => document.removeEventListener(\"keydown\", onKey));\n  });\n\n  protected readonly childContext = computed(() => {\n    const args: ChildArgs = { open: this.open() };\n    return { $implicit: args, ...args };\n  });\n\n  protected idOf(link: LinkItem): string {\n    return linkId(link);\n  }\n\n  /** Every focusable link in the list, in DOM order. */\n  private items(): HTMLElement[] {\n    return Array.from(\n      this.listRef().nativeElement.querySelectorAll<HTMLElement>(\".link-picker-link\"),\n    );\n  }\n\n  // ---------------------------------------------------------------\n  // Open / close\n  // ---------------------------------------------------------------\n\n  /** Open the list, focusing the first link (or the last, if `focusLast`). */\n  openList(focusLast = false): void {\n    this.open.set(true);\n    // Deferred so the `hidden` attribute is gone before focus is moved.\n    queueMicrotask(() => {\n      const all = this.items();\n      (focusLast ? all[all.length - 1] : all[0])?.focus({ preventScroll: true });\n    });\n  }\n\n  /** Close the list; `refocus` returns focus to the trigger. */\n  closeList(refocus = true): void {\n    if (!this.open()) return;\n    this.open.set(false);\n    if (refocus) queueMicrotask(() => this.buttonRef().focus({ preventScroll: true }));\n  }\n\n  protected onButtonClick(): void {\n    if (this.open()) this.closeList();\n    else this.openList();\n  }\n\n  protected onLinkClick(event: MouseEvent, link: LinkItem): void {\n    this.navigated.emit({ id: linkId(link), href: link.href });\n    const go = this.navigate();\n    const modified =\n      event.ctrlKey || event.metaKey || event.shiftKey || event.altKey || event.button !== 0;\n    if (go && !link.newTab && !modified && !event.defaultPrevented) {\n      event.preventDefault();\n      go(link.href);\n    }\n    this.closeList();\n  }\n\n  // ---------------------------------------------------------------\n  // Keyboard\n  // ---------------------------------------------------------------\n\n  protected onButtonKeydown(event: KeyboardEvent): void {\n    // Enter and Space already produce a click; only the arrows need handling here.\n    if (event.key === \"ArrowDown\") {\n      event.preventDefault();\n      if (!this.open()) this.openList();\n      else this.items()[0]?.focus({ preventScroll: true });\n    } else if (event.key === \"ArrowUp\") {\n      event.preventDefault();\n      if (!this.open()) this.openList(true);\n      else {\n        const all = this.items();\n        all[all.length - 1]?.focus({ preventScroll: true });\n      }\n    }\n  }\n\n  private moveFocus(delta: number): void {\n    const all = this.items();\n    if (all.length === 0) return;\n    const i = all.indexOf(document.activeElement as HTMLElement);\n    // Clamp rather than wrap.\n    const next = Math.min(Math.max((i < 0 ? 0 : i) + delta, 0), all.length - 1);\n    all[next]?.focus({ preventScroll: true });\n  }\n\n  protected onListKeydown(event: KeyboardEvent): void {\n    switch (event.key) {\n      case \"ArrowDown\":\n        event.preventDefault();\n        this.moveFocus(1);\n        break;\n      case \"ArrowUp\":\n        event.preventDefault();\n        this.moveFocus(-1);\n        break;\n      case \"Home\":\n        event.preventDefault();\n        this.items()[0]?.focus({ preventScroll: true });\n        break;\n      case \"End\": {\n        event.preventDefault();\n        const all = this.items();\n        all[all.length - 1]?.focus({ preventScroll: true });\n        break;\n      }\n      case \"Escape\":\n        event.preventDefault();\n        this.closeList();\n        break;\n      case \"Tab\":\n        // Focus goes to the button FIRST, without cancelling the key: hiding the list while a\n        // link has focus drops focus to <body>, and the default Tab would restart from the top.\n        this.buttonRef().focus?.({ preventScroll: true });\n        this.closeList(false);\n        break;\n      default:\n        break;\n    }\n  }\n\n  protected onRootFocusOut(event: FocusEvent): void {\n    const next = event.relatedTarget as Node | null;\n    if (next && this.rootRef().nativeElement.contains(next)) return;\n    this.closeList(false);\n  }\n\n  protected onDocumentClick(event: Event): void {\n    if (!this.open()) return;\n    const t = event.target as Node | null;\n    if (t && !this.rootRef().nativeElement.contains(t)) this.closeList(false);\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@lilydesignsystem/angular-link-picker",
+  "version": "0.1.0",
+  "engines": {
+    "node": "=26"
+  },
+  "description": "Lily Design System Angular link picker: an icon button (a home icon) opening a disclosure of app-defined page links. Headless, SSR-safe, no CSS.",
+  "dependencies": {
+    "@lilydesignsystem/angular-headless": "^0.2.0",
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20.0.0 <23.0.0",
+    "@angular/common": ">=20.0.0 <23.0.0"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "lily",
+    "design",
+    "system",
+    "angular",
+    "link",
+    "navigation",
+    "home",
+    "picker"
+  ],
+  "author": "Joel Parker Henderson <joel@joelparkerhenderson.com>",
+  "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-angular-helpers.git",
+    "directory": "lily-design-system-angular-link-picker"
+  },
+  "homepage": "https://lilydesignsystem.com/",
+  "bugs": {
+    "url": "https://github.com/LilyDesignSystem/lily-design-system/issues"
+  },
+  "module": "fesm2022/lilydesignsystem-angular-link-picker.mjs",
+  "typings": "types/lilydesignsystem-angular-link-picker.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/lilydesignsystem-angular-link-picker.d.ts",
+      "default": "./fesm2022/lilydesignsystem-angular-link-picker.mjs"
+    }
+  },
+  "type": "module"
+}

package/types/lilydesignsystem-angular-link-picker.d.ts

@@ -0,0 +1,137 @@
+import * as i0 from "@angular/core";
+import { TemplateRef } from "@angular/core";
+/**
+ * One destination in the list. The app defines them all: this package ships no routes and no
+ * English — `label` is the consumer's text.
+ */
+type LinkItem = {
+  /** Stable identifier, passed back on the `navigated` output. Defaults to `href`. */
+  id?: string;
+  /** Visible link text. Consumer-supplied, so it localises. */
+  label: string;
+  /** Where the link goes: a route ("/about/") or a full URL. */
+  href: string;
+  /** Marks this link as the current page (`aria-current="page"`). */
+  current?: boolean;
+  /** Open in a new tab (`target="_blank"` with `rel="noopener noreferrer"`). */
+  newTab?: boolean;
+};
+/** Context passed to a custom icon `<ng-template>` (the button icon). */
+type ChildArgs = {
+  /** Is the list open? */
+  open: boolean;
+};
+/** Payload of the `navigated` output. */
+type LinkNavigatedEvent = {
+  /** The chosen link's `id` (its `href` when it has none). */
+  id: string;
+  /** The chosen link's `href`. */
+  href: string;
+};
+/** The id a link reports: its explicit `id`, else its `href`. */
+export declare function linkId(link: LinkItem): string;
+/** Stable per-instance id prefix; SSR-safe (no Math.random / Date.now). */
+export declare function nextLinkPickerId(): string;
+/**
+ * Optional marker for the projected icon template. Gives consumers typed `let-` variables:
+ *
+ * ```html
+ * <lily-link-picker label="Pages" [links]="links">
+ *   <ng-template lilyLinkPickerIcon let-args>{{ args.open ? "×" : "☰" }}</ng-template>
+ * </lily-link-picker>
+ * ```
+ */
+export declare class LinkPickerIcon {
+  static ngTemplateContextGuard(_dir: LinkPickerIcon, _ctx: unknown): _ctx is ChildArgs & {
+    $implicit: ChildArgs;
+  };
+  static ɵfac: i0.ɵɵFactoryDeclaration<LinkPickerIcon, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<LinkPickerIcon, "ng-template[lilyLinkPickerIcon]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * LinkPicker — a headless page-links control.
+ *
+ * A single-icon button (a bundled home SVG) that opens a disclosure list of page links the app
+ * defines. It applies nothing to the document and persists nothing. See `spec/index.md`.
+ */
+export declare class LinkPicker {
+  /** Accessible name for the button and the list. */
+  readonly label: import("@angular/core").InputSignal<string>;
+  /** The page links to offer. Defined by the app. */
+  readonly links: import("@angular/core").InputSignal<LinkItem[]>;
+  /**
+   * Client-side navigation hook, e.g. a router's `navigateByUrl`. When given, a plain left click
+   * on a link calls `navigate(href)` instead of letting the browser load the page; modified
+   * clicks (Ctrl/Cmd/Shift/Alt, middle button) and `newTab` links stay native.
+   */
+  readonly navigate: import("@angular/core").InputSignal<((href: string) => void) | undefined>;
+  /** Extra CSS class on the root div. */
+  readonly className: import("@angular/core").InputSignal<string>;
+  /** Fires after a link is chosen. */
+  readonly navigated: import("@angular/core").OutputEmitterRef<LinkNavigatedEvent>;
+  /** Projected icon template; replaces the default icon when supplied. */
+  protected readonly iconTemplate: import("@angular/core").Signal<TemplateRef<any> | undefined>;
+  private readonly rootRef;
+  private readonly buttonRef;
+  private readonly listRef;
+  private readonly baseId;
+  protected readonly listId: string;
+  protected readonly open: import("@angular/core").WritableSignal<boolean>;
+  protected readonly tooltipId: string;
+  protected readonly hoverButton: import("@angular/core").WritableSignal<boolean>;
+  protected readonly hoverTooltip: import("@angular/core").WritableSignal<boolean>;
+  protected readonly focusButton: import("@angular/core").WritableSignal<boolean>;
+  protected readonly dismissed: import("@angular/core").WritableSignal<boolean>;
+  protected readonly tooltipVisible: import("@angular/core").Signal<boolean>;
+  protected onTooltipButtonEnter(): void;
+  protected onTooltipButtonFocusIn(): void;
+  protected onTooltipButtonFocusOut(): void;
+  protected onTooltipKeydown(event: KeyboardEvent): void;
+  private readonly tooltipEscapeListener;
+  protected readonly childContext: import("@angular/core").Signal<{
+    /** Is the list open? */
+    open: boolean;
+    $implicit: ChildArgs;
+  }>;
+  protected idOf(link: LinkItem): string;
+  /** Every focusable link in the list, in DOM order. */
+  private items;
+  /** Open the list, focusing the first link (or the last, if `focusLast`). */
+  openList(focusLast?: boolean): void;
+  /** Close the list; `refocus` returns focus to the trigger. */
+  closeList(refocus?: boolean): void;
+  protected onButtonClick(): void;
+  protected onLinkClick(event: MouseEvent, link: LinkItem): void;
+  protected onButtonKeydown(event: KeyboardEvent): void;
+  private moveFocus;
+  protected onListKeydown(event: KeyboardEvent): void;
+  protected onRootFocusOut(event: FocusEvent): void;
+  protected onDocumentClick(event: Event): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<LinkPicker, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<LinkPicker, "lily-link-picker", never, {
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+    "links": {
+      "alias": "links";
+      "required": true;
+      "isSignal": true;
+    };
+    "navigate": {
+      "alias": "navigate";
+      "required": false;
+      "isSignal": true;
+    };
+    "className": {
+      "alias": "className";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "navigated": "navigated";
+  }, ["iconTemplate"], never, true, never>;
+}
+export type { ChildArgs, LinkItem, LinkNavigatedEvent };
+//# sourceMappingURL=lilydesignsystem-angular-link-picker.d.ts.map

package/types/lilydesignsystem-angular-link-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lilydesignsystem-angular-link-picker.d.ts","names":[],"sources":["../../link-picker.component.ts"],"mappings":";;;;;;KAwBY;;EAEV;;EAEA;;EAEA;;EAEA;;EAEA;;;KAIU;;EAEV;;;KAIU;;EAEV;;EAEA;;;wBAIc,OAAO,MAAM;;wBAMb;;;;;;;;;;qBAkBH;SACJ,uBACL,MAAM,gBACN,gBACC,QAAQ;IAAc,WAAW;;SAJzB,MAAA,GAAA,qBAAA;SAAA,MAAA,GAAA,uBAAA;;;;;;;;qBA2GA;;WAEF,+BAAK;;WAEL,+BAAK,YAAA;;;;;;WAML,kCAAQ,cAAA;;WAER,mCAAS;;WAGT,mCAAS,iBAAA;;qBAGC,sCAAY,OAAA;mBAEd;mBAIA;mBACA;mBAGA;qBACE;qBAEA,8BAAI;qBAKJ;qBACA,qCAAW;qBACX,sCAAY;qBACZ,qCAAW;qBACX,mCAAS;qBACT,wCAAc;YAOvB;YAKA;YAYA;YAKA,iBAAiB,OAAO;mBAMjB;qBASE,sCAAY;;IApOzB;;;YAyOI,KAAK,MAAM;;UAKb;;EAWR,SAAS;;EAUT,UAAU;YAMA;YAKA,YAAY,OAAO,YAAY,MAAM;YAgBrC,gBAAgB,OAAO;UAgBzB;YASE,cAAc,OAAO;YAmCrB,eAAe,OAAO;YAMtB,gBAAgB,OAAO;SAjNtB,MAAA,GAAA,qBAAA;SAAA,MAAA,GAAA,uBAAA;IAAU;MAAA;MAAA;MAAA;;IAAA;MAAA;MAAA;MAAA;;IAAA;MAAA;MAAA;MAAA;;IAAA;MAAA;MAAA;MAAA;;;IAAA"}