@arbor-education/design-system.components 3.1.0 → 3.2.1

package/dist/components/icon/LucideIcon.d.ts

@@ -0,0 +1,17 @@
+import type { IconName } from 'lucide-react/dynamic';
+import type { CustomIconProps } from './types.js';
+/** Every icon name published by `lucide-react`, kebab-cased. */
+export type LucideIconName = IconName;
+/** Every `lucide-react` icon name, for building galleries and validating input. */
+export declare const lucideIconNames: readonly LucideIconName[];
+export type LucideIconProps = CustomIconProps & {
+    name: LucideIconName;
+    fill?: string;
+};
+/**
+ * Renders a single `lucide-react` icon, loading it on demand. Until the icon resolves an empty SVG
+ * of the same size is rendered in its place, so the surrounding layout does not shift and the
+ * element keeps its accessible role throughout.
+ */
+export declare const LucideIcon: (props: LucideIconProps) => import("react").JSX.Element;
+//# sourceMappingURL=LucideIcon.d.ts.map

package/dist/components/icon/LucideIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LucideIcon.d.ts","sourceRoot":"","sources":["../../../src/components/icon/LucideIcon.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEtC,mFAAmF;AACnF,eAAO,MAAM,eAAe,EAAE,SAAS,cAAc,EAAc,CAAC;AAgEpE,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAC9C,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,eAAe,gCAUhD,CAAC"}

package/dist/components/icon/LucideIcon.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useReducer } from 'react';
+import { dynamicIconImports, iconNames } from 'lucide-react/dynamic.mjs';
+/** Every `lucide-react` icon name, for building galleries and validating input. */
+export const lucideIconNames = iconNames;
+const iconLoaders = dynamicIconImports;
+/**
+ * Icons resolve through `lucide-react`'s per-icon dynamic imports so that consumers only ship the
+ * icons they actually render, rather than all ~1,900 of them. Both caches are module-scoped: the
+ * first render of a given icon anywhere in the app pays the import, and every render after that —
+ * including new instances in other trees — resolves synchronously from `loadedIcons`.
+ */
+const loadedIcons = new Map();
+const inFlightLoads = new Map();
+const loadIcon = (name) => {
+    const inFlight = inFlightLoads.get(name);
+    if (inFlight) {
+        return inFlight;
+    }
+    // Annotated rather than inferred: names reaching `Icon` from a backend are not always valid.
+    const loader = iconLoaders[name];
+    if (!loader) {
+        console.error(`[design-system] "${name}" is not a known icon name.`);
+        // Cached so an unknown name is only reported once, however many times it is rendered.
+        const noSuchIcon = Promise.resolve();
+        inFlightLoads.set(name, noSuchIcon);
+        return noSuchIcon;
+    }
+    const load = loader()
+        .then((iconModule) => {
+        loadedIcons.set(name, iconModule.default);
+    })
+        .catch((error) => {
+        // Drop the rejected promise so a later render can retry (e.g. after a transient chunk 404).
+        inFlightLoads.delete(name);
+        console.error(`[design-system] Could not load the "${name}" icon.`, error);
+    });
+    inFlightLoads.set(name, load);
+    return load;
+};
+const useLucideIcon = (name) => {
+    const [, rerender] = useReducer((renderCount) => renderCount + 1, 0);
+    useEffect(() => {
+        if (loadedIcons.has(name)) {
+            return;
+        }
+        let isMounted = true;
+        void loadIcon(name).then(() => {
+            if (isMounted) {
+                rerender();
+            }
+        });
+        return () => {
+            isMounted = false;
+        };
+    }, [name]);
+    return loadedIcons.get(name);
+};
+/**
+ * Renders a single `lucide-react` icon, loading it on demand. Until the icon resolves an empty SVG
+ * of the same size is rendered in its place, so the surrounding layout does not shift and the
+ * element keeps its accessible role throughout.
+ */
+export const LucideIcon = (props) => {
+    const { name, ...iconProps } = props;
+    const Component = useLucideIcon(name);
+    if (!Component) {
+        const { size, ...placeholderProps } = iconProps;
+        return _jsx("svg", { width: size, height: size, viewBox: "0 0 24 24", ...placeholderProps });
+    }
+    return _jsx(Component, { ...iconProps });
+};
+//# sourceMappingURL=LucideIcon.js.map

