@ankhorage/zora 25.9.1 → 25.10.0

package/dist/types/temporal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.js","sourceRoot":"","sources":["../../src/types/temporal.ts"],"names":[],"mappings":"","sourcesContent":["/** A calendar date without a time or timezone, represented as `YYYY-MM-DD`. */\nexport type TemporalDate = `${number}-${number}-${number}`;\n\n/** A UTC ISO-8601 instant, represented as an RFC 3339 string ending in `Z`. */\nexport type TemporalInstant = `${string}Z`;\n\n/** An IANA timezone identifier such as `Europe/Zurich`. */\nexport type TemporalTimeZone = string;\n\n/** An ISO-8601 duration string such as `PT30M` or `-PT15M`. */\nexport type TemporalDuration = string;\n\n/**\n * This contract describes serializable shape, not runtime validation. Consumers must validate\n * RFC 3339 instants, ISO calendar dates and durations, IANA zone identifiers, positive non-zero\n * intervals, ordered ranges, and finite JSON numbers at their input boundary.\n */\nexport type TemporalDataValue =\n  | boolean\n  | null\n  | number\n  | string\n  | readonly TemporalDataValue[]\n  | { readonly [key: string]: TemporalDataValue };\n\n/**\n * A timed interval with exactly one exclusive end. Recurring timed events retain the local\n * wall-clock time derived from `start` in `timeZone` across DST transitions; a recurrence engine\n * materializes each occurrence as its corresponding UTC instant.\n */\nexport type TemporalTimedRange =\n  | {\n      readonly allDay: false;\n      readonly start: TemporalInstant;\n      readonly end: TemporalInstant;\n      readonly duration?: never;\n      readonly timeZone: TemporalTimeZone;\n    }\n  | {\n      readonly allDay: false;\n      readonly start: TemporalInstant;\n      readonly end?: never;\n      readonly duration: TemporalDuration;\n      readonly timeZone: TemporalTimeZone;\n    };\n\n/**\n * A timezone-free all-day calendar-date interval with exactly one exclusive end. `end` is the\n * first day not included, so a one-day event from `2026-10-24` ends on `2026-10-25`.\n */\nexport type TemporalAllDayRange =\n  | {\n      readonly allDay: true;\n      readonly start: TemporalDate;\n      readonly end: TemporalDate;\n      readonly duration?: never;\n    }\n  | {\n      readonly allDay: true;\n      readonly start: TemporalDate;\n      readonly end?: never;\n      readonly duration: TemporalDuration;\n    };\n\n/** A timed or all-day interval with exactly one way to define its exclusive end. */\nexport type TemporalRange = TemporalAllDayRange | TemporalTimedRange;\n\n/** The availability an event contributes without disclosing its details. */\nexport type TemporalAvailability = 'free' | 'busy' | 'tentative' | 'unavailable';\n\n/** A provider-neutral lifecycle state for a scheduled event. */\nexport type TemporalEventStatus = 'cancelled' | 'confirmed' | 'draft' | 'tentative';\n\n/** A semantic theme treatment that later ZORA renderers resolve through their active theme. */\nexport type TemporalTone = 'accent' | 'critical' | 'info' | 'neutral' | 'positive' | 'warning';\n\n/** A person or organization participating in an event without provider-specific identity objects. */\nexport interface TemporalParticipant {\n  readonly id?: string;\n  readonly name?: string;\n  readonly email?: string;\n  readonly role?: 'optional' | 'organizer' | 'required' | 'resource';\n  readonly response?: 'accepted' | 'declined' | 'delegated' | 'needs-action' | 'tentative';\n}\n\n/**\n * A reminder relative to the event start or exclusive end. A negative ISO duration fires before\n * that reference point; a positive duration fires after it.\n */\nexport interface TemporalReminder {\n  readonly id: string;\n  readonly offset: TemporalDuration;\n  readonly reference: 'end' | 'start';\n  readonly channel?: 'display' | 'email' | 'push';\n}\n\n/**\n * One normalized recurrence rule. `until` has the same value type as DTSTART: a date for all-day\n * series and a UTC instant for timed series. Adapter layers map this to and from RFC 5545 RRULE.\n */\nexport interface TemporalRecurrenceRule<TValue extends TemporalDate | TemporalInstant> {\n  readonly frequency: 'daily' | 'monthly' | 'weekly' | 'yearly';\n  readonly interval?: number;\n  readonly count?: number;\n  readonly until?: TValue;\n  readonly weekdays?: readonly (\n    'friday' | 'monday' | 'saturday' | 'sunday' | 'thursday' | 'tuesday' | 'wednesday'\n  )[];\n  readonly monthDays?: readonly number[];\n  readonly months?: readonly number[];\n}\n\n/**\n * Recurrence data retained independently from provider-specific series representations. `dates`\n * and `excludedDates` correspond to RFC 5545 RDATE and EXDATE and use the DTSTART value type.\n */\nexport interface TemporalRecurrence<TValue extends TemporalDate | TemporalInstant> {\n  readonly rules: readonly TemporalRecurrenceRule<TValue>[];\n  readonly dates?: readonly TValue[];\n  readonly excludedDates?: readonly TValue[];\n}\n\n/**\n * A detached occurrence that replaces or cancels one generated recurrence instance. `recurrenceId`\n * is the original scheduled DTSTART value: for timed DST series, the UTC instant materialized from\n * that occurrence's wall-clock time in the series timezone; for all-day series, its calendar date.\n */\nexport interface TemporalRecurrenceException<\n  TValue extends TemporalDate | TemporalInstant,\n  TRange extends TemporalRange,\n> {\n  readonly recurrenceId: TValue;\n  readonly status: 'cancelled' | 'replacement';\n  readonly range?: TRange;\n  readonly title?: string;\n}\n\n/** Lossless serialized data that an interoperability adapter must round-trip without exposing its runtime. */\nexport interface TemporalInteroperabilityData {\n  readonly format: 'icalendar' | 'jcal' | 'provider';\n  readonly value: TemporalDataValue;\n}\n\ninterface TemporalEventBase {\n  readonly id: string;\n  readonly title: string;\n  readonly description?: string;\n  readonly location?: string;\n  readonly conferenceUrl?: string;\n  readonly calendarId?: string;\n  readonly tone?: TemporalTone;\n  readonly availability?: TemporalAvailability;\n  readonly status?: TemporalEventStatus;\n  readonly resourceIds?: readonly string[];\n  readonly organizer?: TemporalParticipant;\n  readonly attendees?: readonly TemporalParticipant[];\n  readonly reminders?: readonly TemporalReminder[];\n  readonly editable?: boolean;\n  readonly metadata?: Readonly<Record<string, TemporalDataValue>>;\n  readonly interoperability?: readonly TemporalInteroperabilityData[];\n}\n\n/** A provider-neutral timed event with instant-based recurrence values. */\nexport interface TemporalTimedEvent extends TemporalEventBase {\n  readonly range: TemporalTimedRange;\n  readonly recurrence?: TemporalRecurrence<TemporalInstant>;\n  readonly recurrenceExceptions?: readonly TemporalRecurrenceException<\n    TemporalInstant,\n    TemporalTimedRange\n  >[];\n}\n\n/** A provider-neutral all-day event with date-based recurrence values. */\nexport interface TemporalAllDayEvent extends TemporalEventBase {\n  readonly range: TemporalAllDayRange;\n  readonly recurrence?: TemporalRecurrence<TemporalDate>;\n  readonly recurrenceExceptions?: readonly TemporalRecurrenceException<\n    TemporalDate,\n    TemporalAllDayRange\n  >[];\n}\n\n/** Provider-neutral, serializable event data shared by future Calendar and Scheduler presentations. */\nexport type TemporalEvent = TemporalAllDayEvent | TemporalTimedEvent;\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "25.9.1",
+  "version": "25.10.0",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -155,7 +155,7 @@
     "format:check": "ankhorage-prettier --check .",
     "prepack": "bun run build",
     "test": "bun run build && bun test src examples/grid-workspaces/time examples/grid-workspaces/plugins --isolate",
