@openbunny/react 0.1.0 → 0.2.0

package/README.md

@@ -1,8 +1,5 @@
 # @openbunny/react
 
-> **Work in progress.** Names, identifiers and interfaces can change without
-> notice.
-
 Generic React components for OpenBunny sites. The package ships components and
 helpers with no site content.
 
@@ -16,12 +13,16 @@ helpers with no site content.
 | `CommandBlock`, `CommandLine`, `ShellCommand` | Numbered command steps, one command row, token spans  |
 | `CopyButton`, `Button`                        | Clipboard button, base button                         |
 | `SkipLink`, `ChevronIcon`                     | Skip-to-content link, chevron icon                    |
+| `Cite`, `CiteGroup`, `References`             | Numbered citation markers and their reference list    |
+| `Screenshot`                                  | Bordered image with a caption below                   |
 
 The package renders no site identity. Each component takes its text, artwork
 and behaviour through props. Where a prop has a default, the default is neutral
 English. No component imports `next`, an analytics client or a router, and none
-renders a link. A caller that needs a link passes its own element as a child or
-as a prop of type `ReactNode`.
+renders a link to a route. The citation components render plain `<a>` elements
+to in-page `#cite-` and `#ref-` anchors and to each `Reference`'s `url`. A
+caller that needs a link to a route passes its own element as a child or as a
+prop of type `ReactNode`.
 
 ## Install
 
@@ -73,6 +74,7 @@ that respect.
 `tailwind.css` from the theme maps each colour to a Tailwind utility. The
 components use these utilities: `border-line`, `bg-paper`, `bg-paper-inset`,
 `bg-foreground`, `text-background`, `text-foreground`, `text-ink`, `text-muted`,
+`hover:text-sprout`,
 `border-foreground`, `ring` and the `font-display`, `font-sc` and `font-mono`
 families. `styles.css` reads `--ink-deep`, `--ink-mid`, `--sprout` and
 `--font-weight-bold`. Components assume square corners (`--radius-*` is `0`).
@@ -86,8 +88,8 @@ families. `styles.css` reads `--ink-deep`, `--ink-mid`, `--sprout` and
 | `.js-only`                          | `@openbunny/react/styles.css` | `CopyButton`   | hidden under `@media (scripting: none)`                             |
 
 `src/styles.test.ts` fails when a component uses a custom class that neither
-this table nor the theme defines. The theme defines `.link` and `.chip`; no
-component uses them.
+this table nor the theme defines. The theme defines `.link` and `.chip`;
+`References` uses `.link` for its source and back-links.
 
 ### Document contract
 
@@ -107,6 +109,10 @@ Every prop is required unless its row shows a default or `?`.
 | `CommandBlock`   | `id`, `number`, `title`, `steps`: `CommandStep[]`, `note?`, `copyAll?` (`false`), `copy?`, `copyLabel?`, `lead?` |
 | `CommandLine`    | `command`, `copy?`, `copyLabel?`                                                                                 |
 | `CopyButton`     | `text`, `label`, `caption?`, `copiedCaption?`, `failureHint?`, `onCopy?`                                         |
+| `Cite`           | `id`, `registry`: `CitationRegistry`                                                                             |
+| `CiteGroup`      | `ids`, `registry`: `CitationRegistry`                                                                            |
+| `References`     | `items`: `Reference[]`, `registry`: `CitationRegistry`, `sourceLabel?`, `backLinkLabel?`: `BackLinkLabel`        |
+| `Screenshot`     | `src`, `alt`, `width`, `height`, `caption`: `ReactNode`                                                          |
 | `PageSection`    | `id`, `className?`, `children`                                                                                   |
 | `PageShell`      | `children`                                                                                                       |
 | `PageTitle`      | `title`, `lastChangedAt?`, `changedLabel?`, `formatDate?`                                                        |
@@ -121,9 +127,18 @@ Types and helpers:
 
 - `PlateAsset`: `gifSrc`, `staticSrc` (strings), `width`, `height` (numbers).
 - `CommandStep`: `command` and `comment` (strings).
-- `CopyText`: `caption?`, `copiedCaption?`, `failureHint?`.
+- `CopyText`: `caption?`, `copiedCaption?`, `failureHint?`, `onCopy?`.
 - `shellTokens(command)` returns `ShellToken[]`; it throws on unbalanced quotes.
 - `formatLongDate(isoDate)` formats an ISO date for `PageTitle`.
