@edoxen/browser 0.1.0

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@edoxen/browser",
+  "version": "0.1.0",
+  "description": "Astro-based browser for edoxen YAML data — drop in your data and ship a resolutions archive site.",
+  "type": "module",
+  "license": "BSD-2-Clause",
+  "author": "Edoxen Project contributors",
+  "homepage": "https://github.com/edoxen/browser",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edoxen/browser.git",
+    "directory": "packages/browser"
+  },
+  "bugs": {
+    "url": "https://github.com/edoxen/browser/issues"
+  },
+  "keywords": [
+    "astro",
+    "edoxen",
+    "resolutions",
+    "standards",
+    "iso",
+    "oiml"
+  ],
+  "sideEffects": false,
+  "bin": {
+    "edoxen-browser": "./dist/cli.js"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./config": "./src/config/index.ts",
+    "./data": "./src/data/index.ts",
+    "./seo": "./src/seo/index.ts",
+    "./i18n": "./src/i18n/index.ts",
+    "./integration": "./src/integration.ts",
+    "./package.json": "./package.json"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "files": [
+    "src/",
+    "styles/",
+    "dist/cli.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "build:cli": "tsup",
+    "prepublishOnly": "pnpm build:cli",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@edoxen/edoxen": "^0.2.0",
+    "ajv": "^8.17.0",
+    "astro": "^4.0.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "@edoxen/edoxen": "link:../../../edoxen-js/packages/edoxen",
+    "@types/node": "^22.10.0",
+    "ajv": "^8.17.0",
+    "astro": "^5.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.0",
+    "yaml": "^2.6.0",
+    "zod": "^3.23.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@astrojs/sitemap": "^3.7.3",
+    "jiti": "^2.4.0"
+  }
+}

package/src/astro/components/ActionTypeBadge.astro

@@ -0,0 +1,28 @@
+---
+import { actionTypeColor, actionTypeLabel } from '@edoxen/edoxen'
+
+interface Props {
+  kind: string
+}
+const { kind } = Astro.props
+const color = actionTypeColor(kind)
+const label = actionTypeLabel(kind)
+const style = color ? `background:${color};color:#fff` : undefined
+---
+
+{kind && (
+  <span class="edoxen-action-badge" style={style}>{label}</span>
+)}
+
+<style>
+.edoxen-action-badge {
+  display: inline-block;
+  padding: 0.15rem 0.55rem;
+  border-radius: var(--edoxen-radius-sm);
+  font-size: 0.8rem;
+  font-weight: 500;
+  background: var(--edoxen-color-muted);
+  color: #fff;
+  text-transform: capitalize;
+}
+</style>

package/src/astro/components/AgendaTable.astro

@@ -0,0 +1,49 @@
+---
+import type { AgendaItem } from '@edoxen/edoxen'
+import { pickLocalizedValue } from '../../i18n/index.js'
+
+interface Props {
+  items: readonly AgendaItem[]
+  locale: string
+}
+const { items, locale } = Astro.props
+---
+
+<table class="edoxen-agenda">
+  <thead>
+    <tr><th scope="col">#</th><th scope="col">Title</th><th scope="col">Outcome</th></tr>
+  </thead>
+  <tbody>
+    {items.map((item) => (
+      <tr>
+        <td><code>{item.label}</code></td>
+        <td>{pickLocalizedValue(item.title, locale, item.label ?? '')}</td>
+        <td>{item.outcome ?? ''}</td>
+      </tr>
+    ))}
+  </tbody>
+</table>
+
+<style>
+.edoxen-agenda {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.95rem;
+}
+.edoxen-agenda th,
+.edoxen-agenda td {
+  text-align: left;
+  padding: 0.5rem 0.75rem;
+  border-bottom: 1px solid var(--edoxen-color-border);
+}
+.edoxen-agenda th {
+  font-weight: 600;
+  color: var(--edoxen-color-muted);
+  text-transform: uppercase;
+  font-size: 0.75rem;
+  letter-spacing: 0.05em;
+}
+.edoxen-agenda code {
+  font-family: var(--edoxen-font-mono, ui-monospace, monospace);
+}
+</style>

