@sarimarcus/content-sites-core 0.74.0 → 0.74.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,19 @@
2
2
 
3
3
  All packages in the platform release in lockstep; entries are per release version.
4
4
 
5
+ ## 0.74.2 (2026-11-17)
6
+
7
+ Additive (SLA-4221). No codemod.
8
+
9
+ - Agenda snapshot contract (`./schema`): `AgendaItem`, `AgendaSnapshot`, `AgendaVenue`, `AGENDA_CATEGORIES`, `AGENDA_KINDS`, and the validators `agendaItemIssues` / `agendaSnapshotIssues` (a snapshot needs `site`, `generatedAt`, an IANA `timezone`, `fallback` and `items`; every item a non-empty `venue.name`).
10
+ - `agendaItemListBuilder` (`./schema`): an ItemList of the agenda items a page shows; a `dated` item is an Event, its `url` the item's `href`, else its venue's, else its `sourceUrl`.
11
+ - Agenda dates (`./dates`): `agendaWindows` (this weekend, next weekend, this month in the site's zone), `DayWindow`, `overlapsWindow`, `isExpired`, `agendaDay`, `localDay`, `addDays`, `isRealDay`, `agendaIsoDate`, and `zoneOffset`.
12
+ - `zoneOffset` now backs the article date stamp in `./articles`; a zone on UTC gets `+00:00` instead of the old `+01:00` fallback. No current site is on UTC (oracle: html identical on all 6).
13
+
14
+ ## 0.74.1 (2026-11-16)
15
+
16
+ - No changes (lockstep release).
17
+
5
18
  ## 0.74.0 (2026-11-15)
6
19
 
7
20
  - No changes (lockstep release).
@@ -1,5 +1,6 @@
1
1
  // Shared article prose and metadata helpers promoted from the sites' src/utils/articleRender.ts (SLA-3720).
2
2
  import { parseMarkdownBlock, parseMarkdownInline } from "../text/markdown.js";
3
+ import { zoneOffset } from "../dates/zone.js";
3
4
  /**
4
5
  * Splits a markdown body on blank lines (`\n\n+`) and renders each chunk:
5
6
  * block-level markdown constructs (lists, blockquotes, tables) use `parseMarkdownBlock`
@@ -35,15 +36,7 @@ export function toISO(dateStr, timeZone = 'Europe/Madrid') {
35
36
  return undefined;
36
37
  if (dateStr.includes('T'))
37
38
  return dateStr;
38
- const probe = new Date(`${dateStr}T12:00:00Z`);
39
- const tzPart = new Intl.DateTimeFormat('en-US', {
40
- timeZone,
41
- timeZoneName: 'longOffset',
42
- })
43
- .formatToParts(probe)
44
- .find((p) => p.type === 'timeZoneName')?.value;
45
- const offset = tzPart?.replace(/^GMT/, '') || '+01:00';
46
- return `${dateStr}T12:00:00${offset}`;
39
+ return `${dateStr}T12:00:00${zoneOffset(new Date(`${dateStr}T12:00:00Z`), timeZone)}`;
47
40
  }
48
41
  /**
49
42
  * Merges `answer-box` interludes from `sections` into the article's `faqs` list (deduping by lowercase question)
@@ -0,0 +1,43 @@
1
+ export interface DayWindow {
2
+ /** First day, inclusive. */
3
+ start: string;
4
+ /** Last day, inclusive. */
5
+ end: string;
6
+ }
7
+ export interface AgendaWindows {
8
+ today: string;
9
+ thisWeekend: DayWindow;
10
+ nextWeekend: DayWindow;
11
+ /** Today to the last day of this month. */
12
+ thisMonth: DayWindow;
13
+ }
14
+ /**
15
+ * Item dates as the windows read them: a start day or local time and an optional inclusive end day. A `recurring`
16
+ * item runs from its start with no end unless `endDate` sets one.
17
+ */
18
+ export interface DatedRange {
19
+ startDate: string;
20
+ endDate?: string;
21
+ kind?: 'dated' | 'recurring';
22
+ }
23
+ /** The calendar day of an item date (`2026-11-21T20:00` → `2026-11-21`). */
24
+ export declare function agendaDay(date: string): string;
25
+ /** `day` is a `YYYY-MM-DD` the calendar has (no 30 February). */
26
+ export declare function isRealDay(day: string): boolean;
27
+ /** The calendar day `instant` falls on in `timeZone`. */
28
+ export declare function localDay(instant: Date, timeZone: string): string;
29
+ export declare function addDays(day: string, days: number): string;
30
+ /**
31
+ * Friday to Sunday. On Friday, Saturday or Sunday "this weekend" is the one under way; Monday to Thursday it is the
32
+ * coming one. "Next weekend" is always the one after it.
33
+ */
34
+ export declare function agendaWindows(now: Date, timeZone: string): AgendaWindows;
35
+ /** The item runs on at least one day of the window. */
36
+ export declare function overlapsWindow(item: DatedRange, window: DayWindow): boolean;
37
+ /** The item's last day is before `today`; a recurring item with no end never expires. */
38
+ export declare function isExpired(item: DatedRange, today: string): boolean;
39
+ /**
40
+ * An item date for JSON-LD: a day stays a day; a local `YYYY-MM-DDTHH:MM` gains seconds and the zone's offset on
41
+ * that date (`2026-11-21T20:00` in Europe/Madrid → `2026-11-21T20:00:00+01:00`).
42
+ */
43
+ export declare function agendaIsoDate(date: string, timeZone: string): string;
@@ -0,0 +1,63 @@
1
+ // Date windows of the What's On hub (SLA-4221). Every day is a `YYYY-MM-DD` string local to the site's zone;
2
+ // arithmetic runs on UTC midnights so it never crosses a DST edge.
3
+ import { zoneOffset } from "./zone.js";
4
+ /** The calendar day of an item date (`2026-11-21T20:00` → `2026-11-21`). */
5
+ export function agendaDay(date) {
6
+ return date.slice(0, 10);
7
+ }
8
+ /** `day` is a `YYYY-MM-DD` the calendar has (no 30 February). */
9
+ export function isRealDay(day) {
10
+ const d = new Date(`${day}T00:00:00Z`);
11
+ return !Number.isNaN(d.getTime()) && d.toISOString().slice(0, 10) === day;
12
+ }
13
+ /** The calendar day `instant` falls on in `timeZone`. */
14
+ export function localDay(instant, timeZone) {
15
+ return new Intl.DateTimeFormat('en-CA', { timeZone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(instant);
16
+ }
17
+ export function addDays(day, days) {
18
+ const d = new Date(`${day}T00:00:00Z`);
19
+ d.setUTCDate(d.getUTCDate() + days);
20
+ return d.toISOString().slice(0, 10);
21
+ }
22
+ /** 0 = Sunday … 6 = Saturday. */
23
+ function weekday(day) {
24
+ return new Date(`${day}T00:00:00Z`).getUTCDay();
25
+ }
26
+ /**
27
+ * Friday to Sunday. On Friday, Saturday or Sunday "this weekend" is the one under way; Monday to Thursday it is the
28
+ * coming one. "Next weekend" is always the one after it.
29
+ */
30
+ export function agendaWindows(now, timeZone) {
31
+ const today = localDay(now, timeZone);
32
+ const dow = weekday(today);
33
+ const friday = dow === 0 ? addDays(today, -2) : dow === 6 ? addDays(today, -1) : addDays(today, (5 - dow + 7) % 7);
34
+ const thisWeekend = { start: friday, end: addDays(friday, 2) };
35
+ const nextWeekend = { start: addDays(friday, 7), end: addDays(friday, 9) };
36
+ const [y, m] = today.split('-').map(Number);
37
+ const monthEnd = new Date(Date.UTC(y, m, 0)).toISOString().slice(0, 10);
38
+ return { today, thisWeekend, nextWeekend, thisMonth: { start: today, end: monthEnd } };
39
+ }
40
+ /** The item's last day, or `undefined` for a recurring item with no end. */
41
+ function lastDay(item) {
42
+ return item.endDate ?? (item.kind === 'recurring' ? undefined : agendaDay(item.startDate));
43
+ }
44
+ /** The item runs on at least one day of the window. */
45
+ export function overlapsWindow(item, window) {
46
+ const end = lastDay(item);
47
+ return agendaDay(item.startDate) <= window.end && (end === undefined || end >= window.start);
48
+ }
49
+ /** The item's last day is before `today`; a recurring item with no end never expires. */
50
+ export function isExpired(item, today) {
51
+ const end = lastDay(item);
52
+ return end !== undefined && end < today;
53
+ }
54
+ /**
55
+ * An item date for JSON-LD: a day stays a day; a local `YYYY-MM-DDTHH:MM` gains seconds and the zone's offset on
56
+ * that date (`2026-11-21T20:00` in Europe/Madrid → `2026-11-21T20:00:00+01:00`).
57
+ */
58
+ export function agendaIsoDate(date, timeZone) {
59
+ if (date.length === 10)
60
+ return date;
61
+ const guess = zoneOffset(new Date(`${date}:00Z`), timeZone);
62
+ return `${date}:00${zoneOffset(new Date(`${date}:00${guess}`), timeZone)}`;
63
+ }
@@ -4,4 +4,7 @@ export { maxDate, latestDateModified, NEW_BADGE_DAYS, isNew } from './lastmod.ts
4
4
  export { eventToIcs, eventsToIcs, googleCalendarUrl, monthsCovered } from './ics.ts';
5
5
  export type { IcsEvent, IcsCalendar } from './ics.ts';
6
6
  export { resolvePeriodDates } from './seasonalDates.ts';
7
+ export { agendaDay, isRealDay, localDay, addDays, agendaWindows, overlapsWindow, isExpired, agendaIsoDate } from './agenda.ts';
8
+ export { zoneOffset } from './zone.ts';
9
+ export type { DayWindow, AgendaWindows, DatedRange } from './agenda.ts';
7
10
  export type { Period, StayDates } from './seasonalDates.ts';
@@ -4,3 +4,5 @@ export { buildNow } from "./buildClock.js";
4
4
  export { maxDate, latestDateModified, NEW_BADGE_DAYS, isNew } from "./lastmod.js";
5
5
  export { eventToIcs, eventsToIcs, googleCalendarUrl, monthsCovered } from "./ics.js";
6
6
  export { resolvePeriodDates } from "./seasonalDates.js";
7
+ export { agendaDay, isRealDay, localDay, addDays, agendaWindows, overlapsWindow, isExpired, agendaIsoDate } from "./agenda.js";
8
+ export { zoneOffset } from "./zone.js";
@@ -0,0 +1,2 @@
1
+ /** The UTC offset of `timeZone` at `instant`, as `+HH:MM` (`+00:00` where the zone is on UTC, e.g. London in winter). */
2
+ export declare function zoneOffset(instant: Date, timeZone: string): string;
@@ -0,0 +1,7 @@
1
+ /** The UTC offset of `timeZone` at `instant`, as `+HH:MM` (`+00:00` where the zone is on UTC, e.g. London in winter). */
2
+ export function zoneOffset(instant, timeZone) {
3
+ const name = new Intl.DateTimeFormat('en-US', { timeZone, timeZoneName: 'longOffset' })
4
+ .formatToParts(instant).find((p) => p.type === 'timeZoneName')?.value ?? 'GMT';
5
+ const m = name.match(/^GMT([+-]\d{2}):?(\d{2})?$/);
6
+ return m ? `${m[1]}:${m[2] ?? '00'}` : '+00:00';
7
+ }
@@ -0,0 +1,55 @@
1
+ import type { FieldIssue } from '../internal/issues.ts';
2
+ export declare const AGENDA_CATEGORIES: readonly ["music", "flamenco", "theatre", "dance", "film", "exhibition", "festival", "talk", "family", "market", "other"];
3
+ export type AgendaCategory = (typeof AGENDA_CATEGORIES)[number];
4
+ /** `dated` items carry real dates; `recurring` items are the thin-week fallback (markets, free-entry slots). */
5
+ export declare const AGENDA_KINDS: readonly ["dated", "recurring"];
6
+ export type AgendaKind = (typeof AGENDA_KINDS)[number];
7
+ export interface AgendaVenue {
8
+ name: string;
9
+ /** Internal route of the site's own venue page, e.g. `/monument/mezquita`. */
10
+ href?: string;
11
+ address?: string;
12
+ }
13
+ export interface AgendaItem {
14
+ /** Stable across refreshes: `<sourceId>:<source's own id or slug>`. */
15
+ id: string;
16
+ title: string;
17
+ kind: AgendaKind;
18
+ category: AgendaCategory;
19
+ /** `YYYY-MM-DD`, or `YYYY-MM-DDTHH:MM` local time when the source gives one. */
20
+ startDate: string;
21
+ /** Last day, inclusive; absent for a single-day item. */
22
+ endDate?: string;
23
+ /** Recurrence in words for a `recurring` item, e.g. "Every Sunday, 10:00–14:00". */
24
+ recurrence?: string;
25
+ venue: AgendaVenue;
26
+ /** Internal link: the venue page or, when a festival page owns the query, `/event/<slug>` (Rule 34). */
27
+ href?: string;
28
+ /** The official page the dates were read from. */
29
+ sourceUrl: string;
30
+ /** Registry id in data/inputs/agenda-sources.json. */
31
+ sourceId: string;
32
+ /** `YYYY-MM-DD` the dates were last read from `sourceUrl`. */
33
+ verifiedAt: string;
34
+ free?: boolean;
35
+ /** Lowest ticket price in EUR. */
36
+ priceFrom?: number;
37
+ /** Curated blurb; absent until the curation step writes it. */
38
+ blurb?: string;
39
+ /** Lead pick of its window, enriched by research. */
40
+ lead?: boolean;
41
+ }
42
+ export interface AgendaSnapshot {
43
+ site: string;
44
+ /** ISO instant the snapshot was written. */
45
+ generatedAt: string;
46
+ /** IANA zone every date is local to. */
47
+ timezone: string;
48
+ /** True when dated items were too few and recurring ones fill the list. */
49
+ fallback: boolean;
50
+ items: AgendaItem[];
51
+ }
52
+ /** Field issues of one agenda item; `[]` when it satisfies the contract. */
53
+ export declare function agendaItemIssues(item: unknown, path?: string): FieldIssue[];
54
+ /** Field issues of a whole snapshot, items included; duplicate ids are an issue. */
55
+ export declare function agendaSnapshotIssues(snapshot: unknown): FieldIssue[];
@@ -0,0 +1,112 @@
1
+ import { isObject } from "../internal/guards.js";
2
+ import { agendaDay, isRealDay } from "../dates/agenda.js";
3
+ export const AGENDA_CATEGORIES = [
4
+ 'music', 'flamenco', 'theatre', 'dance', 'film', 'exhibition', 'festival', 'talk', 'family', 'market', 'other',
5
+ ];
6
+ /** `dated` items carry real dates; `recurring` items are the thin-week fallback (markets, free-entry slots). */
7
+ export const AGENDA_KINDS = ['dated', 'recurring'];
8
+ const DAY = /^\d{4}-\d{2}-\d{2}$/;
9
+ const DAY_OR_LOCAL_TIME = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?$/;
10
+ const INTERNAL_HREF = /^\/[a-z0-9-]+(\/[a-z0-9-]+)*\/?(#[a-z0-9-]+)?$/;
11
+ /** Field issues of one agenda item; `[]` when it satisfies the contract. */
12
+ export function agendaItemIssues(item, path = '') {
13
+ const at = (field) => (path ? `${path}.${field}` : field);
14
+ if (!isObject(item))
15
+ return [{ path, message: 'item is not an object' }];
16
+ const it = item;
17
+ const issues = [];
18
+ const str = (field, required) => {
19
+ const v = it[field];
20
+ if (v === undefined && !required)
21
+ return undefined;
22
+ if (typeof v !== 'string' || !v.trim()) {
23
+ issues.push({ path: at(field), message: 'must be a non-empty string' });
24
+ return undefined;
25
+ }
26
+ return v;
27
+ };
28
+ str('id', true);
29
+ str('title', true);
30
+ if (!AGENDA_KINDS.includes(it.kind))
31
+ issues.push({ path: at('kind'), message: `must be one of ${AGENDA_KINDS.join(', ')}` });
32
+ if (!AGENDA_CATEGORIES.includes(it.category))
33
+ issues.push({ path: at('category'), message: `must be one of ${AGENDA_CATEGORIES.join(', ')}` });
34
+ const start = str('startDate', true);
35
+ if (start && !(DAY_OR_LOCAL_TIME.test(start) && isRealDay(agendaDay(start))))
36
+ issues.push({ path: at('startDate'), message: 'must be YYYY-MM-DD or YYYY-MM-DDTHH:MM' });
37
+ const end = str('endDate', false);
38
+ if (end !== undefined) {
39
+ if (!(DAY.test(end) && isRealDay(end)))
40
+ issues.push({ path: at('endDate'), message: 'must be YYYY-MM-DD' });
41
+ else if (start && end < agendaDay(start))
42
+ issues.push({ path: at('endDate'), message: 'is before startDate' });
43
+ }
44
+ const recurrence = str('recurrence', false);
45
+ if (it.kind === 'recurring' && !recurrence)
46
+ issues.push({ path: at('recurrence'), message: 'is required for a recurring item' });
47
+ const venue = isObject(it.venue) ? it.venue : undefined;
48
+ if (typeof venue?.name !== 'string' || !venue.name.trim()) {
49
+ issues.push({ path: at('venue.name'), message: 'must be a non-empty string' });
50
+ }
51
+ else {
52
+ const vh = venue.href;
53
+ if (vh !== undefined && !(typeof vh === 'string' && INTERNAL_HREF.test(vh)))
54
+ issues.push({ path: at('venue.href'), message: 'must be an internal route like /monument/<slug>' });
55
+ }
56
+ const href = str('href', false);
57
+ if (href !== undefined && !INTERNAL_HREF.test(href))
58
+ issues.push({ path: at('href'), message: 'must be an internal route like /event/<slug>' });
59
+ const src = str('sourceUrl', true);
60
+ if (src && !/^https:\/\/[^\s/]+\.[^\s/]+/.test(src))
61
+ issues.push({ path: at('sourceUrl'), message: 'must be an https URL' });
62
+ str('sourceId', true);
63
+ const verified = str('verifiedAt', true);
64
+ if (verified && !(DAY.test(verified) && isRealDay(verified)))
65
+ issues.push({ path: at('verifiedAt'), message: 'must be YYYY-MM-DD' });
66
+ if (it.free !== undefined && typeof it.free !== 'boolean')
67
+ issues.push({ path: at('free'), message: 'must be a boolean' });
68
+ if (it.priceFrom !== undefined && !(typeof it.priceFrom === 'number' && it.priceFrom >= 0))
69
+ issues.push({ path: at('priceFrom'), message: 'must be a number ≥ 0' });
70
+ if (it.free === true && typeof it.priceFrom === 'number' && it.priceFrom > 0)
71
+ issues.push({ path: at('priceFrom'), message: 'contradicts free: true' });
72
+ str('blurb', false);
73
+ if (it.lead !== undefined && typeof it.lead !== 'boolean')
74
+ issues.push({ path: at('lead'), message: 'must be a boolean' });
75
+ return issues;
76
+ }
77
+ /** Field issues of a whole snapshot, items included; duplicate ids are an issue. */
78
+ export function agendaSnapshotIssues(snapshot) {
79
+ if (!isObject(snapshot))
80
+ return [{ path: '', message: 'snapshot is not an object' }];
81
+ const s = snapshot;
82
+ const issues = [];
83
+ if (typeof s.site !== 'string' || !s.site)
84
+ issues.push({ path: 'site', message: 'must be a non-empty string' });
85
+ if (typeof s.generatedAt !== 'string' || Number.isNaN(Date.parse(s.generatedAt)))
86
+ issues.push({ path: 'generatedAt', message: 'must be an ISO instant' });
87
+ if (typeof s.timezone !== 'string' || !s.timezone)
88
+ issues.push({ path: 'timezone', message: 'must be an IANA zone' });
89
+ else {
90
+ try {
91
+ new Intl.DateTimeFormat('en', { timeZone: s.timezone });
92
+ }
93
+ catch {
94
+ issues.push({ path: 'timezone', message: 'is not a known IANA zone' });
95
+ }
96
+ }
97
+ if (typeof s.fallback !== 'boolean')
98
+ issues.push({ path: 'fallback', message: 'must be a boolean' });
99
+ if (!Array.isArray(s.items))
100
+ return [...issues, { path: 'items', message: 'must be an array' }];
101
+ const seen = new Set();
102
+ s.items.forEach((item, i) => {
103
+ issues.push(...agendaItemIssues(item, `items[${i}]`));
104
+ const id = isObject(item) ? item.id : undefined;
105
+ if (typeof id === 'string') {
106
+ if (seen.has(id))
107
+ issues.push({ path: `items[${i}].id`, message: `duplicates "${id}"` });
108
+ seen.add(id);
109
+ }
110
+ });
111
+ return issues;
112
+ }
@@ -27,5 +27,15 @@ export interface EventItemListOptions extends EventPolicy {
27
27
  /** A listed item is an Event only when this holds (else a WebPage). Default: it has a `startDate`. */
28
28
  isEvent?: (item: Record<string, any>) => boolean;
29
29
  }
30
+ /**
31
+ * Event-list options without the event-page defaults: an agenda Event names no performer unless `performer` says so,
32
+ * and its organizer is the venue unless `itemOrganizer` says so (the city never stands in for either).
33
+ */
34
+ export type AgendaItemListOptions = Omit<EventItemListOptions, 'isEvent' | 'organizer' | 'performer' | 'itemOrganizer'> & Partial<Pick<EventItemListOptions, 'organizer' | 'performer' | 'itemOrganizer'>>;
35
+ /**
36
+ * ItemList for a What's On window (SLA-4221): `data` is `{ name, items: AgendaItem[], timezone }`, already filtered to
37
+ * the window. Dated items become Events; a recurring item becomes a WebPage, since it has no single date.
38
+ */
39
+ export declare function agendaItemListBuilder(options: AgendaItemListOptions): SchemaBuilder;
30
40
  /** ItemList of events, each linked at its `url`; an item that cannot be a valid Event becomes a WebPage. */
31
41
  export declare function eventItemListBuilder(options: EventItemListOptions): SchemaBuilder;
@@ -1,9 +1,10 @@
1
1
  import { createPersonSchema } from "./context.js";
2
2
  import { offer } from "./nodes.js";
3
3
  import { geoCoordinates, isFreeEntry, parsePriceFromString, postalAddress } from "./values.js";
4
+ import { agendaIsoDate } from "../dates/agenda.js";
4
5
  function eventPrice(data) {
5
6
  const isFree = isFreeEntry(data);
6
- return { isFree, price: isFree ? 0 : parsePriceFromString(data.price) };
7
+ return { isFree, price: isFree ? 0 : typeof data.priceValue === 'number' ? data.priceValue : parsePriceFromString(data.price) };
7
8
  }
8
9
  /** Offers open three months before the start date, in UTC; a day the target month lacks clamps to its last day. */
9
10
  function offerValidFrom(startDate) {
@@ -23,7 +24,7 @@ function eventLocation(policy, data) {
23
24
  return {
24
25
  '@type': 'Place',
25
26
  name,
26
- address: postalAddress(policy.address, data),
27
+ address: postalAddress(policy.address, data, typeof data.streetAddress === 'string' ? { street: data.streetAddress } : {}),
27
28
  ...(geo && { geo }),
28
29
  };
29
30
  }
@@ -86,6 +87,38 @@ export function eventBuilder(options) {
86
87
  return author ? [createPersonSchema(author), ...nodes] : nodes;
87
88
  };
88
89
  }
90
+ /**
91
+ * ItemList for a What's On window (SLA-4221): `data` is `{ name, items: AgendaItem[], timezone }`, already filtered to
92
+ * the window. Dated items become Events; a recurring item becomes a WebPage, since it has no single date.
93
+ */
94
+ export function agendaItemListBuilder(options) {
95
+ const venueOrganizer = (item) => ({ '@type': 'Organization', name: item.location });
96
+ const list = eventItemListBuilder({
97
+ ...options,
98
+ organizer: options.organizer ?? venueOrganizer,
99
+ itemOrganizer: options.itemOrganizer ?? venueOrganizer,
100
+ performer: options.performer ?? (() => undefined),
101
+ isEvent: (item) => item.kind === 'dated',
102
+ });
103
+ return (data, ctx) => list({
104
+ name: data.name,
105
+ items: data.items.map((item, i) => ({
106
+ position: i + 1,
107
+ kind: item.kind,
108
+ category: item.category,
109
+ name: item.title,
110
+ description: item.blurb,
111
+ url: item.href ?? item.venue.href ?? item.sourceUrl,
112
+ startDate: agendaIsoDate(item.startDate, data.timezone),
113
+ endDate: item.endDate,
114
+ location: item.venue.name,
115
+ streetAddress: item.venue.address,
116
+ price: item.free ? 'Free' : undefined,
117
+ priceValue: item.free ? undefined : item.priceFrom,
118
+ officialWebsite: item.sourceUrl,
119
+ })),
120
+ }, ctx);
121
+ }
89
122
  /** ItemList of events, each linked at its `url`; an item that cannot be a valid Event becomes a WebPage. */
90
123
  export function eventItemListBuilder(options) {
91
124
  const { isEvent = (item) => Boolean(item.startDate), currency = 'EUR' } = options;
@@ -17,5 +17,7 @@ export { faqPageBuilder, articleBuilder, collectionPageBuilder, itemListBuilder,
17
17
  export type { ArticleOptions, CollectionPageOptions, ItemListOptions, AboutPageOptions, PersonOptions, AggregateOfferOptions, TouristDestinationFields, } from './pages.ts';
18
18
  export { hotelBuilder, activityBuilder } from './places.ts';
19
19
  export type { HotelOptions, ActivityOptions } from './places.ts';
20
- export { eventBuilder, eventItemListBuilder } from './events.ts';
21
- export type { EventPolicy, EventOptions, EventItemListOptions } from './events.ts';
20
+ export { eventBuilder, eventItemListBuilder, agendaItemListBuilder } from './events.ts';
21
+ export type { EventPolicy, EventOptions, EventItemListOptions, AgendaItemListOptions } from './events.ts';
22
+ export { AGENDA_CATEGORIES, AGENDA_KINDS, agendaItemIssues, agendaSnapshotIssues } from './agenda.ts';
23
+ export type { AgendaCategory, AgendaKind, AgendaVenue, AgendaItem, AgendaSnapshot } from './agenda.ts';
@@ -8,4 +8,5 @@ export { offer, placeNode, siteOrganizationNode, siteWebsiteNode } from "./nodes
8
8
  export { buildBreadcrumbList, buildWebPageNode, assembleGraph, finalizeGraph } from "./graph.js";
9
9
  export { faqPageBuilder, articleBuilder, collectionPageBuilder, itemListBuilder, howToBuilder, aboutPageBuilder, contactPageBuilder, personBuilder, historicalPersonSchema, aggregateOfferBuilder, touristDestinationBuilder, organizationBuilder, } from "./pages.js";
10
10
  export { hotelBuilder, activityBuilder } from "./places.js";
11
- export { eventBuilder, eventItemListBuilder } from "./events.js";
11
+ export { eventBuilder, eventItemListBuilder, agendaItemListBuilder } from "./events.js";
12
+ export { AGENDA_CATEGORIES, AGENDA_KINDS, agendaItemIssues, agendaSnapshotIssues } from "./agenda.js";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sarimarcus/content-sites-core",
3
- "version": "0.74.0",
3
+ "version": "0.74.2",
4
4
  "description": "Non-visual utilities, Astro config builders and SEO schema assembly shared by the content sites.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -1,5 +1,6 @@
1
1
  // Shared article prose and metadata helpers promoted from the sites' src/utils/articleRender.ts (SLA-3720).
2
2
  import { parseMarkdownBlock, parseMarkdownInline } from '../text/markdown.ts';
3
+ import { zoneOffset } from '../dates/zone.ts';
3
4
 
4
5
  /**
5
6
  * Splits a markdown body on blank lines (`\n\n+`) and renders each chunk:
@@ -35,15 +36,7 @@ export function renderInlineMarkdown(text: string, basePath: string = '/', sourc
35
36
  export function toISO(dateStr: string | undefined, timeZone: string = 'Europe/Madrid'): string | undefined {
36
37
  if (!dateStr) return undefined;
37
38
  if (dateStr.includes('T')) return dateStr;
38
- const probe = new Date(`${dateStr}T12:00:00Z`);
39
- const tzPart = new Intl.DateTimeFormat('en-US', {
40
- timeZone,
41
- timeZoneName: 'longOffset',
42
- })
43
- .formatToParts(probe)
44
- .find((p) => p.type === 'timeZoneName')?.value;
45
- const offset = tzPart?.replace(/^GMT/, '') || '+01:00';
46
- return `${dateStr}T12:00:00${offset}`;
39
+ return `${dateStr}T12:00:00${zoneOffset(new Date(`${dateStr}T12:00:00Z`), timeZone)}`;
47
40
  }
48
41
 
49
42
  export interface AnswerBoxSectionLike {
@@ -0,0 +1,97 @@
1
+ // Date windows of the What's On hub (SLA-4221). Every day is a `YYYY-MM-DD` string local to the site's zone;
2
+ // arithmetic runs on UTC midnights so it never crosses a DST edge.
3
+ import { zoneOffset } from './zone.ts';
4
+
5
+ export interface DayWindow {
6
+ /** First day, inclusive. */
7
+ start: string;
8
+ /** Last day, inclusive. */
9
+ end: string;
10
+ }
11
+
12
+ export interface AgendaWindows {
13
+ today: string;
14
+ thisWeekend: DayWindow;
15
+ nextWeekend: DayWindow;
16
+ /** Today to the last day of this month. */
17
+ thisMonth: DayWindow;
18
+ }
19
+
20
+ /**
21
+ * Item dates as the windows read them: a start day or local time and an optional inclusive end day. A `recurring`
22
+ * item runs from its start with no end unless `endDate` sets one.
23
+ */
24
+ export interface DatedRange {
25
+ startDate: string;
26
+ endDate?: string;
27
+ kind?: 'dated' | 'recurring';
28
+ }
29
+
30
+ /** The calendar day of an item date (`2026-11-21T20:00` → `2026-11-21`). */
31
+ export function agendaDay(date: string): string {
32
+ return date.slice(0, 10);
33
+ }
34
+
35
+ /** `day` is a `YYYY-MM-DD` the calendar has (no 30 February). */
36
+ export function isRealDay(day: string): boolean {
37
+ const d = new Date(`${day}T00:00:00Z`);
38
+ return !Number.isNaN(d.getTime()) && d.toISOString().slice(0, 10) === day;
39
+ }
40
+
41
+ /** The calendar day `instant` falls on in `timeZone`. */
42
+ export function localDay(instant: Date, timeZone: string): string {
43
+ return new Intl.DateTimeFormat('en-CA', { timeZone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(instant);
44
+ }
45
+
46
+ export function addDays(day: string, days: number): string {
47
+ const d = new Date(`${day}T00:00:00Z`);
48
+ d.setUTCDate(d.getUTCDate() + days);
49
+ return d.toISOString().slice(0, 10);
50
+ }
51
+
52
+ /** 0 = Sunday … 6 = Saturday. */
53
+ function weekday(day: string): number {
54
+ return new Date(`${day}T00:00:00Z`).getUTCDay();
55
+ }
56
+
57
+ /**
58
+ * Friday to Sunday. On Friday, Saturday or Sunday "this weekend" is the one under way; Monday to Thursday it is the
59
+ * coming one. "Next weekend" is always the one after it.
60
+ */
61
+ export function agendaWindows(now: Date, timeZone: string): AgendaWindows {
62
+ const today = localDay(now, timeZone);
63
+ const dow = weekday(today);
64
+ const friday = dow === 0 ? addDays(today, -2) : dow === 6 ? addDays(today, -1) : addDays(today, (5 - dow + 7) % 7);
65
+ const thisWeekend = { start: friday, end: addDays(friday, 2) };
66
+ const nextWeekend = { start: addDays(friday, 7), end: addDays(friday, 9) };
67
+ const [y, m] = today.split('-').map(Number);
68
+ const monthEnd = new Date(Date.UTC(y, m, 0)).toISOString().slice(0, 10);
69
+ return { today, thisWeekend, nextWeekend, thisMonth: { start: today, end: monthEnd } };
70
+ }
71
+
72
+ /** The item's last day, or `undefined` for a recurring item with no end. */
73
+ function lastDay(item: DatedRange): string | undefined {
74
+ return item.endDate ?? (item.kind === 'recurring' ? undefined : agendaDay(item.startDate));
75
+ }
76
+
77
+ /** The item runs on at least one day of the window. */
78
+ export function overlapsWindow(item: DatedRange, window: DayWindow): boolean {
79
+ const end = lastDay(item);
80
+ return agendaDay(item.startDate) <= window.end && (end === undefined || end >= window.start);
81
+ }
82
+
83
+ /** The item's last day is before `today`; a recurring item with no end never expires. */
84
+ export function isExpired(item: DatedRange, today: string): boolean {
85
+ const end = lastDay(item);
86
+ return end !== undefined && end < today;
87
+ }
88
+
89
+ /**
90
+ * An item date for JSON-LD: a day stays a day; a local `YYYY-MM-DDTHH:MM` gains seconds and the zone's offset on
91
+ * that date (`2026-11-21T20:00` in Europe/Madrid → `2026-11-21T20:00:00+01:00`).
92
+ */
93
+ export function agendaIsoDate(date: string, timeZone: string): string {
94
+ if (date.length === 10) return date;
95
+ const guess = zoneOffset(new Date(`${date}:00Z`), timeZone);
96
+ return `${date}:00${zoneOffset(new Date(`${date}:00${guess}`), timeZone)}`;
97
+ }
@@ -5,4 +5,7 @@ export { maxDate, latestDateModified, NEW_BADGE_DAYS, isNew } from './lastmod.ts
5
5
  export { eventToIcs, eventsToIcs, googleCalendarUrl, monthsCovered } from './ics.ts';
6
6
  export type { IcsEvent, IcsCalendar } from './ics.ts';
7
7
  export { resolvePeriodDates } from './seasonalDates.ts';
8
+ export { agendaDay, isRealDay, localDay, addDays, agendaWindows, overlapsWindow, isExpired, agendaIsoDate } from './agenda.ts';
9
+ export { zoneOffset } from './zone.ts';
10
+ export type { DayWindow, AgendaWindows, DatedRange } from './agenda.ts';
8
11
  export type { Period, StayDates } from './seasonalDates.ts';
@@ -0,0 +1,7 @@
1
+ /** The UTC offset of `timeZone` at `instant`, as `+HH:MM` (`+00:00` where the zone is on UTC, e.g. London in winter). */
2
+ export function zoneOffset(instant: Date, timeZone: string): string {
3
+ const name = new Intl.DateTimeFormat('en-US', { timeZone, timeZoneName: 'longOffset' })
4
+ .formatToParts(instant).find((p) => p.type === 'timeZoneName')?.value ?? 'GMT';
5
+ const m = name.match(/^GMT([+-]\d{2}):?(\d{2})?$/);
6
+ return m ? `${m[1]}:${m[2] ?? '00'}` : '+00:00';
7
+ }
@@ -0,0 +1,142 @@
1
+ // Agenda snapshot contract (SLA-4221): the per-site What's On data the harvester writes, the curation command fills,
2
+ // the gates check and the hub renders. A snapshot is replaced whole on each refresh; items have no detail page.
3
+ import type { FieldIssue } from '../internal/issues.ts';
4
+ import { isObject } from '../internal/guards.ts';
5
+ import { agendaDay, isRealDay } from '../dates/agenda.ts';
6
+
7
+ export const AGENDA_CATEGORIES = [
8
+ 'music', 'flamenco', 'theatre', 'dance', 'film', 'exhibition', 'festival', 'talk', 'family', 'market', 'other',
9
+ ] as const;
10
+ export type AgendaCategory = (typeof AGENDA_CATEGORIES)[number];
11
+
12
+ /** `dated` items carry real dates; `recurring` items are the thin-week fallback (markets, free-entry slots). */
13
+ export const AGENDA_KINDS = ['dated', 'recurring'] as const;
14
+ export type AgendaKind = (typeof AGENDA_KINDS)[number];
15
+
16
+ export interface AgendaVenue {
17
+ name: string;
18
+ /** Internal route of the site's own venue page, e.g. `/monument/mezquita`. */
19
+ href?: string;
20
+ address?: string;
21
+ }
22
+
23
+ export interface AgendaItem {
24
+ /** Stable across refreshes: `<sourceId>:<source's own id or slug>`. */
25
+ id: string;
26
+ title: string;
27
+ kind: AgendaKind;
28
+ category: AgendaCategory;
29
+ /** `YYYY-MM-DD`, or `YYYY-MM-DDTHH:MM` local time when the source gives one. */
30
+ startDate: string;
31
+ /** Last day, inclusive; absent for a single-day item. */
32
+ endDate?: string;
33
+ /** Recurrence in words for a `recurring` item, e.g. "Every Sunday, 10:00–14:00". */
34
+ recurrence?: string;
35
+ venue: AgendaVenue;
36
+ /** Internal link: the venue page or, when a festival page owns the query, `/event/<slug>` (Rule 34). */
37
+ href?: string;
38
+ /** The official page the dates were read from. */
39
+ sourceUrl: string;
40
+ /** Registry id in data/inputs/agenda-sources.json. */
41
+ sourceId: string;
42
+ /** `YYYY-MM-DD` the dates were last read from `sourceUrl`. */
43
+ verifiedAt: string;
44
+ free?: boolean;
45
+ /** Lowest ticket price in EUR. */
46
+ priceFrom?: number;
47
+ /** Curated blurb; absent until the curation step writes it. */
48
+ blurb?: string;
49
+ /** Lead pick of its window, enriched by research. */
50
+ lead?: boolean;
51
+ }
52
+
53
+ export interface AgendaSnapshot {
54
+ site: string;
55
+ /** ISO instant the snapshot was written. */
56
+ generatedAt: string;
57
+ /** IANA zone every date is local to. */
58
+ timezone: string;
59
+ /** True when dated items were too few and recurring ones fill the list. */
60
+ fallback: boolean;
61
+ items: AgendaItem[];
62
+ }
63
+
64
+ const DAY = /^\d{4}-\d{2}-\d{2}$/;
65
+ const DAY_OR_LOCAL_TIME = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2})?$/;
66
+ const INTERNAL_HREF = /^\/[a-z0-9-]+(\/[a-z0-9-]+)*\/?(#[a-z0-9-]+)?$/;
67
+
68
+ /** Field issues of one agenda item; `[]` when it satisfies the contract. */
69
+ export function agendaItemIssues(item: unknown, path = ''): FieldIssue[] {
70
+ const at = (field: string) => (path ? `${path}.${field}` : field);
71
+ if (!isObject(item)) return [{ path, message: 'item is not an object' }];
72
+ const it = item as Record<string, unknown>;
73
+ const issues: FieldIssue[] = [];
74
+ const str = (field: string, required: boolean) => {
75
+ const v = it[field];
76
+ if (v === undefined && !required) return undefined;
77
+ if (typeof v !== 'string' || !v.trim()) { issues.push({ path: at(field), message: 'must be a non-empty string' }); return undefined; }
78
+ return v;
79
+ };
80
+ str('id', true);
81
+ str('title', true);
82
+ if (!AGENDA_KINDS.includes(it.kind as AgendaKind)) issues.push({ path: at('kind'), message: `must be one of ${AGENDA_KINDS.join(', ')}` });
83
+ if (!AGENDA_CATEGORIES.includes(it.category as AgendaCategory)) issues.push({ path: at('category'), message: `must be one of ${AGENDA_CATEGORIES.join(', ')}` });
84
+
85
+ const start = str('startDate', true);
86
+ if (start && !(DAY_OR_LOCAL_TIME.test(start) && isRealDay(agendaDay(start)))) issues.push({ path: at('startDate'), message: 'must be YYYY-MM-DD or YYYY-MM-DDTHH:MM' });
87
+ const end = str('endDate', false);
88
+ if (end !== undefined) {
89
+ if (!(DAY.test(end) && isRealDay(end))) issues.push({ path: at('endDate'), message: 'must be YYYY-MM-DD' });
90
+ else if (start && end < agendaDay(start)) issues.push({ path: at('endDate'), message: 'is before startDate' });
91
+ }
92
+ const recurrence = str('recurrence', false);
93
+ if (it.kind === 'recurring' && !recurrence) issues.push({ path: at('recurrence'), message: 'is required for a recurring item' });
94
+
95
+ const venue = isObject(it.venue) ? it.venue : undefined;
96
+ if (typeof venue?.name !== 'string' || !venue.name.trim()) {
97
+ issues.push({ path: at('venue.name'), message: 'must be a non-empty string' });
98
+ } else {
99
+ const vh = venue.href;
100
+ if (vh !== undefined && !(typeof vh === 'string' && INTERNAL_HREF.test(vh))) issues.push({ path: at('venue.href'), message: 'must be an internal route like /monument/<slug>' });
101
+ }
102
+ const href = str('href', false);
103
+ if (href !== undefined && !INTERNAL_HREF.test(href)) issues.push({ path: at('href'), message: 'must be an internal route like /event/<slug>' });
104
+
105
+ const src = str('sourceUrl', true);
106
+ if (src && !/^https:\/\/[^\s/]+\.[^\s/]+/.test(src)) issues.push({ path: at('sourceUrl'), message: 'must be an https URL' });
107
+ str('sourceId', true);
108
+ const verified = str('verifiedAt', true);
109
+ if (verified && !(DAY.test(verified) && isRealDay(verified))) issues.push({ path: at('verifiedAt'), message: 'must be YYYY-MM-DD' });
110
+
111
+ if (it.free !== undefined && typeof it.free !== 'boolean') issues.push({ path: at('free'), message: 'must be a boolean' });
112
+ if (it.priceFrom !== undefined && !(typeof it.priceFrom === 'number' && it.priceFrom >= 0)) issues.push({ path: at('priceFrom'), message: 'must be a number ≥ 0' });
113
+ if (it.free === true && typeof it.priceFrom === 'number' && it.priceFrom > 0) issues.push({ path: at('priceFrom'), message: 'contradicts free: true' });
114
+ str('blurb', false);
115
+ if (it.lead !== undefined && typeof it.lead !== 'boolean') issues.push({ path: at('lead'), message: 'must be a boolean' });
116
+ return issues;
117
+ }
118
+
119
+ /** Field issues of a whole snapshot, items included; duplicate ids are an issue. */
120
+ export function agendaSnapshotIssues(snapshot: unknown): FieldIssue[] {
121
+ if (!isObject(snapshot)) return [{ path: '', message: 'snapshot is not an object' }];
122
+ const s = snapshot as Record<string, unknown>;
123
+ const issues: FieldIssue[] = [];
124
+ if (typeof s.site !== 'string' || !s.site) issues.push({ path: 'site', message: 'must be a non-empty string' });
125
+ if (typeof s.generatedAt !== 'string' || Number.isNaN(Date.parse(s.generatedAt))) issues.push({ path: 'generatedAt', message: 'must be an ISO instant' });
126
+ if (typeof s.timezone !== 'string' || !s.timezone) issues.push({ path: 'timezone', message: 'must be an IANA zone' });
127
+ else {
128
+ try { new Intl.DateTimeFormat('en', { timeZone: s.timezone }); } catch { issues.push({ path: 'timezone', message: 'is not a known IANA zone' }); }
129
+ }
130
+ if (typeof s.fallback !== 'boolean') issues.push({ path: 'fallback', message: 'must be a boolean' });
131
+ if (!Array.isArray(s.items)) return [...issues, { path: 'items', message: 'must be an array' }];
132
+ const seen = new Set<string>();
133
+ s.items.forEach((item, i) => {
134
+ issues.push(...agendaItemIssues(item, `items[${i}]`));
135
+ const id = isObject(item) ? (item as Record<string, unknown>).id : undefined;
136
+ if (typeof id === 'string') {
137
+ if (seen.has(id)) issues.push({ path: `items[${i}].id`, message: `duplicates "${id}"` });
138
+ seen.add(id);
139
+ }
140
+ });
141
+ return issues;
142
+ }
@@ -2,6 +2,8 @@ import { createPersonSchema } from './context.ts';
2
2
  import { offer } from './nodes.ts';
3
3
  import { geoCoordinates, isFreeEntry, parsePriceFromString, postalAddress, type AddressPolicy } from './values.ts';
4
4
  import type { JsonLdNode, SchemaBuilder, SchemaContext } from './types.ts';
5
+ import type { AgendaItem } from './agenda.ts';
6
+ import { agendaIsoDate } from '../dates/agenda.ts';
5
7
 
6
8
  /** Where events take place and who runs them; every value is the site's. */
7
9
  export interface EventPolicy {
@@ -17,7 +19,7 @@ export interface EventPolicy {
17
19
 
18
20
  function eventPrice(data: Record<string, any>): { isFree: boolean | undefined; price: number | null } {
19
21
  const isFree = isFreeEntry(data);
20
- return { isFree, price: isFree ? 0 : parsePriceFromString(data.price) };
22
+ return { isFree, price: isFree ? 0 : typeof data.priceValue === 'number' ? data.priceValue : parsePriceFromString(data.price) };
21
23
  }
22
24
 
23
25
  /** Offers open three months before the start date, in UTC; a day the target month lacks clamps to its last day. */
@@ -40,7 +42,7 @@ function eventLocation(policy: EventPolicy, data: Record<string, any>): JsonLdNo
40
42
  return {
41
43
  '@type': 'Place',
42
44
  name,
43
- address: postalAddress(policy.address, data),
45
+ address: postalAddress(policy.address, data, typeof data.streetAddress === 'string' ? { street: data.streetAddress } : {}),
44
46
  ...(geo && { geo }),
45
47
  };
46
48
  }
@@ -137,6 +139,46 @@ export interface EventItemListOptions extends EventPolicy {
137
139
  isEvent?: (item: Record<string, any>) => boolean;
138
140
  }
139
141
 
142
+ /**
143
+ * Event-list options without the event-page defaults: an agenda Event names no performer unless `performer` says so,
144
+ * and its organizer is the venue unless `itemOrganizer` says so (the city never stands in for either).
145
+ */
146
+ export type AgendaItemListOptions = Omit<EventItemListOptions, 'isEvent' | 'organizer' | 'performer' | 'itemOrganizer'>
147
+ & Partial<Pick<EventItemListOptions, 'organizer' | 'performer' | 'itemOrganizer'>>;
148
+
149
+ /**
150
+ * ItemList for a What's On window (SLA-4221): `data` is `{ name, items: AgendaItem[], timezone }`, already filtered to
151
+ * the window. Dated items become Events; a recurring item becomes a WebPage, since it has no single date.
152
+ */
153
+ export function agendaItemListBuilder(options: AgendaItemListOptions): SchemaBuilder {
154
+ const venueOrganizer = (item: Record<string, any>): JsonLdNode => ({ '@type': 'Organization', name: item.location });
155
+ const list = eventItemListBuilder({
156
+ ...options,
157
+ organizer: options.organizer ?? venueOrganizer,
158
+ itemOrganizer: options.itemOrganizer ?? venueOrganizer,
159
+ performer: options.performer ?? (() => undefined),
160
+ isEvent: (item) => item.kind === 'dated',
161
+ });
162
+ return (data, ctx) => list({
163
+ name: data.name,
164
+ items: (data.items as AgendaItem[]).map((item, i) => ({
165
+ position: i + 1,
166
+ kind: item.kind,
167
+ category: item.category,
168
+ name: item.title,
169
+ description: item.blurb,
170
+ url: item.href ?? item.venue.href ?? item.sourceUrl,
171
+ startDate: agendaIsoDate(item.startDate, data.timezone),
172
+ endDate: item.endDate,
173
+ location: item.venue.name,
174
+ streetAddress: item.venue.address,
175
+ price: item.free ? 'Free' : undefined,
176
+ priceValue: item.free ? undefined : item.priceFrom,
177
+ officialWebsite: item.sourceUrl,
178
+ })),
179
+ }, ctx);
180
+ }
181
+
140
182
  /** ItemList of events, each linked at its `url`; an item that cannot be a valid Event becomes a WebPage. */
141
183
  export function eventItemListBuilder(options: EventItemListOptions): SchemaBuilder {
142
184
  const { isEvent = (item) => Boolean(item.startDate), currency = 'EUR' } = options;
@@ -36,5 +36,7 @@ export type {
36
36
  } from './pages.ts';
37
37
  export { hotelBuilder, activityBuilder } from './places.ts';
38
38
  export type { HotelOptions, ActivityOptions } from './places.ts';
39
- export { eventBuilder, eventItemListBuilder } from './events.ts';
40
- export type { EventPolicy, EventOptions, EventItemListOptions } from './events.ts';
39
+ export { eventBuilder, eventItemListBuilder, agendaItemListBuilder } from './events.ts';
40
+ export type { EventPolicy, EventOptions, EventItemListOptions, AgendaItemListOptions } from './events.ts';
41
+ export { AGENDA_CATEGORIES, AGENDA_KINDS, agendaItemIssues, agendaSnapshotIssues } from './agenda.ts';
42
+ export type { AgendaCategory, AgendaKind, AgendaVenue, AgendaItem, AgendaSnapshot } from './agenda.ts';