+- `Reference`: `id`, `authors`, `title`, `venue` (strings), `year` (number),
+  `url?`.
+- `createCitationRegistry()` returns a `CitationRegistry`. Create one per
+  page and pass it to every `Cite`, `CiteGroup` and `References` on that page.
+  It numbers sources by first citation, so `References` must render after
+  every marker; it lists only cited sources and throws when a cited `id` has
+  no `Reference` in `items`.
+- `BackLinkLabel(number, occurrence, occurrences)` returns the screen-reader
+  name of one back-link.
 - `cn(...classes)` merges class names.
 
 `bun run build` also emits declarations in `dist/index.d.ts`.
@@ -139,6 +154,8 @@ Copy, captions and labels are props with neutral English defaults.
 | `CommandBlock` | `copy`, `copyLabel`, `copyAllCaption`, `copyAllLabel`, `note`, `lead`    |
 | `PageTitle`    | `changedLabel`, `formatDate(isoDate)`                                    |
 | `SkipLink`     | `label`                                                                  |
+| `References`   | `sourceLabel`, `backLinkLabel(number, occurrence, occurrences)`          |
+| `Screenshot`   | `alt` (required), `caption` (required)                                   |
 
 `CopyButton` reports a successful copy through `onCopy`. The consumer attaches
 analytics there; the package contains none.

package/dist/components/cite-group.d.ts

@@ -0,0 +1,6 @@
+import { type ReactElement } from "react";
+import { type CitationRegistry } from "../lib/citation-registry.ts";
+export declare function CiteGroup({ ids, registry, }: {
+    readonly ids: readonly string[];
+    readonly registry: CitationRegistry;
+}): ReactElement;

package/dist/components/cite-group.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment } from "react";
+import { CitationAnchor } from "../lib/citation-anchor.js";
+import { registerCitation, } from "../lib/citation-registry.js";
+export function CiteGroup({ ids, registry, }) {
+    const cited = ids.map((id) => ({ id, ...registerCitation(id, registry) }));
+    return (_jsxs("span", { className: "whitespace-nowrap", children: ["[", cited.map(({ id, number, occurrence }, index) => (_jsxs(Fragment, { children: [index > 0 ? ", " : null, _jsx(CitationAnchor, { id: id, occurrence: occurrence, children: String(number) })] }, id))), "]"] }));
+}
+//# sourceMappingURL=cite-group.js.map

package/dist/components/cite-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cite-group.js","sourceRoot":"","sources":["../../src/components/cite-group.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAqB,MAAM,OAAO,CAAA;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA4B,CAAA;AAC3D,OAAO,EACL,gBAAgB,GAEjB,MAAM,6BAA6B,CAAA;AAEpC,MAAM,UAAU,SAAS,CAAC,EACxB,GAAG,EACH,QAAQ,GAIT;IACC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;IAE1E,OAAO,CACL,gBAAM,SAAS,EAAC,mBAAmB,aAChC,GAAG,EACH,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAChD,MAAC,QAAQ,eACN,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EACxB,KAAC,cAAc,IAAC,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,YAC3C,MAAM,CAAC,MAAM,CAAC,GACA,KAJJ,EAAE,CAKN,CACZ,CAAC,EACD,GAAG,IACC,CACR,CAAA;AACH,CAAC"}

package/dist/components/cite.d.ts

@@ -0,0 +1,6 @@
+import type { ReactElement } from "react";
+import { type CitationRegistry } from "../lib/citation-registry.ts";
+export declare function Cite({ id, registry, }: {
+    readonly id: string;
+    readonly registry: CitationRegistry;
+}): ReactElement;

package/dist/components/cite.js

@@ -0,0 +1,8 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { CitationAnchor } from "../lib/citation-anchor.js";
+import { registerCitation, } from "../lib/citation-registry.js";
+export function Cite({ id, registry, }) {
+    const { number, occurrence } = registerCitation(id, registry);
+    return (_jsxs(CitationAnchor, { id: id, occurrence: occurrence, children: ["[", number, "]"] }));
+}
+//# sourceMappingURL=cite.js.map

package/dist/components/cite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cite.js","sourceRoot":"","sources":["../../src/components/cite.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA4B,CAAA;AAC3D,OAAO,EACL,gBAAgB,GAEjB,MAAM,6BAA6B,CAAA;AAEpC,MAAM,UAAU,IAAI,CAAC,EACnB,EAAE,EACF,QAAQ,GAIT;IACC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAE7D,OAAO,CACL,MAAC,cAAc,IAAC,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,kBAC1C,MAAM,SACO,CAClB,CAAA;AACH,CAAC"}

package/dist/components/copy-button.d.ts