package/src/astro/components/BodyBadge.astro

@@ -0,0 +1,28 @@
+---
+import cfg from 'virtual:edoxen-config'
+
+interface Props {
+  code?: string
+}
+const { code } = Astro.props
+const body = code ? cfg.bodies.find((b) => b.code === code) : undefined
+const style = body?.color
+  ? `background:${body.color};color:${body.textColor ?? '#ffffff'}`
+  : undefined
+---
+
+{code && (
+  <span class="edoxen-badge" style={style}>{body?.name ?? code}</span>
+)}
+
+<style>
+.edoxen-badge {
+  display: inline-block;
+  padding: 0.15rem 0.55rem;
+  border-radius: var(--edoxen-radius-sm);
+  font-size: 0.8rem;
+  font-weight: 500;
+  background: var(--edoxen-color-muted);
+  color: #fff;
+}
+</style>

package/src/astro/components/CommitteeCard.astro

@@ -0,0 +1,58 @@
+---
+import type { MeetingSeries } from '@edoxen/edoxen'
+import { pickLocalizedValue } from '../../i18n/index.js'
+
+interface Props {
+  committee?: MeetingSeries | null
+  locale: string
+}
+const { committee, locale } = Astro.props
+const name = committee ? pickLocalizedValue(committee.name, locale, committee.urn ?? 'Committee') : ''
+const description = committee ? pickLocalizedValue(committee.description, locale) : ''
+const identifiers = committee?.identifier ?? []
+---
+
+{committee && (
+  <article class="edoxen-committee-card">
+    {name && <h2 class="edoxen-committee-card__name">{name}</h2>}
+    {description && <p class="edoxen-committee-card__desc">{description}</p>}
+    {identifiers.length > 0 && (
+      <dl class="edoxen-committee-card__ids">
+        {identifiers.map((id) => (
+          <>
+            <dt>{id.prefix}</dt>
+            <dd>{id.number}</dd>
+          </>
+        ))}
+      </dl>
+    )}
+  </article>
+)}
+
+<style>
+.edoxen-committee-card {
+  border: 1px solid var(--edoxen-color-border);
+  border-radius: var(--edoxen-radius-sm);
+  background: var(--edoxen-color-surface);
+  padding: 1rem 1.25rem;
+}
+.edoxen-committee-card__name {
+  margin: 0 0 0.5rem;
+  font-size: 1.1rem;
+}
+.edoxen-committee-card__desc {
+  margin: 0 0 0.75rem;
+  color: var(--edoxen-color-text);
+}
+.edoxen-committee-card__ids {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 0.25rem 0.75rem;
+  margin: 0;
+  font-size: 0.85rem;
+  color: var(--edoxen-color-muted);
+}
+.edoxen-committee-card__ids dt {
+  font-weight: 500;
+}
+</style>

package/src/astro/components/CountryFlag.astro

@@ -0,0 +1,34 @@
+---
+import { countryFlag } from '@edoxen/edoxen'
+
+interface Props {
+  countryCode?: string
+  city?: string
+}
+const { countryCode, city } = Astro.props
+const flag = countryCode ? countryFlag(countryCode) : ''
+---
+
+{(city || countryCode) && (
+  <span class="edoxen-venue">
+    {flag && <span class="edoxen-venue__flag" aria-hidden="true">{flag}</span>}
+    {city && <span class="edoxen-venue__city">{city}</span>}
+    {countryCode && <span class="edoxen-venue__code">{countryCode}</span>}
+  </span>
+)}
+
+<style>
+.edoxen-venue {
+  display: inline-flex;
+  gap: 0.4rem;
+  align-items: center;
+}
+.edoxen-venue__flag {
+  font-size: 1.2em;
+}
+.edoxen-venue__code {
+  color: var(--edoxen-color-muted);
+  font-size: 0.85em;
+  font-family: var(--edoxen-font-mono, ui-monospace, monospace);
+}
+</style>

package/src/astro/components/DecadeTimeline.astro