package/dist/components/icon/LucideIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LucideIcon.js","sourceRoot":"","sources":["../../../src/components/icon/LucideIcon.tsx"],"names":[],"mappings":"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"}

package/dist/components/icon/allowedIcons.d.ts

@@ -1,115 +1,51 @@
-import { type LucideProps } from 'lucide-react';
+import { type LucideIconName } from './LucideIcon.js';
 import type { CustomIconProps } from './types.js';
-export declare const allowedIcons: {
-    readonly '3-dot': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly archive: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'arrow-down': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'arrow-left': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'arrow-right-from-line': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'arrow-right': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'arrow-up-right': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'arrow-up': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'book-open': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly camera: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'chart-column-increasing': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'chart-spline': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly check: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'chevron-down': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'chevron-left': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'chevron-right': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'chevron-up': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'chevrons-left': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'chevrons-right': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'circle-alert': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'circle-check-big': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'circle-check': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'circle-help': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'circle-percent': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'circle-plus': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'circle-x': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'clipboard-list': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly clipboard: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'clock-3': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'cloud-upload': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly copy: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'corner-down-left': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly date: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly dot: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly download: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'ellipsis-vertical': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly ellipsis: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly expand: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'external-link': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'eye-off': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly eye: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'favourite-outline': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly file: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly files: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly flag: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly funnel: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly grab: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'graduation-cap': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'grid-3x3': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly group: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly guardians: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly history: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly house: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly info: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'iteration-ccw': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'layout-list': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly lightbulb: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly link: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'list-filter-plus': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly list: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'list-tree': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly loader: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'lock-open': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly lock: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'log-out': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly mail: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly menu: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'message-square-more': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly mic: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly minus: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly monitor: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'paint-bucket': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly paperclip: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'party-popper': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly pencil: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly percent: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly phone: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly pin: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly plus: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly projector: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly redo: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly save: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly search: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly send: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly settings: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly share: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly sheet: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly shrink: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'sliders-horizontal': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly smartphone: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly sorting: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly sparkles: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly staff: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'switch-camera': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly table: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly trash: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'trending-down': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'trending-up': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly 'triangle-alert': import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly undo: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly upload: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly user: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly x: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
-    readonly zap: import("react").ForwardRefExoticComponent<Omit<LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+/**
+ * Arbor names that point at a differently-named Lucide icon. These take precedence over the Lucide
+ * name they shadow, so `trash` stays the lidded can (`trash-2`) rather than Lucide's plain `trash`.
+ * Seven of these — `grab`, `group`, `loader`, `redo`, `shrink`, `trash` and `undo` — shadow a real
+ * Lucide icon with a different glyph, which is deliberate: renaming them would break every existing
+ * consumer. Reach for the target name directly if you want Lucide's version.
+ *
+ * The `satisfies` clause makes every target a compile-time-checked Lucide icon name.
+ */
+export declare const iconAliases: {
+    readonly '3-dot': "ellipsis-vertical";
+    readonly 'circle-help': "circle-question-mark";
+    readonly date: "calendar-fold";
+    readonly 'favourite-outline': "star";
+    readonly grab: "grip-vertical";
+    readonly group: "users-round";
+    readonly guardians: "users";
+    readonly loader: "loader-circle";
+    readonly redo: "redo-2";
+    readonly shrink: "minimize-2";
+    readonly sorting: "arrow-down-up";
+    readonly staff: "graduation-cap";
+    readonly trash: "trash-2";
+    readonly undo: "undo-2";
+};
+/**
+ * Icons that are not plain Lucide glyphs: Arbor-specific artwork, and the solid variants built for
+ * particular semantic emphasis states.
+ */
+export declare const customIcons: {
     readonly 'ask-arbor': (props: CustomIconProps) => import("react").JSX.Element;
     readonly google: (props: CustomIconProps) => import("react").JSX.Element;
     readonly 'check-solid': (props: CustomIconProps) => import("react").JSX.Element;
-    readonly 'favourite-filled': (props: LucideProps) => import("react").JSX.Element;
+    readonly 'favourite-filled': (props: CustomIconProps) => import("react").JSX.Element;
     readonly 'x-solid': (props: CustomIconProps) => import("react").JSX.Element;
 };
-export type IconName = keyof typeof allowedIcons;
+export type IconName = LucideIconName | keyof typeof iconAliases | keyof typeof customIcons;
+/** Every name `Icon` accepts: the whole Lucide set, plus Arbor's aliases and custom icons. */
+export declare const iconNames: readonly IconName[];
+/**
+ * The `Icon` name allow-list, as a plain object so that membership can be tested with
+ * `hasOwnProperty`. Prefer {@link isIconName}; the values carry no meaning and exist only to make
+ * this a record. Icon components are no longer held here — they are loaded on demand, so nothing
+ * outside a render has a component to hand out.
+ */
+export declare const allowedIcons: Readonly<Record<IconName, true>>;
+/** Narrows an arbitrary string to an `IconName`, for validating names that come from a backend. */
+export declare const isIconName: (name: string) => name is IconName;
 //# sourceMappingURL=allowedIcons.d.ts.map

package/dist/components/icon/allowedIcons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"allowedIcons.d.ts","sourceRoot":"","sources":["../../../src/components/icon/allowedIcons.tsx"],"names":[],"mappings":"AAAA,OAAO,EA8DG,KAAK,WAAW,EA8BzB,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCA8GA,eAAe;yCACV,WAAW;gCAGpB,eAAe;CAC1B,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,YAAY,CAAC"}
+{"version":3,"file":"allowedIcons.d.ts","sourceRoot":"","sources":["../../../src/components/icon/allowedIcons.tsx"],"names":[],"mappings":"AACA,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;CAeqC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;yCAIM,eAAe;;CAIuC,CAAC;AAErF,MAAM,MAAM,QAAQ,GACd,cAAc,GACd,MAAM,OAAO,WAAW,GACxB,MAAM,OAAO,WAAW,CAAC;AAM/B,8FAA8F;AAC9F,eAAO,MAAM,SAAS,EAAE,SAAS,QAAQ,EAIxC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAEpB,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AAEtC,mGAAmG;AACnG,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,QACQ,CAAC"}