@@ -3,11 +3,11 @@ export type CopyText = {
     readonly failureHint?: string;
     readonly caption?: string;
     readonly copiedCaption?: string;
+    readonly onCopy?: () => void;
 };
 type CopyButtonProps = CopyText & {
     readonly text: string;
     readonly label: string;
-    readonly onCopy?: () => void;
 };
 export declare function CopyButton({ text, label, failureHint, caption, copiedCaption, onCopy, }: CopyButtonProps): ReactElement;
 export {};

package/dist/components/references.d.ts

@@ -0,0 +1,10 @@
+import { type ReactElement } from "react";
+import type { CitationRegistry } from "../lib/citation-registry.ts";
+import type { Reference } from "../lib/reference.ts";
+export type BackLinkLabel = (number: number, occurrence: number, occurrences: number) => string;
+export declare function References({ items, registry, sourceLabel, backLinkLabel, }: {
+    readonly items: readonly Reference[];
+    readonly registry: CitationRegistry;
+    readonly sourceLabel?: string;
+    readonly backLinkLabel?: BackLinkLabel;
+}): ReactElement;

package/dist/components/references.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment } from "react";
+const defaultBackLinkLabel = (number, occurrence, occurrences) => occurrences > 1
+    ? `Back to citation ${String(number)}, occurrence ${String(occurrence)} of ${String(occurrences)}`
+    : `Back to citation ${String(number)}`;
+export function References({ items, registry, sourceLabel = "Source", backLinkLabel = defaultBackLinkLabel, }) {
+    return (_jsx("ol", { className: "mt-4 flex flex-col gap-3 font-display text-[0.85rem] leading-[1.6]", children: registry.citedIds().map((id) => {
+            const reference = items.find((item) => item.id === id);
+            if (reference === undefined) {
+                throw new Error(`References has no entry for the cited id "${id}". Add a Reference with that id to items, or remove the citation.`);
+            }
+            const occurrences = registry.occurrenceCount(id);
+            const number = registry.numberOf(id);
+            const backLinks = Array.from({ length: Math.max(occurrences, 1) }, (_value, index) => index + 1);
+            return (_jsxs("li", { id: `ref-${id}`, children: [reference.authors, " (", reference.year, "). ", reference.title, ".", " ", reference.venue, ".", reference.url === undefined ? null : (_jsxs(_Fragment, { children: [" ", _jsx("a", { href: reference.url, className: "link", children: sourceLabel })] })), backLinks.map((occurrence) => (_jsxs(Fragment, { children: [" ", _jsxs("a", { href: `#cite-${id}-${String(occurrence)}`, className: "link", children: [_jsx("span", { className: "sr-only", children: backLinkLabel(number, occurrence, occurrences) }), _jsx("span", { "aria-hidden": "true", children: occurrences > 1 ? `^${String(occurrence)}` : "^" })] })] }, occurrence)))] }, id));
+        }) }));
+}
+//# sourceMappingURL=references.js.map

package/dist/components/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/components/references.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAqB,MAAM,OAAO,CAAA;AAWnD,MAAM,oBAAoB,GAAkB,CAC1C,MAAM,EACN,UAAU,EACV,WAAW,EACX,EAAE,CACF,WAAW,GAAG,CAAC;IACb,CAAC,CAAC,oBAAoB,MAAM,CAAC,MAAM,CAAC,gBAAgB,MAAM,CAAC,UAAU,CAAC,OAAO,MAAM,CAAC,WAAW,CAAC,EAAE;IAClG,CAAC,CAAC,oBAAoB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAA;AAE1C,MAAM,UAAU,UAAU,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,WAAW,GAAG,QAAQ,EACtB,aAAa,GAAG,oBAAoB,GAMrC;IACC,OAAO,CACL,aAAI,SAAS,EAAC,oEAAoE,YAC/E,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;YACtD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,6CAA6C,EAAE,mEAAmE,CACnH,CAAA;YACH,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;YAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;YACpC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAC1B,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EACpC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAC7B,CAAA;YAED,OAAO,CACL,cAAI,EAAE,EAAE,OAAO,EAAE,EAAE,aAChB,SAAS,CAAC,OAAO,QAAI,SAAS,CAAC,IAAI,SAAK,SAAS,CAAC,KAAK,OAAG,GAAG,EAC7D,SAAS,CAAC,KAAK,OACf,SAAS,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACpC,8BACG,GAAG,EACJ,YAAG,IAAI,EAAE,SAAS,CAAC,GAAG,EAAE,SAAS,EAAC,MAAM,YACrC,WAAW,GACV,IACH,CACJ,EACA,SAAS,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAC7B,MAAC,QAAQ,eACN,GAAG,EACJ,aAAG,IAAI,EAAE,SAAS,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAC,MAAM,aAC5D,eAAM,SAAS,EAAC,SAAS,YACtB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,GAC1C,EACP,8BAAkB,MAAM,YACrB,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAC5C,IACL,KATS,UAAU,CAUd,CACZ,CAAC,KAvBsB,EAAE,CAwBvB,CACN,CAAA;QACH,CAAC,CAAC,GACC,CACN,CAAA;AACH,CAAC"}