@@ -0,0 +1,52 @@
+---
+interface Props {
+  decades: readonly number[]
+  active?: number
+}
+const { decades, active } = Astro.props
+const sorted = [...decades].sort((a, b) => b - a)
+---
+
+{sorted.length > 0 && (
+  <nav class="edoxen-decade-timeline" aria-label="Browse by decade">
+    {sorted.map((d) => (
+      <a
+        href={`#decade-${d}`}
+        class={`edoxen-decade-timeline__link${active === d ? ' edoxen-decade-timeline__link--active' : ''}`}
+      >
+        <span class="edoxen-decade-timeline__decade">{d}s</span>
+      </a>
+    ))}
+  </nav>
+)}
+
+<style>
+.edoxen-decade-timeline {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  margin-bottom: 1.5rem;
+  font-size: 0.85rem;
+}
+.edoxen-decade-timeline__link {
+  padding: 0.3rem 0.7rem;
+  border: 1px solid var(--edoxen-color-border);
+  border-radius: var(--edoxen-radius-sm);
+  text-decoration: none;
+  color: var(--edoxen-color-text);
+  background: var(--edoxen-color-surface);
+}
+.edoxen-decade-timeline__link:hover {
+  background: var(--edoxen-color-accent);
+  color: #fff;
+  border-color: var(--edoxen-color-accent);
+}
+.edoxen-decade-timeline__link--active {
+  background: var(--edoxen-color-accent);
+  color: #fff;
+  border-color: var(--edoxen-color-accent);
+}
+.edoxen-decade-timeline__decade {
+  font-weight: 500;
+}
+</style>

package/src/astro/components/DecisionList.astro

@@ -0,0 +1,66 @@
+---
+import type { DecisionListItem } from '../../data/index.js'
+
+interface Props {
+  items: readonly DecisionListItem[]
+  compact?: boolean
+}
+const { items, compact = false } = Astro.props
+const listClass = compact ? 'edoxen-decision-list edoxen-decision-list--compact' : 'edoxen-decision-list'
+---
+
+{items.length === 0 ? (
+  <p class="edoxen-empty">No decisions.</p>
+) : (
+  <ul class={listClass}>
+    {items.map((d) => (
+      <li class="edoxen-decision-list__item">
+        <a href={`/decisions/${encodeURIComponent(d.urn)}`}>{d.title}</a>
+        {!compact && (
+          <dl class="edoxen-decision-list__meta">
+            <dt>URN</dt>
+            <dd><code>{d.urn}</code></dd>
+            {d.bodyType && <><dt>Body</dt><dd>{d.bodyType}</dd></>}
+            {d.kind && <><dt>Kind</dt><dd>{d.kind}</dd></>}
+            {d.dates[0]?.date && <><dt>Date</dt><dd>{d.dates[0].date}</dd></>}
+          </dl>
+        )}
+      </li>
+    ))}
+  </ul>
+)}
+
+<style>
+.edoxen-decision-list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+.edoxen-decision-list__item {
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--edoxen-color-border);
+  border-radius: var(--edoxen-radius-sm);
+  background: var(--edoxen-color-surface);
+}
+.edoxen-decision-list__item a {
+  font-weight: 500;
+  color: var(--edoxen-color-text);
+}
+.edoxen-decision-list__meta {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 0.25rem 1rem;
+  margin: 0.5rem 0 0;
+  font-size: 0.85rem;
+  color: var(--edoxen-color-muted);
+}
+.edoxen-decision-list__meta dt {
+  font-weight: 500;
+}
+.edoxen-decision-list--compact .edoxen-decision-list__item {
+  padding: 0.5rem 0.75rem;
+}
+</style>

package/src/astro/components/EmptyState.astro

@@ -0,0 +1,19 @@
+---
+interface Props {
+  message?: string
+}
+const { message = 'Nothing here.' } = Astro.props
+---
+
+<p class="edoxen-empty-state">{message}</p>
+
+<style>
+.edoxen-empty-state {
+  padding: 2rem 1rem;
+  text-align: center;
+  color: var(--edoxen-color-muted);
+  border: 1px dashed var(--edoxen-color-border);
+  border-radius: var(--edoxen-radius-sm);
+  background: var(--edoxen-color-surface);
+}
+</style>

