@edoxen/browser 0.1.0

package/src/astro/pages/[lang]/meetings/index.astro

@@ -0,0 +1,27 @@
+---
+import cfg from 'virtual:edoxen-config'
+import payloads from 'virtual:edoxen-payloads'
+import BaseLayout from '../../../layouts/BaseLayout.astro'
+import MeetingList from '../../../components/MeetingList.astro'
+import DecadeTimeline from '../../../components/DecadeTimeline.astro'
+
+export function getStaticPaths() {
+  return cfg.locales
+    .filter((l) => (l.routePrefix ?? '') !== '')
+    .map((l) => ({ params: { lang: l.code } }))
+}
+
+const items = payloads.meetingsList.items
+const decades = payloads.meetingsList.facets.decades
+const lang = Astro.params.lang ?? cfg.site.locale
+---
+
+<BaseLayout config={cfg} lang={lang} title={`Meetings — ${cfg.site.title}`}>
+  <h1>Meetings</h1>
+
+  <decade-scroller>
+    <DecadeTimeline decades={decades} />
+  </decade-scroller>
+
+  <MeetingList items={items} />
+</BaseLayout>

package/src/astro/pages/about.astro

@@ -0,0 +1,65 @@
+---
+import cfg from 'virtual:edoxen-config'
+import payloads from 'virtual:edoxen-payloads'
+import BaseLayout from '../layouts/BaseLayout.astro'
+
+export function getStaticPaths() {
+  return cfg.locales
+    .filter((l) => (l.routePrefix ?? '') !== '')
+    .map((l) => ({ params: { lang: l.code } }))
+}
+
+const decisionCount = payloads.decisionsList.items.length
+const meetingCount = payloads.meetingsList.items.length
+---
+
+<BaseLayout config={cfg} title={`About — ${cfg.site.title}`}>
+  <h1>About</h1>
+
+  <section>
+    <h2>{cfg.site.title}</h2>
+    <p>{cfg.site.description}</p>
+    <dl class="edoxen-stats">
+      <div><dt>Decisions</dt><dd>{decisionCount}</dd></div>
+      <div><dt>Meetings</dt><dd>{meetingCount}</dd></div>
+    </dl>
+  </section>
+
+  <section>
+    <h2>Edoxen format</h2>
+    <p>
+      This site renders meeting and decision data using the
+      <a href="https://edoxen.github.io">Edoxen</a> information model — a
+      YAML-based schema for formal proceedings of standards bodies.
+    </p>
+  </section>
+
+  <section>
+    <h2>Using this site</h2>
+    <ul>
+      <li><strong>Decisions</strong> — browse the resolutions archive.</li>
+      <li><strong>Meetings</strong> — see meetings and their agendas, minutes, and adopted decisions.</li>
+      <li><strong>URNs</strong> — every entity has a stable URN for citation.</li>
+    </ul>
+  </section>
+</BaseLayout>
+
+<style>
+.edoxen-stats {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 1.5rem;
+  margin: 1rem 0 0;
+}
+.edoxen-stats dd {
+  margin: 0;
+  font-size: 1.5rem;
+  font-weight: 600;
+}
+.edoxen-stats dt {
+  font-size: 0.85rem;
+  color: var(--edoxen-color-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+</style>

package/src/astro/pages/decisions/[urn].astro

@@ -0,0 +1,122 @@
+---
+import cfg from 'virtual:edoxen-config'
+import payloads from 'virtual:edoxen-payloads'
+import DecisionLayout from '../../layouts/DecisionLayout.astro'
+import UrnBar from '../../components/UrnBar.astro'
+import BodyBadge from '../../components/BodyBadge.astro'
+import LocaleTabs from '../../components/LocaleTabs.astro'
+import { decisionJsonLd } from '../../../seo/index.js'
+import { pickLocalizedValue, availableSpellings } from '../../../i18n/index.js'
+
+export function getStaticPaths() {
+  return Object.keys(payloads.decisionByUrn).map((urn) => ({
+    params: { urn },
+    props: { decision: payloads.decisionByUrn[urn] },
+  }))
+}
+
+interface Props {
+  decision: typeof payloads.decisionByUrn[string]
+}
+const { decision } = Astro.props
+const locale = cfg.site.locale
+const title = pickLocalizedValue(decision.title, locale, decision.urn ?? '')
+const subject = pickLocalizedValue(decision.subject, locale)
+const considering = pickLocalizedValue(decision.considering, locale)
+const actions = decision.actions ?? []
+const considerations = decision.considerations ?? []
+const approvals = decision.approvals ?? []
+const titleSpellings = availableSpellings(decision.title)
+const jsonld = decisionJsonLd(decision, { siteUrl: cfg.site.url, siteTitle: cfg.site.title, defaultLocale: locale })
+---
+
+<DecisionLayout
+  config={cfg}
+  item={{
+    urn: decision.urn ?? '',
+    identifier: (decision.identifier[0]?.prefix ?? '') + '-' + (decision.identifier[0]?.number ?? ''),
+    title,
+    kind: decision.kind ?? '',
+    dates: (decision.dates ?? []).map((d) => ({ type: d.type ?? '', date: d.date ?? '' })),
+    bodyType: decision.body_type,
+  }}
+>
+  <script type="application/ld+json" set:html={JSON.stringify(jsonld)} is:inline />
+  <UrnBar urn={decision.urn ?? ''} />
+
+  {decision.body_type && <p><BodyBadge code={decision.body_type} /></p>}
+
+  {titleSpellings.length > 1 && <LocaleTabs spellings={titleSpellings} active={locale} field="title" />}
+
+  {subject && (
+    <section>
+      <h2>Subject</h2>
+      <p>{subject}</p>
+    </section>
+  )}
+
+  {considering && (
+    <section>
+      <h2>Considering</h2>
+      <p>{considering}</p>
+    </section>
+  )}
+
+  {considerations.length > 0 && (
+    <section>
+      <h2>Considerations</h2>
+      <ul>
+        {considerations.map((c) => (
+          <li>{c.kind}{c.references && c.references.length > 0 ? `: ${c.references.map((r) => r.urn).join(', ')}` : ''}</li>
+        ))}
+      </ul>
+    </section>
+  )}
+
+  {actions.length > 0 && (
+    <section>
+      <h2>Actions</h2>
+      <ul>
+        {actions.map((a) => (
+          <li>
+            <strong>{a.type}</strong>
+            {a.message && <div>{pickLocalizedValue(a.message, locale)}</div>}
+          </li>
+        ))}
+      </ul>
+    </section>
+  )}
+
+  {approvals.length > 0 && (
+    <section>
+      <h2>Approvals</h2>
+      <ul>
+        {approvals.map((a) => (
+          <li>{a.degree}{a.body ? ` — ${a.body}` : ''}{a.date ? ` (${a.date})` : ''}</li>
+        ))}
+      </ul>
+    </section>
+  )}
+
+  {(decision.dates ?? []).length > 0 && (
+    <section>
+      <h2>Dates</h2>
+      <ul>
+        {(decision.dates ?? []).map((d) => (
+          <li>{d.type}: {d.date}</li>
+        ))}
+      </ul>
+    </section>
+  )}
+
+  {(decision.urls ?? []).length > 0 && (
+    <section>
+      <h2>Reference documents</h2>
+      <ul>
+        {(decision.urls ?? []).map((u) => (
+          <li><a href={u.ref}>{u.kind ?? 'document'}</a></li>
+        ))}
+      </ul>
+    </section>
+  )}
+</DecisionLayout>

package/src/astro/pages/decisions/index.astro

@@ -0,0 +1,67 @@
+---
+import cfg from 'virtual:edoxen-config'
+import payloads from 'virtual:edoxen-payloads'
+import BaseLayout from '../../layouts/BaseLayout.astro'
+import DecisionList from '../../components/DecisionList.astro'
+
+const items = payloads.decisionsList.items
+const endpoint = `${cfg.site.basePath}data/decisions.json`.replace(/\/+/g, '/')
+---
+
+<BaseLayout config={cfg} title={`Decisions — ${cfg.site.title}`}>
+  <h1>Decisions</h1>
+
+  <search-filter data-endpoint={endpoint} data-base-path="/decisions"></search-filter>
+  <noscript>
+    <DecisionList items={items} />
+  </noscript>
+</BaseLayout>
+
+<style>
+:global(search-filter) {
+  display: block;
+  margin: 1rem 0;
+}
+:global(.edoxen-search-filter__form) {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+:global(.edoxen-search-filter__facets) {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.4rem;
+}
+:global(.edoxen-search-filter__facet) {
+  border: 1px solid var(--edoxen-color-border);
+  background: var(--edoxen-color-surface);
+  color: var(--edoxen-color-text);
+  padding: 0.2rem 0.6rem;
+  border-radius: var(--edoxen-radius-sm);
+  font-size: 0.8rem;
+  cursor: pointer;
+}
+:global(.edoxen-search-filter__facet[aria-pressed='true']) {
+  background: var(--edoxen-color-accent);
+  color: #fff;
+  border-color: var(--edoxen-color-accent);
+}
+:global(.edoxen-search-filter__results) {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+:global(.edoxen-search-filter__result) {
+  padding: 0.6rem 0.85rem;
+  border: 1px solid var(--edoxen-color-border);
+  border-radius: var(--edoxen-radius-sm);
+  background: var(--edoxen-color-surface);
+}
+:global(.edoxen-search-filter__result a) {
+  font-weight: 500;
+  color: var(--edoxen-color-text);
+}
+</style>

package/src/astro/pages/index.astro

@@ -0,0 +1,50 @@
+---
+import cfg from 'virtual:edoxen-config'
+import payloads from 'virtual:edoxen-payloads'
+import BaseLayout from '../layouts/BaseLayout.astro'
+
+export function getStaticPaths() {
+  return cfg.locales
+    .filter((l) => (l.routePrefix ?? '') !== '')
+    .map((l) => ({ params: { lang: l.code } }))
+}
+
+const recentDecisions = payloads.decisionsList.items.slice(0, 5)
+const recentMeetings = payloads.meetingsList.items.slice(0, 3)
+const lang = Astro.params.lang
+const prefix = lang && cfg.locales.find((l) => l.code === lang)?.routePrefix
+const urlPrefix = prefix ?? ''
+---
+
+<BaseLayout config={cfg}>
+  <section>
+    <h1>{cfg.site.title}</h1>
+    <p>{cfg.site.description}</p>
+  </section>
+
+  <section>
+    <h2>Latest decisions</h2>
+    <ul>
+      {recentDecisions.map((d) => (
+        <li>
+          <a href={`${urlPrefix}/decisions/${encodeURIComponent(d.urn)}`}>{d.title}</a>
+          {d.bodyType && <span class="edoxen-badge">{d.bodyType}</span>}
+        </li>
+      ))}
+    </ul>
+  </section>
+
+  {recentMeetings.length > 0 && (
+    <section>
+      <h2>Recent meetings</h2>
+      <ul>
+        {recentMeetings.map((m) => (
+          <li>
+            <a href={`${urlPrefix}/meetings/${encodeURIComponent(m.urn)}`}>{m.title}</a>
+            {m.startDate && <span> — {m.startDate}</span>}
+          </li>
+        ))}
+      </ul>
+    </section>
+  )}
+</BaseLayout>

package/src/astro/pages/meetings/[urn].astro

@@ -0,0 +1,110 @@
+---
+import cfg from 'virtual:edoxen-config'
+import payloads from 'virtual:edoxen-payloads'
+import MeetingLayout from '../../layouts/MeetingLayout.astro'
+import UrnBar from '../../components/UrnBar.astro'
+import BodyBadge from '../../components/BodyBadge.astro'
+import AgendaTable from '../../components/AgendaTable.astro'
+import MinutesSection from '../../components/MinutesSection.astro'
+import { meetingJsonLd } from '../../../seo/index.js'
+import { pickLocalizedValue } from '../../../i18n/index.js'
+
+export function getStaticPaths() {
+  return Object.keys(payloads.meetingByUrn).map((urn) => ({
+    params: { urn },
+    props: { meeting: payloads.meetingByUrn[urn] },
+  }))
+}
+
+interface Props {
+  meeting: typeof payloads.meetingByUrn[string]
+}
+const { meeting } = Astro.props
+const locale = cfg.site.locale
+const title = pickLocalizedValue(meeting.title, locale, meeting.urn ?? '')
+const officers = meeting.officers ?? []
+const agenda = meeting.agenda
+const minutes = meeting.minutes ?? []
+const linkedDecisions = (meeting.decisions ?? []).map((id) =>
+  payloads.decisionsList.items.find((d) =>
+    d.identifier === `${id.prefix}-${id.number}`
+  )
+).filter((d): d is NonNullable<typeof d> => d !== undefined)
+const jsonld = meetingJsonLd(meeting, { siteUrl: cfg.site.url, siteTitle: cfg.site.title, defaultLocale: locale })
+---
+
+<MeetingLayout
+  config={cfg}
+  item={{
+    urn: meeting.urn ?? '',
+    identifier: (meeting.identifier[0]?.prefix ?? '') + '-' + (meeting.identifier[0]?.number ?? ''),
+    title,
+    startDate: meeting.date_range?.start,
+    endDate: meeting.date_range?.end,
+    bodyType: meeting.body_type,
+    city: meeting.city,
+    countryCode: meeting.country_code,
+    status: meeting.status,
+  }}
+>
+  <script type="application/ld+json" set:html={JSON.stringify(jsonld)} is:inline />
+  <UrnBar urn={meeting.urn ?? ''} />
+
+  {meeting.body_type && <p><BodyBadge code={meeting.body_type} /></p>}
+
+  {meeting.city && (
+    <section>
+      <h2>Venue</h2>
+      <p>{meeting.city}{meeting.country_code ? `, ${meeting.country_code}` : ''}</p>
+    </section>
+  )}
+
+  {officers.length > 0 && (
+    <section>
+      <h2>Officers</h2>
+      <ul>
+        {officers.map((o) => (
+          <li>{o.role}{o.person?.name ? `: ${o.person.name}` : ''}</li>
+        ))}
+      </ul>
+    </section>
+  )}
+
+  {agenda && agenda.items && agenda.items.length > 0 && (
+    <section>
+      <h2>Agenda</h2>
+      <AgendaTable items={agenda.items} locale={locale} />
+    </section>
+  )}
+
+  {minutes.length > 0 && (
+    <section>
+      <h2>Minutes</h2>
+      {minutes.map((m) => (
+        <MinutesSection minutes={m} locale={locale} />
+      ))}
+    </section>
+  )}
+
+  {linkedDecisions.length > 0 && (
+    <section>
+      <h2>Adopted decisions</h2>
+      <ul>
+        {linkedDecisions.map((d) => (
+          <li><a href={`/decisions/${encodeURIComponent(d.urn)}`}>{d.title}</a></li>
+        ))}
+      </ul>
+    </section>
+  )}
+
+  {(meeting.source_urls ?? []).length > 0 && (
+    <section>
+      <h2>Source documents</h2>
+      <ul>
+        {(meeting.source_urls ?? []).map((s) => (
+          <li><a href={s.ref}>{s.format ?? 'document'}</a></li>
+        ))}
+      </ul>
+    </section>
+  )}
+</MeetingLayout>

package/src/astro/pages/meetings/index.astro

@@ -0,0 +1,20 @@
+---
+import cfg from 'virtual:edoxen-config'
+import payloads from 'virtual:edoxen-payloads'
+import BaseLayout from '../../layouts/BaseLayout.astro'
+import MeetingList from '../../components/MeetingList.astro'
+import DecadeTimeline from '../../components/DecadeTimeline.astro'
+
+const items = payloads.meetingsList.items
+const decades = payloads.meetingsList.facets.decades
+---
+
+<BaseLayout config={cfg} title={`Meetings — ${cfg.site.title}`}>
+  <h1>Meetings</h1>
+
+  <decade-scroller>
+    <DecadeTimeline decades={decades} />
+  </decade-scroller>
+
+  <MeetingList items={items} />
+</BaseLayout>

package/src/cli/index.ts

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util'
+import { existsSync } from 'node:fs'
+import { resolve, extname } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+import { EdoxenConfigSchema } from '../config/index.js'
+import { loadAll, validateAll, lintProject, buildProjectFromLoaded } from '../data/index.js'
+import { EdoxenBrowserError } from '../errors.js'
+
+const HELP = `edoxen-browser — CLI for the @edoxen/browser package
+
+Usage:
+  edoxen-browser <command> [options]
+
+Commands:
+  validate       Validate the data + config without building.
+  lint           Run structural lint (duplicate URNs, broken relations).
+  check          validate + lint in one shot.
+  config         Print the resolved config as JSON.
+  build          Run astro build (thin wrapper).
+  help           Show this help.
+
+Options:
+  --config <path>   Path to edoxen.config.ts (default: ./edoxen.config.ts)
+  --cwd <path>      Working directory (default: process.cwd())
+  --strict          Treat warnings as errors (lint only).
+  -h, --help        Show this help.
+`
+
+interface ParsedArgs {
+  command: string
+  configPath: string
+  cwd: string
+  strict: boolean
+}
+
+function parseCliArgs(argv: string[]): ParsedArgs {
+  const [command, ...rest] = argv.slice(2)
+  const { values } = parseArgs({
+    args: rest,
+    options: {
+      config: { type: 'string', default: './edoxen.config.ts' },
+      cwd: { type: 'string', default: process.cwd() },
+      strict: { type: 'boolean', default: false },
+      help: { type: 'boolean', short: 'h', default: false },
+    },
+    allowPositionals: true,
+  })
+  if (values.help || !command || command === 'help') {
+    process.stdout.write(HELP)
+    process.exit(0)
+  }
+  return {
+    command,
+    configPath: String(values.config),
+    cwd: String(values.cwd),
+    strict: Boolean(values.strict),
+  }
+}
+
+async function loadConfigFile(configPath: string, cwd: string): Promise<unknown> {
+  const absolute = resolve(cwd, configPath)
+  if (!existsSync(absolute)) {
+    throw new EdoxenBrowserError('config', `Config file not found: ${absolute}`, [])
+  }
+  const ext = extname(absolute)
+  if (ext === '.ts' || ext === '.tsx' || ext === '.mts') {
+    const { createJiti } = await import('jiti')
+    const jiti = createJiti(import.meta.url, { interopDefault: true })
+    const mod = (await jiti.import(absolute)) as { default?: unknown }
+    return mod.default
+  }
+  const url = pathToFileURL(absolute).href
+  const mod = (await import(url)) as { default?: unknown }
+  if (!mod.default) {
+    throw new EdoxenBrowserError('config', `Config file ${absolute} does not export a default config`, [])
+  }
+  return mod.default
+}
+
+async function loadValidatedConfig(args: ParsedArgs) {
+  const raw = await loadConfigFile(args.configPath, args.cwd)
+  const parseResult = EdoxenConfigSchema.safeParse(raw)
+  if (!parseResult.success) {
+    throw new EdoxenBrowserError(
+      'config',
+      'edoxen.config.ts failed schema validation',
+      parseResult.error.issues.map((i) => `${i.path.join('.') || '<root>'}: ${i.message}`),
+    )
+  }
+  const cfg = parseResult.data
+  return {
+    ...cfg,
+    data: {
+      decisions: resolve(args.cwd, cfg.data.decisions),
+      ...(cfg.data.meetings ? { meetings: resolve(args.cwd, cfg.data.meetings) } : {}),
+      ...(cfg.data.agendas ? { agendas: resolve(args.cwd, cfg.data.agendas) } : {}),
+      ...(cfg.data.minutes ? { minutes: resolve(args.cwd, cfg.data.minutes) } : {}),
+      ...(cfg.data.committee ? { committee: resolve(args.cwd, cfg.data.committee) } : {}),
+    },
+  }
+}
+
+async function runValidate(args: ParsedArgs): Promise<void> {
+  const cfg = await loadValidatedConfig(args)
+  const loaded = await loadAll(cfg.data)
+  if (!loaded.ok) {
+    throw new EdoxenBrowserError(
+      'load',
+      'Failed to load one or more data sources',
+      loaded.error.map((e) => `${e.source} (${e.path}): ${e.cause.message}`),
+    )
+  }
+  const report = await validateAll(loaded.value)
+  if (!report.valid) {
+    const details: string[] = []
+    if (report.decisions) details.push(...report.decisions.errors.map((e) => e.message))
+    if (report.meetings) details.push(...report.meetings.errors.map((e) => e.message))
+    throw new EdoxenBrowserError('validate', 'Schema validation failed', details)
+  }
+  process.stdout.write(`OK — schema validation passed for ${cfg.data.decisions}\n`)
+}
+
+async function runLint(args: ParsedArgs): Promise<void> {
+  const cfg = await loadValidatedConfig(args)
+  const loaded = await loadAll(cfg.data)
+  if (!loaded.ok) {
+    throw new EdoxenBrowserError(
+      'load',
+      'Failed to load data',
+      loaded.error.map((e) => `${e.source}: ${e.cause.message}`),
+    )
+  }
+  const project = buildProjectFromLoaded(loaded.value)
+  const report = lintProject(project)
+  if (report.findings.length === 0) {
+    process.stdout.write('OK — no lint findings\n')
+    return
+  }
+  for (const finding of report.findings) {
+    const prefix = finding.severity === 'error' ? 'ERROR' : 'WARN'
+    process.stdout.write(`${prefix} [${finding.code}] ${finding.message}\n`)
+  }
+  const hasErrors = args.strict
+    ? report.findings.length > 0
+    : report.findings.some((f) => f.severity === 'error')
+  if (hasErrors) {
+    throw new EdoxenBrowserError('lint', `Lint reported ${report.findings.length} finding(s)`)
+  }
+}
+
+async function runCheck(args: ParsedArgs): Promise<void> {
+  await runValidate(args)
+  await runLint(args)
+}
+
+async function runConfig(args: ParsedArgs): Promise<void> {
+  const cfg = await loadValidatedConfig(args)
+  process.stdout.write(`${JSON.stringify(cfg, null, 2)}\n`)
+}
+
+async function runBuild(args: ParsedArgs): Promise<void> {
+  await runValidate(args)
+  const { spawnSync } = await import('node:child_process')
+  const result = spawnSync('astro', ['build'], { stdio: 'inherit', cwd: args.cwd })
+  if (result.status !== 0) {
+    throw new EdoxenBrowserError('build', `astro build exited with status ${result.status ?? 'null'}`)
+  }
+}
+
+async function main(): Promise<void> {
+  const args = parseCliArgs(process.argv)
+  switch (args.command) {
+    case 'validate': return await runValidate(args)
+    case 'lint': return await runLint(args)
+    case 'check': return await runCheck(args)
+    case 'config': return await runConfig(args)
+    case 'build': return await runBuild(args)
+    default:
+      process.stderr.write(`Unknown command: ${args.command}\n\n${HELP}`)
+      process.exit(1)
+  }
+}
+
+main().catch((e: unknown) => {
+  if (e instanceof EdoxenBrowserError) {
+    process.stderr.write(`${e.toString()}\n`)
+    process.exit(1)
+  }
+  process.stderr.write(`Unexpected error: ${e instanceof Error ? e.stack : String(e)}\n`)
+  process.exit(1)
+})
+
+export const _cliExtAccept = extname

package/src/config/index.ts

@@ -0,0 +1,33 @@
+export {
+  EdoxenConfigSchema,
+  SiteSchema,
+  DataSchema,
+  OutputSchema,
+  BodySchema,
+  LocaleEntrySchema,
+  ThemeSchema,
+  NavItemSchema,
+  SocialItemSchema,
+  FeaturesSchema,
+  defineConfig,
+  type EdoxenConfig,
+  type EdoxenConfigInput,
+  type SiteConfig,
+  type DataConfig,
+  type OutputConfig,
+  type BodyEntry,
+  type LocaleEntry,
+  type ThemeConfig,
+  type NavItem,
+  type SocialItem,
+  type FeaturesConfig,
+} from './schema.js'
+
+export {
+  resolveDataPaths,
+  activeDataKeys,
+  type ResolvedDataPaths,
+  type DataPathKey,
+} from './paths.js'
+
+export { generateCssTokens } from './tokens.js'