package/dist/components/icon/allowedIcons.js

@@ -1,121 +1,61 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { Archive, ArrowDown, ArrowDownUp, ArrowLeft, ArrowRight, ArrowRightFromLine, ArrowUp, ArrowUpRight, BookOpen, CalendarFold, Camera, ChartColumnIncreasing, ChartSpline, Check, ChevronDown, ChevronLeft, ChevronRight, ChevronsLeft, ChevronsRight, ChevronUp, CircleAlert, CircleCheck, CircleCheckBig, CirclePercent, CirclePlus, CircleQuestionMark, CircleX, Clipboard, ClipboardList, Clock3, CloudUpload, Copy, CornerDownLeft, Dot, Download, Ellipsis, EllipsisVertical, Expand, ExternalLink, Eye, EyeOff, File, Files, Flag, Funnel, GraduationCap, Grid3x3, GripVertical, History, House, Info, IterationCcw, LayoutList, Lightbulb, Link, List, ListFilterPlus, ListTree, LoaderCircle, Lock, LockOpen, LogOut, Mail, Menu, MessageSquareMore, Mic, Minimize2, Minus, Monitor, PaintBucket, Paperclip, PartyPopper, Pencil, Percent, Phone, Pin, Plus, Projector, Redo2, Save, Search, Send, Settings, Share, Sheet, SlidersHorizontal, Smartphone, Sparkles, Star, SwitchCamera, Table, Trash2, TrendingDown, TrendingUp, TriangleAlert, Undo2, Upload, User, Users, UsersRound, X, Zap, } from 'lucide-react';
+import { LucideIcon, lucideIconNames } from './LucideIcon.js';
 import { AskArbor } from './customIcons/AskArbor.js';
 import { CheckSolid } from './customIcons/CheckSolid.js';
 import { Google } from './customIcons/Google.js';
 import { XSolid } from './customIcons/XSolid.js';