package/dist/components/screenshot.d.ts

@@ -0,0 +1,8 @@
+import type { ReactElement, ReactNode } from "react";
+export declare function Screenshot({ src, alt, width, height, caption, }: {
+    readonly src: string;
+    readonly alt: string;
+    readonly width: number;
+    readonly height: number;
+    readonly caption: ReactNode;
+}): ReactElement;

package/dist/components/screenshot.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function Screenshot({ src, alt, width, height, caption, }) {
+    return (_jsxs("figure", { className: "flex flex-col gap-2", children: [_jsx("div", { className: "border border-line bg-paper-inset p-1.5", children: _jsx("img", { src: src, alt: alt, width: width, height: height, loading: "lazy", decoding: "async", className: "block h-auto w-full" }) }), _jsx("figcaption", { className: "text-right font-mono text-[0.75rem] leading-normal text-muted", children: caption })] }));
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/components/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/components/screenshot.tsx"],"names":[],"mappings":";AAEA,MAAM,UAAU,UAAU,CAAC,EACzB,GAAG,EACH,GAAG,EACH,KAAK,EACL,MAAM,EACN,OAAO,GAOR;IACC,OAAO,CACL,kBAAQ,SAAS,EAAC,qBAAqB,aACrC,cAAK,SAAS,EAAC,yCAAyC,YACtD,cACE,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAC,MAAM,EACd,QAAQ,EAAC,OAAO,EAChB,SAAS,EAAC,qBAAqB,GAC/B,GACE,EACN,qBAAY,SAAS,EAAC,+DAA+D,YAClF,OAAO,GACG,IACN,CACV,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export { shellTokens, type ShellToken } from "./lib/shell-tokens.ts";
 export { formatLongDate } from "./lib/iso-date.ts";
 export type { PlateAsset } from "./lib/plate-asset.ts";
 export type { CommandStep } from "./lib/command-step.ts";
+export type { Reference } from "./lib/reference.ts";
+export { createCitationRegistry, type CitationRegistry, } from "./lib/citation-registry.ts";
 export { ChevronIcon } from "./components/chevron-icon.tsx";
 export { PageSection } from "./components/page-section.tsx";
 export { PageShell } from "./components/page-shell.tsx";
@@ -17,3 +19,7 @@ export { PlateHeader } from "./components/plate-header.tsx";
 export { StatusPage } from "./components/status-page.tsx";
 export { Button } from "./components/ui/button.tsx";
 export { CopyButton, type CopyText } from "./components/copy-button.tsx";
+export { Cite } from "./components/cite.tsx";
+export { CiteGroup } from "./components/cite-group.tsx";
+export { References, type BackLinkLabel } from "./components/references.tsx";
+export { Screenshot } from "./components/screenshot.tsx";

package/dist/index.js

@@ -1,6 +1,7 @@
 export { cn } from "./lib/utils.js";
 export { shellTokens } from "./lib/shell-tokens.js";
 export { formatLongDate } from "./lib/iso-date.js";
+export { createCitationRegistry, } from "./lib/citation-registry.js";
 export { ChevronIcon } from "./components/chevron-icon.js";
 export { PageSection } from "./components/page-section.js";
 export { PageShell } from "./components/page-shell.js";
@@ -15,4 +16,8 @@ export { PlateHeader } from "./components/plate-header.js";
 export { StatusPage } from "./components/status-page.js";
 export { Button } from "./components/ui/button.js";
 export { CopyButton } from "./components/copy-button.js";
+export { Cite } from "./components/cite.js";
+export { CiteGroup } from "./components/cite-group.js";
+export { References } from "./components/references.js";
+export { Screenshot } from "./components/screenshot.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AACnC,OAAO,EAAE,WAAW,EAAmB,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGlD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA+B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA+B,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA6B,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA6B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAkC,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAAgC,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA+B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAAgC,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA4B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAwB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA+B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA8B,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA4B,CAAA;AACnD,OAAO,EAAE,UAAU,EAAiB,MAAM,6BAA8B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AACnC,OAAO,EAAE,WAAW,EAAmB,MAAM,uBAAuB,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIlD,OAAO,EACL,sBAAsB,GAEvB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA+B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA+B,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA6B,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA6B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAkC,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAAgC,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA+B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAAgC,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA4B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAwB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA+B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA8B,CAAA;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA4B,CAAA;AACnD,OAAO,EAAE,UAAU,EAAiB,MAAM,6BAA8B,CAAA;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAuB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA6B,CAAA;AACvD,OAAO,EAAE,UAAU,EAAsB,MAAM,4BAA6B,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA6B,CAAA"}