package/src/astro/components/LocaleTabs.astro

@@ -0,0 +1,44 @@
+---
+interface Props {
+  spellings: readonly string[]
+  active: string
+  field: string
+}
+const { spellings, active, field } = Astro.props
+---
+
+{spellings.length > 1 && (
+  <nav class="edoxen-locale-tabs" aria-label={`Available languages for ${field}`} data-field={field}>
+    {spellings.map((sp) => (
+      <button type="button" class="edoxen-locale-tabs__tab" data-spelling={sp} aria-pressed={sp === active}>
+        {sp}
+      </button>
+    ))}
+  </nav>
+)}
+
+<style>
+.edoxen-locale-tabs {
+  display: inline-flex;
+  gap: 0.25rem;
+  margin: 0.5rem 0 1rem;
+  padding: 0.25rem;
+  border: 1px solid var(--edoxen-color-border);
+  border-radius: var(--edoxen-radius-sm);
+  background: var(--edoxen-color-surface);
+}
+.edoxen-locale-tabs__tab {
+  border: 0;
+  background: transparent;
+  color: var(--edoxen-color-muted);
+  padding: 0.25rem 0.6rem;
+  border-radius: calc(var(--edoxen-radius-sm) * 0.75);
+  cursor: pointer;
+  font-size: 0.8rem;
+  font-family: var(--edoxen-font-mono, ui-monospace, monospace);
+}
+.edoxen-locale-tabs__tab[aria-pressed='true'] {
+  background: var(--edoxen-color-accent);
+  color: #fff;
+}
+</style>

package/src/astro/components/MeetingList.astro

@@ -0,0 +1,63 @@
+---
+import type { MeetingListItem } from '../../data/index.js'
+
+interface Props {
+  items: readonly MeetingListItem[]
+  compact?: boolean
+}
+const { items, compact = false } = Astro.props
+const listClass = compact ? 'edoxen-meeting-list edoxen-meeting-list--compact' : 'edoxen-meeting-list'
+---
+
+{items.length === 0 ? (
+  <p class="edoxen-empty">No meetings.</p>
+) : (
+  <ul class={listClass}>
+    {items.map((m) => (
+      <li class="edoxen-meeting-list__item">
+        <a href={`/meetings/${encodeURIComponent(m.urn)}`}>{m.title}</a>
+        {!compact && (
+          <dl class="edoxen-meeting-list__meta">
+            <dt>URN</dt>
+            <dd><code>{m.urn}</code></dd>
+            {m.startDate && <><dt>Start</dt><dd>{m.startDate}</dd></>}
+            {m.city && <><dt>Venue</dt><dd>{m.city}{m.countryCode && ` (${m.countryCode})`}</dd></>}
+            {m.bodyType && <><dt>Body</dt><dd>{m.bodyType}</dd></>}
+          </dl>
+        )}
+      </li>
+    ))}
+  </ul>
+)}
+
+<style>
+.edoxen-meeting-list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+.edoxen-meeting-list__item {
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--edoxen-color-border);
+  border-radius: var(--edoxen-radius-sm);
+  background: var(--edoxen-color-surface);
+}
+.edoxen-meeting-list__item a {
+  font-weight: 500;
+  color: var(--edoxen-color-text);
+}
+.edoxen-meeting-list__meta {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 0.25rem 1rem;
+  margin: 0.5rem 0 0;
+  font-size: 0.85rem;
+  color: var(--edoxen-color-muted);
+}
+.edoxen-meeting-list__meta dt {
+  font-weight: 500;
+}
+</style>

package/src/astro/components/MinutesSection.astro