-export const allowedIcons = {
-    // lucide icons
-    '3-dot': EllipsisVertical,
-    'archive': Archive,
-    'arrow-down': ArrowDown,
-    'arrow-left': ArrowLeft,
-    'arrow-right-from-line': ArrowRightFromLine,
-    'arrow-right': ArrowRight,
-    'arrow-up-right': ArrowUpRight,
-    'arrow-up': ArrowUp,
-    'book-open': BookOpen,
-    'camera': Camera,
-    'chart-column-increasing': ChartColumnIncreasing,
-    'chart-spline': ChartSpline,
-    'check': Check,
-    'chevron-down': ChevronDown,
-    'chevron-left': ChevronLeft,
-    'chevron-right': ChevronRight,
-    'chevron-up': ChevronUp,
-    'chevrons-left': ChevronsLeft,
-    'chevrons-right': ChevronsRight,
-    'circle-alert': CircleAlert,
-    'circle-check-big': CircleCheckBig,
-    'circle-check': CircleCheck,
-    'circle-help': CircleQuestionMark,
-    'circle-percent': CirclePercent,
-    'circle-plus': CirclePlus,
-    'circle-x': CircleX,
-    'clipboard-list': ClipboardList,
-    'clipboard': Clipboard,
-    'clock-3': Clock3,
-    'cloud-upload': CloudUpload,
-    'copy': Copy,
-    'corner-down-left': CornerDownLeft,
-    'date': CalendarFold,
-    'dot': Dot,
-    'download': Download,
-    'ellipsis-vertical': EllipsisVertical,
-    'ellipsis': Ellipsis,
-    'expand': Expand,
-    'external-link': ExternalLink,
-    'eye-off': EyeOff,
-    'eye': Eye,
-    'favourite-outline': Star,
-    'file': File,
-    'files': Files,
-    'flag': Flag,
-    'funnel': Funnel,
-    'grab': GripVertical,
-    'graduation-cap': GraduationCap,
-    'grid-3x3': Grid3x3,
-    'group': UsersRound,
-    'guardians': Users,
-    'history': History,
-    'house': House,
-    'info': Info,
-    'iteration-ccw': IterationCcw,
-    'layout-list': LayoutList,
-    'lightbulb': Lightbulb,
-    'link': Link,
-    'list-filter-plus': ListFilterPlus,
-    'list': List,
-    'list-tree': ListTree,
-    'loader': LoaderCircle,
-    'lock-open': LockOpen,
-    'lock': Lock,
-    'log-out': LogOut,
-    'mail': Mail,
-    'menu': Menu,
-    'message-square-more': MessageSquareMore,
-    'mic': Mic,
-    'minus': Minus,
-    'monitor': Monitor,
-    'paint-bucket': PaintBucket,
-    'paperclip': Paperclip,
-    'party-popper': PartyPopper,
-    'pencil': Pencil,
-    'percent': Percent,
-    'phone': Phone,
-    'pin': Pin,
-    'plus': Plus,
-    'projector': Projector,
-    'redo': Redo2,
-    'save': Save,
-    'search': Search,
-    'send': Send,
-    'settings': Settings,
-    'share': Share,
-    'sheet': Sheet,
-    'shrink': Minimize2,
-    'sliders-horizontal': SlidersHorizontal,
-    'smartphone': Smartphone,
-    'sorting': ArrowDownUp,
-    'sparkles': Sparkles,
-    'staff': GraduationCap,
-    'switch-camera': SwitchCamera,
-    'table': Table,
-    'trash': Trash2,
-    'trending-down': TrendingDown,
-    'trending-up': TrendingUp,
-    'triangle-alert': TriangleAlert,
-    'undo': Undo2,
-    'upload': Upload,
-    'user': User,
-    'x': X,
-    'zap': Zap,
-    // custom icons
+/**
+ * Arbor names that point at a differently-named Lucide icon. These take precedence over the Lucide
+ * name they shadow, so `trash` stays the lidded can (`trash-2`) rather than Lucide's plain `trash`.
+ * Seven of these — `grab`, `group`, `loader`, `redo`, `shrink`, `trash` and `undo` — shadow a real
+ * Lucide icon with a different glyph, which is deliberate: renaming them would break every existing
+ * consumer. Reach for the target name directly if you want Lucide's version.
+ *
+ * The `satisfies` clause makes every target a compile-time-checked Lucide icon name.
+ */
+export const iconAliases = {
+    '3-dot': 'ellipsis-vertical',
+    'circle-help': 'circle-question-mark',
+    'date': 'calendar-fold',
+    'favourite-outline': 'star',
+    'grab': 'grip-vertical',
+    'group': 'users-round',
+    'guardians': 'users',
+    'loader': 'loader-circle',
+    'redo': 'redo-2',
+    'shrink': 'minimize-2',
+    'sorting': 'arrow-down-up',
+    'staff': 'graduation-cap',
+    'trash': 'trash-2',
+    'undo': 'undo-2',
+};
+/**
+ * Icons that are not plain Lucide glyphs: Arbor-specific artwork, and the solid variants built for
+ * particular semantic emphasis states.
+ */
+export const customIcons = {
     'ask-arbor': AskArbor,
     'google': Google,
-    // solid icons
-    'check-solid': (props) => _jsx(CheckSolid, { ...props }),
-    'favourite-filled': (props) => (_jsx(Star, { ...props, fill: props.color })),
-    'x-solid': (props) => _jsx(XSolid, { ...props }),
+    'check-solid': CheckSolid,
+    'favourite-filled': (props) => (_jsx(LucideIcon, { name: "star", ...props, fill: props.color })),
+    'x-solid': XSolid,
 };
+// `Object.keys` widens to `string[]`, so the key unions are reasserted here.
+const aliasNames = Object.keys(iconAliases);
+const customIconNames = Object.keys(customIcons);
+/** Every name `Icon` accepts: the whole Lucide set, plus Arbor's aliases and custom icons. */
+export const iconNames = [
+    ...lucideIconNames,
+    ...aliasNames,
+    ...customIconNames,
+];
+/**
+ * The `Icon` name allow-list, as a plain object so that membership can be tested with
+ * `hasOwnProperty`. Prefer {@link isIconName}; the values carry no meaning and exist only to make
+ * this a record. Icon components are no longer held here — they are loaded on demand, so nothing
+ * outside a render has a component to hand out.
+ */
+export const allowedIcons = Object.freeze(Object.fromEntries(iconNames.map(name => [name, true])));
+/** Narrows an arbitrary string to an `IconName`, for validating names that come from a backend. */
+export const isIconName = (name) => Object.prototype.hasOwnProperty.call(allowedIcons, name);
 //# sourceMappingURL=allowedIcons.js.map

package/dist/components/icon/allowedIcons.js.map

@@ -1 +1 @@
-{"version":3,"file":"allowedIcons.js","sourceRoot":"","sources":["../../../src/components/icon/allowedIcons.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"allowedIcons.js","sourceRoot":"","sources":["../../../src/components/icon/allowedIcons.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAuB,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGjD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,mBAAmB;IAC5B,aAAa,EAAE,sBAAsB;IACrC,MAAM,EAAE,eAAe;IACvB,mBAAmB,EAAE,MAAM;IAC3B,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,aAAa;IACtB,WAAW,EAAE,OAAO;IACpB,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,YAAY;IACtB,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,gBAAgB;IACzB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CAC2C,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,UAAU;IACzB,kBAAkB,EAAE,CAAC,KAAsB,EAAE,EAAE,CAAC,CAC9C,KAAC,UAAU,IAAC,IAAI,EAAC,MAAM,KAAK,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,GAAI,CACzD;IACD,SAAS,EAAE,MAAM;CACiE,CAAC;AAOrF,6EAA6E;AAC7E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAA4C,CAAC;AACvF,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAA4C,CAAC;AAE5F,8FAA8F;AAC9F,MAAM,CAAC,MAAM,SAAS,GAAwB;IAC5C,GAAG,eAAe;IAClB,GAAG,UAAU;IACb,GAAG,eAAe;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CACvC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CACpB,CAAC;AAEtC,mGAAmG;AACnG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAoB,EAAE,CAC3D,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC"}

package/dist/components/icon/types.d.ts

@@ -1,9 +1,10 @@
 export declare const iconSizes: readonly [12, 16, 24];
 export type IconSize = typeof iconSizes[number];
 export type CustomIconProps = {
-    size: IconSize;
-    color?: string;
-    role?: string;
-    className?: string;
+    'size': IconSize;
+    'color'?: string;
+    'role'?: string;
+    'className'?: string;
+    'aria-hidden'?: boolean;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/components/icon/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/icon/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,uBAAwB,CAAC;AAC/C,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/icon/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,uBAAwB,CAAC;AAC/C,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC"}

package/dist/components/row/Row.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Row.stories.d.ts","sourceRoot":"","sources":["../../../src/components/row/Row.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAa5D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAyI/B,iBAAS,WAAW,gCAmBnB;AAMD,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiHkB,CAAC;AAE7B,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;AAyGlC,eAAO,MAAM,OAAO,EAAE,KAWrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAqBvB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAqBvB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KA+B7B,CAAC;AAEF,eAAO,MAAM,kCAAkC,EAAE,KAiChD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAiCtB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAiCtB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAsB9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAiC5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAmC7B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAiCvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,KAmC/B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,KAuCrC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAiCvB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAiDzB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAqC1B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KA+B9B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KA+B7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KA+D9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAkChC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KA4CzB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,KAmCjC,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAsBtB,CAAC"}
+{"version":3,"file":"Row.stories.d.ts","sourceRoot":"","sources":["../../../src/components/row/Row.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAa5D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAyI/B,iBAAS,WAAW,gCAmBnB;AAMD,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiHkB,CAAC;AAE7B,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;AAuGlC,eAAO,MAAM,OAAO,EAAE,KAWrB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAqBvB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAqBvB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KA+B7B,CAAC;AAEF,eAAO,MAAM,kCAAkC,EAAE,KAiChD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAiCtB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAiCtB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAsB9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAiC5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAmC7B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAiCvB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,KAmC/B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,KAqCrC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAiCvB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KA+CzB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAqC1B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KA+B9B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KA+B7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KA+D9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAkChC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAwDzB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,KAmCjC,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAsBtB,CAAC"}

package/dist/components/row/Row.stories.js

@@ -270,7 +270,7 @@ const withDescription = (story, description) => ({
 // ---------------------------------------------------------------------------
 // Template components
 // ---------------------------------------------------------------------------
-const MixedClickableAndStaticTemplate = () => (_jsxs(Section, { title: "Pupil details", children: [_jsx(Row, { label: "Name", value: "Amara Osei-Bonsu" }), _jsx(Row, { label: "Year group", value: "Year 10" }), _jsx(Row, { label: "Form", value: "10JH" }), _jsx(Row, { label: "SEN status", value: "SEN Support", note: "Review due May 2026", onClick: () => { } }), _jsx(Row, { label: "Attendance (YTD)", value: "88.3%", note: "Below 90% threshold", onClick: () => { } })] }));
+const MixedClickableAndStaticTemplate = () => (_jsxs(Section, { title: "Pupil details", children: [_jsx(Row, { label: "Name", value: "Amara Osei-Bonsu" }), _jsx(Row, { label: "Year group", value: "Year 10" }), _jsx(Row, { label: "Form", value: "10JH" }), _jsx(Row, { label: "SEN status", value: "SEN Support", onClick: () => { } }), _jsx(Row, { label: "Attendance (YTD)", value: "88.3%", onClick: () => { } })] }));
 const InSectionTemplate = () => (_jsxs(Section, { title: "Personal details", children: [_jsx(Row, { label: "Pupil", value: "Amara Osei-Bonsu" }), _jsx(Row, { label: "Date of birth", value: "14 March 2010" }), _jsx(Row, { label: "Admission number", value: "001847" }), _jsx(Row, { label: "UPN", value: "A823456789012" }), _jsx(Row, { label: "Email address", value: "a.osei-bonsu@pupil.school.example", href: "mailto:a.osei-bonsu@pupil.school.example" })] }));
 const AccessibilityNotesTemplate = () => (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 'var(--spacing-large)' }, children: [_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 'var(--spacing-xsmall)' }, children: [_jsxs("p", { style: { margin: 0, color: 'var(--color-grey-600)', fontSize: 'var(--font-size-3-14)' }, children: ["Static row \u2014", ' ', _jsx("code", { children: "tabIndex=\"-1\"" }), ", no ARIA role, not in tab order"] }), _jsx(Row, { label: "Year group", value: "Year 9" })] }), _jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 'var(--spacing-xsmall)' }, children: [_jsxs("p", { style: { margin: 0, color: 'var(--color-grey-600)', fontSize: 'var(--font-size-3-14)' }, children: ["Clickable row \u2014", ' ', _jsx("code", { children: "tabIndex=\"0\"" }), ", keyboard-activatable, but", ' ', _jsxs("strong", { children: ["no", _jsx("code", { children: "role=\"button\"" })] }), ' ', "\u2014 screen readers may not announce it as interactive"] }), _jsx(Row, { label: "SEN record", value: "SEN Support", onClick: () => { } })] }), _jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 'var(--spacing-xsmall)' }, children: [_jsxs("p", { style: { margin: 0, color: 'var(--color-grey-600)', fontSize: 'var(--font-size-3-14)' }, children: ["href row \u2014 renders a real", ' ', _jsx("code", { children: "<a>" }), ' ', "tag with full native link semantics \u2713"] }), _jsx(Row, { label: "Email address", value: "admin@school.example", href: "mailto:admin@school.example" })] })] }));
 // ---------------------------------------------------------------------------