-    "typecheck": "bun x tsc --noEmit -p tsconfig.json && bun x tsc --noEmit -p tsconfig.scripts.json",
+    "typecheck": "bun x tsc --noEmit -p tsconfig.json && bun x tsc --noEmit -p tsconfig.scripts.json && bun x tsc -p tsconfig.typecheck.json",
     "version-packages": "ankhorage-changeset version"
   },
   "devDependencies": {

package/src/features/calendar/public.ts

@@ -0,0 +1,22 @@
+export type {
+  TemporalAllDayEvent,
+  TemporalAllDayRange,
+  TemporalAvailability,
+  TemporalDataValue,
+  TemporalDate,
+  TemporalDuration,
+  TemporalEvent,
+  TemporalEventStatus,
+  TemporalInstant,
+  TemporalInteroperabilityData,
+  TemporalParticipant,
+  TemporalRange,
+  TemporalRecurrence,
+  TemporalRecurrenceException,
+  TemporalRecurrenceRule,
+  TemporalReminder,
+  TemporalTimedEvent,
+  TemporalTimedRange,
+  TemporalTimeZone,
+  TemporalTone,
+} from '../../types/temporal';

package/src/features/list/adapters/inbound/FlatList.tsx

@@ -4,6 +4,7 @@ import { FlatList as NativeFlatList } from 'react-native';
 import type { ManifestListProps } from '../../../../types/manifest-list';
 import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
 import { Text } from '../../../typography/public';
+import { LIST_VIRTUALIZATION_DEFAULTS } from '../../constants/virtualization';
 import { HorizontalListSeparator } from './HorizontalListSeparator';
 import { useListVisibility } from './useListVisibility';
 import { VerticalListSeparator } from './VerticalListSeparator';
@@ -19,9 +20,9 @@ function FlatListInner({
   horizontal,
   refreshing = false,
   initialNumToRender,
-  maxToRenderPerBatch,
+  maxToRenderPerBatch = LIST_VIRTUALIZATION_DEFAULTS.maxToRenderPerBatch,
   windowSize,
-  onEndReachedThreshold,
+  onEndReachedThreshold = LIST_VIRTUALIZATION_DEFAULTS.onEndReachedThreshold,
   showsScrollIndicator = true,
   bounces,
   showSeparators,

package/src/features/list/adapters/inbound/SectionList.tsx

@@ -5,6 +5,7 @@ import type { ManifestSectionListProps } from '../../../../types/manifest-list';
 import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
 import { Text } from '../../../typography/public';
 import { partitionListSections } from '../../application/use-cases/partitionListSections';
+import { LIST_VIRTUALIZATION_DEFAULTS } from '../../constants/virtualization';
 import { HorizontalListSeparator } from './HorizontalListSeparator';
 import { useListVisibility } from './useListVisibility';
 import { VerticalListSeparator } from './VerticalListSeparator';
@@ -21,9 +22,9 @@ function SectionListInner({
   horizontal,
   refreshing = false,
   initialNumToRender,
-  maxToRenderPerBatch,
+  maxToRenderPerBatch = LIST_VIRTUALIZATION_DEFAULTS.maxToRenderPerBatch,
   windowSize,
-  onEndReachedThreshold,
+  onEndReachedThreshold = LIST_VIRTUALIZATION_DEFAULTS.onEndReachedThreshold,
   showsScrollIndicator = true,
   bounces,
   showSeparators,

package/src/features/list/adapters/inbound/virtualizedLists.test.tsx

@@ -0,0 +1,90 @@
+import { expect, mock, test } from 'bun:test';
+import React from 'react';
+import { renderToStaticMarkup } from 'react-dom/server';
+
+type EndReachedEvent = Readonly<{ distanceFromEnd: number }>;
+
+type NativeListProps = Readonly<{
+  readonly children?: React.ReactNode;
+  readonly maxToRenderPerBatch?: number;
+  readonly onEndReached?: (event: EndReachedEvent) => void;
+  readonly onEndReachedThreshold?: number;
+  readonly [key: string]: unknown;
+}>;
+
+const flatListProps: NativeListProps[] = [];
+const sectionListProps: NativeListProps[] = [];
+
+/*** Captures the props ZORA delivers to the React Native FlatList boundary. */
+function NativeFlatList(props: NativeListProps) {
+  flatListProps.push(props);
+  return null;
+}
+
+/*** Captures the props ZORA delivers to the React Native SectionList boundary. */
+function NativeSectionList(props: NativeListProps) {
+  sectionListProps.push(props);
+  return null;
+}
+
+await mock.module('react-native', () => ({
+  FlatList: NativeFlatList,
+  Platform: { OS: 'web' },
+  SectionList: NativeSectionList,
+  Text: () => null,
+}));
+await mock.module('@ankhorage/surface', () => ({
+  ThemeScope: ({ children }: { readonly children: React.ReactNode }) => children,
+  resolveResponsive: <T,>(value: T) => value,
+  useResponsiveRuntime: () => ({ breakpoint: undefined }),
+  useTheme: () => ({ theme: {} }),
+}));
+await mock.module('../../../layout/public', () => ({ Divider: () => null }));
+
+const { FlatList } = await import('./FlatList');
+const { SectionList } = await import('./SectionList');
+
+test.each([
+  {
+    name: 'FlatList',
+    props: flatListProps,
+    render: (properties: {
+      readonly interactionPolicy?: 'passive';
+      readonly onEndReached?: (event: EndReachedEvent) => void;
+      readonly maxToRenderPerBatch?: number;
+      readonly onEndReachedThreshold?: number;
+    }) => <FlatList {...properties} />,
+  },
+  {
+    name: 'SectionList',
+    props: sectionListProps,
+    render: (properties: {
+      readonly interactionPolicy?: 'passive';
+      readonly onEndReached?: (event: EndReachedEvent) => void;
+      readonly maxToRenderPerBatch?: number;
+      readonly onEndReachedThreshold?: number;
+    }) => <SectionList sections={[]} {...properties} />,
+  },
+])(
+  '$name forwards virtualization and pagination defaults, overrides, and callbacks',
+  ({ props, render }) => {
+    const onEndReached = mock();
+    renderToStaticMarkup(render({ onEndReached }));
+
+    const defaults = props.at(-1);
+    expect(defaults?.maxToRenderPerBatch).toBe(10);
+    expect(defaults?.onEndReachedThreshold).toBe(2);
+    defaults?.onEndReached?.({ distanceFromEnd: 24 });
+    expect(onEndReached).toHaveBeenCalledWith({ distanceFromEnd: 24 });
+
+    renderToStaticMarkup(
+      render({ maxToRenderPerBatch: 4, onEndReachedThreshold: 0.25, onEndReached }),
+    );
+    const overrides = props.at(-1);
+    expect(overrides?.maxToRenderPerBatch).toBe(4);
+    expect(overrides?.onEndReachedThreshold).toBe(0.25);
+
+    renderToStaticMarkup(render({ interactionPolicy: 'passive', onEndReached }));
+    expect(props.at(-1)?.onEndReached).toBeUndefined();
+  },
+);

package/src/features/list/constants/virtualization.ts

@@ -0,0 +1,5 @@
+/*** Shared explicit React Native virtualization and end-of-list defaults for ZORA lists. */
+export const LIST_VIRTUALIZATION_DEFAULTS = {
+  maxToRenderPerBatch: 10,
+  onEndReachedThreshold: 2,
+} as const;

package/src/features/list/flatListMeta.ts

@@ -1,11 +1,12 @@
 import { CONTAINER_ALLOWED_CHILDREN } from '../../constants/authoring';
 import type { ZoraComponentMeta } from '../../types/authoring';
+import { LIST_VIRTUALIZATION_DEFAULTS } from './constants/virtualization';
 
 export const flatListMeta = {
   name: 'FlatList',
   category: 'layout',
   directManifestNode: true,
-  blueprint: { label: 'Flat list' },
+  blueprint: { label: 'Flat list', defaultProps: LIST_VIRTUALIZATION_DEFAULTS },
   allowedChildren: [...CONTAINER_ALLOWED_CHILDREN],
   description:
     'Virtualized children. Put node.repeat on this list for keyed data and item bindings; bind selection on the child Button/Card press event. Bound the list viewport and avoid nesting in a same-direction ScrollView.',

package/src/features/list/sectionListMeta.ts

@@ -4,7 +4,10 @@ import { flatListMeta } from './flatListMeta';
 export const sectionListMeta = {
   ...flatListMeta,
   name: 'SectionList',
-  blueprint: { label: 'Section list', defaultProps: { sections: [] } },
+  blueprint: {
+    label: 'Section list',
+    defaultProps: { ...flatListMeta.blueprint.defaultProps, sections: [] },
+  },
   description:
     'Virtualized sections of ordered children. Section counts must cover every child exactly once.',
   events: {

package/src/features/list/virtualizationDefaults.test.ts

@@ -0,0 +1,24 @@
+import { expect, test } from 'bun:test';
+
+import { LIST_VIRTUALIZATION_DEFAULTS } from './constants/virtualization';
+import { flatListMeta } from './flatListMeta';
+import { sectionListMeta } from './sectionListMeta';
+
+test('publishes aligned list virtualization and pagination defaults in authoring metadata', () => {
+  expect(LIST_VIRTUALIZATION_DEFAULTS).toEqual({
+    maxToRenderPerBatch: 10,
+    onEndReachedThreshold: 2,
+  });
+  expect(flatListMeta.blueprint.defaultProps).toEqual(LIST_VIRTUALIZATION_DEFAULTS);
+  expect(sectionListMeta.blueprint.defaultProps).toEqual({
+    ...LIST_VIRTUALIZATION_DEFAULTS,
+    sections: [],
+  });
+  for (const metadata of [flatListMeta, sectionListMeta]) {
+    expect(metadata.events.endReached.payloadFields).toEqual([
+      { path: 'distanceFromEnd', type: 'number' },
+    ]);
+    expect(metadata.props.maxToRenderPerBatch.type).toBe('number');
+    expect(metadata.props.onEndReachedThreshold.type).toBe('number');
+  }
+});

package/src/readerFree.ts

@@ -70,6 +70,28 @@ export type { IconButtonProps } from './features/button/public';
 export { Button } from './features/button/public';
 export { ButtonGroup } from './features/button/public';
 export { IconButton } from './features/button/public';
+export type {
+  TemporalAllDayEvent,
+  TemporalAllDayRange,
+  TemporalAvailability,
+  TemporalDataValue,
+  TemporalDate,
+  TemporalDuration,
+  TemporalEvent,
+  TemporalEventStatus,
+  TemporalInstant,
+  TemporalInteroperabilityData,
+  TemporalParticipant,
+  TemporalRange,
+  TemporalRecurrence,
+  TemporalRecurrenceException,
+  TemporalRecurrenceRule,
+  TemporalReminder,
+  TemporalTimedEvent,
+  TemporalTimedRange,
+  TemporalTimeZone,
+  TemporalTone,
+} from './features/calendar/public';
 export type { CardProps } from './features/card/public';
 export type { MediaCardImageProps, MediaCardProps } from './features/card/public';
 export type { MetricCardProps } from './features/card/public';

package/src/types/temporal.test.ts

@@ -0,0 +1,88 @@
+import { expect, test } from 'bun:test';
+
+import type { TemporalEvent, TemporalRange } from './temporal';
+
+const timedRange = {
+  allDay: false,
+  end: '2026-10-25T09:30:00Z',
+  start: '2026-10-25T09:00:00Z',
+  timeZone: 'Europe/Zurich',
+} as const satisfies TemporalRange;
+
+const allDayRange = {
+  allDay: true,
+  end: '2026-10-25',
+  start: '2026-10-24',
+} as const satisfies TemporalRange;
+
+test('models calendar, scheduler, planner and Gantt inputs as provider-neutral serialized data', () => {
+  const calendarEvent = {
+    id: 'review',
+    range: timedRange,
+    title: 'Design review',
+  } as const satisfies TemporalEvent;
+  const schedulerEvent = {
+    availability: 'busy',
+    id: 'booking',
+    range: timedRange,
+    resourceIds: ['room-1'],
+    title: 'Room booking',
+  } as const satisfies TemporalEvent;
+  const plannerItem = {
+    editable: true,
+    id: 'plan',
+    range: allDayRange,
+    status: 'draft',
+    title: 'Plan release',
+  } as const satisfies TemporalEvent;
+  const ganttItem = {
+    id: 'task',
+    metadata: { progress: 0.5 },
+    range: timedRange,
+    title: 'Implement contract',
+  } as const satisfies TemporalEvent;
+
+  expect([calendarEvent, schedulerEvent, plannerItem, ganttItem]).toHaveLength(4);
+});
+
+test('keeps Europe/Zurich DST, all-day and recurrence edge fixtures serializable', () => {
+  const event = {
+    id: 'series',
+    interoperability: [
+      {
+        format: 'icalendar',
+        value: { uid: 'series@example.test', xProperties: ['X-OWNER:calendar'] },
+      },
+    ],
+    range: timedRange,
+    recurrence: {
+      dates: ['2026-11-01T09:00:00Z'],
+      excludedDates: ['2026-11-08T09:00:00Z'],
+      rules: [
+        {
+          frequency: 'weekly',
+          interval: 2,
+          until: '2026-11-29T09:00:00Z',
+          weekdays: ['sunday'],
+        },
+      ],
+    },
+    recurrenceExceptions: [{ recurrenceId: '2026-11-22T09:00:00Z', status: 'cancelled' }],
+    reminders: [{ id: 'before-start', offset: '-PT15M', reference: 'start' }],
+    title: 'Biweekly review',
+  } as const satisfies TemporalEvent;
+  const allDayEvent = {
+    id: 'all-day-series',
+    range: allDayRange,
+    recurrence: {
+      dates: ['2026-10-31'],
+      excludedDates: ['2026-11-07'],
+      rules: [{ frequency: 'weekly', until: '2026-11-28', weekdays: ['saturday'] }],
+    },
+    recurrenceExceptions: [{ recurrenceId: '2026-11-14', status: 'cancelled' }],
+    reminders: [{ id: 'after-end', offset: 'PT15M', reference: 'end' }],
+    title: 'All-day Saturday series',
+  } as const satisfies TemporalEvent;
+
+  expect(JSON.parse(JSON.stringify([allDayEvent, event]))).toEqual([allDayEvent, event]);
+});

package/src/types/temporal.ts

@@ -0,0 +1,184 @@
+/** A calendar date without a time or timezone, represented as `YYYY-MM-DD`. */
+export type TemporalDate = `${number}-${number}-${number}`;
+
+/** A UTC ISO-8601 instant, represented as an RFC 3339 string ending in `Z`. */
+export type TemporalInstant = `${string}Z`;
+
+/** An IANA timezone identifier such as `Europe/Zurich`. */
+export type TemporalTimeZone = string;
+
+/** An ISO-8601 duration string such as `PT30M` or `-PT15M`. */
+export type TemporalDuration = string;
+
+/**
+ * This contract describes serializable shape, not runtime validation. Consumers must validate
+ * RFC 3339 instants, ISO calendar dates and durations, IANA zone identifiers, positive non-zero
+ * intervals, ordered ranges, and finite JSON numbers at their input boundary.
+ */
+export type TemporalDataValue =
+  | boolean
+  | null
+  | number
+  | string
+  | readonly TemporalDataValue[]
+  | { readonly [key: string]: TemporalDataValue };
+
+/**
+ * A timed interval with exactly one exclusive end. Recurring timed events retain the local
+ * wall-clock time derived from `start` in `timeZone` across DST transitions; a recurrence engine
+ * materializes each occurrence as its corresponding UTC instant.
+ */
+export type TemporalTimedRange =
+  | {
+      readonly allDay: false;
+      readonly start: TemporalInstant;
+      readonly end: TemporalInstant;
+      readonly duration?: never;
+      readonly timeZone: TemporalTimeZone;
+    }
+  | {
+      readonly allDay: false;
+      readonly start: TemporalInstant;
+      readonly end?: never;
+      readonly duration: TemporalDuration;
+      readonly timeZone: TemporalTimeZone;
+    };
+
+/**
+ * A timezone-free all-day calendar-date interval with exactly one exclusive end. `end` is the
+ * first day not included, so a one-day event from `2026-10-24` ends on `2026-10-25`.
+ */
+export type TemporalAllDayRange =
+  | {
+      readonly allDay: true;
+      readonly start: TemporalDate;
+      readonly end: TemporalDate;
+      readonly duration?: never;
+    }
+  | {
+      readonly allDay: true;
+      readonly start: TemporalDate;
+      readonly end?: never;
+      readonly duration: TemporalDuration;
+    };
+
+/** A timed or all-day interval with exactly one way to define its exclusive end. */
+export type TemporalRange = TemporalAllDayRange | TemporalTimedRange;
+
+/** The availability an event contributes without disclosing its details. */
+export type TemporalAvailability = 'free' | 'busy' | 'tentative' | 'unavailable';
+
+/** A provider-neutral lifecycle state for a scheduled event. */
+export type TemporalEventStatus = 'cancelled' | 'confirmed' | 'draft' | 'tentative';
+
+/** A semantic theme treatment that later ZORA renderers resolve through their active theme. */
+export type TemporalTone = 'accent' | 'critical' | 'info' | 'neutral' | 'positive' | 'warning';
+
+/** A person or organization participating in an event without provider-specific identity objects. */
+export interface TemporalParticipant {
+  readonly id?: string;
+  readonly name?: string;
+  readonly email?: string;
+  readonly role?: 'optional' | 'organizer' | 'required' | 'resource';
+  readonly response?: 'accepted' | 'declined' | 'delegated' | 'needs-action' | 'tentative';
+}
+
+/**
+ * A reminder relative to the event start or exclusive end. A negative ISO duration fires before
+ * that reference point; a positive duration fires after it.
+ */
+export interface TemporalReminder {
+  readonly id: string;
+  readonly offset: TemporalDuration;
+  readonly reference: 'end' | 'start';
+  readonly channel?: 'display' | 'email' | 'push';
+}
+
+/**
+ * One normalized recurrence rule. `until` has the same value type as DTSTART: a date for all-day
+ * series and a UTC instant for timed series. Adapter layers map this to and from RFC 5545 RRULE.
+ */
+export interface TemporalRecurrenceRule<TValue extends TemporalDate | TemporalInstant> {
+  readonly frequency: 'daily' | 'monthly' | 'weekly' | 'yearly';
+  readonly interval?: number;
+  readonly count?: number;
+  readonly until?: TValue;
+  readonly weekdays?: readonly (
+    'friday' | 'monday' | 'saturday' | 'sunday' | 'thursday' | 'tuesday' | 'wednesday'
+  )[];
+  readonly monthDays?: readonly number[];
+  readonly months?: readonly number[];
+}
+
+/**
+ * Recurrence data retained independently from provider-specific series representations. `dates`
+ * and `excludedDates` correspond to RFC 5545 RDATE and EXDATE and use the DTSTART value type.
+ */
+export interface TemporalRecurrence<TValue extends TemporalDate | TemporalInstant> {
+  readonly rules: readonly TemporalRecurrenceRule<TValue>[];
+  readonly dates?: readonly TValue[];
+  readonly excludedDates?: readonly TValue[];
+}
+
+/**
+ * A detached occurrence that replaces or cancels one generated recurrence instance. `recurrenceId`
+ * is the original scheduled DTSTART value: for timed DST series, the UTC instant materialized from
+ * that occurrence's wall-clock time in the series timezone; for all-day series, its calendar date.
+ */
+export interface TemporalRecurrenceException<
+  TValue extends TemporalDate | TemporalInstant,
+  TRange extends TemporalRange,
+> {
+  readonly recurrenceId: TValue;
+  readonly status: 'cancelled' | 'replacement';
+  readonly range?: TRange;
+  readonly title?: string;
+}
+
+/** Lossless serialized data that an interoperability adapter must round-trip without exposing its runtime. */
+export interface TemporalInteroperabilityData {
+  readonly format: 'icalendar' | 'jcal' | 'provider';
+  readonly value: TemporalDataValue;
+}
+
+interface TemporalEventBase {
+  readonly id: string;
+  readonly title: string;
+  readonly description?: string;
+  readonly location?: string;
+  readonly conferenceUrl?: string;
+  readonly calendarId?: string;
+  readonly tone?: TemporalTone;
+  readonly availability?: TemporalAvailability;
+  readonly status?: TemporalEventStatus;
+  readonly resourceIds?: readonly string[];
+  readonly organizer?: TemporalParticipant;
+  readonly attendees?: readonly TemporalParticipant[];
+  readonly reminders?: readonly TemporalReminder[];
+  readonly editable?: boolean;
+  readonly metadata?: Readonly<Record<string, TemporalDataValue>>;
+  readonly interoperability?: readonly TemporalInteroperabilityData[];
+}
+
+/** A provider-neutral timed event with instant-based recurrence values. */
+export interface TemporalTimedEvent extends TemporalEventBase {
+  readonly range: TemporalTimedRange;
+  readonly recurrence?: TemporalRecurrence<TemporalInstant>;
+  readonly recurrenceExceptions?: readonly TemporalRecurrenceException<
+    TemporalInstant,
+    TemporalTimedRange
+  >[];
+}
+
+/** A provider-neutral all-day event with date-based recurrence values. */
+export interface TemporalAllDayEvent extends TemporalEventBase {
+  readonly range: TemporalAllDayRange;
+  readonly recurrence?: TemporalRecurrence<TemporalDate>;
+  readonly recurrenceExceptions?: readonly TemporalRecurrenceException<
+    TemporalDate,
+    TemporalAllDayRange
+  >[];
+}
+
+/** Provider-neutral, serializable event data shared by future Calendar and Scheduler presentations. */
+export type TemporalEvent = TemporalAllDayEvent | TemporalTimedEvent;

package/web-dist/chunks/{Accordion-wf60fekp.js → Accordion-rkg1y7x3.js}

@@ -38,6 +38,12 @@ import {
 var import_react_native = __toESM(require_cjs(), 1);
 import React2 from "react";
 
+// src/features/list/constants/virtualization.ts
+var LIST_VIRTUALIZATION_DEFAULTS = {
+  maxToRenderPerBatch: 10,
+  onEndReachedThreshold: 2
+};
+
 // src/features/list/adapters/inbound/HorizontalListSeparator.tsx
 import { jsx } from "react/jsx-runtime";
 function HorizontalListSeparator() {
@@ -81,9 +87,9 @@ function FlatListInner({
   horizontal,
   refreshing = false,
   initialNumToRender,
-  maxToRenderPerBatch,
+  maxToRenderPerBatch = LIST_VIRTUALIZATION_DEFAULTS.maxToRenderPerBatch,
   windowSize,
-  onEndReachedThreshold,
+  onEndReachedThreshold = LIST_VIRTUALIZATION_DEFAULTS.onEndReachedThreshold,
   showsScrollIndicator = true,
   bounces,
   showSeparators,
@@ -464,9 +470,9 @@ function SectionListInner({
   horizontal,
   refreshing = false,
   initialNumToRender,
-  maxToRenderPerBatch,
+  maxToRenderPerBatch = LIST_VIRTUALIZATION_DEFAULTS.maxToRenderPerBatch,
   windowSize,
-  onEndReachedThreshold,
+  onEndReachedThreshold = LIST_VIRTUALIZATION_DEFAULTS.onEndReachedThreshold,
   showsScrollIndicator = true,
   bounces,
   showSeparators,

package/web-dist/chunks/{Accordion-nsamv0p0.js → Accordion-xt8vafkn.js}

@@ -13,7 +13,7 @@ import {
 } from "./Accordion-whk372cs.js";
 import {
   List2
-} from "./Accordion-wf60fekp.js";
+} from "./Accordion-rkg1y7x3.js";
 import {
   useZoraTheme2
 } from "./Accordion-srjya6dz.js";

package/web-dist/components/data-table/DataTable.js

@@ -43,8 +43,8 @@ import {
 } from "../../chunks/Accordion-nj7k0m66.js";
 import {
   SkeletonList2
-} from "../../chunks/Accordion-nsamv0p0.js";
-import"../../chunks/Accordion-wf60fekp.js";
+} from "../../chunks/Accordion-xt8vafkn.js";
+import"../../chunks/Accordion-rkg1y7x3.js";
 import"../../chunks/Accordion-ng4f4k3b.js";
 import"../../chunks/Accordion-eqvdv7tt.js";
 import"../../chunks/Accordion-61e19g3e.js";

package/web-dist/components/flat-list/FlatList.js

@@ -12,7 +12,7 @@ import {
   List2,
   ListSection2,
   SectionList2
-} from "../../chunks/Accordion-wf60fekp.js";
+} from "../../chunks/Accordion-rkg1y7x3.js";
 import"../../chunks/Accordion-xstk85jq.js";
 import"../../chunks/Accordion-qr5qn652.js";
 import"../../chunks/Accordion-ng4f4k3b.js";

package/web-dist/components/list/List.js

@@ -12,7 +12,7 @@ import {
   List2,
   ListSection2,
   SectionList2
-} from "../../chunks/Accordion-wf60fekp.js";
+} from "../../chunks/Accordion-rkg1y7x3.js";
 import"../../chunks/Accordion-xstk85jq.js";
 import"../../chunks/Accordion-qr5qn652.js";
 import"../../chunks/Accordion-ng4f4k3b.js";

package/web-dist/components/list-item/ListItem.js

@@ -12,7 +12,7 @@ import {
   List2,
   ListSection2,
   SectionList2
-} from "../../chunks/Accordion-wf60fekp.js";
+} from "../../chunks/Accordion-rkg1y7x3.js";
 import"../../chunks/Accordion-xstk85jq.js";
 import"../../chunks/Accordion-qr5qn652.js";
 import"../../chunks/Accordion-ng4f4k3b.js";

package/web-dist/components/list-section/ListSection.js

@@ -12,7 +12,7 @@ import {
   List2,
   ListSection2,
   SectionList2
-} from "../../chunks/Accordion-wf60fekp.js";
+} from "../../chunks/Accordion-rkg1y7x3.js";
 import"../../chunks/Accordion-xstk85jq.js";
 import"../../chunks/Accordion-qr5qn652.js";
 import"../../chunks/Accordion-ng4f4k3b.js";

package/web-dist/components/section-list/SectionList.js

@@ -12,7 +12,7 @@ import {
   List2,
   ListSection2,
   SectionList2
-} from "../../chunks/Accordion-wf60fekp.js";
+} from "../../chunks/Accordion-rkg1y7x3.js";
 import"../../chunks/Accordion-xstk85jq.js";
 import"../../chunks/Accordion-qr5qn652.js";
 import"../../chunks/Accordion-ng4f4k3b.js";