@@ -0,0 +1,59 @@
+---
+import type { Minutes} from '@edoxen/edoxen'
+import { pickLocalizedValue } from '../../i18n/index.js'
+
+interface Props {
+  minutes: Minutes
+  locale: string
+}
+const { minutes, locale } = Astro.props
+const sections = minutes.sections ?? []
+const spelling = minutes.spelling ?? locale
+---
+
+<article class="edoxen-minutes" data-spelling={spelling}>
+  <header>
+    <h3>Minutes{spelling ? ` — ${spelling}` : ''}</h3>
+    {minutes.urn && <p><code>{minutes.urn}</code></p>}
+  </header>
+  {sections.map((section) => (
+    <section class="edoxen-minutes__section">
+      <h4>{section.number}. {pickLocalizedValue(section.title, locale, '(untitled)')}</h4>
+      <div class="edoxen-minutes__narrative">
+        {pickLocalizedValue(section.narrative, locale)}
+      </div>
+    </section>
+  ))}
+</article>
+
+<style>
+.edoxen-minutes {
+  border: 1px solid var(--edoxen-color-border);
+  border-radius: var(--edoxen-radius-sm);
+  padding: 1rem 1.25rem;
+  background: var(--edoxen-color-surface);
+  margin-bottom: 1rem;
+}
+.edoxen-minutes h3 {
+  margin: 0 0 0.5rem;
+  font-size: 1.05rem;
+}
+.edoxen-minutes__section {
+  margin-top: 1rem;
+}
+.edoxen-minutes__section h4 {
+  margin: 0 0 0.5rem;
+  font-size: 0.95rem;
+  font-weight: 600;
+}
+.edoxen-minutes__narrative {
+  font-size: 0.95rem;
+  line-height: 1.5;
+  white-space: pre-wrap;
+  color: var(--edoxen-color-text);
+}
+.edoxen-minutes code {
+  font-family: var(--edoxen-font-mono, ui-monospace, monospace);
+  font-size: 0.85rem;
+}
+</style>

package/src/astro/components/OfficerList.astro

@@ -0,0 +1,49 @@
+---
+import type { Officer } from '@edoxen/edoxen'
+
+interface Props {
+  officers: readonly Officer[]
+}
+const { officers } = Astro.props
+---
+
+{officers.length > 0 && (
+  <ul class="edoxen-officer-list">
+    {officers.map((o) => (
+      <li class="edoxen-officer-list__item">
+        <span class="edoxen-officer-list__role">{o.role}</span>
+        {o.person && (
+          <span class="edoxen-officer-list__name">
+            {o.person.name?.map((n) => n.value).filter(Boolean).join(' ') || ''}
+          </span>
+        )}
+      </li>
+    ))}
+  </ul>
+)}
+
+<style>
+.edoxen-officer-list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.4rem;
+}
+.edoxen-officer-list__item {
+  display: flex;
+  gap: 0.75rem;
+  padding: 0.4rem 0;
+  border-bottom: 1px solid var(--edoxen-color-border);
+}
+.edoxen-officer-list__role {
+  font-weight: 500;
+  text-transform: capitalize;
+  min-width: 8rem;
+  color: var(--edoxen-color-muted);
+}
+.edoxen-officer-list__name {
+  color: var(--edoxen-color-text);
+}
+</style>

package/src/astro/components/PageHero.astro

@@ -0,0 +1,42 @@
+---
+interface Props {
+  title: string
+  subtitle?: string
+  logo?: string
+}
+const { title, subtitle, logo } = Astro.props
+---
+
+<header class="edoxen-page-hero">
+  {logo && <img src={logo} alt="" class="edoxen-page-hero__logo" />}
+  <div>
+    <h1 class="edoxen-page-hero__title">{title}</h1>
+    {subtitle && <p class="edoxen-page-hero__subtitle">{subtitle}</p>}
+  </div>
+</header>
+
+<style>
+.edoxen-page-hero {
+  display: flex;
+  align-items: center;
+  gap: 1.5rem;
+  padding: 2rem 0;
+  margin-bottom: 1.5rem;
+  border-bottom: 1px solid var(--edoxen-color-border);
+}
+.edoxen-page-hero__logo {
+  max-height: 4rem;
+  width: auto;
+}
+.edoxen-page-hero__title {
+  margin: 0;
+  font-size: 2rem;
+  font-weight: 700;
+  letter-spacing: -0.01em;
+}
+.edoxen-page-hero__subtitle {
+  margin: 0.25rem 0 0;
+  color: var(--edoxen-color-muted);
+  font-size: 1.05rem;
+}
+</style>