@@ -562,13 +562,11 @@ function PupilDetailSection() {
       <Row
         label="SEN status"
         value="SEN Support"
-        note="Review due May 2026"
         onClick={() => navigateToSENRecord()}
       />
       <Row
         label="Attendance (YTD)"
         value="88.3%"
-        note="Below 90% threshold"
         onClick={() => navigateToAttendance()}
       />
     </Section>
@@ -611,7 +609,7 @@ export default PersonalDetailsSection;
         },
     },
     render: InSectionTemplate,
-}, 'The canonical real-world usage: `Row` components as children of a `Section`. The `Section` provides the container heading and background; each `Row` handles the label/value layout. Most product uses of `Row` are inside a `Section`.');
+}, 'The canonical real-world usage: `Row` components as children of a `Section`. The `Section` provides the container heading and background; each `Row` handles the label/value layout. Most product uses of `Row` are inside a `Section` — one row demonstrates a linked value via `href` to show that pattern working inside a realistic panel too.');
 export const LongContent = withDescription({
     parameters: {
         controls: { disable: true },
@@ -633,7 +631,6 @@ function LongContentExample() {
         label="Pupil premium eligibility reason"
         value="Free school meals — ever 6"
         note="Verified by LA"
-        onClick={() => navigateToEligibilityDetail()}
       />
     </div>
   );
@@ -643,7 +640,7 @@ export default LongContentExample;
             },
         },
     },