package/dist/lib/citation-anchor.d.ts

@@ -0,0 +1,6 @@
+import type { ReactElement, ReactNode } from "react";
+export declare function CitationAnchor({ id, occurrence, children, }: {
+    readonly id: string;
+    readonly occurrence: number;
+    readonly children: ReactNode;
+}): ReactElement;

package/dist/lib/citation-anchor.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+export function CitationAnchor({ id, occurrence, children, }) {
+    return (_jsx("a", { id: `cite-${id}-${String(occurrence)}`, href: `#ref-${id}`, className: "text-ink hover:text-sprout", children: children }));
+}
+//# sourceMappingURL=citation-anchor.js.map

package/dist/lib/citation-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-anchor.js","sourceRoot":"","sources":["../../src/lib/citation-anchor.tsx"],"names":[],"mappings":";AAEA,MAAM,UAAU,cAAc,CAAC,EAC7B,EAAE,EACF,UAAU,EACV,QAAQ,GAKT;IACC,OAAO,CACL,YACE,EAAE,EAAE,QAAQ,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,EACtC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAClB,SAAS,EAAC,4BAA4B,YAErC,QAAQ,GACP,CACL,CAAA;AACH,CAAC"}

package/dist/lib/citation-registry.d.ts

@@ -0,0 +1,11 @@
+export type CitationRegistry = {
+    readonly numberOf: (id: string) => number;
+    readonly recordOccurrence: (id: string) => number;
+    readonly citedIds: () => readonly string[];
+    readonly occurrenceCount: (id: string) => number;
+};
+export declare function createCitationRegistry(): CitationRegistry;
+export declare function registerCitation(id: string, registry: CitationRegistry): {
+    readonly number: number;
+    readonly occurrence: number;
+};

package/dist/lib/citation-registry.js

@@ -0,0 +1,31 @@
+export function createCitationRegistry() {
+    const order = [];
+    const occurrences = new Map();
+    return {
+        numberOf(id) {
+            let position = order.indexOf(id);
+            if (position === -1) {
+                order.push(id);
+                position = order.length - 1;
+            }
+            return position + 1;
+        },
+        recordOccurrence(id) {
+            const next = (occurrences.get(id) ?? 0) + 1;
+            occurrences.set(id, next);
+            return next;
+        },
+        citedIds() {
+            return order;
+        },
+        occurrenceCount(id) {
+            return occurrences.get(id) ?? 0;
+        },
+    };
+}
+export function registerCitation(id, registry) {
+    const number = registry.numberOf(id);
+    const occurrence = registry.recordOccurrence(id);
+    return { number, occurrence };
+}
+//# sourceMappingURL=citation-registry.js.map

package/dist/lib/citation-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-registry.js","sourceRoot":"","sources":["../../src/lib/citation-registry.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,sBAAsB;IACpC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAA;IAE7C,OAAO;QACL,QAAQ,CAAC,EAAE;YACT,IAAI,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YAChC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACd,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;YAC7B,CAAC;YACD,OAAO,QAAQ,GAAG,CAAC,CAAA;QACrB,CAAC;QACD,gBAAgB,CAAC,EAAE;YACjB,MAAM,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YAC3C,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;YACzB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,QAAQ;YACN,OAAO,KAAK,CAAA;QACd,CAAC;QACD,eAAe,CAAC,EAAE;YAChB,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;QACjC,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,EAAU,EACV,QAA0B;IAE1B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACpC,MAAM,UAAU,GAAG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAA;IAEhD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;AAC/B,CAAC"}

package/dist/lib/reference.d.ts

@@ -0,0 +1,8 @@
+export type Reference = {
+    readonly id: string;
+    readonly authors: string;
+    readonly year: number;
+    readonly title: string;
+    readonly venue: string;
+    readonly url?: string;
+};

package/dist/lib/reference.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reference.js.map

package/dist/lib/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../../src/lib/reference.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openbunny/react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "license": "MIT",
   "description": "Generic React components for OpenBunny sites.",