-    render: () => (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 'var(--spacing-xsmall)' }, children: [_jsx(Row, { label: "Special educational needs and disabilities coordinator", value: "Mrs Jacqueline Abernathy-Thornton", note: "Updated 3 January 2026" }), _jsx(Row, { label: "Pupil premium eligibility reason", value: "Free school meals \u2014 ever 6", note: "Verified by LA", onClick: fn() })] })),
+    render: () => (_jsxs("div", { style: { display: 'flex', flexDirection: 'column', gap: 'var(--spacing-xsmall)' }, children: [_jsx(Row, { label: "Special educational needs and disabilities coordinator", value: "Mrs Jacqueline Abernathy-Thornton", note: "Updated 3 January 2026" }), _jsx(Row, { label: "Pupil premium eligibility reason", value: "Free school meals \u2014 ever 6", note: "Verified by LA" })] })),
 }, 'Long label and value strings exercise the flex layout. The label column enforces a 190 px maximum width — long labels wrap rather than compress the value column. Test your specific container widths if you have long copy in narrow panels.');
 export const MultipleRows = withDescription({
     parameters: {
@@ -799,16 +796,28 @@ export const WithTooltip = withDescription({
                 code: `
 import { Row } from '@arbor-education/design-system.components';
 
-function ReadOnlyRow() {
+function ReadOnlyRows() {
   return (
-    <Row
-      label="UPN"
-      value="A823456789012"
-      tooltipText="Unique Pupil Number — assigned by the DfE and cannot be changed here"
-    />
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 'var(--spacing-small)' }}>
+      <Row
+        label="UPN"
+        value="A823456789012"
+        tooltipText="Unique Pupil Number — assigned by the DfE and cannot be changed here"
+      />
+      <Row
+        label="Admission number"
+        value="001847"
+        tooltipText="Set at admission — contact the office to request a change"
+      />
+      {/* No tooltipText — hovering this row shows nothing */}
+      <Row
+        label="Year group"
+        value="Year 9"
+      />
+    </div>
   );
 }
-export default ReadOnlyRow;
+export default ReadOnlyRows;
 `.trim(),
             },
         },